设置客户预算
功能介绍
当伙伴需要首次设置或调整客户预算大小时，可调用此接口完成客户预算的设置。首次设置，未指定超预算时冻结类型，则默认为手动冻结。
伙伴登录伙伴中心查询客户的预算请单击这里。
华为云总经销商（一级经销商）需为云经销商授权对其拓展的子客户设置预算的权限，才可为云经销商子客户设置预算。
具体操作步骤详见为云经销商授权对其拓展的子客户设置预算的权限。
接口约束
该接口只允许使用解决方案提供商或华为云总经销商（一级经销商）的AK/SK或者Token调用。
调试
您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。
URI
POST /v2/partners/sub-customers/budget
请求消息
请求参数
|
参数 |
是否必选 |
参数类型 |
取值范围 |
描述 |
|---|---|---|---|---|
|
customer_id |
是 |
String |
最大长度：64 |
客户账号ID。您可以调用查询客户列表接口获取customer_id。 |
|
budget_amount |
是 |
BigDecimal |
(0-2147483647] |
调整的目标金额。 单位：元。精确至小数点后2位。 |
|
cancel_partner_frozen |
否 |
String |
- |
是否在设置客户预算的同时解除账号冻结：
默认值为0。 此参数不携带或携带值为空串或携带值为null时，默认为0。 |
|
indirect_partner_id |
否 |
String |
最大长度：64 |
云经销商ID。获取方法请参见查询云经销商列表。如果需要设置云经销商的子客户预算，必须携带该字段。除此之外，此参数不携带或携带值为空串或携带值为null时，不做处理。 |
|
budget_type |
否 |
String |
- |
预算模式：
默认值为MONTHLY。 此参数不携带或携带值为null时，默认为MONTHLY。此参数携带值不支持空串。 |
|
frozen_operate_type |
否 |
Integer |
设置超预算时是否自动冻结
此参数不携带或携带值为null或携带值为空时，字段不生效。 |
请求示例
POST https://bss-intl.myhuaweicloud.com/v2/partners/sub-customers/budget HTTP/1.1 Content-Type: application/json X-Auth-Token：MIIPAgYJKoZIhvcNAQcCo...ggg1BBIINPXsidG9rZ { "customer_id": "053a48736500d5f40ffec01689b88480", "budget_amount": 100, "cancel_partner_frozen": 0, "indirect_partner_id": "0b5e9b********0c0f0fc00874a9e000", "budget_type":"MONTHLY", "frozen_operate_type": 0 }
响应消息
响应参数
|
参数 |
参数类型 |
取值范围 |
描述 |
|---|---|---|---|
|
error_code |
String |
最大长度：20 |
状态码，具体请参考状态码。只有失败才会返回这个参数。 |
|
error_msg |
String |
最大长度：2000 |
错误描述信息。只有失败才会返回这个参数。 |
响应示例
HTTP/1.1 204 No Content Content-Type: application/json;charset=UTF-8 Content-Length: length Date: response time
状态码
- 状态码4xx：由于明显的客户端错误（例如，格式错误的请求语法、参数错误等），华为云会返回4xx错误码，请及时检查请求消息的正确性，重新发起请求。
- 状态码5xx：由于华为云系统原因，导致无法完成明显有效请求的处理，可及时联系华为云客服处理。
|
HTTP状态码 |
错误码 |
错误描述 |
|---|---|---|
|
400 |
CBC.0100 |
参数错误。 |
|
400 |
CBC.50000030 |
云经销商预算额度已不足，无法进行设置预算。 |
|
400 |
CBC.50000033 |
您授权云经销商预算设置权限已取消，云经销商无法进行预算设置。 |
|
400 |
CBC.99000000 |
无对该客户的操作权限。 |
|
400 |
CBC.99000037 |
您没有操作该云经销商的权限。 |
|
400 |
CBC.99005024 |
客户的关联类型不允许调用该接口。 |
|
403 |
CBC.0151 |
访问拒绝。 |
|
403 |
CBC.0150 |
非法操作。 |
|
500 |
CBC.0999 |
其他错误。 |
