# 查询资源池监控 - ShowV2ComputesMetrics #### 功能介绍 查询资源池监控CPU、MEM、NPU、GPU数据。此接口为同步接口，无配套使用接口和特殊场景。 #### 调用方法 请参见[如何调用API](https://support.huaweicloud.com/api-aidatalake/aidatalake_02_0003.html)。 #### URI GET /v2/workspaces/{workspace_id}/computes/metrics 表1路径参数 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | workspace_id | 是 | String | **参数解释**：工作空间ID。 **约束限制**：不涉及。 **取值范围**：长度为32\~36的英文字符、数字和中划线的组合。 **默认取值**：不涉及。 | 表2Query参数 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | step | 是 | Integer | **参数解释**：查询时间步长。 **约束限制**：不涉及。 **取值范围**：单位秒。 - 60：每分钟一个点。 - 3600：每1小时一个点。 - 86400：每天一个点。 **默认取值**：60。 | | metric_name | 是 | String | **参数解释**：指标名称。 **约束限制**：不涉及。 **取值范围**： - CPU：资源池CPU使用率。 - MEM：资源池内存使用率。 - NPU：资源池NPU使用率。 - GPU：资源池GPU使用率。 **默认取值**：不涉及。 | | start_time | 是 | Long | **参数解释**：开始时间。 **约束限制**：不涉及。 **取值范围**：时间戳，单位秒。 **默认取值**：不涉及。 | | end_time | 是 | Long | **参数解释**：结束时间。 **约束限制**：不涉及。 **取值范围**：时间戳，单位秒。 **默认取值**：不涉及。 | | compute_ids | 是 | String | **参数解释**：资源池ids，多个用英文逗号分隔。 **约束限制**：不涉及。 **取值范围**：不涉及。 **默认取值**：1\~1110个英文字符。 | #### 请求参数 表3请求Header参数 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | X-Auth-Token | 是 | String | **参数解释**：用户Token。 **约束限制**：不涉及。 **取值范围**：长度不超过65534个字符。 **默认取值**：不涉及。 | #### 响应参数 **状态码：200** 表4响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | data | Array of [ComputeResourceMetrics] objects | **参数解释**：资源池指标信息。 | 表5ComputeResourceMetrics | 参数 | 参数类型 | 描述 | |:---|:---|:---| | collection_time | Integer | **参数解释**：数据时间（秒）。 **取值范围**：0\~2147483647。 | | values | Array of [ComputeMetric] objects | **参数解释**：资源池指标值列表。 | 表6ComputeMetric | 参数 | 参数类型 | 描述 | |:---|:---|:---| | compute_name | String | **参数解释**：资源池名称。 **取值范围**：长度为1\~63个字符。 | | compute_value | Number | **参数解释**：资源池指标值。 **取值范围**：0\~100。 | **状态码：400** 表7响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | error_code | String | **参数解释**：错误码。 **取值范围**：长度为8\~36个字符。 | | error_msg | String | **参数解释**：错误描述。 **取值范围**：长度为2\~512个字符。 | | solution_msg | String | **参数解释**：解决方案。 **取值范围**：长度为0\~4096个字符。 | **状态码：401** 表8响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | error_code | String | **参数解释**：错误码。 **取值范围**：长度为8\~36个字符。 | | error_msg | String | **参数解释**：错误描述。 **取值范围**：长度为2\~512个字符。 | | solution_msg | String | **参数解释**：解决方案。 **取值范围**：长度为0\~4096个字符。 | **状态码：403** 表9响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | error_code | String | **参数解释**：错误码。 **取值范围**：长度为8\~36个字符。 | | error_msg | String | **参数解释**：错误描述。 **取值范围**：长度为2\~512个字符。 | | solution_msg | String | **参数解释**：解决方案。 **取值范围**：长度为0\~4096个字符。 | **状态码：408** 表10响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | error_code | String | **参数解释**：错误码。 **取值范围**：长度为8\~36个字符。 | | error_msg | String | **参数解释**：错误描述。 **取值范围**：长度为2\~512个字符。 | | solution_msg | String | **参数解释**：解决方案描述。 **取值范围**：长度为0\~4096个字符。 | **状态码：500** 表11响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | error_code | String | **参数解释**：错误码。 **取值范围**：长度为8\~36个字符。 | | error_msg | String | **参数解释**：错误描述。 **取值范围**：长度为2\~512个字符。 | | solution_msg | String | **参数解释**：解决方案。 **取值范围**：长度为0\~4096个字符。 | #### 请求示例 查询资源池"compute1"和"compute2"在"2026-06-16 13:50:00"到"2026-06-16 13:51:00"之间的"CPU"指标数据，数据步长为"1分钟"。 ``` GET /v2/workspaces/{workspace_id}/computes/metrics?compute_ids=02fa5e94-f44c-4ceb-9480-0e1846e6262f,13b46a70-aca3-4935-a04e-6f3dcc0a4203&start_time=1781589000&end_time=1781589060&step=60&metric_name=CPU ``` #### 响应示例 **状态码：200** 请求成功。 ``` [ { "collection_time" : 1781589000, "values" : [ { "compute_name" : "compute1", "compute_value" : 0.5 }, { "compute_name" : "compute2", "compute_value" : 0.5 } ] } ] ``` **状态码：400** 请求参数错误。 ``` { "error_code" : "AIDataLake.00010151", "error_msg" : "Parameter value is invalid.", "solution_msg" : "Please input valid parameter value." } ``` **状态码：401** 未授权。 ``` { "error_code" : "APIGW.0301", "error_msg" : "Incorrect IAM authentication information: decrypt token fail.", "solution_msg" : "Check whether the IAM authentication information is correct." } ``` **状态码：403** 禁止访问。 ``` { "error_code" : "AIDataLake.00010150", "error_msg" : "The operation is not allowed.", "solution_msg" : "Check whether the operation is allowed in the current status." } ``` **状态码：408** 请求超时。 ``` { "error_code" : "common.00000408", "error_msg" : "timeout exception occurred" } ``` **状态码：500** 内部服务器错误。 ``` { "error_code" : "AIDataLake.00011001", "error_msg" : "Internal error.", "solution_msg" : "Contact technical support or try again later." } ``` #### 状态码 | 状态码 | 描述 | |:---|:---| | 200 | 请求成功。 | | 400 | 请求参数错误。 | | 401 | 未授权。 | | 403 | 禁止访问。 | | 408 | 请求超时。 | | 500 | 内部服务器错误。 |