View a markdown version of this page

使用利益分配 - AWS Partner Central

AWS 合作夥伴中心 API 參考已重組。如需支援的 API 操作的詳細資訊,請參閱 AWS 合作夥伴中心 API 參考

本文為英文版的機器翻譯版本,如內容有任何歧義或不一致之處,概以英文版為準。

使用利益分配

利益分配代表已授予合作夥伴的利益。當利益應用程式獲得核准時, 會AWS建立一或多個利益分配,為合作夥伴提供實際的點數、資金、存取權或其他利益履行。

了解利益分配

利益分配可以代表各種類型的履行:

  • 財務支出 (CASH) - 使用支出追蹤將財務付款直接傳送給合作夥伴

  • AWS抵用金 (CREDITS) - 適用於使用量追蹤AWS帳戶的抵用金代碼

  • 消耗分配 - 使用率追蹤的預先核准資金金額或錢包

  • Access Grants (ACCESS) - 存取系統、工具或資源

  • 辨識 (辨識) - 數位徽章、認證或狀態指定

  • 資源 (RESOURCE) - 技術支援、諮詢服務或 ProServe 業務

每個利益分配都有透過其狀態欄位追蹤的生命週期:

  • ACTIVE - 配置可供使用

  • 非作用中 - 配置暫時無法使用

  • FULFILLED - 配置已完全使用或交付

利益分配也包括暫時性資訊,定義它們何時生效 (StartsAt) 和何時過期 (ExpiresAt),讓合作夥伴了解利用利益的時間範圍。

列出利益分配

合作夥伴可以使用 ListBenefitAllocations API 動作檢視其所有利益配置。這會傳回具有完整篩選功能的配置摘要分頁清單。

合作夥伴可以依下列條件篩選配置:

  • 利益識別符 - 檢視特定利益的配置

  • 利益應用程式識別符 - 檢視特定應用程式產生的配置

  • 履行類型 - 依配置類型 (CREDITSACCESS、 等) CASH篩選

  • 狀態 - 依配置狀態篩選 (ACTIVEINACTIVEFULFILLED)

清單回應包含配置摘要,其中包含:

  • 配置 ID、ARN 和名稱

  • 關聯的利益 ID 和利益應用程式 ID (如適用)

  • 履行類型

  • 目前狀態

  • 建立時間戳記

  • 開始日期

此清單檢視可讓合作夥伴建置配置追蹤儀表板,並識別:

  • 可用於立即使用的作用中配置

  • 即將過期的配置

  • 歷史追蹤的完成配置

  • 依程式或履行類型的分配總值

檢視詳細配置資訊

合作夥伴可以使用 GetBenefitAllocation API 動作擷取完整的配置詳細資訊。這可提供配置的完整資訊,包括根據配置類型而有所不同的履行特定詳細資訊。

核心配置資訊:

  • 唯一識別碼 (ID) 和 Amazon Resource Name (ARN)

  • 配置名稱和狀態

  • 狀態原因 (目前狀態的說明)

  • 關聯的利益 ID 和利益應用程式 ID

  • 履行類型

  • 建立、更新、啟動和過期時間戳記

履行詳細資訊 (類型特定):

FulfillmentDetail 欄位根據履行類型包含不同的資訊結構:

現金支出詳細資訊 (現金類型)

對於直接現金付款,履行詳細資訊包括:

  • 已支付金額 - 已支付資金的總金額,包括金額值和貨幣代碼

  • 發行詳細資訊 (如適用) - 有關採購訂單或發行事件的資訊:

    • 發行 ID - 支出的唯一識別符

    • 發行金額 - 以本地貨幣為單位的金額

    • 發出時間 - 分配時間戳記

此結構支援單一支出和預先核准的資金案例,其中單一配置可能會發生多個發行。

點數詳細資訊 (CREDITS 類型)

對於AWS點數,履行詳細資訊包括:

  • 已分配金額 - 已分配的點數總計

  • 已發行金額 - 已發行的點數總額 (可能低於分階段發行的配置)

  • 點數代碼 - 個別點數代碼詳細資訊的陣列:

    • AWS帳戶 ID - 套用點數的帳戶

    • 值 - 點數碼的貨幣值

    • AWS點數代碼 - 實際點數代碼字串

    • 狀態 - 點數碼狀態 (ACTIVEINACTIVEFULFILLED)

    • 發出時間 - 發出點數碼時

    • 過期時間 - 當點數碼過期時

此詳細的點數追蹤可讓合作夥伴監控多個帳戶的點數使用率,並了解哪些點數可用、部分使用或完全使用。

消耗性配置詳細資訊 (預先核准的金額/貨盤)

對於預先核准的資金集區,履行詳細資訊包括:

  • 配置金額 - 配置中的總金額

  • 剩餘金額 - 未使用的金額仍然可用

  • 使用量 - 已使用量

  • 發行詳細資訊 (如適用) - 配置的採購訂單資訊

消耗性配置可讓合作夥伴視需要為合格活動提取資金,並即時追蹤餘額。

存取詳細資訊 (ACCESS 類型)

對於存取授權,履行詳細資訊包括:

  • 描述 - 有關正在授予的存取權及其使用方式的詳細說明

存取配置可能會提供預覽服務、專用工具或受限資源的存取權。描述欄位提供合作夥伴如何啟用和使用授予的存取權的指示。

將配置套用至新的利益應用程式

利益分配中的 ApplicableBenefitIds 欄位可識別可利用此配置的其他優點。這可讓 合作夥伴使用現有配置來申請其他利益,進而實現利益鏈結。

例如,合作夥伴可能會:

  1. 接收預先核准的 MAP 資金分配

  2. 為個別客戶遷移專案建立利益應用程式

  3. 將這些應用程式與預先核准的配置建立關聯

  4. 當專案獲得核准時,從配置中提取資金

此方法可簡化具有預先核准資金之合作夥伴的利益申請程序,減少個別專案請求的審查週期。