AWS 合作夥伴中心 API 參考已重組。如需支援的 API 操作的詳細資訊,請參閱 AWS 合作夥伴中心 API 參考。
本文為英文版的機器翻譯版本,如內容有任何歧義或不一致之處,概以英文版為準。
使用利益分配
利益分配代表已授予合作夥伴的利益。當利益應用程式獲得核准時, 會AWS建立一或多個利益分配,為合作夥伴提供實際的點數、資金、存取權或其他利益履行。
了解利益分配
利益分配可以代表各種類型的履行:
-
財務支出 (CASH) - 使用支出追蹤將財務付款直接傳送給合作夥伴
-
AWS抵用金 (CREDITS) - 適用於使用量追蹤AWS帳戶的抵用金代碼
-
消耗分配 - 使用率追蹤的預先核准資金金額或錢包
-
Access Grants (ACCESS) - 存取系統、工具或資源
-
辨識 (辨識) - 數位徽章、認證或狀態指定
-
資源 (RESOURCE) - 技術支援、諮詢服務或 ProServe 業務
每個利益分配都有透過其狀態欄位追蹤的生命週期:
-
ACTIVE - 配置可供使用
-
非作用中 - 配置暫時無法使用
-
FULFILLED - 配置已完全使用或交付
利益分配也包括暫時性資訊,定義它們何時生效 (StartsAt) 和何時過期 (ExpiresAt),讓合作夥伴了解利用利益的時間範圍。
列出利益分配
合作夥伴可以使用 ListBenefitAllocations API 動作檢視其所有利益配置。這會傳回具有完整篩選功能的配置摘要分頁清單。
合作夥伴可以依下列條件篩選配置:
-
利益識別符 - 檢視特定利益的配置
-
利益應用程式識別符 - 檢視特定應用程式產生的配置
-
履行類型 - 依配置類型 (
CREDITS、ACCESS、 等)CASH篩選 -
狀態 - 依配置狀態篩選 (
ACTIVE、INACTIVE、FULFILLED)
清單回應包含配置摘要,其中包含:
-
配置 ID、ARN 和名稱
-
關聯的利益 ID 和利益應用程式 ID (如適用)
-
履行類型
-
目前狀態
-
建立時間戳記
-
開始日期
此清單檢視可讓合作夥伴建置配置追蹤儀表板,並識別:
-
可用於立即使用的作用中配置
-
即將過期的配置
-
歷史追蹤的完成配置
-
依程式或履行類型的分配總值
檢視詳細配置資訊
合作夥伴可以使用 GetBenefitAllocation API 動作擷取完整的配置詳細資訊。這可提供配置的完整資訊,包括根據配置類型而有所不同的履行特定詳細資訊。
核心配置資訊:
-
唯一識別碼 (ID) 和 Amazon Resource Name (ARN)
-
配置名稱和狀態
-
狀態原因 (目前狀態的說明)
-
關聯的利益 ID 和利益應用程式 ID
-
履行類型
-
建立、更新、啟動和過期時間戳記
履行詳細資訊 (類型特定):
FulfillmentDetail 欄位根據履行類型包含不同的資訊結構:
現金支出詳細資訊 (現金類型)
對於直接現金付款,履行詳細資訊包括:
-
已支付金額 - 已支付資金的總金額,包括金額值和貨幣代碼
-
發行詳細資訊 (如適用) - 有關採購訂單或發行事件的資訊:
-
發行 ID - 支出的唯一識別符
-
發行金額 - 以本地貨幣為單位的金額
-
發出時間 - 分配時間戳記
-
此結構支援單一支出和預先核准的資金案例,其中單一配置可能會發生多個發行。
點數詳細資訊 (CREDITS 類型)
對於AWS點數,履行詳細資訊包括:
-
已分配金額 - 已分配的點數總計
-
已發行金額 - 已發行的點數總額 (可能低於分階段發行的配置)
-
點數代碼 - 個別點數代碼詳細資訊的陣列:
-
AWS帳戶 ID - 套用點數的帳戶
-
值 - 點數碼的貨幣值
-
AWS點數代碼 - 實際點數代碼字串
-
狀態 - 點數碼狀態 (
ACTIVE、INACTIVE、FULFILLED) -
發出時間 - 發出點數碼時
-
過期時間 - 當點數碼過期時
-
此詳細的點數追蹤可讓合作夥伴監控多個帳戶的點數使用率,並了解哪些點數可用、部分使用或完全使用。
消耗性配置詳細資訊 (預先核准的金額/貨盤)
對於預先核准的資金集區,履行詳細資訊包括:
-
配置金額 - 配置中的總金額
-
剩餘金額 - 未使用的金額仍然可用
-
使用量 - 已使用量
-
發行詳細資訊 (如適用) - 配置的採購訂單資訊
消耗性配置可讓合作夥伴視需要為合格活動提取資金,並即時追蹤餘額。
存取詳細資訊 (ACCESS 類型)
對於存取授權,履行詳細資訊包括:
-
描述 - 有關正在授予的存取權及其使用方式的詳細說明
存取配置可能會提供預覽服務、專用工具或受限資源的存取權。描述欄位提供合作夥伴如何啟用和使用授予的存取權的指示。
將配置套用至新的利益應用程式
利益分配中的 ApplicableBenefitIds 欄位可識別可利用此配置的其他優點。這可讓 合作夥伴使用現有配置來申請其他利益,進而實現利益鏈結。
例如,合作夥伴可能會:
-
接收預先核准的 MAP 資金分配
-
為個別客戶遷移專案建立利益應用程式
-
將這些應用程式與預先核准的配置建立關聯
-
當專案獲得核准時,從配置中提取資金
此方法可簡化具有預先核准資金之合作夥伴的利益申請程序,減少個別專案請求的審查週期。