调用DescribePrice查询创建Redis实例、升级配置或续费等操作产生的费用。

调试

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

请求参数

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

系统规定参数，取值：DescribePrice。

OrderType String 是 BUY

订单类型，取值：

  • BUY：新购。
  • UPGRADE：变更配置。
  • RENEW：续费。
  • CONVERT：转换付费类型。
RegionId String 是 cn-hangzhou

地域ID，可调用DescribeRegions查询。

InstanceId String 否 r-bp1zxszhcgatnx****

实例ID。
Capacity Long 否 1024

使用实例的存储容量指定规格，单位为MB。您需要在InstanceClass和Capacity参数中二选一，用来指定查询的规格。建议您使用InstanceClass参数精确地指定一个规格。

InstanceClass String 否 redis.master.small.default

使用InstanceClass编码指定实例规格。您需要在InstanceClass和Capacity参数中二选一，用来指定查询的规格。建议您使用InstanceClass参数精确地指定一个规格。

InstanceClass查询步骤：

1. 在规格查询导航中，根据需要选择实例类型，点击其架构类型列以打开规格文档。

2. 在规格文档的实例规格表中，选择需要的实例规格，并找到其InstanceClass列的编码。

ZoneId String 否 cn-hangzhou-e

可用区ID，可调用DescribeZones查询。

ChargeType String 否 PostPaid

付费类型，取值：

  • PostPaid：按量付费。
  • PrePaid：包年包月。
说明 默认值：PostPaid。
NodeType String 否 MASTER_SLAVE

节点类型，唯一值：MASTER_SLAVE，表示主从双副本。
Period Long 否 3

包年包月时长，单位为月。取值范围：1~9、12、24、36。

Quantity Long 否 1

购买实例的数量，取值范围：1~30。

说明 默认值：1。
Instances String 否 Instances=[{"RegionId": "cn-hangzhou","ZoneId": "cn-hangzhou-b","InstanceClass": "redis.master.small.default","ChargeType": "PostPaid","OrderType": "BUY","Period": "1","Quantity": "1","Capacity": "4096"}]

包含多个实例的JSON格式字符串，设置方式请参见Instances的格式说明。

BusinessInfo String 否 000000000000

活动ID、业务信息等扩展信息。
CouponNo String 否 youhuiquan_promotion_option_id_for_blank

优惠码，默认值：youhuiquan_promotion_option_id_for_blank，表示无优惠码。
ForceUpgrade Boolean 否 true

是否强制变配，取值：

  • false：是。
  • true：否。
说明 默认值：true。
OrderParamOut String 否 true

是否返回订单参数，可选值：

  • false：不返回。
  • true：返回。
说明 默认值：false。

返回数据

名称 类型 示例值 描述
Order Struct

订单信息。
Coupons Array of Coupon

优惠券信息。
Coupon
CouponNo String youhuiquan_promotion_option_id_for_blank

优惠券编码。
Description String coupondemo

备注。
IsSelected String true

是否选中该优惠券。
Name String 内部结算用户0元付

订单实际交易价。
Currency String CNY

币种。
DiscountAmount String 0.21

订单优惠金额。
HandlingFeeAmount String 0.1

手续费。
OriginalAmount String 0.21

订单原价。
RuleIds List RuleId: 1111111111

命中策略的ID。
TradeAmount String 10

订单实际交易价。
SubOrders Array of SubOrder

优惠券对应的策略。
SubOrder
DiscountAmount String 0.21

订单优惠金额。
InstanceId String r-bp1xxxxxxxxxxxxx

实例ID。
OriginalAmount String 0.21

订单原价。
RuleIds List RuleId: 1111111111

命中策略的ID。
TradeAmount String 10

订单实际交易价。
Rules Array of Rule

活动规则。
Rule
Name String 内部结算用户0元付

订单实际交易价。
RuleDescId Long 1111111111

策略ID。
Title String demo

策略标题。
RequestId String 3A40BE4E-1890-4972-889C-FEFA37663635

请求ID。
OrderParams String String

订单参数，当OrderParamOut为true时返回。

示例

请求示例

https://r-kvstore.aliyuncs.com/?Action=DescribePrice
&OrderType=BUY
&RegionId=cn-hangzhou
&<公共请求参数>

正常返回示例

XML格式 

<DescribePriceResponse>
      <Order>
            <Currency>CNY</Currency>
            <RuleIds>
        </RuleIds>
            <TradeAmount>0</TradeAmount>
            <OriginalAmount>0</OriginalAmount>
            <Coupons>
        </Coupons>
            <DiscountAmount>0</DiscountAmount>
      </Order>
      <RequestId>3A40BE4E-1890-4972-889C-FEFA37663635</RequestId>
      <SubOrders>
            <SubOrder>
                  <RuleIds>
            </RuleIds>
                  <TradeAmount>0</TradeAmount>
                  <OriginalAmount>0</OriginalAmount>
                  <DiscountAmount>0</DiscountAmount>
            </SubOrder>
      </SubOrders>
      <Rules>
    </Rules>
</DescribePriceResponse>

JSON格式 

{
	"Order": {
		"Currency": "CNY",
		"RuleIds": {
			"RuleId": []
		},
		"TradeAmount": 0,
		"OriginalAmount": 0,
		"Coupons": {
			"Coupon": []
		},
		"DiscountAmount": 0
	},
	"RequestId": "3A40BE4E-1890-4972-889C-FEFA37663635",
	"SubOrders": {
		"SubOrder": [
			{
				"RuleIds": {
					"RuleId": []
				},
				"TradeAmount": 0,
				"OriginalAmount": 0,
				"DiscountAmount": 0
			}
		]
	},
	"Rules": {
		"Rule": []
	}
}

错误码

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