查询包年/包月产品价格
功能介绍
客户在自建平台按照条件查询包年/包月产品开通时候的价格。
如果购买该产品的客户享受折扣,可以在查询结果中返回折扣金额以及扣除折扣后的最后成交价。
如果该客户享受多种折扣,系统会返回每种折扣的批价结果。如果客户在下单的时候选择自动支付,则系统会优先应用商务折扣的批价结果。
接口约束
该接口可以使用客户AK/SK或者Token调用。
调试
您可以在API Explorer中调试该接口,支持自动认证鉴权。API Explorer可以自动生成SDK代码示例,并提供SDK代码示例调试功能。
URI
POST /v2/bills/ratings/period-resources/subscribe-rate
请求消息
请求参数
参数 |
是否必选 |
参数类型 |
取值范围 |
描述 |
---|---|---|---|---|
project_id |
是 |
String |
最大长度:64 |
项目ID。 |
product_infos |
是 |
List<PeriodProductInfo> |
最大个数:100 |
产品信息列表,询价时要询价产品的信息的列表,具体参见表1。 |
参数 |
是否必选 |
参数类型 |
取值范围 |
描述 |
---|---|---|---|---|
id |
是 |
String |
最大长度:64 |
ID标识,同一次询价中不能重复,用于标识返回询价结果和请求的映射关系。 |
cloud_service_type |
是 |
String |
最大长度:400 |
云服务类型编码,例如OBS的云服务类型编码为“hws.service.type.obs”。您可以调用查询云服务类型列表接口获取。 |
resource_type |
是 |
String |
最大长度:400 |
资源类型编码,例如ECS的VM为“hws.resource.type.vm”。您可以调用查询资源类型列表接口获取。 ResourceType是CloudServiceType中的一种资源,CloudServiceType由多种ResourceType组合提供。 |
resource_spec |
是 |
String |
最大长度:400 |
云服务类型的资源规格。详情请参见各云服务官方文档。 部分云服务类型和资源规格举例如下:
|
region |
是 |
String |
最大长度:64 |
云服务区编码,例如:“ap-southeast-1”。具体请参见地区和终端节点对应云服务的“区域”列的值。 |
period_type |
是 |
Integer |
[0-4] |
订购包年/包月产品的周期类型。
|
period_num |
是 |
Integer |
[1-214783647] |
订购包年/包月产品的周期数。 |
subscription_num |
是 |
Integer |
[1-10000] |
订购包年/包月产品的数量。 |
available_zone |
否 |
String |
最大长度:64 |
可用区标识,例如:“cn-north-1a”,大小写不敏感。具体请参见地区和终端节点可用分区的“可用分区名称”列的值。 此参数不携带或携带值为空串或携带值为null时,不作为筛选条件。 |
resource_size |
否 |
Integer |
[1-214783647] |
资源容量大小,例如购买的卷大小或带宽大小。 线性产品时此参数必填。线性产品为包括硬盘,带宽等在订购时需要指定大小的产品。例如硬盘在订购时需选择10G、20G等不同大小。 非线性产品时此参数不携带或者携带值为null时,不作为筛选条件。 |
size_measure_id |
否 |
Integer |
- |
资源容量度量标识。
线性产品时该参数必填。线性产品为包括硬盘,带宽等在订购时需要指定大小的产品。例如硬盘在订购时需选择10G、20G等不同大小。 非线性产品时此参数不携带或者携带值为null时,不作为筛选条件。 |
POST https://bss-intl.myhuaweicloud.com/v2/bills/ratings/period-resources/subscribe-rate HTTP/1.1 Content-Type: application/json X-Auth-Token:MIIPAgYJKoZIhvcNAQcCo...ggg1BBIINPXsidG9rZ { "project_id": "84c53ec51e794a4888fb0f5c0cfb2420", "product_infos": [ { "id": "1", "cloud_service_type": "hws.service.type.ec2", "resource_type": "hws.resource.type.vm", "resource_spec": "s3.medium.4.linux", "region": "ap-southeast-1", "available_zone": "ap-southeast-1a", "resource_size": null, "size_measure_id": null, "period_type": 2, "period_num": 1, "subscription_num": 1 }, { "id": "2", "cloud_service_type": "hws.service.type.vpc", "resource_type": "hws.resource.type.ip", "resource_spec": "5_bgp", "region": "ap-southeast-1", "available_zone": null, "resource_size": null, "size_measure_id": 15, "period_type": 2, "period_num": 1, "subscription_num": 1 }, { "id": "3", "cloud_service_type": "hws.service.type.ebs", "resource_type": "hws.resource.type.volume", "resource_spec": "GPSSD", "region": "ap-southeast-1", "available_zone": "ap-southeast-1a", "resource_size": 40, "size_measure_id": 17, "period_type": 2, "period_num": 1, "subscription_num": 1 }, { "id": "4", "cloud_service_type": "hws.service.type.vpc", "resource_type": "hws.resource.type.bandwidth", "resource_spec": "19_bgp", "region": "ap-southeast-1", "available_zone":"ap-southeast-1a", "resource_size": 40, "size_measure_id": 15, "period_type": 2, "period_num": 1, "subscription_num": 1 } ] }
响应消息
响应参数
参数 |
参数类型 |
取值范围 |
描述 |
---|---|---|---|
error_code |
String |
最大长度:20 |
状态码。具体请参考状态码。只有失败才返回该字段。 |
error_msg |
String |
最大长度:1000 |
错误描述信息。只有失败才返回该字段。 |
official_website_rating_result |
List<OfficialWebsiteRatingResult Object> |
- |
包年/包月产品的官网价格查询结果,具体参见表2。 |
optional_discount_rating_results |
List<OptionalDiscountRatingResult> |
- |
存在可选折扣优惠时返回折扣优惠维度询价结果,每个折扣优惠一组询价结果,具体参见表4。 |
currency |
String |
最大长度:20 |
币种。 USD:美元。 值为空代表美元。 |
参数 |
参数类型 |
取值范围 |
描述 |
---|---|---|---|
official_website_amount |
BigDecimal |
- |
包年/包月产品的官网价格。 |
measure_id |
Integer |
最大长度:4 |
价格度量单位标识。 1:美元 |
product_rating_results |
List<PeriodProductOfficialRatingResult> |
- |
包年/包月产品的询价结果,具体参见表3。 |
参数 |
参数类型 |
取值范围 |
描述 |
---|---|---|---|
id |
String |
最大长度:64 |
ID标识,来源于请求中的ID。 |
product_id |
String |
最大长度:64 |
包年/包月产品ID。 |
official_website_amount |
BigDecimal |
- |
包年/包月产品的官网价格。 |
measure_id |
Integer |
最大长度:4 |
价格的度量单位标识。
|
参数 |
参数类型 |
取值范围 |
描述 |
---|---|---|---|
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 |
折扣优惠类型。 |
discount_name |
String |
最大长度:256 |
折扣名称。 |
best_offer |
Integer |
- |
是否为最优折扣。 |
product_rating_results |
List<PeriodProductRatingResult> |
- |
产品询价结果,具体参见表5。 |
参数 |
参数类型 |
取值范围 |
描述 |
---|---|---|---|
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 200 OK Content-Type: application/json;charset=UTF-8 Content-Length: length Date: response time { "official_website_rating_result": { "official_website_amount": 623.78, "installment_official_website_amount": null, "installment_period_type": null, "measure_id": 1, "product_rating_results": [ { "id": "1", "product_id": "00301-18008-0--0", "official_website_amount": 27.2, "measure_id": 1, "installment_official_website_amount": null, "installment_period_type": null }, { "id": "2", "product_id": "00301-03001-0--0", "official_website_amount": 0, "measure_id": 1, "installment_official_website_amount": null, "installment_period_type": null }, { "id": "3", "product_id": "00301-170006-0--0", "official_website_amount": 5.28, "measure_id": 1, "installment_official_website_amount": null, "installment_period_type": null }, { "id": "4", "product_id": "00301-34543-0--0", "official_website_amount": 591.3, "measure_id": 1, "installment_official_website_amount": null, "installment_period_type": null } ] }, "optional_discount_rating_results": [], "currency": "USD" }