本文导读

展开导读

文档首页/ 合作伙伴中心/ API参考/ 管理产品/ 查询商品价格/ 查询包年/包月资源的续订金额

查询包年/包月资源的续订金额

更新时间：2024-05-28 GMT+08:00

查看PDF

功能介绍

客户在伙伴销售平台按照条件查询包年/包月资源续订时候的续订金额。

说明：

调用接口时，如果某个主资源有对应的从资源，系统会将主资源和从资源一起计算续订金额，主资源的从资源信息可以通过调用查询客户包年/包月资源列表接口获取。
注意：如ECS主机挂载新购的云硬盘，但此硬盘不是该ECS主资源的从资源，主从资源信息必须以调用查询客户包年/包月资源列表接口获取的信息为准。

接口约束

该接口只允许使用客户AK/SK或者Token调用，不允许使用合作伙伴AK/SK或者Token调用。因为目前合作伙伴不能自己买产品，所以没有自己的包年/包月产品。

调试

您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。

URI

POST /v2/bills/ratings/period-resources/renew-rate

请求消息

请求参数

参数	是否必选	参数类型	取值范围	描述
resource_ids	是	List<String>	[1-10]	资源ID列表。只支持传入主资源ID，最多10个资源ID。哪些资源是主资源请根据“查询客户包年/包月资源列表”接口响应参数中的“is_main_resource”来标识。
period_type	是	Integer	[2\|3]	周期类型： 2：月 3：年
period_num	是	Integer	[1-11]	周期数目：如果是月，目前支持1-11 如果是年，目前支持1-3
include_relative_resources	否	Boolean	-	是否包含关联资源一起续费询价。 false：不包含 true：包含此参数不携带或携带值为空串时，默认值为“false"。

请求示例

POST https://bss-intl.myhuaweicloud.com/v2/bills/ratings/period-resources/renew-rate HTTP/1.1
Content-Type: application/json
X-Auth-Token：MIIPAgYJKoZIhvcNAQcCo...ggg1BBIINPXsidG9rZ
{
	"resource_ids": ["230221_169ee********9d5b8af6a38f099abea"],
	"period_type": 2,
	"period_num": 1,
        "include_relative_resources": false
}

响应消息

响应参数

参数	参数类型	取值范围	描述
error_code	String	最大长度：20	状态码。具体请参见状态码。
error_msg	String	最大长度：1000	错误描述信息。
currency	String	最大长度：20	币种。 USD：美元。值为空代表美元。
renew_inquiry_results	List<RenewInquiryResultInfo>	--	主资源（包含从资源）询价结果。具体请参见表1
official_website_rating_result	OfficialWebsiteRatingResult Object	--	主资源（包含从资源）的官网价格查询结果，具体参见表2。
optional_discount_rating_results	List<OptionalDiscountRatingResult>	--	存在可选折扣优惠时返回折扣优惠维度询价结果，每个折扣优惠一组询价结果，具体参见表3 OptionalDiscountRatingResult。
fail_resource_infos	List<FailResourceInfo>	--	失败的资源信息列表。具体请参见表FailResourceInfo。

表1 RenewInquiryResultInfo
参数	参数类型	描述
resource_id	String	资源ID。说明：请求携带“include_relative_resources”字段，会返回关联资源的主资源ID。
amount	String	主资源（包含从资源）续订金额。单位为美元。说明：请求携带“include_relative_resources”字段，会返回关联资源的主资源的续订金额。

表2 OfficialWebsiteRatingResult
参数	参数类型	取值范围	描述
official_website_amount	String	最大长度：64	官网价格。单位为美元。

表3 OptionalDiscountRatingResult
参数	参数类型	取值范围	描述
discount_id	String	最大长度：64	折扣优惠ID。
amount	String	最大长度：64	总额，即最终优惠后的金额。单位为美元。 amount= official_website_amount - discount_amount。
official_website_amount	String	最大长度：64	官网价。单位为美元。
discount_amount	String	最大长度：64	可选折扣优惠额，如商务折扣、伙伴折扣、促销折扣和折扣券选用时的优惠额。单位为美元。
discount_type	Integer	最大长度：32	折扣优惠类型。合同商务折扣： 605：华为云BE场景下的合同商务折扣 606：分销商BE场景下的合同商务折扣伙伴授予折扣： 607：合作伙伴授予折扣-折扣率
discount_name	String	最大长度：256	折扣名称。
best_offer	Integer	-	是否为最优折扣。 0：不是最优折扣，为缺省值。 1：是最优折扣最优折扣：在商务折扣、伙伴折扣中选择（优惠金额最大的折扣为最优，优惠金额相等则按此顺序排优先级），促销折扣，折扣券不参与最优折扣的计算。

表 FailResourceInfo

参数	参数类型	描述
error_code	String	状态码。具体请参见表状态码
error_msg	String	错误描述信息。
resource_id	String	资源ID。

参数

参数类型

描述

error_code

String

状态码。

具体请参见表状态码

error_msg

String

错误描述信息。

resource_id

String

资源ID。

状态码：200

响应示例

HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8
Content-Length: length
Date: response time  
{
	"currency": "CNY",
	"renew_inquiry_results": [{
		"resource_id": "230221_169ee********9d5b8af6a38f099abea",
		"amount": "800.0"
	}],
	"official_website_rating_result": {
		"official_website_amount": "800.0",
		"installment_official_website_amount": null,
		"installment_period_type": null
	},
	"optional_discount_rating_results": [],
	"fail_resource_infos": []
}

状态码

说明：

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

HTTP状态码	错误码	描述
200	CBC.30050007	资源非主资源，不允许续费询价。
200	CBC.30050008	资源不存在对应的的周期类型或周期数。
200	CBC.30050009	资源已过期删除或不存在。
200	CBC.30050010	当前操作的资源中，有资源包含在您的待支付的订单，不能进行当前操作。
200	CBC.30050011	资源正在退订或者变更。
200	CBC.30050013	该产品不支持续费。
400	CBC.0100	参数错误。
400	CBC.99006006	找不到您询价的产品。
400	CBC.99006024	查询产品信息失败。
400	CBC.99006016	查询优惠券信息失败。
400	CBC.99006017	查询客户信息失败。
400	CBC.99006050	使用量单位错误。
400	CBC.99006055	询价结果超过金额最大限制。
400	CBC.99006066	查询计费信息失败。
400	CBC.99006073	项目不存在。
400	CBC.30050012	存在重复的资源ID。
403	CBC.0151	访问拒绝。
403	CBC.0154	token非法/过期。
500	CBC.0999	其他错误。

父主题： 查询商品价格

上一篇：查询包年/包月产品价格

下一篇：管理客户

意见反馈

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

有帮助没帮助

提供反馈

提交成功！非常感谢您的反馈，我们会继续努力做到更好！

系统繁忙，请稍后重试

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

内容与产品页面不一致

内容不易理解

缺失示例代码

步骤不可操作

搜不到想要的内容

缺少最佳实践

意见反馈（选填）

0/500

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

字符长度不能超过500

直接提交取消

查询包年/包月资源的续订金额

功能介绍

接口约束

调试

URI

请求消息

响应消息

状态码

意见反馈

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

文档反馈