-
用户指南
- 成为合作伙伴
- 合作伙伴发展路径
- 合作伙伴计划
- 伙伴信息管理
- 伙伴组织管理
- 伙伴学习管理
- 伙伴构建管理
- 伙伴能力认证
- 伙伴权益申请
- 机会点管理
- 解决方案提供商
- 分销计划
- 伙伴子客户操作
- 伙伴支持管理
- 附录
- 文档修订记录
-
常见问题
- 概览
- 加入华为云合作伙伴网络(HCPN)
- 合作伙伴计划
- 伙伴信息管理
- 伙伴学习管理
- 伙伴组织管理
- 伙伴构建管理
- 伙伴能力认证
-
伙伴权益申请
- 基本权益说明
- 测试券
- 考试券
-
市场发展基金(MDF)
- 什么是MDF?
- MDF申请门槛是什么?
- MDF权益最高可申请额度有多少?
- 伙伴至少在活动前多久提交MDF使用申请?
- 多场活动是否可以统一申请?
- 若活动时间、地点、对象、形式等关键信息发生变化时,是否要重新提交活动申请?
- 伙伴发起的使用申请审批未结束时能否开展MDF活动?
- MDF额度有效期为多久?
- 哪些活动可以使用MDF?
- 活动结束后多久提交MDF兑现申报?
- MDF兑现申报金额可以超过使用申请金额吗?
- MDF兑现申报需要哪些材料?
- 同一个活动金额较大,可以拆开来报销吗?
- 伙伴开具的发票可以跟开票清单的信息不一致吗?
- MDF额度是含税的吗?
- 有哪些类别不可以通过MDF进行报销?
- 若申请的额度和最终实际使用的金额不同,该如何处理?
- 权益申领为什么会显示冻结状态?以及如何解冻?
- MDF有哪些合规要求?
- MDF使用过程中有哪些重要规范点?
- 专职人员激励(FH)
- 销售人员奖励(SPIF)
- 能力提升激励
- 机会点管理
-
伙伴销售管理
-
解决方案提供商伙伴
-
伙伴政策
- 什么是解决方案提供商计划?
- 什么是解决方案提供商业绩?业绩收入怎么计算?
- 什么是解决方案提供商激励?
- 解决方案提供商自用云资源是否计入销售业绩?
- 华为云发放的代金券、测试券等消费是否计入销售业绩?
- 伙伴业绩是否区分客户的消费为新购、续费?
- 如何申请额外的POC测试券?
- 顾问销售和转售模式两种关联模式的有效期是多长?
- 顾问销售模式和转售模式的交易模式是什么?
- 伙伴如何为客户设置折扣?
- 伙伴中心的账户信息,应还金额和账户余额是什么意思?
- 解决方案提供商销售的华为云服务产品是否需要产品授权销售,无授权的产品不能销售?
- 华为云合作伙伴政策是否一国一策?
- 解决方案提供商销售华为云服务是否需要打款压货?
- 顾问销售模式下伙伴是否需要向客户提供服务?
- 华为云是否给伙伴设置预算,这与伙伴给转售子客户设置预算有什么关系?
- 关联与解除关联
- 消费配额
- 开具发票
-
激励结算
- 什么是伙伴的业绩和激励?
- 客户购买云服务后,华为云什么时候跟伙伴对账及结算激励?
- 合作伙伴在哪里查看业绩激励数据?
- 转售业绩激励与顾问销售业绩激励有什么不同?
- 合作伙伴如何对账?页面上的数据如何跟伙伴政策对应?
- 什么情况下合作伙伴需要向华为云开发票?
- 为什么我看不到/打不开“开票清单”?
- 发票寄到哪里?除了发票,还要寄什么东西?
- 对激励发票有什么要求?
- 银行转账付款的结算币种是什么货币?
- 支付激励时,要扣除什么税?
- 激励发放选择转代金券,什么时候能到账?
- 寄发票后,过多少天激励能到账?
- 提取激励的有效期是多久?
- 激励发放方式有哪几种?
- 业绩说明
- 业绩如何对账?
- 增量激励明细示例
- 激励发放方式选择错误,该如何处理?
- 折扣与优惠券
- 指标管理
-
其他
- 伙伴注册账户时收不到验证码是什么原因?
- 伙伴如何为特定人员配置针对账号欠款、激励对账等财务相关的邮件和短信提醒功能?
- 包年/包月产品如何支付?
- 关闭转售类客户账单权限有哪些影响?
- 消费看板的统计规则是什么?
- 原客户消费下的消费汇总功能合并到消费看板后,如何在消费看板查看消费汇总?
- 月结95峰值计费产品
- 出账机制调整对伙伴的影响有哪些?
- 伙伴如何新建工单?
- 伙伴如何查看工单处理进度?
- 伙伴受限或冻结的影响有哪些?
- 什么是组合交易单?
- 什么是子资源?
- 如何查询财务托管模式企业子账号解绑当月账期的消费数据?
- 销售菜单新旧版对比
- 伙伴登录伙伴中心没有客户拓展菜单?
- 伙伴中心收支明细页面客户账号与客户名显示为空是什么原因?
- 国际站转售伙伴可以转售中国大陆region的资源吗
- 哪些伙伴可以处理营销任务?
-
伙伴政策
- 总经销商伙伴
- 云经销商伙伴
- 伙伴子客户
-
解决方案提供商伙伴
- 伙伴支持管理
- 合作伙伴品牌营销
- API
- 开发指南
- API参考
- 通用参考
链接复制成功!
查询资源包列表
功能介绍
客户在伙伴销售平台查询客户的资源包列表。
接口约束
该接口只允许使用客户AK/SK或者Token调用,不允许使用解决方案提供商或华为云总经销商(一级经销商)的AK/SK或者Token调用。
资源包失效时间超过18个月则无法查询其信息。
调试
您可以在API Explorer中调试该接口,支持自动认证鉴权。API Explorer可以自动生成SDK代码示例,并提供SDK代码示例调试功能。
URI
POST /v3/payments/free-resources/query
参数 |
是否必选 |
取值范围 |
描述 |
---|---|---|---|
X-Language |
否 |
最大长度:8 |
语言。
缺省为zh_CN。 |
请求消息
请求参数
参数 |
是否必选 |
参数类型 |
取值范围 |
描述 |
---|---|---|---|---|
region_code |
否 |
String |
最大长度:64 |
云服务区编码,例如:“ap-southeast-1”。具体请参见地区和终端节点对应云服务的“区域”列的值。 此参数不携带或携带值为空串或携带值为null时,不作为筛选条件。 |
order_id |
否 |
String |
最大长度:64 |
订单ID。 此参数不携带或携带值为空串或携带值为null时,不作为筛选条件。 |
product_id |
否 |
String |
最大长度:64 |
产品ID,即资源包ID。 此参数不携带或携带值为空串或携带值为null时,不作为筛选条件。 |
product_name |
否 |
String |
最大长度:256 |
产品名称,即资源包名称。 此参数不携带或携带值为空串或携带值为null时,不作为筛选条件。 |
enterprise_project_id |
否 |
String |
最大长度:64 |
企业项目ID。 如需查询企业项目下的资源列表,必须携带该参数; 若参数不携带或携带值为空串或携带值为null时,查询除企业项目外的其他所有资源列表。 |
status |
否 |
Integer |
[0-4] |
状态:
此参数不携带或携带值为空串或携带值为null时,不作为筛选条件。 |
offset |
否 |
Integer |
[0-999999] |
偏移量,从0开始,默认为0。 offset用于分页处理,如不涉及分页,请使用默认值0。offset表示相对于满足条件的第一个数据的偏移量。如offset = 1,则返回满足条件的第二个数据至最后一个数据。 示例1,满足查询条件的结果共10条数据,limit取值为10,offset取值为1,则返回的数据为2~10,第一条数据不返回。 示例2,查询总数20条,期望每页返回10条数据,则获取第一页数据,入参offset填写0,limit填写10;获取第二页数据,入参offset填写10,limit填写10。 |
limit |
否 |
Integer |
[1-1000] |
每次查询的记录数,默认为10。 |
service_type_code_list |
否 |
List<String> |
[0-10] |
云服务类型编码列表,大小写不敏感。 例如OBS的云服务类型编码为“hws.service.type.obs”。您可以调用查询云服务类型列表接口获取。 此参数不携带或携带值为空列表或携带值为null时,不作为筛选条件,返回其他条件匹配的记录。 |
请求示例
POST https://bss-intl.myhuaweicloud.com/v3/payments/free-resources/query HTTP/1.1
Content-Type: application/json
X-Auth-Token:MIIPAgYJKoZIhvcNAQcCo...ggg1BBIINPXsidG9rZ
{
"region_code": "cn-north-7",
"order_id": "CS21043011259RWXXTA",
"product_id": "90301-296014-0--0",
"product_name": "华为云WeLink",
"enterprise_project_id": null,
"status": 1,
"offset": 0,
"limit": 10,
"service_type_code_list": [
"hws.service.type.obs",
"hws.service.type.vpc"
]
}
响应消息
响应参数
参数 |
参数类型 |
取值范围 |
描述 |
---|---|---|---|
error_code |
String |
20 |
状态码。 具体请参考状态码。只有失败才返回该字段。 |
error_msg |
String |
1000 |
错误描述信息。只有失败才返回该字段。 |
free_resource_packages |
List<FreeResourcePackage> |
- |
资源包信息列表,具体参见表2。 |
total_count |
Integer |
- |
总条数。 |
参数 |
参数类型 |
取值范围 |
描述 |
---|---|---|---|
order_instance_id |
String |
最大长度:64 |
订购资源包产品后,系统生成的ID,是这个资源包列表的标识字段。 |
order_id |
String |
最大长度:64 |
订单ID,如果source_type为“1:软开云赠送”,该字段为空。 若订单存在暂未生效的续费订单,此处返回的是当前生效的订单ID。 |
product_id |
String |
最大长度:64 |
产品ID,即资源包ID。 |
product_name |
String |
最大长度:256 |
产品名称,即资源包名称。 |
enterprise_project_id |
String |
最大长度:64 |
企业项目ID。 |
enterprise_project_scope |
Integer |
[0-1] |
企业项目应用范围:
|
effective_time |
String |
最大长度:20 |
生效时间,购买资源包的时间,格式UTC。 |
expire_time |
String |
最大长度:20 |
失效时间,资源包到期时间,格式UTC。 |
status |
Integer |
[0-4] |
状态:
|
service_type_code |
String |
最大长度:64 |
云服务类型编码,例如OBS的云服务类型编码为“hws.service.type.obs”。 |
service_type_name |
String |
最大长度:200 |
云服务类型名称。例如ECS的云服务类型名称为“弹性云服务器”。 |
region_code |
String |
最大长度:64 |
云服务区编码,例如:“ap-southeast-1”。具体请参见地区和终端节点对应云服务的“区域”列的值。 |
source_type |
Integer |
[0-1] |
资源包的来源类型:
|
bundle_type |
String |
[ATOMIC_PKG|BUNDLE_PKG] |
套餐绑定类型:
|
quota_reuse_mode |
Integer |
[1-2] |
使用模式。 |
free_resources |
List<FreeResource> |
- |
资源套餐内的资源项信息(资源项ID级的详情),具体参见表3。 |
参数 |
参数类型 |
取值范围 |
描述 |
---|---|---|---|
free_resource_id |
String |
最大长度:64 |
资源项ID,一个资源包中会含有多个资源项,一个使用量类型对应一个资源项。 |
usage_type_name |
String |
最大长度:1024 |
使用量类型名称。 |
amount |
String |
最大长度:32 |
资源剩余额度,针对可重置资源包,是指当前重置周期内的剩余量。 |
original_amount |
String |
最大长度:32 |
资源原始额度,针对可重置资源包,是指每个重置周期内的总量。 |
measure_id |
Integer |
- |
度量单位,免费资源套餐额度度量单位。您可以调用查询度量单位列表接口获取。 |
响应示例
HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8
Content-Length: length
Date: response time
{
"total_count": 1,
"free_resource_packages": [
{
"order_instance_id": "01154-228300268-0",
"order_id": "CS21043011259RWXXTA",
"product_id": "90301-296014-0--0",
"product_name": "华为云WeLink",
"enterprise_project_id": null,
"enterprise_project_scope": 0,
"effective_time": "2021-04-30T03:30:56Z",
"expire_time": "2021-05-31T15:59:59Z",
"status": 1,
"service_type_code": "hws.service.type.cpts",
"region_code": "cn-north-7",
"source_type": 0,
"bundle_type": "ATOMIC_PKG",
"quota_reuse_mode": 2,
"free_resources": [
{
"free_resource_id": "d4463497-991b-439d-9ab6-23f9ed197fe9",
"usage_type_name": "时长",
"amount": 100,
"original_amount": 100,
"measure_id": 34
}
]
}
]
}