Dong, Qiu Jian 3336ba8df7 CCE API for v1.23

Reviewed-by: gtema <artem.goncharov@gmail.com>
Co-authored-by: Dong, Qiu Jian <qiujiandong1@huawei.com>
Co-committed-by: Dong, Qiu Jian <qiujiandong1@huawei.com>

2022-11-10 12:48:59 +00:00

12 KiB

Raw Blame History

Listing All Nodes in a Cluster

Function

This API is used to obtain details about all nodes in a cluster with a specified cluster ID.

URI

GET /api/v3/projects/{project_id}/clusters/{cluster_id}/nodes

Table 1 describes the parameters of the API.

**Table 1** Parameter description
Parameter	Mandatory	Description
project_id	Yes	Project ID. For details about how to obtain the project ID, see How to Obtain Parameters in the API URI.
cluster_id	Yes	Cluster ID. For details about how to obtain the cluster ID, see How to Obtain Parameters in the API URI.

Request

Request parameters:

Table 2 describes the request parameters.

**Table 2** Parameters in the request header
Parameter	Mandatory	Description
Content-Type	Yes	Message body type (format). Possible values: application/json;charset=utf-8 application/json
X-Auth-Token	Yes	Requests for calling an API can be authenticated using either a token or AK/SK. If token-based authentication is used, this parameter is mandatory and must be set to a user token. For details on how to obtain a user token, see API Usage Guidelines.

Example request:

N/A

Response

Response parameters:

Table 3 describes the response parameters.

**Table 3** Response parameters
Parameter	Type	Description
kind	String	API type. The value is fixed to List.
apiVersion	String	API version. The value is fixed at v3.
items	Object	A list of details for all nodes in the current cluster. You can filter nodes by items.metadata.name. For more information, see Table 4.

Example response:

{
  "kind": "List",
  "apiVersion": "v3",
  "items": [
    {
      "kind": "Node",
      "apiversion": "v3",
      "metadata": {
        "name": "myhost",
        "uid": "4d1ecb2c-229a-11e8-9c75-0255ac100ceb",
        "creationTimestamp": "2020-02-02 07:37:24.005071325 +0000 UTC",
        "updateTimestamp": "2020-02-02 07:44:04.965500815 +0000 UTC",
        "annotations": {
         "kubernetes.io/node-pool.id": "eu-de-01#s1.medium#EulerOS 2.5"        
        }
      },
      "spec": {
        "flavor": "s1.medium",
        "az": "eu-de-01",
        "os": "EulerOS 2.5",
        "login": {
          "sshKey": "KeyPair-demo"
        },
        "rootVolume": {
          "volumetype": "SAS",
          "size": 40
        },
        "dataVolumes": [
          {
            "volumetype": "SAS",
            "size": 100
          }
        ],
        "publicIP": {
          "eip": {
            "bandwidth": {}
          }
        },
      "nodeNicSpec": {
          "primaryNic": {
          "subnetId": "c90b3ce5-e1f1-4c87-a006-644d78846438"
         }
     },
      "billingMode": 0
      },
      "status": {
        "phase": "Active",
        "serverId": "456789abc-9368-46f3-8f29-d1a95622a568",
        "publicIP": "10.34.56.78",
        "privateIP": "192.168.1.23"
      }
    }
  ]
}

Status Code

Table 4 describes the status code of this API.

**Table 4** Status code
Status Code	Description
200	Information about all the nodes in the specified cluster is successfully obtained.

For details about error status codes, see Status Code.

Parent topic: Cluster Management

12 KiB Raw Blame History