文档首页 > > API参考> 管理包周期订单> 根据产品规格查询价格

根据产品规格查询价格

分享
更新时间: 2020/01/10 GMT+08:00

功能介绍

客户自建平台根据产品目录,获取不同规格产品对应的华为云官网价格。

注意事项:

  • 新订购产品,或者续订产品,均可以调用该接口询价。
  • 该接口可以使用客户AK/SK或者Token调用。

URI

POST /v1.0/{domain_id}/customer/product-mgr/query-rating

参数说明请参见表1

表1 URI参数说明

参数

是否必选

取值范围

描述

domain_id

最大长度:64

客户账号ID。获取方法请参见如何获取customer_id/domain_id

请求消息

请求参数

参数

是否必选

参数类型

取值范围

描述

tenantId

String

最大长度:128

项目ID。

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

regionId

String

最大长度:128

区域ID。

取值为地区和终端节点中查询的对应云服务的“区域”列的值。

avaliableZoneId

String

最大长度:128

AvalibleZoneID,可用区ID。

chargingMode

Integer

[0|1|2|10]

计费模式:

  • 0:包周期
  • 1:按需
  • 2:一次性(指下单完成后,会进行一次性服务,服务完成后即结束。如安全专家服务、硬件安装服务等);
  • 10:预留实例。

periodType

Integer

[0-5]

订购周期类型:

  • 0:天
  • 1:周
  • 2:月
  • 3:年
  • 4:小时
  • 5:绝对时间

包周期计费询价必填。

periodNum

Integer

[1-最大整数]

订购周期数。

包周期计费,且订购周期类型非5时必填。

periodEndDate

String

最大长度:40

到期时间。

包周期云服务器追加云硬盘或者包周期共享带宽新增弹性IP时,填写云服务器或共享带宽的到期时间。

包周期计费,且订购周期类型为5时必填。

UTC时间,格式:yyyy-MM-dd'T'HH:mm:ss'Z',如“2019-05-06T08:05:01Z”。

其中,HH范围是0~23,mm和ss范围是0~59。

为空的时候默认当前时间。

relativeResourceId

String

最大长度:64

关联资源标识。

包周期云服务器追加云硬盘或者包周期共享带宽新增弹性IP时,填写云服务器或共享带宽的实例标识。

relativeResourcePeriodType

Integer

[0-4]

关联资源周期类型:

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

传关联资源标识时必填。

subscriptionNum

Integer

[1-10000]

订购数量。

预留字段,当前默认为1。

productInfos

List<ProductInfo>

-

产品信息。

具体请参见表2

inquiryTime

String

最大长度:40

询价时间。

UTC时间,格式:yyyy-MM-dd'T'HH:mm:ss'Z',如“2019-05-06T08:05:01Z”。

为空的时候默认当前时间。

表2 ProductInfo

参数

是否必选

参数类型

取值范围

描述

id

String

最大长度:128

ID标识。

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

cloudServiceType

String

最大长度:400

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

resourceType

String

最大长度:400

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

resourceSpecCode

String

最大长度:400

云服务产品的资源规格,例如VM的资源规格举例为“s2.small.1.linux”。具体请参见对应云服务的相关介绍。

resourceSize

Integer

[1-最大整数]

资源容量大小,与“resouceSizeMeasureId”配合。

例如购买的卷大小或带宽大小。

resouceSizeMeasureId

Integer

-

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

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

usageFactor

String

最大长度:400

使用量因子。

按需计费必填。

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

  • 云服务器:Duration
  • 云硬盘:Duration
  • 弹性IP:Duration
  • 带宽:Duration(按带宽询价)或upflow(按流量询价)
  • 市场镜像:Duration

usageValue

Double

最大值:99999999999

使用量值。

按需询价必填。

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

usageMeasureId

Integer

-

使用量单位标识。

按需询价必填。

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

枚举值如下:

  • 4:小时
  • 10:GB(带宽按流量询价使用)
  • 11:MB(带宽按流量询价使用)
  • 13:Byte(带宽按流量询价使用)

extendParams

String/JSON

最大长度:10240

扩展参数,可空。

请求示例

POST https://bss.myhuaweicloud.com/v1.0/{domain_id}/customer/product-mgr/query-rating  HTTP/1.1
Content-Type: application/json
X-Auth-TokenMIIPAgYJKoZIhvcNAQcCo...ggg1BBIINPXsidG9rZ

{
    "regionId": "cn-north-1",
    "tenantId": "74610f3a5ad941998e91f076297ecf27",
    "chargingMode": 0,
    "periodType": 2,
    "periodNum": 1,
    "subscriptionNum": 1,
    "periodEndDate": "",
    "productInfos": [
        {
            "id": "1",
            "cloudServiceType": "hws.service.type.ec2",
            "resourceType": "hws.resource.type.vm",
            "resourceSpecCode": "s2.small.1.linux"
        },
        {
            "id": "2",
            "cloudServiceType": "hws.service.type.ebs",
            "resourceType": "hws.resource.type.volume",
            "resourceSpecCode": "SATA",
            "resourceSize": 1,
            "resouceSizeMeasureId": 17
        },
        {
            "id": "3",
            "cloudServiceType": "hws.service.type.vpc",
            "resourceType": "hws.resource.type.ip",
            "resourceSpecCode": "5_bgp"
        },
        {
            "id": "4",
            "cloudServiceType": "hws.service.type.vpc",
            "resourceType": "hws.resource.type.bandwidth",
            "resourceSpecCode": "19_bgp",
            "resourceSize": 1,
            "resouceSizeMeasureId": 15
        }
    ],
    "inquiryTime": ""
}

响应消息

响应参数

参数

参数类型

描述

error_code

String

状态码。

具体请参见状态码

error_msg

String

错误描述信息。

ratingResult

RatingResult

询价结果。

具体请参见表3

表3 RatingResult

参数

参数类型

取值范围

描述

amount

Double

-

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

discountAmount

Double

-

订单优惠额。

originalAmount

Double

-

订单原总额,即优惠前订单总额。

measureId

Integer

-

度量单位标识:

  • 1:元
  • 2:角
  • 3:分

currency

String

最大长度:10

货币单位代码(遵循ISO 4217标准)。

CNY:人民币

值为空代表人民币。

productRatingResult

List<ProductRatingResult>

-

产品询价结果。

具体请参见表4

extendParams

String/JSON

最大长度:1024

扩展参数。

表4 ProductRatingResult

参数

参数类型

取值范围

描述

id

String

最大长度:36

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

productId

String

最大长度:64

产品ID。

amount

Double

-

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

originalAmount

Double

-

产品原总金额。

discountAmount

Double

-

优惠额。

measureId

Integer

-

度量单位标识:

  • 1:元
  • 2:角
  • 3:分

extendParams

String/JSON

最大长度:1024

扩展参数。

响应示例

HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8
Content-Length: length
Date: response time  

{
    "ratingResult": {
        "amount": 55.5,
        "discountAmount": 0,
        "originalAmount": 55.5,
        "measureId": 1,
        "currency": null,
        "extendParams": null,
        "productRatingResult": [
            {
                "id": "1",
                "productId": "00301-52002-0--0",
                "amount": 32.2,
                "discountAmount": 0,
                "originalAmount": 32.2,
                "measureId": 1,
                "extendParams": null
            },
            {
                "id": "2",
                "productId": "d5d5ba12f9ed4d0f997ab48464133d24",
                "amount": 0.3,
                "discountAmount": 0,
                "originalAmount": 0.3,
                "measureId": 1,
                "extendParams": null
            },
            {
                "id": "3",
                "productId": "da27d47d84ff4adba7de3ca3b0c9ce08",
                "amount": 0,
                "discountAmount": 0,
                "originalAmount": 0,
                "measureId": 1,
                "extendParams": null
            },
            {
                "id": "4",
                "productId": "60564b0c1f484feaad26cda1acc6d4d8",
                "amount": 23,
                "discountAmount": 0,
                "originalAmount": 23,
                "measureId": 1,
                "extendParams": null
            }
        ]
    },
    "error_code": "CBC.0000",
    "error_msg": "Success"
}

状态码

状态码

描述

CBC.0000

成功。

CBC.6006

找不到您询价的产品。

如果报此错误,请检查请求参数中的“productInfos”中 “cloudServiceType”、“resourceType”、“resourceSpecCode”及其他参数是否填写正确。

CBC.0999

其他错误。

分享:

    相关文档

    相关产品

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

提交成功!

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

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

*必选

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

字符长度不能超过200

提交反馈 取消

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

跳转到云社区