文档首页/ AI开发平台ModelArts/ API参考/ DevServer管理/ 查询Hyper Cluster实例详情
更新时间：2025-11-17 GMT+08:00
查看PDF
分享

查询Hyper Cluster实例详情

功能介绍

查询Hyper Cluster实例详情。

接口约束

暂无约束

调试

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

URI

GET /v1/{project_id}/dev-servers/hyper-clusters/{id}

表1 路径参数

参数

是否必选

参数类型

描述

id

是

String

参数解释：Hyper Cluster ID。

约束限制：必填。

取值范围：1 - 64字符。

默认取值：不涉及。

project_id

是

String

参数解释：用户项目ID。

约束限制：必填。

取值范围：1 - 64字符，字母、数字和中划线。

默认取值：不涉及。
表2 Query参数

参数

是否必选

参数类型

描述

type

否

String

参数解释：Hyper Cluster的类型。

约束限制：可选。

取值范围：

  • HPS：默认值，查询HPS机型的Hyper Cluster。

  • ECS：查询ECS机型的Hyper Cluster。

默认取值：HPS。

请求参数

无

响应参数

状态码：200

表3 响应Body参数

参数

参数类型

描述

id

String

参数解释：hyper cluster的ID。

取值范围：^[0-9a-f]{8}-[0-9a-f]{4}-[1-5][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$。

name

String

参数解释：hyper cluster的名称。

取值范围：^[-_.a-zA-Z0-9]{1,64}$。

network_info

Array of network_info objects

参数解释：网络信息。
表4 network_info

参数

参数类型

描述

hyper_cluster_subnet_id

String

参数解释：hyper cluster的子网名称。

取值范围：^[-_.a-zA-Z0-9]{1,64}$。

is_default

Boolean

参数解释：是否默认。

约束限制：不涉及。

取值范围：

  • true：默认网络

  • false：非默认网络

请求示例

GET https://{endpoint}/v1/{project_id}/dev-servers/hyper-clusters/{id}

响应示例

状态码：200

OK

{
  "id" : "74437437-6810-43b8-ba20-8f8e5bc034da",
  "name" : "test-hps--1107",
  "network_info" : [ {
    "hyper_cluster_subnet_id" : "47be1c96-b00c-4cc9-83cb-089893a632b6",
    "is_default" : true
  } ]
}

状态码

状态码

描述

200

OK

错误码

请参见错误码。

父主题： DevServer管理

相关文档