调用DescribeRenewalPrice接口查询RDS实例续费的费用。

查询包年包月实例续费所需费用。

调试

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

请求参数

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

系统默认参数,取值为:DescribeRenewalPrice

DBInstanceId String rm-uf6wjk5xxxxxx

实例ID。

TimeType String Year

实例包年包月的类型,取值:

  • Year :包年
  • Month :包月
UsedTime Integer 1

实例购买时长,取值:

  • 当参数TimeType=Year时,取值为 1~3
  • 当参数TimeType=Month时,取值为 1~9
ClientToken String ETnLKlblzczshOTUbOCzxxxxxxxxxx

用于保证请求的幂等性。

RegionId String cn-hangzhou

地域ID。可以通过接口DescribeRegions查看可用的地域ID。

PayType String Postpaid

实例的付费类型。取值:

  • Postpaid:后付费(按量付费)
  • Prepaid:预付费(包年包月)
DBInstanceClass String mysql.n2.medium.2c

实例规格。规格详情请参见主实例规格表。默认为实例当前规格。

Quantity Integer 1

实例个数,默认值:1

OrderType String BUY

订单类型。仅唯一取值:BUY

BusinessInfo String 121436975448952

业务扩展参数。

返回数据

名称 类型 示例值 描述
Rules Array

活动规格。

Rule
RuleId Long 1001199213

活动ID。

Name String test

活动名称。

Description String 内容介绍

活动描述。

PriceInfo Struct

价格信息列表。

Currency String CNY

货币单位。

ActivityInfo Struct

价格信息。

CheckErrMsg String 错误描述

错误描述。

ErrorCode String 123456

错误代码。

Success String Success

是否成功。

OriginalPrice Float 138

原价。

DiscountPrice Float 27

折扣。

TradePrice Float 111

最终价,为原价减去折扣。

Coupons Array

优惠信息列表。

Coupon
Name String test

优惠券名称。

Description String test

优惠券描述。

CouponNo String 123456

优惠券编号。

IsSelected String true

是否已选择优惠券。

RuleIds List 1001199213

活动ID。

RequestId String DC9F4EF6-D038-4405-B497-1F48E722C9F2

请求ID。

示例

请求示例

http(s)://rds.aliyuncs.com/?Action=DescribeRenewalPrice
&TimeType=Year
&UsedTime=1
&DBInstanceId=rm-uf6wjk5xxxxxx
&<公共请求参数>

正常返回示例

XML 格式

<DescribeRenewalPriceResponse>
  <PriceInfo>
        <RuleIds>
              <RuleId>1001199213</RuleId>
        </RuleIds>
        <DiscountPrice>1480</DiscountPrice>
        <Coupons>
    </Coupons>
        <OriginalPrice>1480</OriginalPrice>
        <TradePrice>0</TradePrice>
        <Currency>CNY</Currency>
  </PriceInfo>
  <RequestId>DC9F4EF6-D038-4405-B497-1F48E722C9F2</RequestId>
  <Rules>
        <Rule>
              <Name>xxxxx</Name>
              <RuleId>1001199213</RuleId>
        </Rule>
  </Rules>
</DescribeRenewalPriceResponse>

JSON 格式

{
	"PriceInfo": {
		"RuleIds": {
			"RuleId": [
				1001199213
			]
		},
		"DiscountPrice": 1480,
		"Coupons": {
			"Coupon": []
		},
		"OriginalPrice": 1480,
		"TradePrice": 0,
		"Currency": "CNY"
	},
	"RequestId": "DC9F4EF6-D038-4405-B497-1F48E722C9F2",
	"Rules": {
		"Rule": [
			{
				"Name": "xxxxx",
				"RuleId": 1001199213
			}
		]
	}
}

错误码

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