对 AWS 合作伙伴中心 API 参考进行了重组。有关支持的 API 操作的更多信息,请参阅 AWS 合作伙伴中心 API 参考。
本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。
处理福利分配
福利分配是指已授予合作伙伴的福利。福利申请获得批准后, AWS 创建一项或多项福利分配,为合作伙伴提供实际积分、资金、准入或其他福利兑现。
了解福利分配
福利分配可以代表各种类型的履行情况:
-
财务支出 (CASH) -使用支出追踪功能直接向合作伙伴付款
-
AWS 积分(积分)-适用于具有使用情况跟踪功能的 AWS 账户的信用代码
-
消耗品分配 -可跟踪使用情况的 Pre-approved 资金金额或钱包
-
访问授权 (ACCESS) -访问系统、工具或资源
-
识别(识别)-数字徽章、认证或身份指定
-
资源(资源)-技术支持、咨询服务或 ProServe 参与
每项福利分配都通过其 “状态” 字段跟踪生命周期:
-
ACTI VE-该配额可供使用
-
无效 -配额暂时不可用
-
已发货 -配额已完全使用或已送达
福利分配还包括定义福利何时生效(StartsAt)和何时到期(ExpiresAt)的时间信息,使合作伙伴能够了解使用福利的时间框架。
列出福利分配
合作伙伴可以使用 ListBenefitAllocations API 操作查看其所有福利分配。这将返回具有全面筛选功能的分页分配摘要列表。
合作伙伴可以按以下条件筛选分配:
-
福利标识符 -查看特定福利的分配
-
福利申请标识符 -查看由特定应用程序产生的分配
-
配送类型 -按分配类型(
CREDITS、CASHACCESS、等)筛选 -
状态 -按分配状态筛选 (
ACTIVE,INACTIVE,FULFILLED)
清单回复包括分配摘要,其中包含:
-
分配 ID、ARN 和名称
-
相关福利 ID 和福利申请 ID(如果适用)
-
配送类型
-
当前状态
-
创建时间戳
-
开始日期
此列表视图使合作伙伴能够建立分配跟踪仪表板并确定:
-
有效配额可供立即使用
-
配额接近到期
-
已完成历史追踪配额
-
按计划或配送类型划分的总分配价值
查看详细的分配信息
合作伙伴可以使用 GetBenefitAllocation API 操作检索完整的分配详情。这提供了有关分配的全面信息,包括因分配类型而异的配送特定详情。
核心分配信息:
-
唯一标识符 (ID) 和亚马逊资源名称 (ARN)
-
分配名称和状态
-
状态原因(对当前状态的解释)
-
相关的福利 ID 和福利申请 ID
-
配送类型
-
创建、更新、开始和过期时间戳
配送详情 (Type-Specific):
该 FulfillmentDetail 字段包含基于配送类型的不同信息结构:
现金支付详情(现金类型)
对于直接现金付款,配送详情包括:
-
支出金额 -已支付的资金总额,包括金额价值和货币代码
-
发行详情(如果适用)-有关采购订单或发行事件的信息:
-
发行 ID-付款的唯一标识符
-
发行金额-以当地货币计算的金额
-
发行日期-付款时间戳
-
该结构既支持单笔付款,也支持预先批准的融资方案,其中一次拨款可以进行多次发行。
积分详情(积分类型)
对于 AWS 积分,配送详情包括:
-
分配金额 -分配的总积分金额
-
已发行金额 -已发放的信贷总金额(可能少于分阶段发行的拨款)
-
信用代码 -个人信用代码详细信息阵列:
-
AWS 账户 ID-使用积分的账户
-
价值-信用代码的货币价值
-
AWS 信用代码-实际的信用代码字符串
-
状态-信用代码状态 (
ACTIVE,INACTIVE,FULFILLED) -
发行日期-信用代码的签发时间
-
到期时间-当信用码到期时
-
这种详细的信用跟踪使合作伙伴能够监控多个账户的信用使用情况,并了解哪些积分可用、部分使用或已全部消耗。
消耗品分配详情 () Pre-Approved Amounts/Wallets
对于预先批准的资金池,配送详情包括:
-
分配金额 -分配中的总金额
-
剩余金额 -仍可用的未使用金额
-
已使用金额 -已消耗的金额
-
发行详情(如果适用)-分配的采购订单信息
消费品分配使合作伙伴能够根据需要为符合条件的活动提取资金,并实时跟踪剩余余额。
访问详情(访问类型)
对于访问授权,配送详情包括:
-
描述 -详细说明授予的访问权限以及如何使用它
访问权限分配可能提供对预览服务、专业工具或受限资源的访问权限。描述字段提供有关合作伙伴如何激活和使用授予的访问权限的说明。
将拨款应用于新的福利申请
福利分配中的 ApplicableBenefitIds 字段确定了可以利用这种分配的其他福利。这实现了福利链,合作伙伴可以使用现有分配来申请额外福利。
例如,合作伙伴可能:
-
获得预先批准的 MAP 资金分配
-
为个人客户迁移项目创建福利应用程序
-
将这些申请与预先批准的拨款关联起来
-
项目获得批准后,从拨款中提取资金
这种方法简化了获得预先批准资金的合作伙伴的福利申请流程,缩短了单个项目申请的审查周期。