Description
Obtains the cluster instance list.
Request syntax
GET /clusters/{ClusterId}/groups/{GroupName}/instances?Marker={Marker}&MaxItemCount={MaxItemCount}
Attribute description
| Attribute |
Type |
Required |
Description |
| ClusterId |
String |
Yes |
Cluster ID |
| GroupName |
String |
Yes |
Name of a group in the cluster |
| Marker |
String |
No |
Start resource ID of the current page.Default value: Null string |
| MaxItemCount |
int |
No |
Maximum number of actually returned resources.The default value is 50, and the maximum value is 100. |
Response
Success
The 200 status code and the following ClusterInstance list are returned:
{ "NextMarker": "", "Items":[{ "Id": "i-123456789", "Hint": "", "State": "Pending", "IpAddress": "10.160.25.1", "CreationTime": "2016-01-18T09:15:41.005259Z" }]}
Attribute description
| Attribute |
Type |
Description |
| NextMarker |
string |
Start resource ID on the next page.The value is blank in the last page. |
| Items |
array |
List of resources. |
Error codes
| Error code |
Error message |
Status code |
Syntax |
| InvalidMaxItemCount |
Specified parameter MaxItemCount is not valid. Its type must be integer. |
400 |
MaxItemCount must be an integer. |
| InvalidMaxItemCount |
Specified parameter MaxItemCount is not valid. It must be in [0, 100]. |
400 |
The MaxItemCount value must be in the range of [0, 100]. |
| InvalidResource.NotFound |
Specified resource is not found. |
404 |
The user requested resource does not exist. |