开发者社区> 问答> 正文

ECS如何获取所有实例的状态信息



描述


批量获取当前用户所有实例的状态信息。

  • 能查询到的所有可能的实例状态参阅实例状态表
  • 该接口同时可用于获取实例列表。


请求参数


名称类型是否必须描述
ActionString系统规定参数。取值:DescribeInstanceStatus
RegionIdString实例所属的 Region ID。Region ID 的列表详见 地域列表 或者通过 API 接口 DescribeRegions 查看完整的地域列表。
ZoneIdString实例所属可用区
PageNumberInteger实例状态列表的页码。起始值:1默认值:1
PageSizeInteger分页查询时设置的每页行数。取值范围:[1, 50]默认值: 10


返回参数


名称类型描述
TotalCountInteger实例总个数
PageNumberInteger实例列表的页码
PageSizeInteger输入时设置的每页行数
InstanceStatusesInstanceStatusSetType由 InstanceStatusItemType 组成的数组格式,返回实例的状态信息


错误码


错误代码描述Http 状态码语义
InvalidRegionId.NotFoundThe specified RegionId does not exist.404指定的 RegionId 不存在。
InvalidZoneId.NotFoundThe ZoneId provided does not exist in our records.404指定的 ZoneId 不存在。


示例



请求示例


https://ecs.aliyuncs.com/?Action=DescribeInstanceStatus
&RegionId=cn-hangzhou
&<公共请求参数>
返回示例

XML格式
<DescribeInstanceStatusResponse>
    <RequestId>6EF60BEC-0242-43AF-BB20-270359FB54A7</RequestId>
    <TotalCount>2</TotalCount>
    <PageNumber>1</PageNumber>
    <PageSize>10</PageSize>
    <InstanceStatuses>
        <InstanceStatus>
            <InstanceId>i-instance1</InstanceId>
                <Status>Running</Status>
            </InstanceStatus>
            <InstanceStatus>
                <InstanceId>i-ae4r89pp</InstanceId>
                <Status>Stopped</Status>
        </InstanceStatus>
    </InstanceStatuses>
</DescribeInstanceStatusResponse>
JSON格式
{
"RequestId": "6EF60BEC-0242-43AF-BB20-270359FB54A7",
"TotalCount": 2,
"PageNumber": 1,
"PageSize": 10,
"InstanceStatuses": {
    "InstanceStatus": [{
        "InstanceId": "i-instance1",
            "Status": "Running"
        },
        {
            "InstanceId": "i-ae4r89pp",
            "Status": "Stopped"
        }]
    }
}


展开
收起
boxti 2017-10-19 14:10:04 3082 0
0 条回答
写回答
取消 提交回答
问答排行榜
最热
最新

相关电子书

更多
如何运维千台以上游戏云服务器 立即下载
网站/服务器取证 实践与挑战 立即下载
ECS计算与存储分离架构实践 立即下载