DescribeRenewalPrice_云服务器 ECS_API文档

2014-05-26

获取元数据获取 SDK

找不到 API ? 点击反馈吧

插件下载了解更多

VS Code 插件反馈

安装插件之前，确保已安装 VS Code

Alibaba Cloud Developer ToolkitbetaAlibaba Cloud OpenAPI

Alibaba Cloud Developer Toolkit is a collection of extensions that can help access Alibaba Cloud services in Visual Studio Code.

JetBrains 插件反馈

安装插件之前，确保已安装 JetBrains IDE

Alibaba Cloud Developer ToolkitbetaAlibaba Cloud OpenAPI

The Alibaba Cloud Developer Toolkit for JetBrains makes it easier to access Alibaba Cloud services.

接口说明

仅支持查询包年包月 ECS 实例续费时长的价格或者续费至统一到期日的价格。
参数设置的注意事项如下：
- 只设置必选参数时，默认查询实例续费时长 1 个月的价格信息。
- 不支持同时查询续费时长价格和续费至统一到期日的价格，即续费时长参数（Period、PeriodUnit）与续费至统一到期日参数（ExpectedRenewDay）不能同时设置。

流控信息

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

授权信息

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

具体说明如下：展开详情

操作	访问级别	资源类型	条件关键字	关联操作

ecs:DescribeRenewalPrice	Get	DedicatedHost acs:ecs:{#regionId}:{#accountId}:ddh/{#ddhId} Instance acs:ecs:{#regionId}:{#accountId}:instance/{#instanceId}	无	无

请求参数

字段名称	字段详情
RegionIdstring	实例所属的地域 ID。您可以调用 DescribeRegions 查看最新的阿里云地域列表。示例值:cn-hangzhou参考取值来源: DescribeRegions
ResourceTypestring	查询续费价格的资源类型。取值：instance。展开详情示例值:instance参考取值来源: TagResources
ResourceIdstring	查询续费价格的资源 ID。参数`ResourceType`取值为`instance`时，`ResourceId`可以理解为`InstanceId`。示例值:i-bp1f2o4ldh8l29zv****参考取值来源: TagResources ListTagResources
Periodinteger<int32>	指定续费时长。取值范围：展开详情示例值:1
PriceUnitstring	指定续费周期。取值范围：展开详情示例值:Month
ExpectedRenewDayinteger<int32>	统一到期日。指定该参数后，将查询实例续费至统一到期日的价格信息。取值范围：1~28。展开详情示例值:5

返回参数

字段名称	字段详情
RequestIdstring	请求 ID。示例值:473469C7-AA6F-4DC5-B3DB-A3DC0DE3****
PriceInfoobject	价格信息类型（PriceInfo）组成的数据类型，包括价格和优惠规则信息。

返回示例

错误码

没有我想要的错误码, 点击反馈

全局错误码

HTTP 状态码	错误码	错误信息	操作

400	InvalidResourceType.ValueNotSupported	The specified parameter ResourceType is not valid.	诊断
400	InvalidPeriod	The specified period is not valid.	诊断
400	InvalidPriceUnit.ValueNotSupported	The specified parameter PriceUnit is not valid.	诊断
400	Throttling	Request was denied due to request throttling.	诊断
400	Throttling.User	Request was denied due to user flow control.	诊断
400	InternalError	The request processing has failed due to some unknown error.	诊断
400	InvalidExpectedRenewDay.Conflict	The specified expectedRenewDay is in conflict with period.	诊断
400	InvalidExpectedRenewDay.ValueNotSupported	The specified parameter ExpectedRenewDay is not valid.	诊断
403	ChargeTypeViolation	The operation is not permitted due to charge type of the instance.	诊断
403	InvalidAction.Unauthorized	The specified action is not valid.	诊断
404	InvalidInstanceId.NotFound	The specified InstanceId does not exist.	诊断
500	InternalError	The request processing has failed due to some unknown error, exception or failure.	诊断

变更历史

	变更时间	变更内容概要	操作
	2025-02-13	删除返回参数
	2025-01-08	变更错误码500

相关示例