调用DescribeReservedInstanceAutoRenewAttribute查询一个或多个包年包月预留实例券自动续费状态。

调试

您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

请求参数

名称 类型 是否必选 示例值 描述
Action String DescribeReservedInstanceAutoRenewAttribute

系统规定参数。取值:DescribeReservedInstanceAutoRenewAttribute

RegionId String cn-hangzhou

预留实例券所属的地域ID。您可以调用DescribeRegions查看最新的阿里云地域列表。

ReservedInstanceId.N String ecsri-ajdfaj****

预留实例券ID。您可以调用DescribeReservedInstances查看已购买的预留实例券。仅支持查询已生效(Status=Active)的预留实例券的自动续费状态。

单次续费的预留实例券数量最多不超过100个。

返回数据

名称 类型 示例值 描述
RequestId String 04F0F334-1335-436C-A1D7-6C044FE7****

请求ID。

ReservedInstanceRenewAttributes Array of ReservedInstanceRenewAttribute

由ReservedInstanceRenewAttribute组成的数组格式,返回预留实例券的自动续费设置信息。

ReservedInstanceRenewAttribute
PeriodUnit String Month

续费单位。

可能值:Year、Month。

Duration Integer 1

自动续费时长。

ReservedInstanceId String ecsri-ajdfaj****

预留实例券ID。

RenewalStatus String AutoRenewal

预留实例券自动续费状态。取值范围:

  • AutoRenewal:自动续费。
  • Normal:手动续费。

示例

请求示例

http(s)://ecs.aliyuncs.com/?Action=DescribeReservedInstanceAutoRenewAttribute
&RegionId=cn-hangzhou
&ReservedInstanceId.1=ecsri-ajdfaj****
&ReservedInstanceId.2=ecsri-abjkql****
&公共请求参数

正常返回示例

XML格式

HTTP/1.1 200 OK
Content-Type:application/xml

<DescribeReservedInstanceAutoRenewAttributeResponse>
    <RequestId>04F0F334-1335-436C-A1D7-6C044FE7****</RequestId>
    <ReservedInstanceRenewAttributes>
        <ReservedInstanceRenewAttribute>
            <PeriodUnit>Month</PeriodUnit>
            <Duration>1</Duration>
            <ReservedInstanceId>ecsri-ajdfaj****</ReservedInstanceId>
            <RenewalStatus>AutoRenewal</RenewalStatus>
        </ReservedInstanceRenewAttribute>
        <ReservedInstanceRenewAttribute>
            <PeriodUnit>Month</PeriodUnit>
            <Duration>1</Duration>
            <ReservedInstanceId>ecsri-abjkql****</ReservedInstanceId>
            <RenewalStatus>AutoRenewal</RenewalStatus>
        </ReservedInstanceRenewAttribute>
    </ReservedInstanceRenewAttributes>
</DescribeReservedInstanceAutoRenewAttributeResponse>

JSON格式

HTTP/1.1 200 OK
Content-Type:application/json

{
  "RequestId" : "04F0F334-1335-436C-A1D7-6C044FE7****",
  "ReservedInstanceRenewAttributes" : {
    "ReservedInstanceRenewAttribute" : [ {
      "PeriodUnit" : "Month",
      "Duration" : 1,
      "ReservedInstanceId" : "ecsri-ajdfaj****",
      "RenewalStatus" : "AutoRenewal"
    }, {
      "PeriodUnit" : "Month",
      "Duration" : 1,
      "ReservedInstanceId" : "ecsri-abjkql****",
      "RenewalStatus" : "AutoRenewal"
    } ]
  }
}

错误码

HttpCode 错误码 错误信息 描述
403 InvalidParameter %s 无效的参数。
403 ChargeTypeViolation The operation is not permitted due to charge type of the instance. 付费方式不支持该操作,请您检查实例的付费类型是否与该操作冲突。

访问错误中心查看更多错误码。