You can call this operation to query Elastic Compute Service (ECS) instances by cluster IDs.

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 only uses common request headers. For more information, see the Common request parameters topic.

Request syntax

GET /pop/v5/resource/cluster_member_list HTTPS|HTTP

Request parameters

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

The cluster ID by which you want to query ECS instances.

CurrentPage Integer No 1

The number of the page to return. Default value: 1

PageSize Integer No 50

The number of entries to return on each page. Default value: 1000

Response parameters

Parameter Type Example Description
Code Integer 200

The returned code.

Message String success

The returned message.

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

The ID of the request.

ClusterMemberPage Struct

The returned information, including the paging settings.

CurrentPage Integer 1

The page number of the returned page.

PageSize Integer 10

The number of entries returned per page.

TotalSize Integer 5

The total number of returned pages.

ClusterMemberList Array

The returned list of ECS instances.

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

The member ID of the returned ECS instance in the cluster.

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

The ID of the cluster where the ECS instance is located.

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

The ID of the Elastic Compute Unit (ECU) corresponding to the ECS instance returned. To query the ECU ID, you can run dmidecode on the ECS instance.

EcsId String i-2zej4i****3ntwh****

The ID of the ECS instance returned.

Status Integer 1

The status of the ECS instance returned. Valid values: 1: running. 0: being converted. -1: failed to be converted. -2: Offline.

CreateTime Long 1573281038175

The time when the ECS instance was created.

UpdateTime Long 1573281041113

The time when the ECS instance was last updated.

Examples

Sample requests

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

Sample success responses

JSON format

{
    "Message": "success",
    "Code": 200,
    "ClusterMemberPage": {
        "ClusterMemberList": {
            "ClusterMember": [
                {
                    "ClusterMemberId": "adb03eeb-3adf-4d7e-afe1-03d1ad45****",
                    "Status": 1,
                    "EcsId": "i-2zej4i2j****ntwhj****",
                    "ClusterId": "52984524-6d48-4bbd-85f2-a34b0e5b****",
                    "CreateTime": 1573281038175,
                    "UpdateTime": 1573281041113,
                    "EcuId": "70ed3f59-b476-49aa-be09-9e6c375d****"
                },
                {
                    "ClusterMemberId": "8f797d66-a7e1-4329-802b-b86d9212****",
                    "Status": 1,
                    "EcsId": "i-2zej4i2jdf3ntwhjignc",
                    "ClusterId": "52984524-6d48-4bbd-85f2-a34b0e5b****",
                    "CreateTime": 1573281038162,
                    "UpdateTime": 1573281041304,
                    "EcuId": "f6917537-b28d-456e-8d00-567985d2****"
                },
                {
                    "ClusterMemberId": "1a289406-f22a-44e1-b254-1491ae8c****",
                    "Status": 1,
                    "EcsId": "i-2zej4i2****ntwhj****",
                    "ClusterId": "52984524-6d48-4bbd-85f2-a34b0e5b****",
                    "CreateTime": 1573281038150,
                    "UpdateTime": 1573281040844,
                    "EcuId": "0de2ebdb-9490-4fc4-be41-6eddbe61****"
                },
                {
                    "ClusterMemberId": "6b75ae95-3c25-496e-8fd1-a85d60ea****",
                    "Status": 1,
                    "EcsId": "i-2zej4i2jd****whj****",
                    "ClusterId": "52984524-6d48-4bbd-85f2-a34b0e5b****",
                    "CreateTime": 1573281038138,
                    "UpdateTime": 1573281041366,
                    "EcuId": "6f9cb7fd-bbe1-4cbd-b549-f3f02364****"
                },
                {
                    "ClusterMemberId": "d618ba60-78af-49b6-a64b-c212cd25****",
                    "Status": 1,
                    "EcsId": "i-2zej4i2j****twhj****",
                    "ClusterId": "52984524-6d48-4bbd-85f2-a34b0e5b****",
                    "CreateTime": 1573281038127,
                    "UpdateTime": 1573281041155,
                    "EcuId": "cfe7f474-3861-453e-b236-887d4932****"
                }
            ]
        },
        "PageSize": 10,
        "TotalSize": 5,
        "CurrentPage": 1
    }
}

XML format

<Message>success</Message>
<Code>200</Code>
<ClusterMemberPage>
    <ClusterMemberList>
        <ClusterMember>
            <ClusterMemberId>adb03eeb-3adf-4d7e-afe1-03d1ad45****</ClusterMemberId>
            <Status>1</Status>
            <EcsId>i-2zej4i2j****twhj****</EcsId>
            <ClusterId>52984524-6d48-4bbd-85f2-a34b0e5b****</ClusterId>
            <CreateTime>1573281038175</CreateTime>
            <UpdateTime>1573281041113</UpdateTime>
            <EcuId>70ed3f59-b476-49aa-be09-9e6c375d****</EcuId>
        </ClusterMember>
        <ClusterMember>
            <ClusterMemberId>8f797d66-a7e1-4329-802b-b86d9212****</ClusterMemberId>
            <Status>1</Status>
            <EcsId>i-2zej4i2j****twhj****</EcsId>
            <ClusterId>52984524-6d48-4bbd-85f2-a34b0e5b****</ClusterId>
            <CreateTime>1573281038162</CreateTime>
            <UpdateTime>1573281041304</UpdateTime>
            <EcuId>f6917537-b28d-456e-8d00-567985d2****</EcuId>
        </ClusterMember>
        <ClusterMember>
            <ClusterMemberId>1a289406-f22a-44e1-b254-1491ae8c****</ClusterMemberId>
            <Status>1</Status>
            <EcsId>i-2zej4i****3ntwhj****</EcsId>
            <ClusterId>52984524-6d48-4bbd-85f2-a34b0e5b****</ClusterId>
            <CreateTime>1573281038150</CreateTime>
            <UpdateTime>1573281040844</UpdateTime>
            <EcuId>0de2ebdb-9490-4fc4-be41-6eddbe61****</EcuId>
        </ClusterMember>
        <ClusterMember>
            <ClusterMemberId>6b75ae95-3c25-496e-8fd1-a85d60ea****</ClusterMemberId>
            <Status>1</Status>
            <EcsId>i-2zej4i2****ntwhj****</EcsId>
            <ClusterId>52984524-6d48-4bbd-85f2-a34b0e5b****</ClusterId>
            <CreateTime>1573281038138</CreateTime>
            <UpdateTime>1573281041366</UpdateTime>
            <EcuId>6f9cb7fd-bbe1-4cbd-b549-f3f02364****</EcuId>
        </ClusterMember>
        <ClusterMember>
            <ClusterMemberId>d618ba60-78af-49b6-a64b-c212cd25****</ClusterMemberId>
            <Status>1</Status>
            <EcsId>i-2zej4i2****ntwhj****</EcsId>
            <ClusterId>52984524-6d48-4bbd-85f2-a34b0e5b****</ClusterId>
            <CreateTime>1573281038127</CreateTime>
            <UpdateTime>1573281041155</UpdateTime>
            <EcuId>cfe7f474-3861-453e-b236-887d4932****</EcuId>
        </ClusterMember>
    </ClusterMemberList>
    <PageSize>10</PageSize>
    <TotalSize>5</TotalSize>
    <CurrentPage>1</CurrentPage>
</ClusterMemberPage>

Error codes

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