查詢一台或多台預付費執行個體自動續費狀態。

描述

  • 為了方便您瞭解自己的執行個體是否為自動續費狀態,本介面支援執行個體續費狀態的查詢。

  • 目前只支援 訂用帳戶 的執行個體,隨用隨付 的執行個體執行該介面會報錯。

請求參數

名稱 類型 是否必需 描述
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。