DescribePrice - 查询费用

询价

调试

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

授权信息

下表是API对应的授权信息,可以在RAM权限策略语句的Action元素中使用,用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下:

  • 操作:是指具体的权限点。
  • 访问级别:是指每个操作的访问级别,取值为写入(Write)、读取(Read)或列出(List)。
  • 资源类型:是指操作中支持授权的资源类型。具体说明如下:
    • 对于必选的资源类型,用背景高亮的方式表示。
    • 对于不支持资源级授权的操作,用全部资源表示。
  • 条件关键字:是指云产品自身定义的条件关键字。
  • 关联操作:是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限,操作才能成功。
操作访问级别资源类型条件关键字关联操作
dds:DescribePriceget
  • 全部资源
    *

请求参数

名称类型必填描述示例值
RegionIdstring

地域 ID,您可以调用 DescribeRegions 接口查询地域 ID。

cn-hangzhou
OrderTypestring

订单类型,取值说明:

  • BUY:创建实例。
  • UPGRADE:变更配置。
  • RENEW:续费实例。
BUY
DBInstancesstring

包含实例中多个信息的 JSON 格式字符串。参数说明以及更多 JSON 格式示例,请参见DescribePrice 接口 DBInstances 参数说明

[ { "DBInstanceId":"dds-bp1b6e54e7cc****", "RegionId":"cn-hangzhou", "ZoneId":"cn-hangzhou-h", "Engine":"MongoDB", "EngineVersion":" 5.0", "DBInstanceClass":"mdb.shard.2x.xlarge.d", "DBInstanceStorage":30, "ChargeType":"PrePaid", "Period":1, "StorageType":"cloud_essd1" } ]
CommodityCodestring

集群代码,取值说明:

  • dds:副本集版按量付费。
  • badds: 副本集版包年包月。
  • dds_sharding: 分片集群版按量付费。
  • badds_sharding: 分片集群版包年包月。
  • badds_sharding_intl: 分片集群版包年包月(国际站)。
  • dds_sharding_intl: 分片集群版按量付费(国际站)。
  • badds_sharding_jp: 分片集群版包年包月(日本站)。
  • badds_intl: 副本集版包年包月(国际站)。
  • dds_intl: 副本集版按量付费(国际站)。
badds
ProductCodestring

产品代码,默认为 dds

dds
BusinessInfostring

附加参数,业务信息。

{"AccountPassword":"Pw123456","DBInstanceDescription":"test"}
CouponNostring

是否使用优惠券,取值说明:

  • defaultnull(默认):使用优惠券。
  • youhuiquan_promotion_option_id_for_blank:不使用优惠券。
default
OrderParamOutstring

是否返回订单参数,取值说明:

  • false(默认值):不返回。
  • true:返回。
true
ResourceGroupIdstring

资源组 ID。资源组详情请参见查看资源组基本信息

rg-acfmyiu4ekp****

返回参数

名称类型描述示例值
object

订单信息列表。

Orderobject

订单信息列表。

Couponsarray<object>

优惠券信息列表。

Couponobject

订单优惠券信息。

Descriptionstring

备注。

ceshi
IsSelectedstring

是否选中该优惠券,取值说明:

  • true:选中优惠券。
  • false:不选中优惠券。
true
CouponNostring

优惠券编码。

youhuiquan_promotion_option_id_for_blank
Namestring

优惠券名称。

youhuiquan111
PromotionRuleIdListarray

优惠券对应的规则 ID 列表。

PromotionRuleIdlong

优惠券对应的规则 ID。

18772041****
PromotionOptionCodestring

促销信息,促销选项代码。

youhui_quan
OptionCodestring

优惠券代号。

youhui_quan
ActivityCategorystring

优惠券的活动类型,取值说明:

  • payondemand:预付费。
  • payasyougo:后付费。
payondemand
OriginalAmountstring

订单原价。

322.4
DiscountAmountstring

订单优惠金额。

322.4
RuleIdsarray

订单规则信息。

RuleIdstring

活动规则 ID 合集。

{ "RuleId": [ 2075**** ] }
TradeAmountstring

订单实际交易价。

0
Currencystring

币种。

USD
ShowDiscountInfoboolean

是否展示折扣信息。

true
OptionalPromotionsstring

优惠活动信息列表。

"[{\"activityCategory\":\"discount\",\"activityExtInfo\":{\"noUseYouhuiquan\":\"true\",\"activityId\":\"191156098xxxx\",\"activityExtraAttr\":\"{\\\"forbiddenCpsProfit\\\":\\\"true\\\",\\\"forbiddenCouponsRestricted\\\":\\\"true\\\",\\\"forbiddenAmbassadorProfit\\\":\\\"true\\\"}\",\"isActivityIdFromWanHuaTong\":\"true\",\"isContractActivity\":\"false\"},\"canPromFee\":906130,\"optionCode\":\"wanhua_activity\",\"promotionName\":\"FY24--MongoDB 副本集--首购--1年*折--ft首购权益\",\"promotionOptionNo\":\"19115609882xxxx\",\"promotionRuleIdList\":[2091xxxx],\"selected\":true,\"targetArticleItemCodes\":[]},{\"activityCategory\":\"discount\",\"activityExtInfo\":{\"activityId\":\"1018040010xxxxx\",\"wanHuaOrderExpireSec\":\"604800\",\"isActivityIdFromWanHuaTong\":\"true\",\"isContractActivity\":\"false\"},\"canPromFee\":339799,\"optionCode\":\"wanhua_activity\",\"promotionName\":\"FY24--MongoDB年付折扣\",\"promotionOptionNo\":\"10180400107xxxxx\",\"promotionRuleIdList\":[xxxxx],\"selected\":false,\"targetArticleItemCodes\":[]}]"
PromDetailListstring

命中的优惠活动。

[{\"finalPromFee\":90xxx,\"optionCode\":\"wanhua_activity\",\"promType\":\"discount\",\"promotionId\":2091xxxx,\"promotionName\":\"新用户购买云数据库 MongoDB 副本集1年享*折优惠,限1台\"}]"
DepreciateInfoobject

降价信息。

ListPricedouble

目录价。

1*
OriginalStandAmountdouble

原始官网总价。

12*
CheapStandAmountdouble

降价后官网总价。

9*
CheapRatedouble

降价比例。

30%
Differentialdouble

差价优惠(订单总价展示)。

**
DifferentialNamestring

差价优惠名称。

XXXXX
MonthPricedouble

折合月价。

**
IsContractActivityboolean

命中合同优惠。

false
IsShowstring

是否展示降价幅度。

true
ContractActivityobject

合同优惠。

FinalPromFeedouble

优惠总费用。

3621.6
FinalFeedouble

优惠后费用。

20522.4
ProdFeedouble

原价。

24144.0
ActivityIdlong

活动 id。

41120065996xxxxx
OptionCodestring

优惠 id。

wanhua_activity
ActivityNamestring

活动名称。

合同优惠_整单_xxx
OptionIdsarray

优惠 id 列表。

OptionIdlong

优惠 id

200000614xxxx
StandDiscountPricedouble

折扣价格。

0
StandPricedouble

折扣价。

0
ContractActivityboolean

命中合同优惠。

false
Codestring

订单码

""
Messagestring

订单信息

""
IsContractActivityboolean

命中合同优惠。

false
RequestIdstring

请求 ID。

27227A3D-6B86-56F3-9E03-9E60F001CE12
SubOrdersarray<object>

优惠券对应的规则列表。

SubOrderobject

优惠券规则信息。

OriginalAmountstring

订单原价。

322.4
DiscountAmountstring

订单优惠金额。

322.4
RuleIdsarray

活动规则列表。

RuleIdstring

活动规则 ID 合集。

{ "RuleId": [ 2075**** ] }
TradeAmountstring

订单实际交易价格。

0
InstanceIdstring

实例 ID。

dds-bp1b6e54e7cc****
DepreciateInfoobject

降价信息。

ListPricedouble

目录价。

1*
OriginalStandAmountdouble

原始官网总价。

12*
CheapStandAmountdouble

降价后官网总价。

9*
CheapRatedouble

降价比例。

30%
Differentialdouble

差价优惠(订单总价展示)。

**
DifferentialNamestring

差价优惠名称。

XXXXX
MonthPricedouble

折合月价。

**
IsContractActivityboolean

命中合同优惠。

false
IsShowstring

是否展示降价幅度。

true
ContractActivityobject

活动信息。

FinalPromFeedouble

优惠总费用。

3621.6
FinalFeedouble

优惠后费用。

20522.4
ProdFeedouble

原价。

24144.0
ActivityIdlong

活动 ID。

41120065996xxxxx
OptionCodestring

优惠 ID。

wanhua_activity
ActivityNamestring

活动名称。

合同优惠_整单_xxx
OptionIdsarray

优惠 ID 列表。

OptionIdlong

优惠 ID。

2388xxxx
StartTimestring

活动开始时间。

2024-02-29 10:30:00
IsNewOfficialActivitystring

命中降价优惠。

命中降价优惠。
ModuleInstancearray<object>

订单行实例配置。

ModuleInstanceobject

订单行实例配置子对象。

CycleFeestring

模块的周期费。

0.0
PromDetailListarray<object>

优惠明细信息。

PromDetailobject

优惠信息。

FinalPromFeedouble

优惠金额。

0.0
ActivityExtInfoobject

优惠详情额外信息。

{ "activityId": "1512010241743170" }
OptionCodestring

优惠券商品 Code。

wanhua_activity
PromTypestring

优惠子类型。

discount
PromotionIdlong

优惠活动 ID。

8105187xxxx
PromotionNamestring

促销活动名称。

【xxxx-x月降价项目】MongoDB全规格--xxxxx
PromotionCodestring

优惠码。

aliwood-xxx
DerivedPromTypestring

优惠子类型。

subPrice
DepreciateInfoobject

活动信息。

ListPricedouble

目录价。

1*
OriginalStandAmountdouble

原始官网总价。

12*
CheapStandAmountdouble

降价后官网总价。

9*
CheapRatedouble

降价比例。

30%
Differentialdouble

差价优惠(订单总价展示)。

**
DifferentialNamestring

差价优惠名称。

XXXXX
MonthPricedouble

折合月价。

**
IsContractActivityboolean

命中合同优惠。

false
IsShowstring

是否展示降价幅度。

true
DiscountFeestring

折扣费用。

0.0
ModuleAttrsarray<object>

模块属性。

moduleAttrobject

订购参数。

Codestring

属性代码。

dds_dbtype
Namestring

属性名称。

MongoDB
Typestring

属性类型。

3
Valuestring

属性值。

MongoDB
ModuleCodestring

模块 code。

dds_dbtype
ModuleIdlong

模块 Id。

1017110000415xxx
ModuleNamestring

模块名称。

数据库类型
NeedOrderPayboolean

在订单中是否需要支付。

true
PayFeedouble

实付金额。

0.0
PricingModuleboolean

是否计价项

false
StandPricedouble

折扣价。

0
TotalProductFeedouble

产品原价。

0.0
ContractActivityboolean

命中合同优惠。

false
StandDiscountPricedouble

优惠价格。

451.00
ContractActivityboolean

命中合同优惠。

false
OptionalPromotionsarray<object>

可选择的优惠选项列表结果。

OptionalPromotionobject
ActivityCategorystring

活动类型。

discount
ActivityExtInfoobject

活动额外信息。

{ "activityId": "1512010241743170" }
CanPromFeedouble

可优惠价格

4560789
OptionCodestring

优惠类型。

wanhua_activity
PromotionNamestring

优惠名称。

【xxx月降价项目】MongoDB全规格--xxx
PromotionOptionNostring

优惠号。

1512010241xxxxx
Selectedboolean

是否外部选中。

false
Showboolean

优惠是否展示。

true
TargetArticleItemCodesarray

目标商品规格 code 列表。

targetArticleItemCodestring

目标商品规格 code。

""
PromotionRuleIdListarray

优惠 id 列表。

promotionRuleIdstring

优惠 id。

43289909
PromDetailListarray<object>

优惠明细信息。

PromDetailobject

优惠信息。

FinalPromFeedouble

优惠金额。

0.0
ActivityExtInfoobject

活动额外信息。

{ "activityId": "1512010241743170" }
OptionCodestring

优惠券代号。

youhui_quan
PromTypestring

优惠子类型。

discount
PromotionIdlong

优惠 ID。

233xxxxx
PromotionNamestring

优惠活动名称。

【xxxx-x月降价项目】MongoDB全规格--xxxxx
PromotionCodestring

优惠码。

ali-wood
DerivedPromTypestring

优惠子类型。

subPrice
StandDiscountPricedouble

折扣价。

8687
StandPricedouble

折扣价。

62982
IsContractActivityboolean

命中合同优惠。

false
TraceIdstring

调用链 ID。

27227A3D-6B87-56F3-9E03-9E60F001****
OrderParamsstring

订单参数。

说明 仅当 OrderParamOut 参数传入 true 时,返回该参数。
{\"autoPay\":false}"
Rulesarray<object>

活动规则列表。

Ruleobject

活动规则信息。

RuleDescIdlong

策略 ID。

2075****
Titlestring

规则标题。

demo
Namestring

规则名称。

demoname

示例

正常返回示例

JSON格式

{
  "Order": {
    "Coupons": {
      "Coupon": [
        {
          "Description": "ceshi",
          "IsSelected": "true",
          "CouponNo": "youhuiquan_promotion_option_id_for_blank",
          "Name": "youhuiquan111",
          "PromotionRuleIdList": {
            "PromotionRuleId": [
              0
            ]
          },
          "PromotionOptionCode": "youhui_quan",
          "OptionCode": "youhui_quan",
          "ActivityCategory": "payondemand"
        }
      ]
    },
    "OriginalAmount": "322.4",
    "DiscountAmount": "322.4",
    "RuleIds": {
      "RuleId": [
        "{ \"RuleId\": [ 2075**** ] }"
      ]
    },
    "TradeAmount": "0",
    "Currency": "USD",
    "ShowDiscountInfo": true,
    "OptionalPromotions": "\"[{\\\"activityCategory\\\":\\\"discount\\\",\\\"activityExtInfo\\\":{\\\"noUseYouhuiquan\\\":\\\"true\\\",\\\"activityId\\\":\\\"191156098xxxx\\\",\\\"activityExtraAttr\\\":\\\"{\\\\\\\"forbiddenCpsProfit\\\\\\\":\\\\\\\"true\\\\\\\",\\\\\\\"forbiddenCouponsRestricted\\\\\\\":\\\\\\\"true\\\\\\\",\\\\\\\"forbiddenAmbassadorProfit\\\\\\\":\\\\\\\"true\\\\\\\"}\\\",\\\"isActivityIdFromWanHuaTong\\\":\\\"true\\\",\\\"isContractActivity\\\":\\\"false\\\"},\\\"canPromFee\\\":906130,\\\"optionCode\\\":\\\"wanhua_activity\\\",\\\"promotionName\\\":\\\"FY24--MongoDB 副本集--首购--1年*折--ft首购权益\\\",\\\"promotionOptionNo\\\":\\\"19115609882xxxx\\\",\\\"promotionRuleIdList\\\":[2091xxxx],\\\"selected\\\":true,\\\"targetArticleItemCodes\\\":[]},{\\\"activityCategory\\\":\\\"discount\\\",\\\"activityExtInfo\\\":{\\\"activityId\\\":\\\"1018040010xxxxx\\\",\\\"wanHuaOrderExpireSec\\\":\\\"604800\\\",\\\"isActivityIdFromWanHuaTong\\\":\\\"true\\\",\\\"isContractActivity\\\":\\\"false\\\"},\\\"canPromFee\\\":339799,\\\"optionCode\\\":\\\"wanhua_activity\\\",\\\"promotionName\\\":\\\"FY24--MongoDB年付折扣\\\",\\\"promotionOptionNo\\\":\\\"10180400107xxxxx\\\",\\\"promotionRuleIdList\\\":[xxxxx],\\\"selected\\\":false,\\\"targetArticleItemCodes\\\":[]}]\"",
    "PromDetailList": "[{\\\"finalPromFee\\\":90xxx,\\\"optionCode\\\":\\\"wanhua_activity\\\",\\\"promType\\\":\\\"discount\\\",\\\"promotionId\\\":2091xxxx,\\\"promotionName\\\":\\\"新用户购买云数据库 MongoDB 副本集1年享*折优惠,限1台\\\"}]\"",
    "DepreciateInfo": {
      "ListPrice": 0,
      "OriginalStandAmount": 0,
      "CheapStandAmount": 0,
      "CheapRate": 0,
      "Differential": 0,
      "DifferentialName": "XXXXX",
      "MonthPrice": 0,
      "IsContractActivity": false,
      "IsShow": "true",
      "ContractActivity": {
        "FinalPromFee": 3621.6,
        "FinalFee": 20522.4,
        "ProdFee": 24144,
        "ActivityId": 0,
        "OptionCode": "wanhua_activity",
        "ActivityName": "合同优惠_整单_xxx折",
        "OptionIds": {
          "OptionId": [
            0
          ]
        }
      }
    },
    "StandDiscountPrice": 0,
    "StandPrice": 0,
    "ContractActivity": false,
    "Code": "\"\"",
    "Message": "\"\"",
    "IsContractActivity": false
  },
  "RequestId": "27227A3D-6B86-56F3-9E03-9E60F001CE12",
  "SubOrders": {
    "SubOrder": [
      {
        "OriginalAmount": "322.4",
        "DiscountAmount": "322.4",
        "RuleIds": {
          "RuleId": [
            "{ \"RuleId\": [ 2075**** ] }"
          ]
        },
        "TradeAmount": "0",
        "InstanceId": "dds-bp1b6e54e7cc****",
        "DepreciateInfo": {
          "ListPrice": 0,
          "OriginalStandAmount": 0,
          "CheapStandAmount": 0,
          "CheapRate": 0,
          "Differential": 0,
          "DifferentialName": "XXXXX",
          "MonthPrice": 0,
          "IsContractActivity": false,
          "IsShow": "true",
          "ContractActivity": {
            "FinalPromFee": 3621.6,
            "FinalFee": 20522.4,
            "ProdFee": 24144,
            "ActivityId": 0,
            "OptionCode": "wanhua_activity",
            "ActivityName": "合同优惠_整单_xxx折",
            "OptionIds": {
              "OptionId": [
                0
              ]
            }
          },
          "StartTime": "2024-02-29 10:30:00"
        },
        "IsNewOfficialActivity": "命中降价优惠。",
        "ModuleInstance": {
          "ModuleInstance": [
            {
              "CycleFee": "0.0",
              "PromDetailList": {
                "PromDetail": [
                  {
                    "FinalPromFee": 0,
                    "ActivityExtInfo": {
                      "activityId": "1512010241743170"
                    },
                    "OptionCode": "wanhua_activity",
                    "PromType": "discount",
                    "PromotionId": 0,
                    "PromotionName": "【xxxx-x月降价项目】MongoDB全规格--xxxxx",
                    "PromotionCode": "aliwood-xxx",
                    "DerivedPromType": "subPrice"
                  }
                ]
              },
              "DepreciateInfo": {
                "ListPrice": 0,
                "OriginalStandAmount": 0,
                "CheapStandAmount": 0,
                "CheapRate": 0,
                "Differential": 0,
                "DifferentialName": "XXXXX",
                "MonthPrice": 0,
                "IsContractActivity": false,
                "IsShow": "true"
              },
              "DiscountFee": "0.0",
              "ModuleAttrs": {
                "moduleAttr": [
                  {
                    "Code": "dds_dbtype",
                    "Name": "MongoDB",
                    "Type": "3",
                    "Value": "MongoDB"
                  }
                ]
              },
              "ModuleCode": "dds_dbtype",
              "ModuleId": 0,
              "ModuleName": "数据库类型",
              "NeedOrderPay": true,
              "PayFee": 0,
              "PricingModule": false,
              "StandPrice": 0,
              "TotalProductFee": 0,
              "ContractActivity": false,
              "StandDiscountPrice": 451
            }
          ]
        },
        "ContractActivity": false,
        "OptionalPromotions": {
          "OptionalPromotion": [
            {
              "ActivityCategory": "discount",
              "ActivityExtInfo": {
                "activityId": "1512010241743170"
              },
              "CanPromFee": 4560789,
              "OptionCode": "wanhua_activity",
              "PromotionName": "【xxx月降价项目】MongoDB全规格--xxx",
              "PromotionOptionNo": "1512010241xxxxx",
              "Selected": false,
              "Show": true,
              "TargetArticleItemCodes": {
                "targetArticleItemCode": [
                  "\"\""
                ]
              },
              "PromotionRuleIdList": {
                "promotionRuleId": [
                  "43289909"
                ]
              }
            }
          ]
        },
        "PromDetailList": {
          "PromDetail": [
            {
              "FinalPromFee": 0,
              "ActivityExtInfo": {
                "activityId": "1512010241743170"
              },
              "OptionCode": "youhui_quan",
              "PromType": "discount",
              "PromotionId": 0,
              "PromotionName": "【xxxx-x月降价项目】MongoDB全规格--xxxxx",
              "PromotionCode": "ali-wood",
              "DerivedPromType": "subPrice"
            }
          ]
        },
        "StandDiscountPrice": 8687,
        "StandPrice": 62982,
        "IsContractActivity": false
      }
    ]
  },
  "TraceId": "27227A3D-6B87-56F3-9E03-9E60F001****",
  "OrderParams": "{\\\"autoPay\\\":false}\"",
  "Rules": {
    "Rule": [
      {
        "RuleDescId": 0,
        "Title": "demo",
        "Name": "demoname"
      }
    ]
  }
}

错误码

HTTP status code错误码错误信息
400MissingParameterPeriod is mandatory for this action.
400MissingParameterDBInstanceId is mandatory for this action.
400InvalidParamSpecified parameter Period is not valid.
400OriginPriceErrorOrigin price error.

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

变更历史

变更时间变更内容概要操作
2024-05-10OpenAPI 描述信息更新、OpenAPI 错误码发生变更、OpenAPI 返回结构发生变更查看变更详情
2024-05-09OpenAPI 错误码发生变更、OpenAPI 返回结构发生变更查看变更详情
2024-04-07OpenAPI 错误码发生变更、OpenAPI 返回结构发生变更查看变更详情
2024-03-05OpenAPI 错误码发生变更、OpenAPI 返回结构发生变更查看变更详情
2024-02-28OpenAPI 错误码发生变更、OpenAPI 返回结构发生变更查看变更详情
2024-01-31OpenAPI 错误码发生变更、OpenAPI 返回结构发生变更查看变更详情
2023-09-11OpenAPI 错误码发生变更、OpenAPI 返回结构发生变更查看变更详情