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

调试

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

请求参数

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

系统规定参数。取值:DescribePrice

RegionId String cn-hangzhou

地域ID,可调用DescribeRegions查询。

Capacity Long 1024

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

InstanceClass String redis.master.small.default

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

InstanceClass查询步骤:

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

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

OrderType String BUY

订单类型,取值:

  • BUY:新购。
  • UPGRADE:变更配置。
  • RENEW:续费。
  • CONVERT:转换付费类型。
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
InstanceId String r-bp1zxszhcgatnx****

实例ID。

Instances String Instances=[{"RegionId": "cn-hangzhou","ZoneId": "cn-hangzhou-b","InstanceClass": "redis.master.small.default","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

返回数据

名称 类型 示例值 描述
OrderParams String String

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

RequestId String 3A40BE4E-1890-4972-889C-FEFA37663635

请求ID。

Order Object

订单信息。

OriginalAmount String 0.21

订单原价。

HandlingFeeAmount String 0.1

手续费。

Currency String CNY

币种,中国站为CNY(人民币);国际站为USD(美元)。

DiscountAmount String 0.21

订单优惠金额。

TradeAmount String 10

订单实际交易价。

Coupons Array of Coupon

优惠券信息。

Coupon
IsSelected String true

是否选中该优惠券。

CouponNo String youhuiquan_promotion_option_id_for_blank

优惠券编码。

Name String test

优惠券名称。

Description String coupondemo

优惠券描述。

RuleIds Array of String 1001199213

活动ID。

Rules Array of Rule

活动规格。

Rule
RuleDescId Long 1111111111

策略ID。

Title String test

策略标题。

Name String test

活动名称。

SubOrders Array of SubOrder

优惠券对应的策略。

SubOrder
OriginalAmount String 0.21

订单原价。

InstanceId String r-bp1xxxxxxxxxxxxx

实例ID。

DiscountAmount String 0.21

订单优惠金额。

TradeAmount String 10

订单实际交易价。

RuleIds Array of String RuleId: 1111111111

命中策略的ID。

示例

请求示例

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

正常返回示例

XML格式

HTTP/1.1 200 OK
Content-Type:application/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格式

HTTP/1.1 200 OK
Content-Type:application/json

{
  "RequestId" : "BA34B8E6-4119-49B0-BDA3-6ECD9B097A98",
  "Rules" : {
    "Rule" : [ {
      "RuleId" : "1020021003939076",
      "Name" : "test"
    } ]
  },
  "PriceInfo" : {
    "OriginalPrice" : 1070,
    "Currency" : "CNY",
    "DiscountPrice" : 1070,
    "RuleIds" : {
      "RuleId" : [ "1020021003939076" ]
    },
    "TradePrice" : 0,
    "Coupons" : {
      "Coupon" : [ ]
    }
  }
}

返回示例补充说明

<props="intl">
<pre>
{
    "RequestId": "BA34B8E6-4119-49B0-BDA3-6ECD9B097A98",
    "Rules": {
        "Rule": [
            {
                "RuleId": "1020021003939076",
                "Name": "test"
            }
        ]
    },
    "PriceInfo": {
        "OriginalPrice": 1070,
        "Currency": "USD",
        "DiscountPrice": 1070,
        "RuleIds": {
            "RuleId": [
                "1020021003939076"
            ]
        },
        "TradePrice": 0,
        "Coupons": {
            "Coupon": []
        }
    }
}
</pre>
</props>

错误码

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