查询节点列表
功能介绍
查询资源池中的节点列表。
调试
您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。
URI
GET /v2/{project_id}/pools/{pool_name}/nodes
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
project_id |
是 |
String |
用户项目ID。获取方法请参见获取项目ID和名称。 |
|
pool_name |
是 |
String |
资源池名称。 |
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
continue |
否 |
String |
分页查询时上一页位置。 |
|
limit |
否 |
Integer |
分页单次查询返回数。 |
请求参数
无
响应参数
状态码： 200
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
apiVersion |
String |
API版本。可选值如下：
|
|
kind |
String |
资源类型。可选值如下：
|
|
metadata |
NodeListMetadata object |
资源列表的metadata信息。 |
|
items |
Array of Node objects |
节点列表。 |
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
apiVersion |
String |
API版本。可选值如下：
|
|
kind |
String |
资源类型。可选值如下：
|
|
metadata |
metadata object |
节点metadata信息。 |
|
spec |
NodeSpec object |
节点期望信息。 |
|
status |
NodeStatus object |
节点状态信息。 |
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
phase |
String |
节点当前状态。可选值如下：
|
|
az |
String |
节点所在的可用区。 |
|
privateIp |
String |
节点的IP地址。 |
|
resources |
NodeResource object |
节点资源量信息。 |
|
availableResources |
NodeResource object |
节点可用资源量信息。 |
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
cpu |
String |
CPU资源量。 |
|
memory |
String |
内存资源量。 |
|
nvidia.com/gpu |
String |
GPU节点的GPU资源量。 |
|
huawei.com/ascend-snt3 |
String |
昇腾节点的NPU资源量。 |
|
huawei.com/ascend-snt9 |
String |
昇腾节点的NPU资源量。 |
状态码： 404
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
error_code |
String |
ModelArts错误码。 |
|
error_msg |
String |
具体错误信息。 |
请求示例
查询资源池的节点列表。
GET https://{endpoint}/v2/{project_id}/pools/{pool_name}/nodes
{ }
响应示例
状态码： 200
OK。
{
"kind" : "NodeList",
"apiVersion" : "v2",
"metadata" : { },
"items" : [ {
"kind" : "Node",
"apiVersion" : "v2",
"metadata" : {
"name" : "os-node-created-zlncn",
"creationTimestamp" : "2022-09-16T05:32:44Z"
},
"spec" : {
"flavor" : "modelarts.vm.cpu.4ud"
},
"status" : {
"phase" : "Available",
"az" : "cn-north-7c",
"privateIp" : "192.168.0.1",
"resources" : {
"cpu" : "3920m",
"memory" : "6270Mi"
},
"availableResources" : {
"cpu" : "2970m",
"memory" : "4558Mi"
}
}
}, {
"kind" : "Node",
"apiVersion" : "v2",
"metadata" : {
"name" : "os-node-created-4s522",
"creationTimestamp" : "2022-09-16T03:20:53Z"
},
"spec" : {
"flavor" : "modelarts.vm.cpu.4ud"
},
"status" : {
"phase" : "Available",
"az" : "cn-north-7c",
"privateIp" : "192.168.0.2",
"resources" : {
"cpu" : "3920m",
"memory" : "6270Mi"
},
"availableResources" : {
"cpu" : "2970m",
"memory" : "4558Mi"
}
}
}, {
"kind" : "Node",
"apiVersion" : "v2",
"metadata" : {
"name" : "os-node-created-v7hfj",
"creationTimestamp" : "2022-09-16T09:16:37Z"
},
"spec" : {
"flavor" : "modelarts.vm.cpu.4ud"
},
"status" : {
"phase" : "Available",
"az" : "cn-north-7c",
"privateIp" : "192.168.0.3",
"resources" : {
"cpu" : "3920m",
"memory" : "6270Mi"
},
"availableResources" : {
"cpu" : "3720m",
"memory" : "5670Mi"
}
}
} ]
}
状态码： 404
Not Found。
{
"error_code" : "ModelArts.50015001",
"error_msg" : "pool not found"
}
状态码
|
状态码 |
描述 |
|---|---|
|
200 |
OK。 |
|
404 |
Not Found。 |
错误码
请参见错误码。
