DescribeInstanceAutoRenewAttribute -

描述

為了方便您瞭解自己的執行個體是否為自動續費狀態，本介面支援執行個體續費狀態的查詢。
目前只支援訂用帳戶的執行個體，隨用隨付的執行個體執行該介面會報錯。

請求參數


名稱	類型	是否必需	描述
Action	String	是	系統規定參數。取值：DescribeInstanceAutoRenewAttribute
RegionId	String	是	執行個體所屬的地域 ID。您可以調用 DescribeRegions 查看最新的阿里雲地域列表。
InstanceId	String	是	執行個體 ID。支援最多 100 個訂用帳戶執行個體批量查詢，多個執行個體 ID 以英文逗號分隔。

返回參數


名稱	類型	描述
InstanceId	String	執行個體 ID，由系統生成，全域唯一。是訪問執行個體的唯一標識。
Duration	Integer	自動續費時長。
AutoRenewEnabled	Boolean	是否自動續費。 true：自動續費類型。 false：非自動續費類型。
RenewalStatus	String	是否不再續費的返回資訊 AutoRenewal：自動續費 Normal：非自動續費，您需要自行續費 ECS 執行個體 NotRenewal：不再續費。返回該值後，系統不再發送到期提醒，只在到期前第三天發送不續費提醒。不再續費的 ECS 執行個體可以更改成待續費（`Noramal`）後，再自行續費或設定為自動續費

樣本

請求樣本

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>
            <RenewalStatus>Normal</RenewalStatus>
          </Instance>
          <Instance>
            <InstanceId>i-instance2</InstanceId>
            <Duration>1</Duration>
            <AutoRenewEnalbed>true</AutoRenewEnalbed>
            <RenewalStatus>AutoRenewal</RenewalStatus>
          </Instance>
        </InstanceRenewAttribute>
    </InstanceRenewAttributes>
</DescribeInstanceAutoRenewAttributeResponse>

JSON 格式

{
    "InstanceRenewAttributes": {
        "InstanceRenewAttribute": [
            {
                "Duration": 0,
                "InstanceId": "i-instance1",
                "AutoRenewEnabled": false
                "RenewalStatus": "Normal"
            },
            {
                "Duration": 1,
                "InstanceId": "i-instance2",
                "AutoRenewEnabled": true
                "RenewalStatus": "AutoRenewal"
            }
        ]
    },
    "RequestId": "04F0F334-1335-436C-A1D7-6C044FE73368"
}

錯誤碼

以下為本介面特有的錯誤碼。更多錯誤碼，請訪問 API 錯誤中心。


錯誤碼	錯誤資訊	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。