AWS パートナーセントラル API リファレンスが再構築されました。サポートされている API オペレーションの詳細については、 [AWS パートナーセントラル API リファレンス](https://docs.aws.amazon.com/partner-central/latest/APIReference/Welcome.html)を参照してください。
翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
# Benefits API へのアクセス
アクセスコントロールとアクセス許可はAWS Identity and Access Management(IAM) によって管理されます。このセクションでは、 Benefits API を操作するために必要なアクセス許可を設定するためのガイダンスを提供します。
## 前提条件
アクセス許可を設定する前に、AWS アカウントが にリンクされ、必要な IAM ロールとユーザーが作成されていることを確認します。詳細については、「[セットアップと認証](setup-authentication.md)」を参照してください。
## AWS管理ポリシーの使用
AWSには、 Benefits API を操作するために必要なアクセス許可を付与する マネージドポリシーが用意されています。特典リソースを管理するために必要なアクセスを提供するには、`AWSPartnerCentralFullAccess`ポリシーを IAM ID にアタッチします。詳細については、[AWS「 ユーザーの 管理ポリシー](https://docs.aws.amazon.com/partner-central/latest/getting-started/managed-policies.html)」を参照してください。
## IAM ロールとユーザーにポリシーを割り当てる
IAM ロールとユーザーにポリシーを割り当てるには、次の手順に従います。
1. AWS Management Consoleにサインインします。
1. IAM サービスに移動します。
1. ロールまたはユーザーを選択し、ポリシーをアタッチする IAM ロールまたはユーザーを選択します。
1. 選択した IAM ロールまたはユーザーに`AWSPartnerCentralFullAccess`ポリシーをアタッチします。
詳細については、「[Adding and removing IAM identity permissions](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_manage-attach-detach.html)」(IAM アクセス許可の追加と削除) を参照してください。
## 条件キーを使用したアクセス許可の管理
IAM ポリシーの条件キーは、ステートメントポリシーを適用するタイミングに関するリソースレベルのアクセス許可を提供します。条件キーを使用して、特定のアクセス許可がいつ許可または拒否されるかを決定する条件を指定できます。
詳細については、「[IAM JSON ポリシー要素: 条件演算子](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_elements_condition_operators.html)」を参照してください。
**条件キーの概要**
| 条件キー | 説明 | 適用可能なアクション | 有効値 |
| --- | --- | --- | --- |
| partnercentral:カタログ | は、関連付けられたカタログエンティティのタイプによってアクセスをフィルタリングします | すべてのアクション | AWS、サンドボックス |
## 必要なアクセス許可の概要
**必要なアクセス許可の概要**
| [アクション] | 説明 |
| --- | --- |
| partnercentral:AmendBenefitApplication | では、メリットアプリケーションを修正できます。 |
| partnercentral:AssociateBenefitApplicationResource | では、リソースをメリットアプリケーションに関連付けることができます |
| partnercentral:CancelBenefitApplication | で特典アプリケーションのキャンセルを許可する |
| partnercentral:CreateBenefitApplication | でメリットアプリケーションを作成可能に |
| partnercentral:DisassociateBenefitApplicationResource | では、メリットアプリケーションからリソースの関連付けを解除できます |
| partnercentral:GetBenefit | では、メリットの詳細を取得できます。 |
| partnercentral:GetBenefitAllocation | では、メリット配分の詳細を取得できます。 |
| partnercentral:GetBenefitApplication | では、メリットアプリケーションの詳細を取得できます |
| partnercentral:ListBenefitAllocations | でメリット配分の一覧表示を許可 |
| partnercentral:ListBenefitApplications | でメリットアプリケーションの出品を許可 |
| partnercentral:ListBenefits | では、利点を一覧表示できます。 |
| partnercentral:RecallBenefitApplication | では、メリットアプリケーションを再現できます。 |
| partnercentral:SubmitBenefitApplication | はメリットアプリケーションの送信を許可します |
| partnercentral:UpdateBenefitApplication | メリットアプリケーションの更新を許可 |