DescribeInstanceAutoRenewAttribute_云服务器 ECS_API文档

插件下载了解更多
VS Code 插件
安装插件之前,确保已安装 VS Code安装插件之前,确保已安装 VS Code
Alibaba Cloud Developer Toolkit is a collection of extensions that can help access Alibaba Cloud services in Visual Studio Code.
JetBrains 插件
安装插件之前,确保已安装 JetBrains IDE安装插件之前,确保已安装 JetBrains IDE
The Alibaba Cloud Developer Toolkit for JetBrains makes it easier to access Alibaba Cloud services.

接口说明

  • 仅支持包年包月的实例,按量付费的实例调用该接口会报错。
  • 在设置自动续费或者手动续费前,查询实例续费状态可以帮助您了解实例是否已为自动续费状态。

流控信息

请求速率为1000/60(s)。

授权信息

如下是此API对应的授权信息,用于RAM权限策略语句的Action元素中,为RAM用户或RAM角色授予调用此API的权限。请通过 RAM 访问控制设置,使用方法可参考访问控制帮助文档

具体说明如下:展开详情

操作访问级别资源类型条件关键字关联操作
ecs:DescribeInstanceAutoRenewAttribute
List
Instance
acs:ecs:{#regionId}:{#accountId}:instance/{#instanceId}
Instance
acs:ecs:{#regionId}:{#accountId}:instance/*

请求参数

字段名称字段详情
InstanceIdstring

实例 ID。支持最多 100 台包年包月实例批量查询,多个实例 ID 以半角逗号分隔。展开详情

示例值:i-bp18x3z4hc7bixhx****,i-bp1g6zv0ce8oghu7****参考取值来源:
    RunInstances
    StopInstances
    CreateInstance
    StartInstances
    RebootInstances
    DescribeInstances
    ModifyManagedInstance
    RenewReservedInstances
    DetachInstanceRamRole
    AttachInstanceRamRole
    DeregisterManagedInstance
    PurchaseReservedInstancesOffering
RegionIdstring

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

示例值:cn-hangzhou参考取值来源:
    DescribeRegions
RenewalStatusstring

实例的自动续费状态。取值范围:展开详情

示例值:AutoRenewal
PageSizestring

分页展示响应信息时设置的每页行数,单位:行。展开详情

示例值:10正则:^\d+$
PageNumberstring

查询接口返回资源信息列表的页码。展开详情

示例值:1正则:^\d+$

返回参数

字段名称字段详情
RequestIdstring

请求 ID。

示例值:473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E
PageNumberinteger<int32>

页码。

示例值:1
PageSizeinteger<int32>

每页行数。

示例值:10
TotalCountinteger<int32>

返回的实例总数。

示例值:6
InstanceRenewAttributesobject

返回示例

错误返回示例

错误码

全局错误码
HTTP 状态码错误码错误信息操作
400
Throttling
Request was denied due to request throttling.诊断
403
MissingParameter.InstanceId
InstanceId should not be null.诊断
403
InvalidParameter.ToManyInstanceIds
InstanceId should be less than 100.诊断
403
IncorrectInstanceStatus
The current status of the resource does not support this operation.诊断
403
ChargeTypeViolation
Pay-As-You-Go instances do not support this operation.诊断
403
InvalidParameter.RenewalStatus
The specified parameter RenewalStatus is not valid.诊断
403
InvalidParameter.RenewalStatusInstanceId
The parameter RenewalStatus and InstanceId can not be both empty.诊断
403
InvalidParameter.PageSize
The specified parameter PageSize is not valid.诊断
403
InvalidParameter.PageNumber
The specified parameter PageNumber is not valid.诊断
403
InvalidParameter.InvalidInstanceId
The specified InstanceId does not exist.诊断

变更历史

变更时间变更内容概要操作
2025-03-11
变更错误码403
2021-11-04
新增错误码400

相关示例

本文介绍如何通过阿里云ECS SDK调用DescribeInstances、RenewInstance、ModifyInstanceAutoRenewAttribute查询并续费ECS实例、开启自动续费功能。
2024-08-21