调用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

接口状态或POP错误码。

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
}

错误码

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