获取集群实例列表
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. | 用户请求的资源不存在。 |