参数名称	必选	允许NULL	类型	描述
Action	是	否	String	公共参数，本接口取值：DescribeInstancesStatus
Version	是	否	String	公共参数，本接口取值：2017-03-12
Region	是	否	String	公共参数，地域信息可通过DescribeRegions接口查看产品支持的地域列表
InstanceIds	否	否	Array of String	按照一个或者多个实例ID查询。实例ID形如：`ins-11112222`。此参数的具体格式可参考API简介的`id.N`一节）。每次请求的实例的上限为100。示例值： ["ins-r8hr2upy\r\n","ins-5d8a23rs\r\n"]
Offset	否	否	Int64	偏移量，默认为0。关于`Offset`的更进一步介绍请参考 API 简介中的相关小节。示例值： 0
Limit	否	否	Int64	返回数量，默认为20，最大值为100。关于`Limit`的更进一步介绍请参考 API 简介中的相关小节。示例值： 2

3. 输出参数

参数名称	类型	描述
TotalCount	Int64	符合条件的实例状态数量。示例值： 2
InstanceStatusSet	Array of InstanceStatus	实例状态列表。示例值：查看
RequestId	String	唯一请求 ID，每次请求都会返回。定位问题时需要提供该次请求的 RequestId。

4. 错误码

以下仅列出了接口业务逻辑相关的错误码，其他错误码详见公共错误码。

错误码	描述
InvalidParameterValue	无效参数值。参数值格式错误或者参数值不被支持等。
InternalServerError	操作内部错误。
InvalidParameterValue.LimitExceeded	参数值数量超过限制。
InvalidInstanceId.Malformed	无效实例`ID`。指定的实例`ID`格式错误。例如实例`ID`长度错误`ins-1122`。

5. 示例

示例1 查看实例状态列表

输入示例

https://cvm.api3.fincloud.tencent.cn/?Action=DescribeInstancesStatus
&InstanceIds.0=ins-r8hr2upy
&InstanceIds.1=ins-5d8a23rs
&Offset=0
&Limit=2
&<公共请求参数>

输出示例

{
    "Response": {
        "TotalCount": 2,
        "InstanceStatusSet": [
            {
                "InstanceId": "ins-r8hr2upy",
                "InstanceState": "RUNNING"
            },
            {
                "InstanceId": "ins-5d8a23rs",
                "InstanceState": "STOPPED"
            }
        ],
        "RequestId": "6ef60bec-0242-43af-bb20-270359fb54a7"
    }
}