文档中心

云容器引擎CKS API参考手册

最近更新时间：2023-04-16 17:00:00

2 节点管理

2.1 AddWorkers

调用 AddWorkers 接口将节点加入到指定集群。

2.1.1 使用说明

POST https://{Endpoint}/cks/v1.0/clusters/{ClusterId}/nodes

2.1.2 请求参数

表2-1 header 中请求参数

表2-2 body 中的请求参数

表2-3 URL 中的请求参数

2.1.3 返回数据

2.1.4 错误码

2.1.5 示例

1. 请求示例
POST https://{Endpoint}/cks/v1.0/clusters/cks-d1******8zq9ib/nodes
{
"Nodes": "vk-cks-******8zq9ib"
}
2. 正常返回示例
HTTP/1.1 200 OK
Content-Type:application/json
{
"RequestId": "71e69b56-32be-4412-ab45-49eded6a87be"
}

2.2 DeleteWorkers

调用 DeleteWorkers 接口移除节点。

2.2.1 使用说明

DELETE https://{Endpoint}/cks/v1.0/clusters/{ClusterId}/nodes

2.2.2 请求参数

表2-4 URL 中的请求参数

表2-5 header 中请求参数

表2-6 body 中请求参数

2.2.3 返回数据

2.2.4 错误码

2.2.5 示例

1. 请求示例
DELETE https://{Endpoint}/cks/v1.0/clusters/cks-d1******8zq9ib/nodes
{
"Nodes": "vk-cks-******8zq9ib"
}
2. 正常返回示例
HTTP/1.1 200 OK
Content-Type:application/json
{
"RequestId": "71e69b56-32be-4412-ab45-49eded6a87be"
}

2.3 GetWorker

调用 GetWorker 接口获取节点详情。

2.3.1 使用说明

GET https://{Endpoint}/cks/v1.0/clusters/{ClusterId}/nodes/{NodeName}

2.3.2 请求参数

表2-7 URL 中的请求参数

表2-8 header 中请求参数

2.3.3 返回数据

2.3.4 错误码

2.3.5 示例

1. 请求示例
GET https://{Endpoint}/cks/v1.0/clusters/cks-d1******zq9ib/nodes/******rz1o8h0
2. 正常返回示例
HTTP/1.1 200 OK
Content-Type:application/json
{
      "RequestId": "71e69b56-32be-4412-ab45-49eded6a87be",
      "NodeId": "vk-cks-02******1o8h0",
      "Namespace": ""，
      "Labels": {
          "beta.kubernetes.io/os": "linux",
          "kubernetes.io/arch": "amd64",
          "kubernetes.io/hostname": "vk-cks-02******1o8h0",
          "kubernetes.io/os": "linux",
          "kubernetes.io/role": "agent",
          "role/tenants-ecs": "true",
          "type": "virtual-kubelet"
      },
    "Annotations": {
          "node.alpha.kubernetes.io/ttl": "0",
          "virtual-kubelet.io/last-applied-node-status": "",
          "virtual-kubelet.io/last-applied-object-meta": ""
      },
      "CreateTime": "2022-07-13T15:31:12+08:00",
      "DeleteTime": null,
      "Description": "",
      "Config": null,
      "Architecture": "amd64",
      "ContainerRuntimeVersion": "",
      "KernelVersion": "",
      "OperatingSystem": "linux",
      "PodNum": "509",
      "Memory": "111******7072",
      "Cpu": "152**4m",
      "Address": "192.168.0.**",
      "Unschedulable": false,
      "Status": "running",
      "Role": "master",
      "KubeVersion": "vk-cks-02******1o8h0",
      "Image": null
}

2.4 GetWorkers

调用 GetWorkers 接口获取节点列表。

2.4.1 使用说明

GET https://{Endpoint}/cks/v1.0/clusters/{ClusterId}/nodes

2.4.2 请求参数

表2-9 URL 中的请求参数

表2-10 header 中请求参数

2.4.3 返回数据

表2-11 Nodes 结构说明

2.4.4 错误码

2.4.5 示例

1. 请求示例
GET https://{Endpoint}/cks/v1.0/clusters/cks-d1*******zq9ib/nodes
2. 正常返回示例
HTTP/1.1 200 OK
Content-Type:application/json
{
     "RequestId": "71e69b56-32be-4412-ab45-49eded6a87be",
     "TotalCount":1,
     "PageSize": 10,
      "PageNumber": 1,
      "Nodes": [
      {
          "NodeId": "vk-cks-02******1o8h0",
          "Namespace": "",
          "Labels": {
              "beta.kubernetes.io/os": "linux",
              "kubernetes.io/arch": "amd64",
              "kubernetes.io/hostname": "vk-cks-02******1o8h0",
              "kubernetes.io/os": "linux",
              "kubernetes.io/role": "agent",
              "role/tenants-ecs": "true",
              "type": "virtual-kubelet"
          },
          "Annotations": {
              "node.alpha.kubernetes.io/ttl": "0",
            "virtual-kubelet.io/last-applied-node-status": "",
              "virtual-kubelet.io/last-applied-object-meta": ""
          },
          "CreateTime": "2022-07-13T15:31:12+08:00",
          "DeleteTime": null,
          "Description": "",
          "Config": null,
          "Architecture": "amd64",
          "ContainerRuntimeVersion": "",
          "KernelVersion": "",
          "OperatingSystem": "linux",
          "PodNum": "509",
          "Memory": "1112******7072",
          "Cpu": "152**4m",
          "Address": "192.168.0.**",
          "Unschedulable": false,
          "Status": "running",
          "Role": "master",
          "KubeVersion": "vk-cks-******1o8h0",
          "Image": null
      }
      ]
}

意见反馈

文档内容是否对您有帮助？

如您有其他疑问，您也可以通过在线客服来与我们联系探讨在线客服