You need to enable JavaScript to run this app.
导航

ListNodes

最近更新时间2024.02.26 20:17:37

首次发布时间2022.06.27 21:21:47

查询符合条件的节点列表及信息。

请求参数

调用该 API 时的请求参数如下,除此之外还需传入公共请求参数。公共请求参数说明,请参见 公共参数

参数名称类型是否必选示例值说明
ActionStringListNodes公共参数,本接口值:ListNodes。
VersionString2022-05-12公共参数,本接口值:2022-05-12。
FilterObject NodesFilterRequest待查询节点的筛选条件。
PageNumberInteger1分页查询时的起始页码,从 1 开始,默认为 1。
PageSizeInteger10分页查询时每页显示的记录数,取值:
  • 最小值:1
  • 最大值:100
  • 默认值:10

NodesFilterRequest

参数名参数类型是否必选示例值说明

ClusterIds

Array of String

["cc5silumrsfeq****"]

集群 ID 列表。
可以调用 ListClusters 接口,获取集群 ID。单次最多填写 100 个集群 ID。

说明

此参数为空数组时,筛选基于账号下指定地域的所有集群。

Ids

Array of String

["nc5t5epmrsf****"]

节点 ID 列表。
单次调用最多填写 100 个节点 ID。

NameStringtest-node节点名称。

支持模糊匹配。

NodePoolIds

Array of String

["pc8oah9cbcv****"]

节点池 ID 列表。
可以调用 ListNodePools 接口,获取节点池 ID。单次调用最多填写 100 个节点池 ID。

ZoneIdsArray of String["cn-beijing-a"]可用区 ID 列表。容器服务的可用区列表,请参见 地域和可用区

Statuses

Array of Object NodeStatusFilterRequest

节点状态。
单次调用最多填写 15 个数组元素。传入多个状态时,状态间是逻辑「或」关系。

CreateClientToken

String

BC028527-33B9-4990-A633-84E9F9******

创建成功时的 ClientToken。
用于保证请求幂等性的字符串。该字符串由调用方传入,需保证不同请求之间唯一。ClientToken 对大小写敏感,且最大值不超过 64 个 ASCII 字符。

NodeStatusFilterRequest

注意

PhaseConditions.Type 两者至少有一个参数必填,否则为无效数组元素。合法的 PhaseConditions.Type 组合请参见 资源状态说明

参数名参数类型是否必选示例值说明

Phase

String

Running

节点的状态,取值:

  • Creating
  • Running
  • Deleting
  • Failed
  • Updating

Conditions.Type

String

Ok

节点池当前主状态下的状态条件,即进入该主状态的原因,可以有多个原因,取值:

  • Progressing
  • Ok
  • Unschedulable
  • InitilizeFailed
  • NotReady
  • Balance
  • ResourceCleanupFailed
  • Unknown

请求示例

POST /?Action=ListNodes&Version=2022-05-12 HTTP/1.1
Content-Type:application/json
{
    "PageNumber": 1,
    "PageSize": 10,
    "Filter": {
        "ClusterIds": [
            "cc5silumrsfeq****"
        ],
        "NodePoolIds": [
            "pc8oah9cbcv****"
        ],
        "Statuses": [
            {
                "Phase": "Running",
                "Conditions.Type": "Ok"
            }
        ]
    }
}

返回参数

本接口返回参数如下表所示,公共返回参数请参见 返回结果

参数名称类型示例值描述
ItemsArray of Node节点列表。
PageNumberInteger1当前页码。
PageSizeInteger10每页显示的节点数。
TotalCountInteger100返回数据列表的总量。

Node

参数名参数类型示例值说明
IdStringnc5t5epmrsf****节点 ID。
NameStringtest-node节点名称。
ClusterIdStringcc5silumrsfeq****集群 ID。
InstanceIdStringi-ybo9229pdf****节点对应的云服务器实例 ID。
NodePoolIdStringpc8oah9cbcv****节点池 ID。
ZoneIdStringcn-beijing-a可用区 ID。

Roles

Array Of String

["Worker"]

节点角色,参数值说明:
Worker:Worker节点

CreateClientToken

String

BC028527-33B9-4990-A633-84E9F9******

创建成功时的 ClientToken。
ClientToken 是保证请求幂等性的字符串。该字符串由调用方传入。

CreateTimeString2021-10-27T10:33:30Z创建时间。

标准 RFC3339 格式的 UTC+0 时间。

UpdateTimeString2021-10-29T10:33:30Z更新时间。

标准 RFC3339 格式的 UTC+0 时间。

StatusObject NodeStatus节点状态。

IsVirtual

Boolean

false

是否为虚拟节点,参数值说明:

  • false:否
  • true:是

AdditionalContainerStorageEnabled

Boolean

false

是否已配置节点的数据盘作为容器镜像和日志的存储目录,参数值说明:

  • false:未配置
  • true:已配置
ContainerStoragePathString/dev/vdb用于作为容器镜像和日志存储目录的数据盘设备名称。
ImageIdStringimage-kdvapv****节点对应的云服务器实例使用的镜像 ID。
InitializeScriptStringZWNo****dGVzdCI=创建 ECS 节点并完成 Kubernetes 组件部署后执行的脚本。
KubernetesConfigObject KubernetesConfigResponse节点初始化时使用的 Kubernetes 相关配置。

NodeStatus

说明

合法的 PhaseConditions.Type 组合说明,请参见 资源状态说明

参数名参数类型示例值说明

Phase

String

Running

节点的状态,参数值有:

  • Creating
  • Running
  • Deleting
  • Failed
  • Updating
ConditionsArray of NodeCondition节点当前主状态下的状态条件,即进入该主状态的原因。

NodeCondition

参数名参数类型示例值说明

Type

String

Ok

节点当前主状态下的状态条件,即进入该主状态的原因,可以有多个原因,参数值有:

  • Progressing
  • Ok
  • Unschedulable
  • InitilizeFailed
  • NotReady
  • Balance
  • ResourceCleanupFailed
  • Unknown

返回示例

HTTP/1.1 200 OK
Content-Type:application/json
{
    "ResponseMetadata": {
        "RequestId": "021635330810134****",
        "Action": "ListNodes",
        "Version": "2022-05-12",
        "Service": "vke",
        "Region": "cn-beijing"
    },
    "Result": {
        "Items": [
            {
                "Id": "nc5t5epmrsf****",
                "Name": "test-node",
                "ClusterId": "cc5silumrsfeq****",
                "NodePoolId": "pc8oah9cbcv****",
                "Roles": ["Worker"],
                "IsVirtual": false,
                "InstanceId": "i-ybo9229pdf****",
                "ZoneId": "cn-beijing-a",
                "AdditionalContainerStorageEnabled": false,
                "ContainerStoragePath": "",
                "ImageId": "image-kdvapv****",
                "Status": {
                    "Phase": "Running",
                    "Conditions": [
                        {
                            "Type": "Ok"
                        }
                    ]
                },
                "CreateClientToken": "BC028527-33B9-4990-A633-84E9F9******",
                "CreateTime": "2022-05-12T14:28:34Z",
                "UpdateTime": "2022-05-13T14:30:14Z"
            }
        ],
        "PageNumber": 1,
        "PageSize": 10,
        "TotalCount": 1
    }
}

错误码

本接口无专有错误码,公共错误码请参见 公共错误码