文档

DescribeCommodityPrice - 查询全球加速商品的价格信息

更新时间:

调用DescribeCommodityPrice接口查询全球加速商品的价格信息。

接口说明

您可以通过调用 DescribeCommodity 查询商品模块信息。

调试

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

授权信息

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

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

请求参数

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

全球加速实例所属的地域 ID,仅取值:cn-hangzhou

cn-hangzhou
Ordersobject []

商品订单。

CommodityCodestring

商品 Code。

中国站示例值:

  • ga_gapluspre_public_cn:全球加速实例。

  • ga_plusbwppre_public_cn:基础带宽包。

国际站示例值:

  • ga_pluspre_public_intl:全球加速实例。

  • ga_bwppreintl_public_intl:基础带宽包。

ga_gapluspre_public_cn
OrderTypestring

订单类型。取值:

  • BUY:新购。
  • RENEW:续费。
  • UPGRADE:升级。
BUY
ChargeTypestring

计费方式。 取值 PREPAY,表示预付费。

PREPAY
PricingCyclestring

计费周期。取值:

  • Month:按月计费。
  • Year:按年计费。
Month
Durationlong

购买时长。

  • PricingCycle 取值 Month 时,Duration 取值范围为 1~9
  • PricingCycle 取值 Year 时,Duration 取值范围为 1~3
1
Quantitylong

购买数量。

1
Componentsobject []

商品模块信息。

不同商品模块,信息不同。

ComponentCodestring

商品模块 Code。

不同商品模块,信息不同。 例如:instance(全球加速实例)、购买时长(商品购买时长)。

instance
Propertiesobject []

商品模块属性。

不同商品模块,信息不同。

Codestring

商品模块属性 Code。

不同商品模块,信息不同。 例如:instance(全球加速实例)、ord_time(商品购买时长)。

instance
Valuestring

商品模块属性值。

不同商品模块,信息不同。 例如:instance_fee(全球加速实例费)、1:Month(购买时长为 1 个月)。

instance_fee
PromotionOptionNostring

优惠券号码。

说明 中国站不涉及该参数。
50003298014****

返回参数

名称类型描述示例值
object

返回参数列表。

Currencystring

货币单位。

  • 中国站:CNY

  • 国际站:USD

CNY
OriginalPricedouble

原价。

2099
DiscountPricedouble

折扣金额。

419.8
TradePricedouble

最终价,为原价减去折扣。

1679.2
OrderDetailsobject []

计价模块价格详情。

CommodityCodestring

商品 Code。

ga_gapluspre_public_cn
CommodityNamestring

商品名称。

全球加速_实例规格(包年包月)
OriginalPricedouble

原价。

2099
DiscountPricedouble

折扣金额。

419.8
TradePricedouble

最终价,为原价减去折扣。

1679.2
Quantitylong

购买数量。

1
ModuleDetailsobject []

模块价格信息。

ModuleCodestring

计价模块 Code。

spec
ModuleNamestring

计价模块名称。

规格
OriginalPricedouble

原价。

200000.0
DiscountPricedouble

折扣金额。

40000.0
TradePricedouble

优惠金额。

160000.0
RuleIdsarray

优惠规则 ID。

long

优惠规则 ID。

102104100786****
PromDetailsobject []

优惠细则。

说明 中国站不涉及该参数。
PromotionIdstring

优惠项 ID。

说明 中国站不涉及该参数。
50003298014****
PromotionNamestring

优惠项名称。

说明 中国站不涉及该参数。
coupon
FinalPromFeedouble

优惠价格。

说明 中国站不涉及该参数。
0.01
PromTypestring

优惠子类型。

说明 中国站不涉及该参数。
deduct
OptionCodestring

优惠选项 Code。

说明 中国站不涉及该参数。
youhui_quan
RuleDetailsobject []

优惠规则详情。

RuleIdstring

优惠规则 ID。

102104100786****
RuleNamestring

优惠规则名称。

GA新客户小型II规格月付-8折优惠
Promotionsobject []

优惠券列表。

说明 中国站不涉及该参数。
PromotionOptionNostring

优惠券号码。

说明
  • youhuiquan_promotion_option_id_for_blank代表不适用优惠券。
  • 中国站不涉及该参数。
  • 50003298014****
    PromotionNamestring

    优惠券名称。

    说明 中国站不涉及该参数。
    youhuiquan_promotion_option_id_for_blank
    CanPromFeedouble

    可优惠金额。

    说明 中国站不涉及该参数。
    0
    Selectedboolean

    是否被选中。

    • true:是。
    • false:否。
    说明 中国站不涉及该参数。
    false
    OptionCodestring

    优惠券商品 Code。

    说明 中国站不涉及该参数。
    youhui_quan
    RequestIdstring

    请求 ID。

    04F0F334-1335-436C-A1D7-6C044FE73368

    示例

    正常返回示例

    JSON格式

    {
      "Currency": "CNY",
      "OriginalPrice": 2099,
      "DiscountPrice": 419.8,
      "TradePrice": 1679.2,
      "OrderDetails": [
        {
          "CommodityCode": "ga_gapluspre_public_cn",
          "CommodityName": "全球加速_实例规格(包年包月)",
          "OriginalPrice": 2099,
          "DiscountPrice": 419.8,
          "TradePrice": 1679.2,
          "Quantity": 1,
          "ModuleDetails": [
            {
              "ModuleCode": "spec",
              "ModuleName": "规格",
              "OriginalPrice": 200000,
              "DiscountPrice": 40000,
              "TradePrice": 160000
            }
          ],
          "RuleIds": [
            0
          ],
          "PromDetails": [
            {
              "PromotionId": "50003298014****",
              "PromotionName": "coupon",
              "FinalPromFee": 0.01,
              "PromType": "deduct",
              "OptionCode": "youhui_quan"
            }
          ]
        }
      ],
      "RuleDetails": [
        {
          "RuleId": "102104100786****",
          "RuleName": "GA新客户小型II规格月付-8折优惠"
        }
      ],
      "Promotions": [
        {
          "PromotionOptionNo": "50003298014****",
          "PromotionName": "youhuiquan_promotion_option_id_for_blank",
          "CanPromFee": 0,
          "Selected": false,
          "OptionCode": "youhui_quan"
        }
      ],
      "RequestId": "04F0F334-1335-436C-A1D7-6C044FE73368"
    }

    错误码

    HTTP status code错误码错误信息描述
    400IllegalParameter.SpecThe specified Spec is invalid.入参Spec非法格式
    500UnknownErrorAn error occurred while processing your request. Please try again. If the error persists, please submit a ticket.处理请求时出现错误,请稍后重试。

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

    变更历史

    变更时间变更内容概要操作
    2023-04-13OpenAPI 错误码发生变更看变更集
    变更项变更内容
    错误码OpenAPI 错误码发生变更
      删除错误码:500
      新增错误码:400
    • 本页导读 (1)
    文档反馈