文档首页/ 合作伙伴中心/ API参考/ 待下线接口/ 管理产品/ 查询商品价格/ 根据产品规格查询价格（旧）

更新时间：2024-09-24 GMT+08:00

查看PDF

根据产品规格查询价格（旧）

功能介绍

伙伴销售平台根据产品目录，获取不同规格产品对应的华为云官网价格。

注意事项：

新订购产品，或者续订产品，均可以调用该接口询价。
该接口可以使用客户AK/SK或者Token调用，也可以使用合作伙伴AK/SK或者Token调用。
该接口不支持查询预留实例产品价格

该接口即将下线，“根据产品规格查询价格”新接口请参考查询按需产品价格和查询包年/包月产品价格。

URI

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

参数说明请参见表1。

表1 URI参数说明
参数	是否必选	取值范围	描述
domain_id	是	最大长度：64	如果使用合作伙伴AK/SK或者Token，此处为合作伙伴ID，获取方法请参见如何获取合作伙伴ID（partner_id）。如果使用客户AK/SK或者Token，此处为客户账号ID，您可以调用查询客户列表接口获取customer_id。

请求消息

请求参数

参数	是否必选	参数类型	取值范围	描述
tenantId	是	String	最大长度：128	项目ID。如果使用客户AK/SK或者Token，可以调用通过assume_role方式获取用户token接口获取“regionId”取值对应的project id。具体请参见如何将合作伙伴Token置换为客户Token的步骤2。如果使用合作伙伴AK/SK或者Token，参见如何获取合作伙伴ID（partner_id）进入“我的凭证”页面，在“项目列表”页签，可以查看不同所属区域对应的项目ID。
regionId	是	String	最大长度：128	区域ID。取值为地区和终端节点中查询的对应云服务的“区域”列的值。
avaliableZoneId	否	String	最大长度：128	AvalibleZoneID，可用区ID。此参数不携带或携带值为空串或携带值为null时，不作为筛选条件。
chargingMode	是	Integer	[0\|1\|2]	计费模式： 0：包年/包月； 1：按需； 2：一次性（指下单完成后，会进行一次性服务，服务完成后即结束。如安全专家服务、硬件安装服务等）；
periodType	否	Integer	[0-5]	订购周期类型： 0：天 2：月 3：年 4：小时 5：绝对时间当periodType为“5：绝对时间”的时候，追加产品的周期类型由relativeResourcePeriodType(即关联资源周期类型)的取值决定。包年/包月计费询价必填。当计费模式不为包年/包月时，此参数不携带或携带值为空串或携带值为null时，不作为筛选条件。
periodNum	否	Integer	[1-214783647]	订购周期数。包年/包月计费，且订购周期类型非5时必填。当不满足上述条件时，此参数不携带或携带值为空串或携带值为null时，不作为筛选条件。
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。为空的时候默认当前时间。此参数不携带或携带值为空串或携带值为null时，默认当前时间。
relativeResourceId	否	String	最大长度：64	关联资源标识。包年/包月云服务器追加云硬盘或者包年/包月共享带宽新增弹性IP时，填写云服务器或共享带宽的实例标识。当不满足上述条件时，此参数不携带或携带值为空串或携带值为null时，不作为筛选条件。
relativeResourcePeriodType	否	Integer	[0-4]	关联资源周期类型： 0：天 2：月 3：年 4：小时传关联资源标识时必填。当不满足上述条件时，此参数不携带或携带值为空串或携带值为null时，不作为筛选条件。
subscriptionNum	是	Integer	[1-10000]	订购数量。预留字段，当前默认为1。
productInfos	是	List<ProductInfo>	[1-100]	产品信息。具体请参见表2。
inquiryTime	否	String	最大长度：40	询价时间。 UTC时间，格式：yyyy-MM-dd'T'HH:mm:ss'Z'，如“2019-05-06T08:05:01Z”。为空的时候默认当前时间。此参数不携带或携带值为空串或携带值为null时，默认当前时间。

表2 ProductInfo
参数	是否必选	参数类型	取值范围	描述
id	是	String	最大长度：128	ID标识。同一次询价中不能重复，用于标识返回询价结果和请求的映射关系。
cloudServiceType	是	String	最大长度：400	云服务类型编码，例如OBS的云服务类型编码为“hws.service.type.obs”。您可以调用查询云服务类型列表接口获取。
resourceType	是	String	最大长度：400	资源类型编码，例如ECS的VM为“hws.resource.type.vm”。您可以调用查询资源类型列表接口获取。
resourceSpecCode	是	String	最大长度：400	云服务产品的资源规格。如果是VM的资源规格，则需要在规格后面添加“.win”或“.linux”，例如“s2.small.1.linux”。
resourceSize	否	Integer	[1-214783647]	资源容量大小，与“resouceSizeMeasureId”配合。例如购买的卷大小或带宽大小。此参数不携带或携带值为null时，不作为筛选条件；不支持携带值为空串。
resouceSizeMeasureId	否	Integer	-	资源容量度量标识，枚举值如下： 15：Mbps（购买带宽时使用） 17：GB（购买云硬盘时使用）此参数不携带或携带值为空串或携带值为null时，不作为筛选条件。
usageFactor	否	String	最大长度：400	使用量因子。按需计费必填。取值和话单中的使用量因子一致，云服务和使用量因子对应关系如下：云服务器：Duration 云硬盘：Duration 弹性IP：Duration 带宽：Duration（按带宽询价）或upflow（按流量询价）市场镜像：Duration 非按需计费时，此参数不携带或携带值为空串或携带值为null，不做筛选条件。
usageValue	否	Double	最大值：99999999999	使用量值。按需询价必填。例如按小时询价，使用量值为1，使用量单位为小时。非按需计费时，此参数不携带或携带值为空串或携带值为null，不做筛选条件。
usageMeasureId	否	Integer	-	使用量单位标识。按需询价必填。例如按小时询价，使用量值为1，使用量单位为小时。枚举值如下： 4：小时 10：GB（带宽按流量询价使用） 11：MB（带宽按流量询价使用） 13：Byte（带宽按流量询价使用）非按需计费时，此参数不携带或携带值为空串或携带值为null，不做筛选条件。
extendParams	否	String/JSON	最大长度：10240	扩展参数，可空。此参数不携带或携带值为空串或携带值为null，不做筛选条件。

请求示例

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

{
    "regionId": "cn-north-1",
    "tenantId": "74******cf27",
    "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

参数

参数类型

描述

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": "d5******24",
                "amount": 0.3,
                "discountAmount": 0,
                "originalAmount": 0.3,
                "measureId": 1,
                "extendParams": null
            },
            {
                "id": "3",
                "productId": "da27*****ce08",
                "amount": 0,
                "discountAmount": 0,
                "originalAmount": 0,
                "measureId": 1,
                "extendParams": null
            },
            {
                "id": "4",
                "productId": "605*****d4d8",
                "amount": 23,
                "discountAmount": 0,
                "originalAmount": 23,
                "measureId": 1,
                "extendParams": null
            }
        ]
    },
    "error_code": "CBC.0000",
    "error_msg": "Success"
}

状态码

状态码4xx：由于明显的客户端错误（例如，格式错误的请求语法、参数错误等），华为云会返回4xx错误码，请及时检查请求消息的正确性，重新发起请求。
状态码5xx：由于华为云系统原因，导致无法完成明显有效请求的处理，可及时联系华为云客服处理。

HTTP状态码	错误码	描述
200	CBC.0000	成功。
400	CBC.0100	参数错误。
403	CBC.0151	拒绝访问。
200	CBC.6006	找不到您询价的产品。如果报此错误，请检查请求参数中的“productInfos”中 “cloudServiceType”、“resourceType”、“resourceSpecCode”及其他参数是否填写正确。
200	CBC.6055	询价结果超过金额最大限制。
500	CBC.0999	其他错误。

父主题： 查询商品价格

上一篇：查询商品价格

下一篇：根据变更产品规格查询价格（旧）

意见反馈

文档内容是否对您有帮助？

有帮助没帮助

提供反馈

提交成功！非常感谢您的反馈，我们会继续努力做到更好！您可在我的云声建议查看反馈及问题处理状态。

系统繁忙，请稍后重试

在使用文档中是否遇到以下问题

内容与产品页面不一致

内容不易理解

缺失示例代码

步骤不可操作

搜不到想要的内容

缺少最佳实践

意见反馈（选填）

0/500

请至少选择一项反馈信息并填写问题反馈

字符长度不能超过500

直接提交取消

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

智能客服提问云社区提问

根据产品规格查询价格（旧）

功能介绍

URI

请求消息

响应消息

状态码

相关文档

意见反馈

文档内容是否对您有帮助？

7*24

备案

专业服务

退订

建议反馈

售前咨询热线