AWS 合作夥伴中心 API 參考已重組。如需支援的 API 操作的詳細資訊，請參閱 [AWS 合作夥伴中心 API 參考](https://docs.aws.amazon.com/partner-central/latest/APIReference/Welcome.html)。

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

# 使用利益分配
<a name="working-with-benefit-allocations"></a>

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

## 了解利益分配
<a name="understanding-benefit-allocations"></a>

利益分配可以代表各種類型的履行：
+ **財務支出 (CASH)** - 使用支出追蹤將財務付款直接傳送給合作夥伴
+ **AWS 抵用金 (CREDITS)** - 適用於使用量追蹤 AWS 帳戶的抵用金代碼
+ **消耗分配** - 使用率追蹤的預先核准資金金額或錢包
+ **Access Grants (ACCESS)** - 存取系統、工具或資源
+ **辨識 （辨識）** - 數位徽章、認證或狀態指定
+ **資源 (RESOURCE)** - 技術支援、諮詢服務或 ProServe 業務

每個利益分配都有透過其狀態欄位追蹤的生命週期：
+ **ACTIVE** - 配置可供使用
+ **非作用中** - 配置暫時無法使用
+ **FULFILLED** - 配置已完全使用或交付

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

## 列出利益分配
<a name="listing-benefit-allocations"></a>

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

合作夥伴可以依下列條件篩選配置：
+ **利益識別符** - 檢視特定利益的配置
+ **利益應用程式識別符** - 檢視特定應用程式產生的配置
+ **履行類型** - 依配置類型 (`CREDITS`、`ACCESS`、 等） `CASH`篩選
+ **狀態** - 依配置狀態篩選 (`ACTIVE`、`INACTIVE`、`FULFILLED`)

清單回應包含配置摘要，其中包含：
+ 配置 ID、ARN 和名稱
+ 關聯的利益 ID 和利益應用程式 ID （如適用）
+ 履行類型
+ 目前狀態
+ 建立時間戳記
+ 開始日期

此清單檢視可讓合作夥伴建置配置追蹤儀表板，並識別：
+ 可用於立即使用的作用中配置
+ 即將過期的配置
+ 歷史追蹤的完成配置
+ 依程式或履行類型的分配總值

## 檢視詳細配置資訊
<a name="viewing-detailed-allocation-information"></a>

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

**核心配置資訊：**
+ 唯一識別碼 (ID) 和 Amazon Resource Name (ARN)
+ 配置名稱和狀態
+ 狀態原因 （目前狀態的說明）
+ 關聯的利益 ID 和利益應用程式 ID
+ 履行類型
+ 建立、更新、啟動和過期時間戳記

**履行詳細資訊 （類型特定）：**

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

### 現金支出詳細資訊 （現金類型）
<a name="cash-disbursement-details"></a>

對於直接現金付款，履行詳細資訊包括：
+ **已支付金額** - 已支付資金的總金額，包括金額值和貨幣代碼
+ **發行詳細資訊 （如適用）** - 有關採購訂單或發行事件的資訊：
  + 發行 ID - 支出的唯一識別符
  + 發行金額 - 以當地貨幣為單位的金額
  + 發出時間 - 分配時間戳記

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

### 點數詳細資訊 (CREDITS 類型）
<a name="credit-details"></a>

對於 AWS 點數，履行詳細資訊包括：
+ **已分配金額** - 已分配的點數總計
+ **已發行金額** - 已發行的點數總額 （可能低於分階段發行的配置）
+ **點數代碼** - 個別點數代碼詳細資訊的陣列：
  + AWS 帳戶 ID - 套用點數的帳戶
  + 值 - 點數碼的貨幣值
  + AWS 點數代碼 - 實際點數代碼字串
  + 狀態 - 點數碼狀態 (`ACTIVE`、`INACTIVE`、`FULFILLED`)
  + 發出時間 - 發出點數碼時
  + 過期時間 - 當點數碼過期時

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

### 消耗分配詳細資訊 （預先核准的金額/貨盤）
<a name="consumable-allocation-details"></a>

對於預先核准的資金集區，履行詳細資訊包括：
+ **配置金額** - 配置中的總金額
+ **剩餘金額** - 未使用的金額仍然可用
+ **使用量** - 已使用量
+ **發行詳細資訊 （如適用）** - 配置的採購訂單資訊

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

### 存取詳細資訊 (ACCESS 類型）
<a name="access-details"></a>

對於存取授權，履行詳細資訊包括：
+ **描述** - 有關所授予存取及其使用方式的詳細說明

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

## 將配置套用至新的利益應用程式
<a name="applying-allocations-to-new-benefit-applications"></a>

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

例如，合作夥伴可能會：

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

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

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

1. 專案獲得核准時，從配置中提取資金

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