更新时间:2025-10-29 GMT+08:00

资源池统计

功能介绍

资源池统计接口用于获取指定资源池的统计信息。该接口适用于以下场景:当需要了解资源池的资源使用情况、分配情况或利用率时,用户可通过此接口获取资源池的统计数据。使用该接口的前提条件是资源池已存在且用户具有管理员权限。调用接口成功后,系统将返回资源池的统计信息,包括资源使用总量、已分配量、利用率及资源分配趋势等数据。若资源池不存在、用户无权限操作或资源池当前不可用,接口将返回相应的错误信息。

调试

您可以在API Explorer中调试该接口,支持自动认证鉴权。API Explorer可以自动生成SDK代码示例,并提供SDK代码示例调试功能。

URI

GET /v2/{project_id}/statistics/pools

表1 路径参数

参数

是否必选

参数类型

描述

project_id

String

参数解释:用户项目ID。获取方法请参见获取项目ID和名称

约束限制:不涉及。

取值范围:不涉及。

默认取值:不涉及。

表2 Query参数

参数

是否必选

参数类型

描述

workspaceId

String

参数解释:工作空间,默认值为0。

约束限制:不涉及。

取值范围:不涉及。

默认取值:不涉及。

请求参数

响应参数

状态码:200

表3 响应Body参数

参数

参数类型

描述

statistics

statistics object

参数描述: 资源池统计信息。

operationTime

String

参数描述: 统计的时间。

取值范围: 不涉及。

表4 statistics

参数

参数类型

描述

status

status object

参数描述: 不同状态下的资源池统计信息。

表5 status

参数

参数类型

描述

creating

Integer

参数描述: 正在创建中的资源池统计信息。

取值范围: 不涉及。

created

Integer

参数描述: 创建成功的资源池数量。

取值范围: 不涉及。

failed

Integer

参数描述: 最近三天内创建失败的资源池数量,最大值为500。

取值范围: 不涉及。

pending

Integer

参数描述: 等待中的资源池数量,通常是未支付的包周期资源池。

取值范围: 不涉及。

状态码:500

表6 响应Body参数

参数

参数类型

描述

error_code

String

参数解释:ModelArts错误码。

取值范围:不涉及。

error_msg

String

参数解释:具体错误信息。

取值范围:不涉及。

请求示例

查询资源池监控信息。

GET https://{endpoint}/v2/{project_id}/pools

{ }

响应示例

状态码:200

OK。

{
  "statistics" : {
    "status" : {
      "created" : 3,
      "creating" : 0,
      "failed" : 1,
      "pending" : 0
    }
  },
  "operationTime" : "2022-12-05 11:15:59.329633162 +0000 UTC"
}

状态码:500

Internal error

{
  "error_code" : "ModelArts.50005000",
  "error_msg" : "internal error"
}

状态码

状态码

描述

200

OK。

500

Internal error

错误码

请参见错误码