Help Center> Cloud Search Service> API Reference> APIs Related to Cluster Management> Querying Cluster Details
View PDF

Querying Cluster Details

Function

This API is used to query and display details about a cluster.

URI

GET /v1.0/{project_id}/clusters/{cluster_id}
Table 1 Parameter description

Parameter

Mandatory

Type

Description

project_id

Yes

String

Project ID. For details, see Obtaining the Project ID and Account ID.

cluster_id

Yes

String

ID of the cluster to be queried.

Request

None

Response

Table 2 describes the response parameters.

Table 2 Parameter description

Parameter

Type

Description

datastore

Object

Type of the data search engine. For details, see Table 3.

instances

Array of instance objects

List of node objects.

updated

String

Last modification time of a cluster. The format is ISO8601: CCYY-MM-DDThh:mm:ss.

name

String

Cluster name.

created

String

Time when a cluster is created. The format is ISO8601: CCYY-MM-DDThh:mm:ss.

id

String

Cluster ID.

status

String

Return value.

  • 100: The operation, such as instance creation, is in progress.
  • 200: The cluster is available.
  • 303: The cluster is unavailable.

endpoint

String

Indicates the IP address and port number of the user used to access the VPC.

actionProgress

Object

Cluster operation progress, which indicates the progress of cluster creation and expansion in percentage.

actions

Array of strings

Current behavior on a cluster. Value REBOOTING indicates that the cluster is being restarted, GROWING indicates that capacity expansion is being performed on the cluster, RESTORING indicates that the cluster is being restored, and SNAPSHOTTING indicates that the snapshot is being created.

failed_reasons

Object

Failure cause. If the cluster is in the Available state, this parameter is not returned. For details, see Table 5.

enterprise_project_id

String

ID of the enterprise project to which 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 tag objects

Tags in a cluster.
Table 3 datastore field data structure description

Parameter

Type

Description

type

String

Supported type: elasticsearch

version

String

Engine version number. The current engine version is 5.5.1, 6.2.3, 6.5.4, or 7.1.1.
Table 4 instances field data structure description

Parameter

Type

Description

type

String

Supported type: ess (indicating the Elasticsearch node)

id

String

Instance ID.

name

String

Instance name.

status

String

Instance status.

  • 100: The operation, such as instance creation, is in progress.
  • 200: The instance is available.
  • 303: The instance is unavailable.
Table 5 failed_reasons field data structure description

Parameter

Type

Description

error_code

String

Error code.

  • CSS.6000: indicates that a cluster fails to be created.
  • CSS.6001: indicates that capacity expansion of a cluster fails.
  • CSS.6002: indicates that a cluster fails to be restarted.
  • CSS.6004: indicates that a node fails to be created in a cluster.
  • CSS.6005: indicates that the service fails to be initialized.

error_msg

String

Detailed error information.
Table 6 tags field data structure description

Parameter

Type

Description

key

String

Tag key.

value

String

Tag value.

Examples

Example request

GET /v1.0/6204a5bd270343b5885144cf9c8c158d/clusters/5c77b71c-5b35-4f50-8984-76387e42451a

Example response

{
  "datastore": {
    "type": "elasticsearch",
    "version": "5.5.1"
  },
  "instances": [
    {
      "status": "200",
      "type": "ess",
      "id": "3c7fe582-a9f6-46fd-9d01-956bed4a8bbc",
      "name": "ES-1-16-test17-ess-esn-1-1"
    }
  ],
  "updated": "2018-01-16T08:37:18",
  "name": "ES-1-16-test17",
  "created": "2018-01-16T08:37:18",
  "id": "5c77b71c-5b35-4f50-8984-76387e42451a",
  "status": "200",
  "endpoint": "192.168.0.8:9200",
  "actionProgress": {},
  "actions": [],
  "enterprise_project_id":"3e1c74a0-86a0-40e9-bdc9-c6b9e46cf81b",
  "tags": [
               {
                "key": "k1",
                "value": "v1"
               }
          ]
}

Status Code

Table 7 describes the status code.

Table 7 Status code

Status Code

Code

Status Code Description

400

BadRequest

Invalid request.

The client should not repeat the request without modifications.

404

NotFound

The requested resource cannot be found.

The client should not repeat the request without modifications.

200

OK

The request is processed successfully.