全部产品
存储与CDN 数据库 安全 应用服务 数加·人工智能 数加·大数据基础服务 互联网中间件 视频服务 开发者工具 解决方案 物联网
云服务器 ECS

DescribeInstanceAutoRenewAttribute

更新时间:2017-09-13 09:26:00

描述

查询实例自动续费状态。为了方便您清楚地了解自己的实例是否为自动续费状态,本接口支持实例续费状态的查询。目前只支持包年包月的实例,按量付费的实例执行该接口会报错。

请求参数

名称 类型 是否必须 描述
Action String 操作接口名,系统规定参数,取值:DescribeInstanceAutoRenewAttribute。
RegionId String 实例所属的地域 ID。
InstanceId String 实例 ID。支持最多 100 个包年包月实例批量查询,多个实例 ID 以英文逗号分隔。

返回参数

名称 类型 描述
InstanceId String 实例 ID,由系统生成,全局唯一。是访问实例的唯一标识。
Duration Integer 自动续费时长。
AutoRenewEnabled Boolean 是否自动续费。
  • true:自动续费类型。
  • false:非自动续费类型。

错误码

错误代码 描述 Http状态码 语义
Abs.MissingParamter.InstanceId InstanceId should not be null. 403 InstanceId 不能为空。
ChargeTypeViolation Pay-As-You-Go instances do not support this operation. 403 按量付费的实例不支持此操作。
IncorrectInstanceStatus The current status of the resource does not support this operation. 403 由于实例已过期,不支持此操作。
InvalidParameter.InvalidInstanceId The specified instanceId is not valid. 403 指定的 InstanceId 无效。
InvalidParameter.ToManyInstanceIds No more than 100 InstanceIds can be specified. 403 指定的 InstanceId 数量不能大于 100。

示例

请求示例

  1. https://ecs.aliyuncs.com/?Action=DescribeInstanceAutoRenewAttribute
  2. &RegionId=cn-hangzhou
  3. &InstanceId=i-instance1,i-instance2
  4. &<公共请求参数>

返回示例

XML格式

  1. <DescribeInstanceAutoRenewAttributeResponse>
  2. <RequestId>04F0F334-1335-436C-A1D7-6C044FE73368</RequestId>
  3. <InstanceRenewAttributes>
  4. <InstanceRenewAttribute>
  5. <Instance>
  6. <InstanceId>i-instance1</InstanceId>
  7. <Duration>0</Duration>
  8. <AutoRenewEnalbed>false</AutoRenewEnalbed>
  9. </Instance>
  10. <Instance>
  11. <InstanceId>i-instance2</InstanceId>
  12. <Duration>1</Duration>
  13. <AutoRenewEnalbed>true</AutoRenewEnalbed>
  14. </Instance>
  15. </InstanceRenewAttribute>
  16. </InstanceRenewAttributes>
  17. </DescribeInstanceAutoRenewAttributeResponse>

JSON格式

  1. {
  2. "InstanceRenewAttributes": {
  3. "InstanceRenewAttribute": [
  4. {
  5. "Duration": 0,
  6. "InstanceId": "i-instance1",
  7. "AutoRenewEnabled": false
  8. },
  9. {
  10. "Duration": 1,
  11. "InstanceId": "i-instance2",
  12. "AutoRenewEnabled": true
  13. }
  14. ]
  15. },
  16. "RequestId": "04F0F334-1335-436C-A1D7-6C044FE73368"
  17. }
本文导读目录