描述
查询实例自动续费状态。为了方便您清楚地了解自己的实例是否为自动续费状态,本接口支持实例续费状态的查询。目前只支持包年包月的实例,按量付费的实例执行该接口会报错。
请求参数
名称 | 类型 | 是否必须 | 描述 |
Action | String | 是 | 操作接口名,系统规定参数,取值:DescribeInstanceAutoRenewAttribute。 |
RegionId | String | 是 | 实例所属的地域 ID。 |
InstanceId | String | 是 | 实例 ID。支持最多 100 个包年包月实例批量查询,多个实例 ID 以英文逗号分隔。 |
名称 | 类型 | 描述 |
InstanceId | String | 实例 ID,由系统生成,全局唯一。是访问实例的唯一标识。 |
Duration | Integer | 自动续费时长。 |
AutoRenewEnabled | Boolean | 是否自动续费。
|
错误代码 | 描述 | 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。 |
https://ecs.aliyuncs.com/?Action=DescribeInstanceAutoRenewAttribute
&RegionId=cn-hangzhou
&InstanceId=i-instance1,i-instance2
&<公共请求参数>
返回示例
XML格式
<DescribeInstanceAutoRenewAttributeResponse>
<RequestId>04F0F334-1335-436C-A1D7-6C044FE73368</RequestId>
<InstanceRenewAttributes>
<InstanceRenewAttribute>
<Instance>
<InstanceId>i-instance1</InstanceId>
<Duration>0</Duration>
<AutoRenewEnalbed>false</AutoRenewEnalbed>
</Instance>
<Instance>
<InstanceId>i-instance2</InstanceId>
<Duration>1</Duration>
<AutoRenewEnalbed>true</AutoRenewEnalbed>
</Instance>
</InstanceRenewAttribute>
</InstanceRenewAttributes>
</DescribeInstanceAutoRenewAttributeResponse>
JSON格式
{
"InstanceRenewAttributes": {
"InstanceRenewAttribute": [
{
"Duration": 0,
"InstanceId": "i-instance1",
"AutoRenewEnabled": false
},
{
"Duration": 1,
"InstanceId": "i-instance2",
"AutoRenewEnabled": true
}
]
},
"RequestId": "04F0F334-1335-436C-A1D7-6C044FE73368"
}
版权声明:本文内容由阿里云实名注册用户自发贡献,版权归原作者所有,阿里云开发者社区不拥有其著作权,亦不承担相应法律责任。具体规则请查看《阿里云开发者社区用户服务协议》和《阿里云开发者社区知识产权保护指引》。如果您发现本社区中有涉嫌抄袭的内容,填写侵权投诉表单进行举报,一经查实,本社区将立刻删除涉嫌侵权内容。
您可以通过调用阿里云ECS(Elastic Compute Service)的API接口来查询实例的自动续费状态。具体操作如下:
请求方式:使用HTTP GET方法。
请求URL:
https://ecs.aliyuncs.com/?Action=DescribeInstanceAutoRenewAttribute&RegionId=您的地域ID&InstanceId=您的实例ID
请求参数说明:
Action
: 必须参数,固定值为DescribeInstanceAutoRenewAttribute
,表示查询实例自动续费属性的操作。RegionId
: 必须参数,填写实例所在的地域ID,例如cn-hangzhou
代表杭州地域。InstanceId
: 必须参数,填写要查询的实例ID。支持批量查询,最多100个实例ID,多个实例ID之间以英文逗号分隔。返回结果示例:
成功响应时,返回的数据格式一般为JSON,包含以下字段:
{
"InstanceId": "i-instance12345678",
"Duration": 1,
"AutoRenewEnabled": true
}
InstanceId
: 实例ID。Duration
: 自动续费时长,单位通常为月。AutoRenewEnabled
: 是否开启自动续费,true
表示已开启,false
表示未开启。错误码处理:
如果请求中出现错误,HTTP响应状态码将不是200,并且会返回具体的错误信息,如错误代码、描述及对应的HTTP状态码。根据您提供的错误码列表,可以针对性地进行问题排查和解决。
例如,如果收到Abs.MissingParamter.InstanceId
错误,意味着请求中缺少了InstanceId
参数;若收到ChargeTypeViolation
错误,则表明尝试对按量付费实例执行此操作,而该操作只支持包年包月实例。
确保在发起请求前,仔细检查请求参数是否符合要求,并正确设置地域ID、实例ID等信息。此外,也可以通过阿里云官方文档或SDK进一步了解如何调用此接口及处理返回结果。
你好,我是AI助理
可以解答问题、推荐解决方案等