文档首页 > > API参考> 管理交易> 购买云服务> 查询产品价格> 查询按需产品价格

查询按需产品价格

分享
更新时间: 2020/06/24 GMT+08:00

功能介绍

客户在自建平台按照条件查询按需产品的价格。

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

如果该租户享受多种折扣,系统会优先返回客户享受的商务折扣的折扣金额和最终成交价。

注意事项:

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

URI

POST /v2/bills/ratings/on-demand-resources

请求消息

请求参数

参数

是否必选

参数类型

取值范围

描述

project_id

String

最大长度:64

项目ID。

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

inquiry_precision

Integer

-

询价结果的精度模式。

  • 0:询价结果默认精度截取,即最长保留到元后6位小数点,如0.000001元
  • 1:询价结果保留10位精度,即最长保留到元后10位小数点,如1.0000000001元
说明:

如果询价结果只到元后2位或者3位,那么价格也只到元后2位或者3位,不管传0或者传1都一样,只有询价结果到了小数点后面6位以上,传0和传1才有区别。

product_infos

list<DemandProductInfo>

最大个数:100

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

表1 DemandProductInfo

参数

是否必选

参数类型

取值范围

描述

id

String

最大长度:64

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

cloud_service_type

String

最大长度:400

云服务类型编码,例如ECS的云服务类型编码为“hws.service.type.ec2”。具体请参见云服务类型

resource_type

String

最大长度:400

资源类型编码,例如ECS的VM为“hws.resource.type.vm”。具体请参见资源类型

ResourceType是CloudServiceType中的一种资源,CloudServiceType由多种ResourceType组合提供。

resource_spec

String

最大长度:400

云服务产品的资源规格。如果是VM的资源规格,则需要在规格后面添加“.win”或“.linux”,例如“s2.small.1.linux”。具体请参见对应云服务的相关介绍。

region

String

最大长度:64

云服务区编码,例如:“cn-north-1”。具体请参见地区和终端节点对应云服务的“区域”列的值。

available_zone

String

最大长度:64

可用区标识。

resource_size

Integer

-

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

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

size_measure_id

Integer

最大长度:4

资源容量度量标识,枚举值如下:

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

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

usage_factor

String

最大长度:64

使用量因子编码,取值和话单中的使用量因子一致,云服务和使用量因子对应关系举例如下:

  • 云服务器:Duration
  • 云硬盘:Duration
  • 弹性IP:Duration
  • 带宽:Duration或upflow
  • 市场镜像:Duration

具体每种云服务对应的计费因子,请联系云服务侧确认。

usage_value

BigDecimal

-

使用量值。

例如按小时询价,使用量值为1,使用量单位为小时。

usage_measure_id

Integer

最大长度:4

使用量单位标识。

例如按小时询价,使用量值为1,使用量单位为小时。

全量枚举如下:

  • 0:天(时长);
  • 1:元(货币);
  • 2:角(货币);
  • 3:分(货币);
  • 4:小时(时长);
  • 5:分钟(时长);
  • 6:秒(时长);
  • 7:EB(流量);
  • 8:PB(流量);
  • 9:TB(流量);
  • 10:GB(流量);
  • 11:MB(流量);
  • 12:KB(流量);
  • 13:Byte(流量);
  • 14:个(次)(数量);
  • 15:Mbps(流量);
  • 16:Byte(容量);
  • 17:GB(容量);
  • 18:KLOC(行数);
  • 19:年(周期);
  • 20:月(周期);
  • 21:MB(容量);
  • 22:赫兹(频率);
  • 23:核(数量);
  • 24:天(周期);
  • 25:小时(周期);
  • 30:个数(个数);
  • 31:千次(数量);
  • 32:百万次(数量);
  • 33:十亿次(数量);
  • 34:bps(带宽速率);
  • 35:kbps(带宽速率);
  • 36:Mbps(带宽速率);
  • 37:Gbps(带宽速率);
  • 38:Tbps(带宽速率);
  • 39:GB-秒(容量时长);
  • 40:次(数量);
  • 41:个(数量);
  • 42:千个(数量);
  • 43:张(数量);
  • 44:千张(数量);
  • 45:每秒查询率(查询速率);
  • 46:人/天(数量);
  • 47:TB(容量);
  • 48:PB(容量)。

具体每个云服务使用对应的单位,请联系云服务侧确认。

subscription_num

Integer

-

订购数量。

请求示例

POST https://bss.myhuaweicloud.com/v2/bills/ratings/on-demand-resources HTTP/1.1
Content-Type: application/json
X-Auth-TokenMIIPAgYJKoZIhvcNAQcCo...ggg1BBIINPXsidG9rZ
{
    "project_id": "84c53ec51e794a4888fb0f5c0cfb2420",
    "product_infos": [
        {
            "resource_size": 1,
            "subscription_num": 1,
            "size_measure_id": 0,
            "resource_type": "hws.resource.type.vm",
            "usage_factor": "Duration",
            "id": "516",
            "usage_value": 1,
            "usage_measure_id": 4,
            "region": "cn-north-1",
            "cloud_service_type": "hws.service.type.ec2",
            "resource_spec": "c3.large.2.linux"
        }
    ],
    "inquiry_precision": 1
}

响应消息

响应参数

参数

参数类型

取值范围

描述

error_code

String

最大长度:20

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

error_msg

String

最大长度:1000

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

amount

BigDecimal

-

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

discount_amount

BigDecimal

-

优惠额(官网价和总价的差)。

official_website_amount

BigDecimal

-

按需产品的官网价。

measure_id

Integer

最大长度:4

度量单位标识。

1:元

currency

String

最大长度:20

币种。

CNY:人民币。

值为空代表人民币。

product_rating_results

list<DemandProductRatingResult>

-

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

表2 DemandProductRatingResult

参数

参数类型

取值范围

描述

id

String

最大长度:64

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

product_id

String

最大长度:64

按需产品的ID。

amount

BigDecimal

-

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

discount_amount

BigDecimal

-

优惠额(官网价和总价的差)。

official_website_amount

BigDecimal

-

按需产品的官网价。

measure_id

Integer

最大长度:4

价格度量单位标识。

1:元

discount_rating_results

List<DemandDiscountRatingResult>

-

折扣优惠明细,包含产品本身的促销信息,同时包含商务或者伙伴折扣的优惠信息,具体参见表3

表3 DemandDiscount RatingResult

参数

参数类型

取值范围

描述

discount_id

String

最大长度:64

优惠标识ID。

discount_type

Integer

最大长度:4

折扣优惠类型。

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

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

amount

BigDecimal

-

折扣的金额。

measure_id

Integer

最大长度:4

度量单位标识。

1:元

discount_name

String

最大长度:256

折扣名称。

响应示例

HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8
Content-Length: length
Date: response time 
{
    "amount": 0.493,
    "discount_amount": 0.087,
    "official_website_amount": 0.58,
    "measure_id": 1,
    "currency": "CNY",
    "product_rating_results": [
        {
            "id": "516",
            "product_id": "OFFI469474107826130949",
            "amount": 0.493,
            "discount_amount": 0.087,
            "official_website_amount": 0.58,
            "measure_id": 1,
            "discount_rating_results": [
                {
                    "discount_id": "f4b258df36a2464f939bbb7e563519d4",
                    "discount_type": 607,
                    "amount": 0.087,
                    "measure_id": 1,
                    "discount_name": "Partner Discounts"
                }
            ]
        }
    ]
}

状态码

HTTP状态码

错误码

错误描述

500

CBC.0999

其他错误。

400

CBC.0100

参数错误。

403

CBC.0151

拒绝访问。

分享:

    相关文档

    相关产品

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

提交成功!

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

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

*必选

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

字符长度不能超过200

提交反馈 取消

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

智能客服提问云社区提问