获取集群实例列表

ListClusterInstances

描述

获取集群实例列表。

请求语法

请求行:

GET /clusters/{ClusterId}/groups/{GroupName}/instances?Marker={Marker}&MaxItemCount={MaxItemCount}

请求方法为 GET,请求资源为 clusters,请求参数为:

属性名称

类型

是否必须

描述

ClusterId

stirng

集群ID

GroupName

string

该集群中的group名字

Marker

string

本页起始资源标识符。默认为空字符串。

MaxItemCount

int

实际返回最大资源数量。默认值50,最大值100。

无请求数据。

返回信息

成功

状态行:

HTTP/1.1 201 OK

响应数据:

{
    "NextMarker": "",
    "Items":[{
        "Id": "i-123456789",
        "Hint": "",
        "State": "Pending",
        "IpAddress": "10.160.25.1",
        "CreationTime": "2016-01-18T09:15:41.005259Z"
    }]
}

属性说明:

属性名称

类型

是否必须

描述

NextMarker

string

下一页起始资源标识符。最后一页该值为空。

Items

array

资源列表。

错误

状态码

错误码

错误信息

语义

400

InvalidMaxItemCount

Specified parameter MaxItemCount is not valid. Its type must be integer.

MaxItemCount必须是一个integer。

400

InvalidMaxItemCount

Specified parameter MaxItemCount is not valid. It must be in [0, 100].

MaxItemCount的大小必须在0与100之间。

404

InvalidResource.NotFound

Specified resource is not found.

用户请求的资源不存在。