根据产品规格查询价格（旧）
功能介绍
自建平台根据产品目录，获取不同规格产品对应的华为云官网价格。
注意事项：
- 新订购产品，或者续订产品，均可以调用该接口询价。
- 该接口可以使用客户AK/SK或者Token调用。
- 该接口不支持查询预留实例产品价格
请求消息
请求参数
|
参数 |
是否必选 |
参数类型 |
取值范围 |
描述 |
|---|---|---|---|---|
|
tenantId |
是 |
String |
最大长度：128 |
项目ID。 访问“我的凭证”页面，在“项目列表”页签，可以查看不同所属区域对应的项目ID。 |
|
regionId |
是 |
String |
最大长度：128 |
区域ID。 取值为地区和终端节点中查询的对应云服务的“区域”列的值。 |
|
avaliableZoneId |
否 |
String |
最大长度：128 |
AvalibleZoneID，可用区ID。 此参数不携带或携带值为空串或携带值为null时，不作为筛选条件。 |
|
chargingMode |
是 |
Integer |
[0|1|2] |
计费模式：
|
|
periodType |
否 |
Integer |
[0-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] |
关联资源周期类型：
传关联资源标识时必填。 当不满足上述条件时，此参数不携带或携带值为空串或携带值为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时，默认当前时间。 |
|
参数 |
是否必选 |
参数类型 |
取值范围 |
描述 |
|---|---|---|---|---|
|
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 |
- |
资源容量度量标识，枚举值如下：
此参数不携带或携带值为空串或携带值为null时，不作为筛选条件。 |
|
usageFactor |
否 |
String |
最大长度：400 |
使用量因子。 按需计费必填。 取值和话单中的使用量因子一致，云服务和使用量因子对应关系如下：
非按需计费时，此参数不携带或携带值为空串或携带值为null，不做筛选条件。 |
|
usageValue |
否 |
Double |
最大值：99999999999 |
使用量值。 按需询价必填。 例如按小时询价，使用量值为1，使用量单位为小时。 非按需计费时，此参数不携带或携带值为空串或携带值为null，不做筛选条件。 |
|
usageMeasureId |
否 |
Integer |
- |
使用量单位标识。 按需询价必填。 例如按小时询价，使用量值为1，使用量单位为小时。 枚举值如下：
非按需计费时，此参数不携带或携带值为空串或携带值为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 |
|
参数 |
参数类型 |
取值范围 |
描述 |
|---|---|---|---|
|
amount |
Double |
- |
订单总额，即最终优惠后的订单金额。 |
|
discountAmount |
Double |
- |
订单优惠额。 |
|
originalAmount |
Double |
- |
订单原总额，即优惠前订单总额。 |
|
measureId |
Integer |
- |
度量单位标识：
|
|
currency |
String |
最大长度：10 |
货币单位代码（遵循ISO 4217标准）。 CNY：人民币 值为空代表人民币。 |
|
productRatingResult |
List<ProductRatingResult> |
- |
产品询价结果。 具体请参见表4。 |
|
extendParams |
String/JSON |
最大长度：1024 |
扩展参数。 |
|
参数 |
参数类型 |
取值范围 |
描述 |
|---|---|---|---|
|
id |
String |
最大长度：36 |
ID标识，来源于请求中的ID。 |
|
productId |
String |
最大长度：64 |
产品ID。 |
|
amount |
Double |
- |
总额，即最终优惠后的金额。 |
|
originalAmount |
Double |
- |
产品原总金额。 |
|
discountAmount |
Double |
- |
优惠额。 |
|
measureId |
Integer |
- |
度量单位标识：
|
|
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 |
其他错误。 |
