# 列出所有Space - ListCoreSpaces #### 功能介绍 查询租户下的所有记忆空间信息，支持分页查询。 #### 调用方法 请参见[如何调用API](https://support.huaweicloud.com/api-agentarts/agentarts_07_0003.html)。 #### URI GET /v1/core/spaces 表1Query参数 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | limit | 否 | Integer | **参数解释：** 每页返回的记录数量（条），用于分页查询。 **约束限制：** 不涉及。 **取值范围：** 1-100。 **默认取值：** 20。 | | offset | 否 | Integer | **参数解释：** 查询游标，即偏移量（条），用于分页查询时指定起始位置，从0开始。 **约束限制：** 不涉及。 **取值范围：** 0-100000。 **默认取值：** 0。 | | tag_key_exists | 否 | Array of strings | **参数解释**： 需要匹配的包含该标签名称的资源，数组元素为标签key名称字符串，多个值通过重复参数名传递，如：tag_key_exists=env\&tag_key_exists=team。 **约束限制**: 支持批量查询多个标签名，最少1个，最多支持10个标签。 | | tag_key_matches | 否 | Array of strings | **参数解释**： 需要匹配的包含该标签的资源，数组元素为标签key名称字符串，多个值通过重复参数名传递，如：tag_key_matches=env\&tag_key_matches=team。 **约束限制**: 支持批量查询多个标签，最少1个，最多支持10个标签。需要和tag_value_matches条件配合使用，tag_key_matches和tag_value_matches的元素个数需要一致，且标签顺序需要完全匹配，不支持空字符串。 | | tag_value_matches | 否 | Array of strings | **参数解释**： 需要匹配的包含该标签的资源，数组元素为标签value值字符串，多个值通过重复参数名传递，如：tag_key_matches=env\&tag_value_matches=prod。 **约束限制**: 支持批量查询多个标签，最少1个，最多支持10个标签。需要和tag_key_matches条件配合使用，tag_key_matches和tag_value_matches的元素个数需要一致，且标签顺序需要完全匹配，不支持空字符串。 | | tag_match_policy | 否 | String | **参数解释**： 标签匹配模式，仅针对tag_key_exists，tag_key_matches，tag_value_matches参数生效。 **约束限制**: 不涉及。 **取值范围**： 长度为1-3个字符。允许的值为： - ALL：若请求中包含tag_key_exists参数，查询规则为资源标签需要包含tag_key_exists中的所有元素，若请求中tag_key_matches以及tag_value_matches参数存在，查询规则为资源标签需要包含所有tag_key_matches以及tag_value_matches参数中指定的key-value对应的标签。 - ANY：若请求中包含tag_key_exists参数，查询规则为资源标签需要包含tag_key_exists中的任意一个元素，若请求中tag_key_matches以及tag_value_matches参数存在，查询规则为资源标签需要包含tag_key_matches以及tag_value_matches参数中任意一个key-value对应的标签。 **默认取值**: ALL | | id | 否 | Array of strings | **参数解释**： 按记忆空间ID过滤。 **约束限制**： 支持批量查询多个ID，最多支持100个。 **取值范围**： UUID格式字符串。 **默认取值**： 不涉及。 | | name | 否 | String | **参数解释**： 按记忆空间名称模糊过滤。 **约束限制**： 不涉及。 **取值范围**： 长度1-255个字符。 **默认取值**： 不涉及。 | | status | 否 | Array of strings | **参数解释**： 按记忆空间状态过滤。 **约束限制**： 支持批量查询多个状态。 **取值范围**： 允许的值为： - creating: 创建中 - running: 运行中 - create_failed: 创建失败 **默认取值**： 不涉及。 | #### 请求参数 无 #### 响应参数 **状态码：200** 表2响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | spaces | Array of [CoreSpaceSummary] objects | **参数解释：** 记忆空间列表，最多返回100个空间对象。 | | size | Integer | **参数解释：** 返回的记忆空间数量（个）。 **取值范围：** 0-100。 | | total | Integer | **参数解释：** 记忆空间总数（个）。 **取值范围：** 不涉及。 | 表3CoreSpaceSummary | 参数 | 参数类型 | 描述 | |:---|:---|:---| | id | String | **参数解释：** 记忆空间 ID，唯一标识一个记忆空间，可通过"创建Space"接口获取。 **取值范围：** 不涉及。 | | name | String | **参数解释：** Space 名称。 **取值范围：** 不涉及。 | | description | String | **参数解释：** Space 描述。 **取值范围：** 不涉及。 | | status | String | **参数解释：** 记忆空间状态。 **取值范围：** - creating: 创建中 - running: 运行中 - deleted: 已删除 - create_failed: 创建失败 | | memory_strategy_count | Integer | **参数解释：** 关联的记忆策略数目（个）。 **取值范围：** 不涉及。 | | message_ttl_days | Integer | **参数解释：** 短期记忆过期时间（天），由 message_ttl_hours 换算。 **取值范围：** 不涉及。 | | tags | Array of [CoreSpaceTag] objects | **参数解释：** 库标签列表。 **取值范围：** 不涉及。 | | created_at | String | **参数解释：** 记录的创建时间，由系统自动生成，格式为 ISO 8601（YYYY-MM-DDTHH:mm:ssZ）。 **取值范围：** 不涉及。 | | updated_at | String | **参数解释：** 记录的最近更新时间，由系统自动更新，格式为 ISO 8601（YYYY-MM-DDTHH:mm:ssZ）。 **取值范围：** 不涉及。 | 表4CoreSpaceTag | 参数 | 参数类型 | 描述 | |:---|:---|:---| | key | String | **参数解释：** 标签键，用于标识标签的名称，最大长度128字符，不允许为空。 **取值范围：** 不涉及。 | | value | String | **参数解释：** 标签值，用于配合标签键标识标签的具体内容，最大长度255字符，可以为空。 **取值范围：** 不涉及。 | **状态码：400** 表5响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | error_code | String | **参数解释：** 错误码，标识错误类型，格式为 AgentArts.01XXXXXX。 **取值范围：** 不涉及。 | | error_msg | String | **参数解释：** 错误信息，描述错误详情，供问题排查使用。 **取值范围：** 不涉及。 | **状态码：401** 表6响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | error_code | String | **参数解释：** 错误码，标识错误类型，格式为 AgentArts.01XXXXXX。 **取值范围：** 不涉及。 | | error_msg | String | **参数解释：** 错误信息，描述错误详情，供问题排查使用。 **取值范围：** 不涉及。 | **状态码：403** 表7响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | error_code | String | **参数解释：** 错误码，标识错误类型，格式为 AgentArts.XXXXXXXX。 **取值范围：** 不涉及。 | | error_msg | String | **参数解释：** 错误信息，描述错误详情，供问题排查使用。 **取值范围：** 不涉及。 | | encoded_authorization_message | String | **参数解释：** 编码后的授权失败信息。 **取值范围：** 不涉及。 | | details | Array of [CoreSpaceCommonError] objects | **参数解释：** 依赖的下游服务错误信息列表，包含导致当前请求失败的下游服务错误详情。 **取值范围：** 不涉及。 | 表8CoreSpaceCommonError | 参数 | 参数类型 | 描述 | |:---|:---|:---| | error_code | String | **参数解释：** 错误码，标识错误类型，格式为 AgentArts.01XXXXXX。 **取值范围：** 不涉及。 | | error_msg | String | **参数解释：** 错误信息，描述错误详情，供问题排查使用。 **取值范围：** 不涉及。 | **状态码：404** 表9响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | error_code | String | **参数解释：** 错误码，标识错误类型，格式为 AgentArts.01XXXXXX。 **取值范围：** 不涉及。 | | error_msg | String | **参数解释：** 错误信息，描述错误详情，供问题排查使用。 **取值范围：** 不涉及。 | **状态码：429** 表10响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | error_code | String | **参数解释：** 错误码，标识错误类型，格式为 AgentArts.01XXXXXX。 **取值范围：** 不涉及。 | | error_msg | String | **参数解释：** 错误信息，描述错误详情，供问题排查使用。 **取值范围：** 不涉及。 | **状态码：500** 表11响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | error_code | String | **参数解释：** 错误码，标识错误类型，格式为 AgentArts.01XXXXXX。 **取值范围：** 不涉及。 | | error_msg | String | **参数解释：** 错误信息，描述错误详情，供问题排查使用。 **取值范围：** 不涉及。 | #### 请求示例 ``` /v1/core/spaces?limit=20&offset=0 ``` #### 响应示例 **状态码：200** 成功获取 Space 列表 ``` { "spaces" : [ { "id" : "123e4567-e89b-12d3-a456-426614174000", "name" : "space-01", "description" : "test-environment", "status" : "running", "memory_strategy_count" : 3, "message_ttl_days" : 7, "tags" : [ { "key" : "Environment", "value" : "production" } ], "created_at" : "2025-01-18T10:00:00.000Z", "updated_at" : "2025-01-18T10:00:00.000Z" } ], "size" : 100, "total" : 1000000 } ``` #### 状态码 | 状态码 | 描述 | |:---|:---| | 200 | 成功获取 Space 列表 | | 400 | 请求参数错误。 | | 401 | 认证失败。 | | 403 | 权限不足。 | | 404 | 记忆库未找到 | | 429 | 请求频率超限。 | | 500 | 内部服务器错误 | #### 错误码 请参见[错误码](https://support.huaweicloud.com/api-agentarts/ErrorCode.html)。