Queries Elastic Compute Service (ECS) instances.

Debugging

OpenAPI Explorer automatically calculates the signature value. For your convenience, we recommend that you call this operation in OpenAPI Explorer. OpenAPI Explorer dynamically generates the sample code of the operation for different SDKs.

Request headers

This operation uses only the common request header. For more information, see Common request parameters.

Request syntax

GET /pop/v5/resource/cluster_member_list HTTP/1.1

Request parameters

Parameter Type Position Required Example Description
ClusterId String Query Yes 52984524-6d48-4bbd-85f2-a34b0e5b****

The ID of the cluster. You can call the ListCluster operation to query the ID.

CurrentPage Integer Query No 1

The number of the page to return. If this parameter is not specified, the first page is returned.

PageSize Integer Query No 50

The number of ECS instances to return on each page. If this parameter is not specified, all ECS instances of the cluster are returned on one page.

EcsList String Query No 1

The number of ECS instance lists.

Response parameters

Parameter Type Example Description
ClusterMemberPage Struct

The information about the ECS instances in the cluster.

ClusterMemberList Array of ClusterMember

The list of instances in the cluster.

ClusterMember
ClusterId String 52984524-6d48-4bbd-85f2-a34b0e5b****

The ID of the cluster.

ClusterMemberId String adb03eeb-3adf-4d7e-afe1-03d1ad45****

The unique ID of the instance in the cluster.

CreateTime Long 1573281038175

The timestamp when the instance was created.

EcsId String i-2zej4i2jdf3ntwhj****

The ID of the ECS instance.

EcuId String 70ed3f59-b476-49aa-be09-9e6c375d****

The unique ID of the elastic compute unit (ECU). You can run dmidecode on the ECS instance to query the ECU ID.

Status Integer 1

The status of the instance.

  • 1: indicates that the instance is running.
  • 0: indicates that the instance is being converted.
  • -1: indicates that the conversion has failed.
  • -2: indicates that the instance is offline.
UpdateTime Long 1573281041113

The timestamp when the instance information was updated.

CurrentPage Integer 1

The page number of the returned page. If this is parameter is not specified, the first page is returned.

PageSize Integer 10

The number of instances returned on each page.

TotalSize Integer 5

The total number of pages returned when all ECS instances are returned based on the specified PageSize parameter.

Code Integer 200

The HTTP status code.

Message String success

The additional information.

RequestId String b197-40ab-9155-****

The ID of the request.

Examples

Sample requests

GET /pop/v5/resource/cluster_member_list HTTP/1.1
Common request parameters
{
"ClusterId": "52984524-6d48-4bbd-85f2-a34b0e5b****"
}

Sample success responses

XML format

<ListClusterMembersResponse>
  <Message>success</Message>
  <RequestId>b197-40ab-9155-****</RequestId>
  <ClusterMemberPage>
        <ClusterMemberList>
              <ClusterMember>
                    <Status>1</Status>
                    <ClusterId>52984524-6d48-4bbd-85f2-a34b0e5b****</ClusterId>
                    <CreateTime>1573281038175</CreateTime>
                    <UpdateTime>1573281041113</UpdateTime>
                    <EcuId>70ed3f59-b476-49aa-be09-9e6c375d****</EcuId>
                    <ClusterMemberId>adb03eeb-3adf-4d7e-afe1-03d1ad45****</ClusterMemberId>
                    <EcsId>i-2zej4i2jdf3ntwhj****</EcsId>
              </ClusterMember>
        </ClusterMemberList>
        <PageSize>10</PageSize>
        <CurrentPage>1</CurrentPage>
        <TotalSize>5</TotalSize>
  </ClusterMemberPage>
  <Code>200</Code>
</ListClusterMembersResponse>

JSON format

{
    "Message": "success",
    "RequestId": "b197-40ab-9155-****",
    "ClusterMemberPage": {
        "ClusterMemberList": {
            "ClusterMember": {
                "Status": 1,
                "ClusterId": "52984524-6d48-4bbd-85f2-a34b0e5b****",
                "CreateTime": 1573281038175,
                "UpdateTime": 1573281041113,
                "EcuId": "70ed3f59-b476-49aa-be09-9e6c375d****",
                "ClusterMemberId": "adb03eeb-3adf-4d7e-afe1-03d1ad45****",
                "EcsId": "i-2zej4i2jdf3ntwhj****"
            }
        },
        "PageSize": 10,
        "CurrentPage": 1,
        "TotalSize": 5
    },
    "Code": 200
}

Error codes

For a list of error codes, visit the API Error Center.