文档首页 > > API参考> 管理交易> 购买云服务> 查询产品价格> 查询包年/包月产品价格

查询包年/包月产品价格

分享
更新时间: 2020/05/29 GMT+08:00

功能介绍

客户在自建平台按照条件查询包年/包月产品开通时候的价格。

如果购买该产品的客户享受折扣,可以在查询结果中返回折扣金额以及扣除折扣后的最后成交价。

如果该客户享受多种折扣,系统会返回每种折扣的批价结果。如果客户在下单的时候选择自动支付,则系统会优先应用商务折扣的批价结果。

注意事项:

该接口可以使用客户AK/SK或者Token调用

URI

POST /v2/bills/ratings/period-resources/subscribe-rate

请求消息

请求参数

参数

是否必选

参数类型

取值范围

描述

project_id

String

最大长度:64

项目ID。

访问“我的凭证”页面,在“项目列表”页签,可以查看不同所属区域对应的项目ID。

product_infos

list<PeriodProductInfo>

最大个数:100

产品信息列表,询价时要询价产品的信息的列表,具体参见表1

表1 PeriodProductInfo

参数

是否必选

参数类型

取值范围

描述

id

String

最大长度:64

ID标识,同一次询价中不能重复,用于标识返回询价结果和请求的映射关系。

cloud_service_type

String

最大长度:400

用户购买云服务产品的云服务类型,例如EC2,云服务类型为hws.service.type.ec2。

resource_type

String

最大长度:400

用户购买云服务产品的资源类型,例如EC2中的VM,资源类型为hws.resource.type.vm。ResourceType是CloudServiceType中的一种资源,CloudServiceType由多种ResourceType组合提供。

resource_spec

String

最大长度:400

用户购买云服务产品的资源规格。

例如VM的小型规格,资源规格为m1.tiny。

region

String

最大长度:64

云服务区编码。

available_zone

String

最大长度:64

可用区标识。

resource_size

Integer

-

资源容量大小,例如购买的卷大小或带宽大小。

只有线性产品才有这个字段。

size_measure_id

Integer

-

资源容量度量标识。

  • 15:Mbps(购买带宽时使用)
  • 17:GB(购买云硬盘时使用)
  • 14:个

只有线性产品才有这个字段。

period_type

Integer

[0-4]

订购包年/包月产品的周期类型。

  • 0:天
  • 1:周
  • 2:月
  • 3:年
  • 4:小时

period_num

Integer

-

订购包年/包月产品的周期数。

subscription_num

Integer

-

订购包年/包月产品的数量。

请求示例

POST https://bss.myhuaweicloud.com/v2/bills/ratings/period-resources/subscribe-rate HTTP/1.1
Content-Type: application/json
X-Auth-TokenMIIPAgYJKoZIhvcNAQcCo...ggg1BBIINPXsidG9rZ
{
  "project_id": "xxxxx",
  "product_infos": [
    {
      "id": "xxxxx",
      "cloud_service_type": "xxxxx",
      "resource_type": "xxxxx",
      "resource_spec": "xxxxx",
      "region": "xxxxx",
      "available_zone": "xxxxx",
      "resource_size": 0,
      "size_measure_id": 14,
      "period_type": 0,
      "period_num": 0,
      "subscription_num": 0
    }
  ]
}

响应消息

响应参数

参数

参数类型

取值范围

描述

error_code

String

最大长度:20

状态码。具体请参考状态码。只有失败才返回该字段。

error_msg

String

最大长度:1000

错误描述信息。只有失败才返回该字段。

official_website_rating_result

OfficialWebsiteRatingResult

-

包年/包月产品的官网价格查询结果,具体参见表2

optional_discount_rating_results

List<OptionalDiscountRatingResult>

-

存在可选折扣优惠时返回折扣优惠维度询价结果,每个折扣优惠一组询价结果,具体参见表4

currency

String

最大长度:20

币种。

CNY:人民币。

值为空代表人民币。

表2 OfficialWebsiteRatingResult

参数

参数类型

取值范围

描述

official_website_amount

BigDecimal

-

包年/包月产品的官网价格。

measure_id

Integer

最大长度:4

价格度量单位标识。

1:元

product_rating_results

List<PeriodProductOfficialRatingResult>

-

包年/包月产品的询价结果,具体参见表3

表3 PeriodProductOfficialRatingResult

参数

参数类型

取值范围

描述

id

String

最大长度:64

ID标识,来源于请求中的ID。

product_id

String

最大长度:64

包年/包月产品ID。

official_website_amount

BigDecimal

-

包年/包月产品的官网价格。

measure_id

Integer

最大长度:4

价格的度量单位标识。

1:元

表4 OptionalDiscountRatingResult

参数

参数类型

取值范围

描述

discount_id

String

最大长度:64

折扣优惠ID。

amount

BigDecimal

-

总额,即最终优惠后的金额。

amount= official_website_amount - discountAmount。

official_website_amount

BigDecimal

-

包年/包月产品的官网价。

discount_amount

BigDecimal

-

可选折扣优惠额,如商务折扣、伙伴折扣、促销折扣和折扣券选用时的优惠额。

measure_id

Integer

最大长度:4

价格度量单位标识。

1:元

discount_type

Integer

最大长度:32

折扣优惠类型。

  • 合同商务折扣:
    • 605:华为云BE场景下的合同商务折扣
    • 606:分销商BE场景下的合同商务折扣
  • 伙伴授予折扣:

    607:合作伙伴授予折扣-折扣率

discount_name

String

最大长度:256

折扣名称。

best_offer

Integer

-

是否为最优折扣。

  • 0:不是最优折扣,为缺省值。
  • 1:是最优折扣

    最优折扣:在商务折扣、伙伴折扣中选择(优惠金额最大的折扣为最优,优惠金额相等则按此顺序排优先级),促销折扣,折扣券不参与最优折扣的计算。

product_rating_results

List<PeriodProductRatingResult>

-

产品询价结果,具体参见表5

表5 PeriodProductRatingResult

参数

参数类型

取值范围

描述

id

String

最大长度:64

ID标识,来源于请求中的ID。

product_id

String

最大长度:64

包年/包月产品的ID。

amount

BigDecimal

-

总额,即最终优惠后的金额。

amount= official_website_amount - discountAmount。

official_website_amount

BigDecimal

-

包年/包月产品的官网价。

discount_amount

BigDecimal

-

可选折扣优惠额,如商务折扣、伙伴折扣、促销折扣和折扣券选用时的优惠额。

measure_id

Integer

最大长度:4

价格度量单位标识。

1:元

响应示例

HTTP/1.1 204 No Content
Content-Type: application/json;charset=UTF-8
Content-Length: length
Date: response time 
{
  "official_website_rating_result": {
    "official_website_amount": 0,
    "measure_id": 1,
    "product_rating_results": [
      {
        "id": "xxxxx",
        "product_id": "xxxxx",
        "official_website_amount": 0,
        "measure_id": 1
      }
    ]
  },
  "optional_discount_rating_results": [
    {
      "discount_id": "xxxxx",
      "amount": 0,
      "official_website_amount": 0,
      "discount_amount": 0,
      "measure_id": 1,
      "discount_type": 1,
      "discount_name": "xxxxx",
      "best_offer": 1,
      "product_rating_results": [
        {
          "id": "xxxxx",
          "product_id": "xxxxx",
          "amount": 5,
          "official_website_amount": 5,
          "discount_amount": 5,
          "measure_id": 1
        }
      ]
    }
  ],
  "currency": "xxxxx"
}

状态码

HTTP状态码

错误码

错误描述

500

CBC.0999

其他错误。

400

CBC.0100

输入参数校验失败。

403

CBC.0151

拒绝访问。

分享:

    相关文档

    相关产品

文档是否有解决您的问题?

提交成功!

非常感谢您的反馈,我们会继续努力做到更好!

反馈提交失败,请稍后再试!

*必选

请至少选择或填写一项反馈信息

字符长度不能超过200

提交反馈 取消

如您有其它疑问,您也可以通过华为云社区问答频道来与我们联系探讨

智能客服提问云社区提问