调用DescribePrice接口查询RDS实例的价格。
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
请求参数
名称 | 类型 | 是否必选 | 示例值 | 描述 |
---|---|---|---|---|
Action | String | 是 | DescribePrice | 系统规定参数。取值:DescribePrice。 |
ClientToken | String | 否 | ETnLKlblzczshOTUbOCz***** | 用于保证请求的幂等性,防止重复提交请求。由客户端生成该参数值,要保证在不同请求间唯一,最大值不超过64个ASCII字符,且该参数值中不能包含非ASCII字符。 |
CommodityCode | String | 否 | rds | 当前实例的商品码,取值:
说明 查询只读实例时必须传入本参数。
|
RegionId | String | 是 | cn-hangzhou | 地域ID。可以通过接口DescribeRegions查看地域ID。 |
Engine | String | 是 | MySQL | 数据库类型,取值:
|
EngineVersion | String | 是 | 5.5 | 数据库版本,取值:
|
DBInstanceClass | String | 是 | rds.mysql.s1.small | 实例规格,详情请参见主实例规格表。 |
DBInstanceStorage | Integer | 是 | 20 | 实例存储空间,单位:GB。每5 GB进行递增,取值范围请参见实例规格表。 |
PayType | String | 否 | Prepaid | 实例的付费类型,取值:
|
ZoneId | String | 否 | cn-hangzhou-b | 主节点可用区ID。可以通过接口DescribeRegions查看可用区ID。
说明 指定了VPC和交换机时,为匹配交换机对应的可用区,该参数必填。
|
UsedTime | Integer | 否 | 1 | 指定购买时长,取值:
默认值:1。 |
TimeType | String | 否 | Year | 包年包月的付费类型,当CommodityCode参数的值为RDS、rds_rordspre_public_cn、rds_intl或rds_rordspre_public_intl时必传。取值:
|
Quantity | Integer | 是 | 10 | 购买实例的数量,取值范围:0~30。 |
InstanceUsedType | Integer | 否 | 0 | 实例类型,取值:
|
OrderType | String | 否 | BUY | 订单类型,取值:
|
DBInstanceStorageType | String | 否 | local_ssd | 实例存储类型,取值:
|
DBInstanceId | String | 否 | rm-***** | 变配或续费的实例ID。
说明
|
DBNode | Array | 否 | 节点相关信息。
说明 该参数用于MySQL集群版实例。
|
|
ClassCode | String | 否 | mysql.n2.small.xc | 节点规格。 |
ZoneId | String | 否 | cn-hangzhou-j | 节点可用区ID。 |
返回数据
名称 | 类型 | 示例值 | 描述 |
---|---|---|---|
RequestId | String | CA0ADDDC-0BEB-4381-A3ED-73B4C79B8CC6 | 请求ID。 |
PriceInfo | Object | 价格信息。 |
|
OriginalPrice | Float | 2504 | 原价。 |
DiscountPrice | Float | 0 | 折扣。 |
Currency | String | CNY | 货币单位。 |
TradePrice | Float | 2504 | 最终价,为原价减去折扣。 |
Coupons | Array of Coupon | 优惠信息列表。 |
|
Coupon | |||
IsSelected | String | true | 是否已选择优惠券。 |
CouponNo | String | 123456 | 优惠券编号。 |
Name | String | test | 优惠券名称。 |
Description | String | test | 优惠券描述。 |
RuleIds | Array of String | 1001199213 | 活动ID。 |
ActivityInfo | Object | 价格信息。 |
|
CheckErrMsg | String | Error description | 错误描述。 |
ErrorCode | String | 123456 | 错误代码。 |
Success | String | Success | 是否成功。 |
Rules | Array of Rule | 活动规格列表。 |
|
Rule | |||
Name | String | Rule1 | 活动名称。 |
Description | String | Activity Description | 活动描述。 |
RuleId | Long | 1020021003939076 | 活动ID。 |
示例
请求示例
http(s)://rds.aliyuncs.com/?Action=DescribePrice
&ClientToken=ETnLKlblzczshOTUbOCz*****
&CommodityCode=rds
&RegionId=cn-hangzhou
&Engine=MySQL
&EngineVersion=5.5
&DBInstanceClass=rds.mysql.s1.small
&DBInstanceStorage=20
&PayType=Prepaid
&ZoneId=cn-hangzhou-b
&UsedTime=1
&TimeType=Year
&Quantity=10
&InstanceUsedType=0
&OrderType=BUY
&DBInstanceStorageType=local_ssd
&DBInstanceId=rm-*****
&公共请求参数
正常返回示例
XML
格式
HTTP/1.1 200 OK
Content-Type:application/xml
<DescribePriceResponse>
<RequestId>CA0ADDDC-0BEB-4381-A3ED-73B4C79B8CC6</RequestId>
<PriceInfo>
<OriginalPrice>2504</OriginalPrice>
<DiscountPrice>0</DiscountPrice>
<Currency>CNY</Currency>
<TradePrice>2504</TradePrice>
<Coupons>
<IsSelected>true</IsSelected>
<CouponNo>123456</CouponNo>
<Name>test</Name>
<Description>test</Description>
</Coupons>
<RuleIds>1001199213</RuleIds>
<ActivityInfo>
<CheckErrMsg>Error description</CheckErrMsg>
<ErrorCode> 123456</ErrorCode>
<Success>Success</Success>
</ActivityInfo>
</PriceInfo>
<Rules>
<Name>Rule1</Name>
<Description>Activity Description</Description>
<RuleId>1020021003939076</RuleId>
</Rules>
</DescribePriceResponse>
JSON
格式
HTTP/1.1 200 OK
Content-Type:application/json
{
"RequestId" : "CA0ADDDC-0BEB-4381-A3ED-73B4C79B8CC6",
"PriceInfo" : {
"OriginalPrice" : 2504,
"DiscountPrice" : 0,
"Currency" : "CNY",
"TradePrice" : 2504,
"Coupons" : [ {
"IsSelected" : "true",
"CouponNo" : "123456",
"Name" : "test",
"Description" : "test"
} ],
"RuleIds" : [ "1001199213" ],
"ActivityInfo" : {
"CheckErrMsg" : "Error description",
"ErrorCode" : " 123456",
"Success" : "Success"
}
},
"Rules" : [ {
"Name" : "Rule1",
"Description" : "Activity Description",
"RuleId" : 1020021003939076
} ]
}
错误码
HttpCode | 错误码 | 错误信息 | 描述 |
---|---|---|---|
400 | InvalidDBInstanceStorage.Format | InvalidDBInstanceStorage.Format | 实例存储大小不符合要求,请检查。 |
400 | DBNodeParameter.InvalidClassCode | The ClassCode of the item of the specified parameter DBNode is inconsistent. | 参数DBNode中的ClassCode配置不一致。 |
400 | DBNodeParameter.Required | The specified parameter DBNode is required. | 参数DBNode是必需的。 |
400 | DBNodeParameter.TooFewItems | The specified parameter DBNode has too few items. | 参数DBNode中的配置项过少。 |
400 | DBNodeParameter.TooManyItems | The specified parameter DBNode has too many items. | 参数DBNode中的配置项过多。 |
404 | InvalidTimeType.NotFound | The parameter timeType does not exist. | 请检查 TimeType 参数。可选值为 Year、Month、Day |
访问错误中心查看更多错误码。