AWS Marketplace API リファレンスが再構築されました。サポートされている API オペレーションの詳細については、[AWS Marketplace API リファレンス](https://docs.aws.amazon.com/marketplace/latest/APIReference/Welcome.html)を参照してください。
翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
# AWS Marketplace 契約 API のアクセスコントロール
Agreement Service AWS Marketplace を使用して で契約を管理するには、 AWS Identity and Access Management (IAM) ポリシーとロールが設定されていることを確認する必要があります。ユーザーがアクションを実行できるようにするには、次のポリシー/アクセス許可が必要です。
+ `CreateAgreementRequest` – 新しい契約を作成したり、既存の契約を更新したりするための新しいリクエストを開始するアクセス許可をユーザーに付与します。
+ `AcceptAgreementRequest` – 契約にマテリアライズするために以前に作成したリクエストを受け入れるアクセス許可をユーザーに付与します。注: 契約リクエストを受け入れる際に、ユーザーが発注書を提供する場合は、アクションを実行するための`UpdatePurchaseOrders`アクセス許可も必要です。
+ `GetAgreementEntitlements` – 契約の使用権限を一覧表示するアクセス許可をユーザーに付与します。
+ `CancelAgreement` – ユーザーが参加しているアクティブな契約をキャンセルするアクセス許可を付与します。
+ `ListAgreementCharges` – 契約に対する料金を一覧表示するアクセス許可をユーザーに付与します。
+ `UpdatePurchaseOrders` – 契約料金の発注書を更新するアクセス許可をユーザーに付与します。
+ `SendAgreementCancellationRequest` – キャンセルリクエストを送信するアクセス許可をユーザーに付与します。
+ `AcceptAgreementCancellationRequest` – アクセプタとして参加する契約について、販売者が開始したキャンセルリクエストを受け入れるアクセス許可をユーザーに付与します。注: キャンセルリクエストを承認すると契約がキャンセルされるため、ユーザーには アクセス`CancelAgreement`許可も必要です。
+ `RejectAgreementCancellationRequest` – アクセプタとして参加する契約について販売者が開始したキャンセルリクエストを拒否するアクセス許可をユーザーに付与します。
+ `SendAgreementPaymentRequest` – 支払いリクエストを送信するアクセス許可をユーザーに付与します。
+ `AcceptAgreementPaymentRequest` – アクセプタとして参加する契約について、販売者が開始した支払いリクエストを受け入れるアクセス許可をユーザーに付与します。
+ `RejectAgreementPaymentRequest` – アクセプタとして参加する契約について販売者が開始した支払いリクエストを拒否するアクセス許可をユーザーに付与します。
+ `GetAgreementCancellationRequest` – アクセプターとして参加する契約の特定のキャンセルリクエストに関する詳細情報を取得するアクセス許可をユーザーに付与します。
+ `ListAgreementCancellationRequests` – アクセプターとして参加する契約のキャンセルリクエストを一覧表示するアクセス許可をユーザーに付与します。
+ `GetAgreementPaymentRequest` – アクセプタとして参加する契約の特定の支払いリクエストに関する詳細情報を取得するアクセス許可をユーザーに付与します。
+ `ListAgreementPaymentRequests` – アクセプターとして参加する契約の支払いリクエストを一覧表示するアクセス許可をユーザーに付与します。
+ `DescribeAgreement` – 契約に関する詳細なメタデータを取得するアクセス許可をユーザーに付与します。
+ `GetAgreementTerms` – 契約の条件に関する詳細を取得するアクセス許可をユーザーに付与します。
+ `SearchAgreements` – すべての契約を検索するためのアクセス許可をユーザーに付与します。
**注記**
これらのアクセス許可の詳細については、「 [販売者ガイド」の「AWS Marketplace 販売者のポリシーとアクセス許可](https://docs.aws.amazon.com/marketplace/latest/userguide/detailed-management-portal-permissions.html)」および「 *AWS Marketplace 購入者ガイド*」の[「AWS Marketplace サブスクリプションへのアクセスの制御](https://docs.aws.amazon.com/marketplace/latest/buyerguide/buyer-iam-users-groups-policies.html)」を参照してください。 *AWS Marketplace *
## AWS 管理ポリシーによるアクションの許可
AWS Marketplace はペルソナ固有の管理ポリシーを定義します。IAM ID に マネージドポリシーを使用できます。これにより、デフォルトで指定されたロールのポリシーの範囲が絞り込まれます。マネージドポリシーを使用すると、ベストプラクティスに従い、 Marketplace で新機能が利用可能になったときにポリシーの更新を受け取ることができます。
これらのアクセス許可の詳細については、「 *AWS Marketplace 販売者ガイド*[」の「AWS Marketplace 販売者のポリシーとアクセス許可](https://docs.aws.amazon.com/marketplace/latest/userguide/detailed-management-portal-permissions.html)」および「 *AWS Marketplace 購入者ガイド*」の[「AWS Marketplace サブスクリプションへのアクセスの制御](https://docs.aws.amazon.com/marketplace/latest/buyerguide/buyer-iam-users-groups-policies.html)」を参照してください。
ここで説明する AWS 管理ポリシーのアクセス許可に制限されません。IAM を使用して、カスタムアクセス許可を持つポリシーを作成し、そのポリシーを IAM ロールに追加できます。詳細については、「*IAM ユーザーガイド*」の「[IAM ポリシーを管理する](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_manage.html)」と「[IAM ID のアクセス許可の追加](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_manage-attach-detach.html)」を参照してください。
## カスタマー管理ポリシーによるアクションの許可
カスタマー管理ポリシーを定義して、契約サービス APIs へのアクセスを制御することもできます。効果、アクション、サポートされている条件を組み合わせてポリシーをカスタマイズできます。
製品サブスクリプションを管理するための AWS Marketplace Agreements API にアクセスするには、次のポリシーを作成してアクセスを許可できます。
```
{
"Version": "2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Action": [
"aws-marketplace:CreateAgreementRequest",
"aws-marketplace:AcceptAgreementRequest"
],
"Resource": "*",
"Condition": {
"ForAllValues:StringEquals": {
"aws-marketplace:AgreementType": ["PurchaseAgreement"]
}
}
},
{
"Effect": "Allow",
"Action": [
"aws-marketplace:CancelAgreement",
"aws-marketplace:GetAgreementEntitlements",
"aws-marketplace:UpdatePurchaseOrders",
"aws-marketplace:ListAgreementCharges"
],
"Resource": "*",
"Condition": {
"ForAllValues:StringEquals": {
"aws-marketplace:AgreementType": ["PurchaseAgreement"]
}
}
},
{
"Effect": "Allow",
"Action": [
"aws-marketplace:AcceptAgreementCancellationRequest",
"aws-marketplace:RejectAgreementCancellationRequest",
"aws-marketplace:GetAgreementCancellationRequest",
"aws-marketplace:ListAgreementCancellationRequests",
"aws-marketplace:CancelAgreement"
],
"Resource": "*",
"Condition": {
"ForAllValues:StringEquals": {
"aws-marketplace:AgreementType": ["PurchaseAgreement"]
}
}
},
{
"Effect": "Allow",
"Action": [
"aws-marketplace:AcceptAgreementPaymentRequest",
"aws-marketplace:RejectAgreementPaymentRequest",
"aws-marketplace:GetAgreementPaymentRequest",
"aws-marketplace:ListAgreementPaymentRequests"
],
"Resource": "*",
"Condition": {
"ForAllValues:StringEquals": {
"aws-marketplace:AgreementType": ["PurchaseAgreement"]
}
}
},
{
"Effect": "Allow",
"Action": [
"aws-marketplace:DescribeAgreement",
"aws-marketplace:SearchAgreements",
"aws-marketplace:GetAgreementTerms"
],
"Resource": "*",
"Condition": {
"ForAllValues:StringEquals": {
"aws-marketplace:AgreementType": ["PurchaseAgreement"]
},
"StringEquals": {
"aws-marketplace:PartyType": "Acceptor"
}
}
}
]
}
```
## サービス定義の条件キーを使用したポリシーのカスタマイズ
### AgreementType 条件キーの使用
以下のステートメントは、 `UpdatePurchaseOrders`オペレーションへのアクセスを`PurchaseAgreement`契約タイプに対してのみ制限します。
```
{
"Effect": "Allow",
"Action": [
"aws-marketplace:UpdatePurchaseOrders"
],
"Resource": "*",
"Condition": {
"ForAllValues:StringEquals": {
"aws-marketplace:AgreementType": ["PurchaseAgreement"]
}
}
}
```
### ProductId 条件キーの使用
以下のステートメントでは、 `CreateAgreementRequest`および へのアクセス`AcceptAgreementRequest`を、指定された AWS Marketplace 製品 ID のみに制限しています。このステートメントを含めると、Bedrock 基盤モデルの制限など、事前承認された製品 ID のみを作成できます。
```
{
"Effect": "Allow",
"Action": [
"aws-marketplace:CreateAgreementRequest",
"aws-marketplace:AcceptAgreementRequest"
],
"Resource": "*",
"Condition": {
"ForAnyValue:StringEquals": {
"aws-marketplace:ProductId": [
"model-product-id-1",
"model-product-id-2"
]
}
}
}
```
### PartyType 条件キーの使用
以下のステートメントでは、ユーザーが契約の提案者である場合、契約の詳細を読み取るためのアクセス権を付与します。
```
{
"Effect": "Allow",
"Action": [
"aws-marketplace:DescribeAgreement"
],
"Resource": "*",
"Condition": {
"StringEquals": {
"aws-marketplace:PartyType": "Proposer"
}
}
}
```