调用ListClusterMembers接口获取ECS实例列表。

调试

您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。

请求头

该接口使用公共请求头，无特殊请求头。请参见公共请求参数文档。

请求语法

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

请求参数

名称 类型 位置 是否必选 示例值 描述
ClusterId String Query 是 52984524-6d48-4bbd-85f2-a34b0e5b****

集群ID。可以调用ListCluster来获取，具体操作，请参见ListCluster。

CurrentPage Integer Query 否 1

分页查询时，当前显示的页面数，不设置的情况下默认显示第1页。
PageSize Integer Query 否 50

分页查询时，若不设置，则显示该集群的所有ECS列表；若设置，则按照设置的pagesize来分页显示ECS列表。
EcsList String Query 否 1

ECS实例列表数量。

返回数据

名称 类型 示例值 描述
ClusterMemberPage Struct

集群中包含的ECS实例页面。
ClusterMemberList Array of ClusterMember

集群中包含的实例列表。
ClusterMember
ClusterId String 52984524-6d48-4bbd-85f2-a34b0e5b****

集群ID。
ClusterMemberId String adb03eeb-3adf-4d7e-afe1-03d1ad45****

实例集群ID。
CreateTime Long 1573281038175

创建时间的时间戳。
EcsId String i-2zej4i2jdf3ntwhj****

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

这台ECU的唯一标示ID，可以通过在ECS上执行dmidecode获取。

Status Integer 1

实例状态。

  • 1：表示运行中。
  • 0：表示转化中。
  • -1：表示转化失败。
  • -2：表示离线。
UpdateTime Long 1573281041113

更新时间的时间戳。
CurrentPage Integer 1

分页查询时，当前显示的页面数，不设置的情况下默认显示第1页。
PageSize Integer 10

所有实例分页显示的页面数。
TotalSize Integer 5

所有的ECS实例按照pagesize的大小进行分页显示时，总的显示页数。
Code Integer 200

接口状态码。
Message String success

返回信息。
RequestId String b197-40ab-9155-****

唯一请求ID。

示例

请求示例

GET /pop/v5/resource/cluster_member_list HTTP/1.1
公共请求头
{
"ClusterId": "52984524-6d48-4bbd-85f2-a34b0e5b****"
}

正常返回示例

XML格式 

<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格式 

{
    "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
}

错误码

访问错误中心查看更多错误码。