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

调试

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

请求参数

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

系统规定参数,取值:DescribePrice

OrderType String BUY

订单类型,取值:

  • BUY:新购。
  • UPGRADE:变更配置。
  • RENEW:续费。
RegionId String cn-hangzhou

地域ID,可调用DescribeRegions查询。

InstanceId String r-bp1zxszhcgatnx****

实例ID。

Capacity Long 1024

使用实例的存储容量指定规格,单位为MB。您需要在InstanceClassCapacity参数中二选一,用来指定查询的规格。建议您使用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~9122436

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

订单优惠金额。

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": []
	}
}

错误码

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