文档首页/ AI开发平台ModelArts/ API参考/ DevServer管理/ 查询超节点hyperinstance-clusters逻辑容量测算结果
更新时间:2025-11-17 GMT+08:00
分享

查询超节点hyperinstance-clusters逻辑容量测算结果

功能介绍

查询指定超节点集群的逻辑容量测算结果

调试

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

URI

POST /v1/{project_id}/dev-servers/hyperinstance/cluster-capacity-evaluations

表1 路径参数

参数

是否必选

参数类型

描述

project_id

String

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

约束限制:1 - 64字符,字母、数字和中划线。

取值范围:不涉及。

默认取值:不涉及。

请求参数

表2 请求Body参数

参数

是否必选

参数类型

描述

hyperinstance_cluster_ids

Array of strings

参数解释:超节点集群ID列表。

约束限制:数组长度0-5,每个元素长度1-128字符。

默认取值:不涉及。

flavor

String

参数解释:规格名称。

约束限制:长度1-65536个字符。

默认取值:不涉及。

availability_zone

String

参数解释:可用区。

约束限制:长度1-65536个字符。

默认取值:不涉及。

resource_flavor

String

参数解释:资源规格。

约束限制:长度1-65536个字符。

默认取值:不涉及。

响应参数

状态码:200

表3 响应Body参数

参数

参数类型

描述

capacities

Array of ServerHpsClusterCapacity objects

容量信息列表

表4 ServerHpsClusterCapacity

参数

参数类型

描述

flavor

String

参数解释:规格名称。

约束限制:长度1-65536个字符。

默认取值:不涉及。

availability_zone

String

参数解释:可用区ID。

约束限制:长度1-65536个字符。

默认取值:不涉及。

hyperinstance_cluster_id

String

参数解释:超节点集群ID。

约束限制:长度1-65536个字符。

默认取值:不涉及。

hyperinstance_cluster_name

String

参数解释:超节点集群名称。

约束限制:长度1-65536个字符。

默认取值:不涉及。

resource_flavor

String

参数解释:资源规格。

约束限制:长度1-65536个字符。

默认取值:不涉及。

is_sold_out

Boolean

参数解释:售罄状态。

约束限制:布尔值(true/false)。

默认取值:不涉及。

状态码:401

表5 响应Body参数

参数

参数类型

描述

error_code

String

参数解释:ModelArts错误码。

取值范围:不涉及。

error_msg

String

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

取值范围:不涉及。

状态码:403

表6 响应Body参数

参数

参数类型

描述

error_code

String

参数解释:ModelArts错误码。

取值范围:不涉及。

error_msg

String

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

取值范围:不涉及。

状态码:404

表7 响应Body参数

参数

参数类型

描述

error_code

String

参数解释:ModelArts错误码。

取值范围:不涉及。

error_msg

String

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

取值范围:不涉及。

请求示例

POST https://{endpoint}/v1/{project_id}/dev-servers/hyperinstance/cluster-capacity-evaluations

{
  "hyperinstance_cluster_ids" : [ "a1b2c3d4-e5f6-7890-abcd-ef1234567890" ],
  "flavor" : "kat3ne-8.48xlarge.8.800t.matrix",
  "availability_zone" : "cn-east-3a",
  "resource_flavor" : "gpu.8xlarge"
}

响应示例

状态码:200

参数解释:容量查询结果。

{
  "capacities" : [ {
    "flavor" : "kat3ne-8.48xlarge.8.800t.matrix",
    "availability_zone" : "cn-east-3a",
    "hyperinstance_cluster_id" : "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "hyperinstance_cluster_name" : "production-cluster-1",
    "resource_flavor" : "gpu.8xlarge",
    "is_sold_out" : true
  }, {
    "flavor" : "kat3ne-16.96xlarge.16.1600t.matrix",
    "availability_zone" : "cn-east-3b",
    "hyperinstance_cluster_id" : "b2c3d4e5-f6a7-8901-bcde-f23456789012",
    "hyperinstance_cluster_name" : "production-cluster-2",
    "resource_flavor" : "gpu.16xlarge",
    "is_sold_out" : true
  } ]
}

状态码

状态码

描述

200

参数解释:容量查询结果。

401

Unauthorized

403

Forbidden

404

Not Found

错误码

请参见错误码

相关文档