查询超节点规格详情-ShowHypernodeType
功能介绍
查询指定超节点规格的详细信息,仅返回当前用户有权限访问的规格。
接口保障强一致性。该接口为公开接口,需要用户Token鉴权。
调试
您可以在API Explorer中调试该接口,支持自动认证鉴权。API Explorer可以自动生成SDK代码示例,并提供SDK代码示例调试功能。
授权信息
账号根用户具备所有API的调用权限,如果使用账号下的IAM用户调用当前API,该IAM用户需具备如下身份策略权限,更多的权限说明请参见权限和授权项。
| 授权项 | 访问级别 | 资源类型(*为必须) | 条件键 | 别名 | 依赖的授权项 |
|---|---|---|---|---|---|
| aics::getHypernodeType | Read | - | - | - | - |
URI
GET /v2/{project_id}/hypernode-types/{hypernode_type_id}
| 参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
| project_id | 是 | String | 参数解释: 项目ID,获取方法请参见获取项目ID。 约束限制: 不涉及。 取值范围: 不涉及。 默认取值: 不涉及。 |
| hypernode_type_id | 是 | String | 参数解释: 超节点规格标识,用于唯一标识一个超节点规格。 约束限制: 不涉及。 取值范围: 长度1-64,只能由英文字母、数字及"_"、"-"、"."组成。可通过查询超节点规格列表获取。 默认取值: 不涉及。 |
请求参数
| 参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
| X-Auth-Token | 否 | String | 参数解释: 用户Token,通过调用IAM服务获取用户Token接口获取(响应消息头中X-Subject-Token的值)。 约束限制: 不涉及。 取值范围: 不涉及。 默认取值: 不涉及。 |
响应参数
状态码:200
| 参数 | 参数类型 | 描述 |
|---|---|---|
| id | String | 参数解释: 超节点规格标识,用于唯一标识一个超节点规格。创建超节点时需指定此标识来选择对应的规格。 取值范围: 长度1-64,只能由英文字母、数字及"_"、"-"、"."组成。 |
| family | String | 参数解释: 规格族名称,用于标识超节点所属的规格族。同一规格族下的超节点具有相似的硬件配置特征。 取值范围: 长度1-64,只能由英文字母、数字及"_"、"-"、"."组成。 |
| product_info | ProductInfo object | 参数解释: 超节点规格的产品信息,包含计费模式、服务类型等。 取值范围: 不涉及。 |
| node_info | NodeInfo object | 参数解释: 超节点中计算节点的规格信息,包含节点数量、CPU、内存等配置。 取值范围: 不涉及。 |
| npu_info | NpuInfo object | 参数解释: 超节点中NPU设备的规格信息,包含NPU型号、数量、集群网络等配置。 取值范围: 不涉及。 |
| network_info | NetworkInfo object | 参数解释: 超节点的业务网络规格信息,包含最大网卡数量等配置。 取值范围: 不涉及。 |
| volume_info | VolumeInfo object | 参数解释: 超节点的云硬盘规格信息,包含最大云硬盘数量等配置。 取值范围: 不涉及。 |
| status | String | 参数解释: 超节点规格的售卖状态,用于标识规格当前的可用性。 取值范围: |
| 参数 | 参数类型 | 描述 |
|---|---|---|
| charge_mode | String | 参数解释: 超节点规格支持的计费模式,用于确定资源的付费方式。 取值范围: |
| service_type | String | 参数解释: 服务类型,用于标识该规格所属的服务类别。 取值范围: 长度1-64,只能由英文字母、数字及"_"、"-"、"."组成。 |
| resource_type | String | 参数解释: 资源类型,用于标识该规格对应的资源类别。 取值范围: 长度1-64,只能由英文字母、数字及"_"、"-"、"."组成。 |
| resource_spec_code | String | 参数解释: 资源规格编码,用于在计费系统中唯一标识该规格对应的资源规格。 取值范围: 长度1-64,只能由英文字母、数字及"_"、"-"、"."组成。 |
| 参数 | 参数类型 | 描述 |
|---|---|---|
| count | Integer | 参数解释: 超节点中包含的计算节点总数。该参数用于描述超节点的计算规模,决定超节点可提供的计算能力。 取值范围: 不涉及。 |
| cpu_info | CpuInfo object | 参数解释: 计算节点的CPU规格信息,包含vCPU数量等配置。 取值范围: 不涉及。 |
| memory_info | MemoryInfo object | 参数解释: 计算节点的内存规格信息,包含内存大小等配置。 取值范围: 不涉及。 |
| local_disk_infos | Array of LocalDiskInfo objects | 参数解释: 计算节点的本地磁盘规格信息列表,包含本地盘类型、数量和容量等配置。 取值范围: 不涉及。 |
| 参数 | 参数类型 | 描述 |
|---|---|---|
| type | String | 参数解释: 本地盘类型,用于标识本地盘的存储介质类型,影响磁盘的IO性能。 取值范围: 长度1-64,只能由英文字母、数字及"_"、"-"、"."组成。 |
| count | Integer | 参数解释: 同类型本地盘的数量。该参数用于描述超节点中同类型本地盘的配置数量,影响节点的本地存储能力。 取值范围: 不涉及。 |
| size_gb | Integer | 参数解释: 单块本地盘的容量大小,单位为GiB。该参数用于描述单块本地盘的存储容量,影响节点的本地存储空间。 取值范围: 不涉及。 |
| 参数 | 参数类型 | 描述 |
|---|---|---|
| name | String | 参数解释: NPU设备型号,用于标识NPU的具体产品型号,决定NPU的计算能力和特性。 取值范围: 长度1-64,只能由英文字母、数字及"_"、"-"、"."组成。 |
| count | Integer | 参数解释: 单个计算节点中NPU设备数量。该参数用于描述单个计算节点的NPU算力规模。 取值范围: 最小1,最大64。 |
| cluster_network_info | ClusterNetworkInfo object | 参数解释: NPU集群的参数面网络信息,包含参数面网络接口数量等配置。 取值范围: 不涉及。 |
| topology | String | 参数解释: NPU集群的拓扑结构,形式为MxN,其中M表示行数,N表示列数。该参数用于描述NPU设备之间的互联拓扑关系,影响NPU集群的通信效率。 取值范围: 格式为MxN,M和N均为正整数,且总长度不超过25。 |
| memory_info | MemoryInfo object | 参数解释: NPU设备的内存规格信息,包含内存大小等配置。 取值范围: 不涉及。 |
| peak_compute | Array of PeakCompute objects | 参数解释: NPU设备的峰值算力信息列表,每个元素包含一种精度类型及其对应的算力值和单位。该参数用于描述NPU在不同精度下的峰值计算性能。 取值范围: 列表长度1-16。 |
| bandwidth_gbs | Long | 参数解释: NPU设备的显存带宽,单位为GB/s。该参数用于描述NPU显存的数据传输速率,影响大规模模型训练时的数据吞吐能力。 取值范围: 不涉及。 |
| 参数 | 参数类型 | 描述 |
|---|---|---|
| cluster_network_interface_count | Integer | 参数解释: 参数面网络接口数量。该参数用于描述NPU集群参数面通信的网络接口数量,影响NPU集群间的通信带宽。 取值范围: 不涉及。 |
| 参数 | 参数类型 | 描述 |
|---|---|---|
| size_gb | Long | 参数解释: 内存大小,单位为GB。该参数用于描述计算节点或NPU的内存容量,影响节点的数据处理能力。 取值范围: 不涉及。 |
| 参数 | 参数类型 | 描述 |
|---|---|---|
| precision | String | 参数解释: 算力精度类型,用于标识算力值的计算精度。 取值范围: |
| value | Long | 参数解释: 算力值,与精度和单位配合描述NPU的计算性能。 取值范围: 不涉及。 |
| unit | String | 参数解释: 算力单位,用于标识算力值的计量单位。 取值范围: |
请求示例
查询超节点规格详情请求示例。使用场景:用户需要查看指定超节点规格的详细信息时,通过规格ID获取规格详情。
GET https://{endpoint}/v2/0605767a3300d5762fb7c0186d9e1779/hypernode-types/aics.a5-e.64.superpod 响应示例
状态码:200
OK
{
"id" : "aics.a5-e.64.superpod",
"family" : "ka5n",
"product_info" : {
"charge_mode" : "prePaid",
"service_type" : "hws.service.type.aics",
"resource_type" : "hws.resource.type.npucluster",
"resource_spec_code" : "aics.a5-e.64.superpod"
},
"node_info" : {
"count" : 8,
"cpu_info" : {
"vcpus" : 192
},
"memory_info" : {
"size_gb" : 2304
}
},
"npu_info" : {
"name" : "950DT",
"count" : 8,
"cluster_network_info" : {
"cluster_network_interface_count" : 64
},
"topology" : "8x8",
"memory_info" : {
"size_gb" : 96
},
"peak_compute" : [ {
"precision" : "FP16",
"value" : 486,
"unit" : "TFLOPS"
} ],
"bandwidth_gbs" : 4096
},
"network_info" : {
"max_interface_count" : 5,
"uboe_supported" : true
},
"volume_info" : {
"max_volume_count" : 15
},
"status" : "normal"
} 状态码
| 状态码 | 描述 |
|---|---|
| 200 | OK |
错误码
请参见错误码。