AWS パートナーセントラル API リファレンスが再構築されました。サポートされている API オペレーションの詳細については、 [AWS パートナーセントラル API リファレンス](https://docs.aws.amazon.com/partner-central/latest/APIReference/Welcome.html)を参照してください。

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

# メリット配分の使用
<a name="working-with-benefit-allocations"></a>

メリット配分は、パートナーに付与されたメリットを表します。メリットアプリケーションが承認されると、 は、実際のクレジット、資金、アクセス、またはその他のメリットフルフィルメントをパートナーに提供する 1 つ以上のメリット配分AWSを作成します。

## メリット配分について
<a name="understanding-benefit-allocations"></a>

メリット配分は、さまざまなタイプのフルフィルメントを表すことができます。
+ **財務支払い (CASH)** - 支払い追跡機能を備えたパートナーへの直接財務支払い
+ **AWSクレジット (CREDITS)** - 使用状況を追跡するAWSアカウントに適用されるクレジットコード
+ **消費可能な配分** - 使用率を追跡する事前承認済みの資金金額またはウォレット
+ **Access Grants (ACCESS)** - システム、ツール、またはリソースへのアクセス
+ **認識 (RECOGNITION)** - デジタルバッジ、証明書、またはステータス指定
+ **リソース (リソース)** - テクニカルサポート、アドバイザリサービス、または ProServe エンゲージメント

各利点の割り当てには、ステータスフィールドを通じて追跡されるライフサイクルがあります。
+ **ACTIVE** - 割り当てを使用できます
+ **INACTIVE** - 割り当ては一時的に使用できません
+ **FULFILLED** - 割り当てが完全に使用または配信されました

メリット配分には、いつ有効になるか (StartsAt) といつ期限切れになるか (ExpiresAt) を定義する時間情報も含まれます。これにより、パートナーはメリットを活用するための時間枠を理解できます。

## メリット配分の一覧表示
<a name="listing-benefit-allocations"></a>

パートナーは、 `ListBenefitAllocations` API アクションを使用してすべてのメリット配分を表示できます。これにより、包括的なフィルタリング機能を備えた割り当ての概要のページ分割されたリストが返されます。

パートナーは、以下によって割り当てをフィルタリングできます。
+ **メリット識別子** - 特定のメリットの割り当てを表示する
+ **メリットアプリケーション識別子** - 特定のアプリケーションから生じる割り当てを表示する
+ **フルフィルメントタイプ** - 割り当てタイプ (`CREDITS`、`CASH`、 `ACCESS`など) でフィルタリングする
+ **ステータス** - 割り当てステータス (`ACTIVE`、`INACTIVE`、`FULFILLED`) でフィルタリングする

リストレスポンスには、以下を含む割り当ての概要が含まれます。
+ 割り当て ID、ARN、および名前
+ 関連する特典 ID と特典アプリケーション ID (該当する場合)
+ フルフィルメントタイプ
+ 現在のステータス
+ 作成タイムスタンプ
+ [開始日]

このリストビューを使用すると、パートナーは配分追跡ダッシュボードを構築し、以下を特定できます。
+ すぐに使用できるアクティブな割り当て
+ 割り当ての有効期限が近づいています
+ 履歴追跡の達成された割り当て
+ プログラムまたはフルフィルメントタイプ別の合計割り当て値

## 詳細な配分情報の表示
<a name="viewing-detailed-allocation-information"></a>

パートナーは `GetBenefitAllocation` API アクションを使用して、完全な割り当ての詳細を取得できます。これにより、割り当てタイプによって異なるフルフィルメント固有の詳細など、割り当てに関する包括的な情報が提供されます。

**コア割り当て情報:**
+ 一意の識別子 (ID) と Amazon リソースネーム (ARN)
+ 割り当て名とステータス
+ ステータスの理由 (現在のステータスの説明)
+ 関連するメリット ID とメリットアプリケーション ID
+ フルフィルメントタイプ
+ 作成、更新、開始、有効期限のタイムスタンプ

**フルフィルメントの詳細 (タイプ固有):**

FulfillmentDetail フィールドには、フルフィルメントタイプに基づいて異なる情報構造が含まれています。

### 資金支払いの詳細 (CASH タイプ)
<a name="cash-disbursement-details"></a>

直接現金支払いの場合、フルフィルメントの詳細には以下が含まれます。
+ **支払い金額** - 金額の値と通貨コードを含む、支払い済みの資金の合計金額
+ **発行の詳細 (該当する場合)** - 発注書または発行イベントに関する情報:
  + 発行 ID - 支払いの一意の識別子
  + 発行金額 - 現地通貨での金額
  + 発行日時 - 支払いのタイムスタンプ

この構造は、1 回の支払いと、1 回の配分に対して複数の発行が発生する可能性がある事前承認済みの資金シナリオの両方をサポートします。

### クレジットの詳細 (クレジットタイプ)
<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. プロジェクトが承認されると、配分から資金を引き出す

このアプローチにより、事前に承認された資金を持つパートナーのメリット申請プロセスが合理化され、個々のプロジェクトリクエストのレビューサイクルが短縮されます。