調用DescribePrice介面查詢執行個體費用-ApsaraDB for MongoDB-阿里雲 - ApsaraDB for 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>	優惠券資訊列表。
	array<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
Effective	boolean	優惠券是否生效。	true
ActivityExtInfo	object	優惠券的額外資訊。
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\":\"新使用者購買ApsaraDB for 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>	優惠券對應的規則列表。
	array<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>	訂單行執行個體配置。
	array<object>	訂單行執行個體配置子物件。
CycleFee	string	模組的周期費。	0.0
PromDetailList	object
PromDetail	array<object>	優惠明細資訊。
	array<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	價格單位。	USD/Hour
ContractActivity	boolean	命中合約優惠。	false
OptionalPromotions	object
OptionalPromotion	array<object>	可選擇的優惠選項列表結果。
	array<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>	優惠明細資訊。
	array<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",
          "Effective": true,
          "ActivityExtInfo": {
            "test": "test",
            "test2": 1
          }
        }
      ]
    },
    "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\\\":\\\"新使用者購買ApsaraDB for 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": "USD/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.

訪問錯誤中心查看更多錯誤碼。

變更歷史

更多資訊，參考變更詳情。