Querying the Cluster List

Function

This API is used to query and display the cluster list and cluster status.

Calling Method

For details, see Calling APIs.

URI

GET /v1.0/{project_id}/clusters

**Table 1** URI parameters
Parameter	Mandatory	Type	Description
project_id	Yes	String	Project ID. For details about how to obtain the project ID and name, see Obtaining a Project ID and Name.

**Table 2** Query parameters
Parameter	Mandatory	Type	Description
start	No	Integer	Start value of the query. The default value is 1, indicating that the query starts from the first cluster.
limit	No	Integer	Number of clusters to be queried. The default value is 10, indicating that 10 clusters are queried at a time.
datastoreType	No	String	Cluster engine type.

Request Parameters

None

Response Parameters

Status code: 200

**Table 3** Response body parameters
Parameter	Type	Description
totalSize	Integer	Number of clusters.
clusters	Array of ClusterList objects	List of cluster objects.

**Table 4** ClusterList
Parameter	Type	Description
datastore	ClusterListDatastore object	Search engine type.
instances	Array of ClusterListInstances objects	List of node objects.
publicKibanaResp	publicKibanaRespBody object	Kibana public network access information.
elbWhiteList	elbWhiteListResp object	EIP whitelist.
updated	String	Last modification time of a cluster. The format is ISO8601: CCYY-MM-DDThh:mm:ss.
name	String	Cluster name.
publicIp	String	Public IP address.
created	String	Cluster creation time. The format is ISO8601: CCYY-MM-DDThh:mm:ss. The returned cluster list is sorted by creation time in descending order. The latest cluster is displayed at the top.
id	String	Cluster ID.
status	String	Cluster status. 100: Creating. 200: Available. 303: The cluster is unavailable, for example, due to a creation failure.
endpoint	String	IPv4 address and port number accessible from the cluster's private network.
vpcId	String	VPC ID.
subnetId	String	Subnet ID.
securityGroupId	String	Security group ID.
bandwidthSize	Integer	Public network bandwidth. Unit: Mbit/s
httpsEnable	Boolean	Communication encryption status. false: Communication encryption is disabled. true: Communication encryption is enabled.
authorityEnable	Boolean	Whether to enable authentication. true: Authentication is enabled for the cluster. false: Authentication is disabled for the cluster.
diskEncrypted	Boolean	Whether disks are encrypted. true: Disks are encrypted. false: Disks are not encrypted.
backupAvailable	Boolean	Whether the snapshot function is enabled. true: The snapshot function is enabled. false: The snapshot function is disabled.
actionProgress	Object	Cluster operation progress, which shows the progress of cluster creation or scale-out in percentage. CREATING indicates the progress of creation.
actions	Array of strings	Current behavior of a cluster. REBOOTING indicates that the cluster is being restarted. GROWING indicates that the cluster is being scaled. RESTORING indicates that the cluster is being restored. SNAPSHOTTING indicates that a snapshot is being created.
enterpriseProjectId	String	ID of the enterprise project that a cluster belongs. If the user of the cluster does not enable the enterprise project, the setting of this parameter is not returned.
tags	Array of ClusterListTags objects	Cluster tags.
failedReason	ClusterListFailedReasons object	Failure cause. If the cluster is in the Available state, this parameter is not returned.
bandwidthResourceId	String	ID of the resource accessed from the ES public network.

**Table 5** ClusterListDatastore
Parameter	Type	Description
type	String	Engine type. The value can be elasticsearch.
version	String	Version of the CSS cluster engine. For details, see Supported Cluster Versions.
supportSecuritymode	Boolean	Whether the security mode is supported.

**Table 6** ClusterListInstances
Parameter	Type	Description
status	String	Node status. 100: Creating. 200: Available. 303: The cluster is unavailable, for example, due to a creation failure.
type	String	Node type.
id	String	Instance ID.
name	String	Instance name.
specCode	String	Node specifications.
azCode	String	AZ of a node.
ip	String	Instance IP address.
volume	ClusterVolumeRsp object	Instance disk information.
resourceId	String	Instance resource ID.

**Table 7** ClusterVolumeRsp
Parameter	Type	Description
type	String	Instance disk type.
size	Integer	Instance disk size.
resourceIds	Array of strings	Instance disk resource ID.

**Table 8** publicKibanaRespBody
Parameter	Type	Description
eipSize	Integer	Bandwidth size. Unit: Mbit/s.
elbWhiteListResp	kibanaElbWhiteListResp object	Kibana public network access information.
publicKibanaIp	String	IP address for accessing Kibana.
bandwidthResourceId	String	Resource ID corresponding to the Kibana public network.

**Table 9** kibanaElbWhiteListResp
Parameter	Type	Description
enableWhiteList	Boolean	Whether Kibana access control is enabled. true: Access control is enabled. false: Access control is disabled.
whiteList	String	Whitelist for Kibana public network access.

**Table 10** elbWhiteListResp
Parameter	Type	Description
enableWhiteList	Boolean	Whether public network access control is enabled. true: Public network access control is enabled. false: Public network access control is disabled.
whiteList	String	Whitelist for public network access.

**Table 11** ClusterListTags
Parameter	Type	Description
key	String	Tag key.
value	String	Tag value.

**Table 12** ClusterListFailedReasons
Parameter	Type	Description
errorCode	String	Error code. CSS.6000: A cluster failed to be created. CSS.6001: A cluster failed to be scaled out. CSS.6002: A cluster failed to be restarted. CSS.6004: A node failed to be created in a cluster. CSS.6005: A service failed to be initialized.
errorMsg	String	Error details.

Example Requests

Query the first two clusters.

- Method 1: GET /v1.0/6204a5bd270343b5885144cf9c8c158d/clusters?start=1&limit=2

- Method 2: GET /v1.0/6204a5bd270343b5885144cf9c8c158d/clusters?limit=2

Query the first ten clusters.

- Method 1: GET /v1.0/6204a5bd270343b5885144cf9c8c158d/clusters?start=1&limit=10

- Method 2: GET /v1.0/6204a5bd270343b5885144cf9c8c158d/clusters?limit=10

Example Responses

Status code: 200

Request succeeded.

{
  "totalSize" : 1,
  "clusters" : [ {
    "datastore" : {
      "type" : "elasticsearch",
      "version" : "7.10.2",
      "supportSecuritymode" : false
    },
    "instances" : [ {
      "status" : "200",
      "type" : "ess",
      "id" : "{INSTANCE_ID}",
      "name" : "css-8bc5-ess-esn-1-1",
      "specCode" : "ess.spec-4u8g",
      "azCode" : "{AZ_CODE}",
      "volume" : {
        "type" : "ULTRAHIGH",
        "size" : 40,
        "resourceIds" : [ "{RESOURCE_ID}" ]
      },
      "ip" : "192.168.0.122",
      "resourceId" : "{RESOURCE_ID}"
    } ],
    "publicKibanaResp" : {
      "eipSize" : 10,
      "publicKibanaIp" : "100.95.152.28:9200",
      "elbWhiteListResp" : null,
      "bandwidthResourceId" : "18bec13f-5cc1-4631-867f-33505d15be12"
    },
    "elbWhiteList" : {
      "whiteList" : "",
      "enableWhiteList" : false
    },
    "updated" : "2023-10-09T02:07:13",
    "name" : "css-8bc5",
    "publicIp" : "100.85.222.202",
    "created" : "2023-10-09T02:07:13",
    "id" : "{CLUSTER_ID}",
    "status" : "200",
    "vpcId" : "{VPC_ID}",
    "subnetId" : "{SUBNET_ID}",
    "securityGroupId" : "{SECURITY_GROUP_ID}",
    "bandwidthResourceId" : "{BANDWIDTH_RESOURCE_ID}",
    "bandwidthSize" : 3,
    "httpsEnable" : true,
    "authorityEnable" : true,
    "diskEncrypted" : false,
    "backupAvailable" : false,
    "actionProgress" : { },
    "actions" : [ ],
    "enterpriseProjectId" : "0",
    "tags" : [ ]
      } ]
}

Status Codes

Status Code	Description
200	Request succeeded.
400	Invalid request. Modify the request before retry.
404	The requested resource could not be found. Modify the request before retry.

Status Code

Description

200

Request succeeded.

400

Invalid request.

Modify the request before retry.

404

The requested resource could not be found.

Modify the request before retry.