查询集群的节点列表
功能介绍
应用服务器可调用此接口查询集群的节点列表。
调试
您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。
URI
GET /v3/{project_id}/clusters/{cluster_id}/nodes
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
project_id |
是 |
String |
项目ID。获取方法请参见 获取项目ID。 |
|
cluster_id |
是 |
String |
边缘集群ID 最小长度：1 最大长度：64 |
请求参数
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
X-Auth-Token |
是 |
String |
用户Token。通过调用IAM服务 获取IAM用户Token接口获取，接口返回的响应消息头中“X-Subject-Token”就是需要获取的用户Token。简要的获取方法样例请参见 Token认证。 |
响应参数
状态码： 200
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
nodes |
Array of QueryNodeResp objects |
节点列表 数组长度：0 - 1000 |
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
name |
String |
节点名称 |
|
internal_ip |
String |
节点ip |
|
hostname |
String |
主机名 |
|
allocatable |
NodeResourceDTO object |
节点可用于调度的资源容量 |
|
capacity |
NodeResourceDTO object |
节点总资源容量 |
|
allocated_resources |
NodeAllocatedResourceDTO object |
节点已分配资源容量 |
|
status |
String |
状态，Ready or NotReady |
|
architecture |
String |
架构，amd64 or arm64 |
|
labels |
Map<String,String> |
map类型，key为string,value为string |
|
node_type |
String |
节点类型 |
|
kernel_version |
String |
内核版本 |
|
os_image |
String |
操作系统版本 |
|
container_runtime_version |
String |
容器运行时版本 |
|
kubernetes_version |
String |
k8s版本 |
|
create_time |
String |
创建时间 |
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
request |
NodeResourceDTO object |
请求资源详情 |
|
limit |
NodeResourceDTO object |
限制资源详情 |
请求示例
GET https://{endpoint}/v3/{project_id}/clusters/{cluster_id}/nodes
响应示例
状态码： 200
OK
{
"nodes" : [ {
"name" : "string",
"internal_ip" : "string",
"hostname" : "string",
"allocatable" : {
"cpu" : 0,
"memory" : 0,
"storage" : 0,
"pods" : 0
},
"capacity" : {
"cpu" : 0,
"memory" : 0,
"storage" : 0,
"pods" : 0
},
"allocated_resources" : {
"request" : {
"cpu" : 0,
"memory" : 0,
"storage" : 0,
"pods" : 0
},
"limit" : {
"cpu" : 0,
"memory" : 0,
"storage" : 0,
"pods" : 0
}
},
"status" : "string",
"architecture" : "string",
"labels" : { },
"node_type" : "string",
"kernel_version" : "string",
"os_image" : "string",
"container_runtime_version" : "string",
"kubernetes_version" : "string",
"create_time" : "string"
} ]
}
状态码
|
状态码 |
描述 |
|---|---|
|
200 |
OK |
|
400 |
BAD REQUEST |
|
401 |
Unauthorized |
|
403 |
FORBIDDEN |
|
500 |
Internal Server Error |
错误码
请参见错误码。
