调用DescribePrice接口查询实例费用-云数据库 MongoDB 版-阿里云

询价

调试

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

调试

授权信息

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

操作：是指具体的权限点。
访问级别：是指每个操作的访问级别，取值为写入（Write）、读取（Read）或列出（List）。
资源类型：是指操作中支持授权的资源类型。具体说明如下：
- 对于必选的资源类型，用前面加 * 表示。
- 对于不支持资源级授权的操作，用全部资源表示。
条件关键字：是指云产品自身定义的条件关键字。
关联操作：是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限，操作才能成功。

操作

访问级别

资源类型

条件关键字

关联操作

dds:DescribePrice

get

*全部资源

*

无

请求参数

名称	类型	必填	描述	示例值
RegionId	string	否	地域 ID，您可以调用 DescribeRegions 接口查询地域 ID。	cn-hangzhou
OrderType	string	是	订单类型，取值说明： BUY：创建实例。 UPGRADE：变更配置。 RENEW：续费实例。	BUY
DBInstances	string	是	包含实例中多个信息的 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" } ]
CommodityCode	string	否	集群代码，取值说明： dds：副本集版按量付费。 badds: 副本集版包年包月。 dds_sharding: 分片集群版按量付费。 badds_sharding：分片集群版包年包月。 badds_sharding_intl：分片集群版包年包月（国际站）。 dds_sharding_intl：分片集群版按量付费（国际站）。 badds_sharding_jp：分片集群版包年包月（日本站）。 badds_intl：副本集版包年包月（国际站）。 dds_intl：副本集版按量付费（国际站）。	badds
ProductCode	string	否	产品代码，默认为 dds。	dds
BusinessInfo	string	否	附加参数，业务信息。	{"AccountPassword":"Pw123456","DBInstanceDescription":"test"}
CouponNo	string	否	是否使用优惠券，取值说明： default 或 null（默认）：使用优惠券。 youhuiquan_promotion_option_id_for_blank：不使用优惠券。	default
OrderParamOut	string	否	是否返回订单参数，取值说明： false（默认值）：不返回。 true：返回。	true
ResourceGroupId	string	否	资源组 ID。资源组详情请参见查看资源组基本信息。	rg-acfmyiu4ekp****

返回参数

名称	类型	描述	示例值
	object	订单信息列表。
Order	object	订单信息列表。
Coupons	object
Coupon	array<object>	优惠券信息列表。
	object	订单优惠券信息。
Description	string	备注。	ceshi
IsSelected	string	是否选中该优惠券，取值说明： true：选中优惠券。 false：不选中优惠券。	true
CouponNo	string	优惠券编码。	youhuiquan_promotion_option_id_for_blank
Name	string	优惠券名称。	youhuiquan111
PromotionRuleIdList	object
PromotionRuleId	array	优惠券对应的规则 ID 列表。
	integer	优惠券对应的规则 ID。	18772041****
PromotionOptionCode	string	促销信息，促销选项代码。	youhui_quan
OptionCode	string	优惠券代号。	youhui_quan
ActivityCategory	string	优惠券的活动类型，取值说明： payondemand：预付费。 payasyougo：后付费。	payondemand
OriginalAmount	string	订单原价。	322.4
DiscountAmount	string	订单优惠金额。	322.4
RuleIds	object
RuleId	array	订单规则信息。
	string	活动规则 ID 合集。	{ "RuleId": [ 2075**** ] }
TradeAmount	string	订单实际交易价。	0
Currency	string	币种。	USD
ShowDiscountInfo	boolean	是否展示折扣信息。	true
OptionalPromotions	string	优惠活动信息列表。	"[{\"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	string	命中的优惠活动。	[{\"finalPromFee\":90xxx,\"optionCode\":\"wanhua_activity\",\"promType\":\"discount\",\"promotionId\":2091xxxx,\"promotionName\":\"新用户购买云数据库 MongoDB 副本集1年享*折优惠，限1台\"}]"
DepreciateInfo	object	降价信息。
ListPrice	number	目录价。	1*
OriginalStandAmount	number	原始官网总价。	12*
CheapStandAmount	number	降价后官网总价。	9*
CheapRate	number	降价比例。	30%
Differential	number	差价优惠（订单总价展示）。	**
DifferentialName	string	差价优惠名称。	XXXXX
MonthPrice	number	折合月价。	**
IsContractActivity	boolean	命中合同优惠。	false
IsShow	string	是否展示降价幅度。	true
ContractActivity	object	合同优惠。
FinalPromFee	number	优惠总费用。	3621.6
FinalFee	number	优惠后费用。	20522.4
ProdFee	number	原价。	24144.0
ActivityId	integer	活动 id。	41120065996xxxxx
OptionCode	string	优惠 id。	wanhua_activity
ActivityName	string	活动名称。	合同优惠_整单_xxx折
OptionIds	object
OptionId	array	优惠 id 列表。
	integer	优惠 id	200000614xxxx
StandDiscountPrice	number	折扣价格。	0
StandPrice	number	折扣价。	0
ContractActivity	boolean	命中合同优惠。	false
Code	string	订单码	""
Message	string	订单信息	""
IsContractActivity	boolean	命中合同优惠。	false
TotalCostAmount	number	订单聚合价格	483.14
RequestId	string	请求 ID。	27227A3D-6B86-56F3-9E03-9E60F001CE12
SubOrders	object
SubOrder	array<object>	优惠券对应的规则列表。
	object	优惠券规则信息。
OriginalAmount	string	订单原价。	322.4
DiscountAmount	string	订单优惠金额。	322.4
RuleIds	object
RuleId	array	活动规则列表。
	string	活动规则 ID 合集。	{ "RuleId": [ 2075**** ] }
TradeAmount	string	订单实际交易价格。	0
InstanceId	string	实例 ID。	dds-bp1b6e54e7cc****
DepreciateInfo	object	降价信息。
ListPrice	number	目录价。	1*
OriginalStandAmount	number	原始官网总价。	12*
CheapStandAmount	number	降价后官网总价。	9*
CheapRate	number	降价比例。	30%
Differential	number	差价优惠（订单总价展示）。	**
DifferentialName	string	差价优惠名称。	XXXXX
MonthPrice	number	折合月价。	**
IsContractActivity	boolean	命中合同优惠。	false
IsShow	string	是否展示降价幅度。	true
ContractActivity	object	活动信息。
FinalPromFee	number	优惠总费用。	3621.6
FinalFee	number	优惠后费用。	20522.4
ProdFee	number	原价。	24144.0
ActivityId	integer	活动 ID。	41120065996xxxxx
OptionCode	string	优惠 ID。	wanhua_activity
ActivityName	string	活动名称。	合同优惠_整单_xxx折
OptionIds	object
OptionId	array	优惠 ID 列表。
	integer	优惠 ID。	2388xxxx
StartTime	string	活动开始时间。	2024-02-29 10:30:00
IsNewOfficialActivity	string	命中降价优惠。	命中降价优惠。
ModuleInstance	object
ModuleInstance	array<object>	订单行实例配置。
	object	订单行实例配置子对象。
CycleFee	string	模块的周期费。	0.0
PromDetailList	object
PromDetail	array<object>	优惠明细信息。
	object	优惠信息。
FinalPromFee	number	优惠金额。	0.0
ActivityExtInfo	object	优惠详情额外信息。	{ "activityId": "1512010241743170" }
OptionCode	string	优惠券商品 Code。	wanhua_activity
PromType	string	优惠子类型。	discount
PromotionId	integer	优惠活动 ID。	8105187xxxx
PromotionName	string	促销活动名称。	【xxxx-x月降价项目】MongoDB全规格--xxxxx
PromotionCode	string	优惠码。	aliwood-xxx
DerivedPromType	string	优惠子类型。	subPrice
DepreciateInfo	object	活动信息。
ListPrice	number	目录价。	1*
OriginalStandAmount	number	原始官网总价。	12*
CheapStandAmount	number	降价后官网总价。	9*
CheapRate	number	降价比例。	30%
Differential	number	差价优惠（订单总价展示）。	**
DifferentialName	string	差价优惠名称。	XXXXX
MonthPrice	number	折合月价。	**
IsContractActivity	boolean	命中合同优惠。	false
IsShow	string	是否展示降价幅度。	true
DiscountFee	string	折扣费用。	0.0
ModuleAttrs	object
moduleAttr	array<object>	模块属性。
	object	订购参数。
Code	string	属性代码。	dds_dbtype
Name	string	属性名称。	MongoDB
Type	string	属性类型。	3
Value	string	属性值。	MongoDB
ModuleCode	string	模块 code。	dds_dbtype
ModuleId	integer	模块 Id。	1017110000415xxx
ModuleName	string	模块名称。	数据库类型
NeedOrderPay	boolean	在订单中是否需要支付。	true
PayFee	number	实付金额。	0.0
PricingModule	boolean	是否计价项	false
StandPrice	number	折扣价。	0
TotalProductFee	number	产品原价。	0.0
ContractActivity	boolean	命中合同优惠。	false
StandDiscountPrice	number	优惠价格。	451.00
priceUnit	string	价格单位。	xxxx
priceType	string	价格类型。	monthPrice
UnitPriceUnit4Buy	string	价格单位。	CNY/Hour
ContractActivity	boolean	命中合同优惠。	false
OptionalPromotions	object
OptionalPromotion	array<object>	可选择的优惠选项列表结果。
	object
ActivityCategory	string	活动类型。	discount
ActivityExtInfo	object	活动额外信息。	{ "activityId": "1512010241743170" }
CanPromFee	number	可优惠价格	4560789
OptionCode	string	优惠类型。	wanhua_activity
PromotionName	string	优惠名称。	【xxx月降价项目】MongoDB全规格--xxx
PromotionOptionNo	string	优惠号。	1512010241xxxxx
Selected	boolean	是否外部选中。	false
Show	boolean	优惠是否展示。	true
TargetArticleItemCodes	object
targetArticleItemCode	array	目标商品规格 code 列表。
	string	目标商品规格 code。	""
PromotionRuleIdList	object
promotionRuleId	array	优惠 id 列表。
	string	优惠 id。	43289909
PromDetailList	object
PromDetail	array<object>	优惠明细信息。
	object	优惠信息。
FinalPromFee	number	优惠金额。	0.0
ActivityExtInfo	object	活动额外信息。	{ "activityId": "1512010241743170" }
OptionCode	string	优惠券代号。	youhui_quan
PromType	string	优惠子类型。	discount
PromotionId	integer	优惠 ID。	233xxxxx
PromotionName	string	优惠活动名称。	【xxxx-x月降价项目】MongoDB全规格--xxxxx
PromotionCode	string	优惠码。	ali-wood
DerivedPromType	string	优惠子类型。	subPrice
StandDiscountPrice	number	折扣价。	8687
StandPrice	number	折扣价。	62982
IsContractActivity	boolean	命中合同优惠。	false
TraceId	string	调用链 ID。	27227A3D-6B87-56F3-9E03-9E60F001****
OrderParams	string	订单参数。说明仅当 OrderParamOut 参数传入 true 时，返回该参数。	{\"autoPay\":false}"
Rules	object
Rule	array<object>	活动规则列表。
	object	活动规则信息。
RuleDescId	integer	策略 ID。	2075****
Title	string	规则标题。	demo
Name	string	规则名称。	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,
    "TotalCostAmount": 483.14
  },
  "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,
              "priceUnit": "xxxx",
              "priceType": "monthPrice",
              "UnitPriceUnit4Buy": "CNY/Hour"
            }
          ]
        },
        "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	错误码	错误信息
400	MissingParameter	Period is mandatory for this action.
400	InvalidParam	Specified parameter Period is not valid.
400	OriginPriceError	Origin price error.

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

变更历史

更多信息，参考变更详情。