AWS パートナーセントラル API リファレンスが再構築されました。サポートされている API オペレーションの詳細については、 [AWS パートナーセントラル API リファレンス](https://docs.aws.amazon.com/partner-central/latest/APIReference/Welcome.html)を参照してください。
翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
# マルチパートナーの機会の使用
AWS Partnerは、アクティブな参加者AWSとして と機会を連携させることができます。
**Topics**
+ [エンゲージメントとスナップショット](#engagements-and-snapshots)
+ [のカスタムポリシーの作成 ResourceSnapshotJobRole](#creating-custom-policy-resourcesnapshotjobrole)
+ [パートナーをオポチュニティに招待する](#inviting-partners-to-an-opportunity)
+ [エンゲージメントの招待の詳細の取得](#retrieving-invitation-details)
+ [エンゲージメントの招待への応答](#responding-engagement-invitation)
+ [マルチパートナーの機会の確認と更新](#reviewing-and-updating-multipartner-opportunities)
+ [スナップショットを使用してパートナーの更新を受け取る](#using-snapshots-to-receive-partner-updates)
+ [エンゲージメントメンバーの表示](#viewing-engagement-members)
+ [リソーススナップショットジョブのステータスのモニタリング](#monitoring-resource-snapshot-job-status)
## エンゲージメントとスナップショット
*エンゲージメント*は、複数のAWS Partnerアカウント間および顧客機会AWSでのコラボレーションAWSのために が所有するリソースです。エンゲージメントにより、個々の機会の所有権と管理を維持しながら、パートナー間の安全な情報共有とコラボレーションが容易になります。エンゲージメントには、アクティブな参加者AWSとしてAWSと パートナーの両方から発生する機会が含まれます。パートナーは、AWSまたは他のパートナーを招待して、 を使用してエンゲージメントに参加させることができます`EngagementInvitations`。招待されたパートナーが承諾すると、同じエンゲージメント内で独自の機会を受け取ります。
エンゲージメントメンバーは、スナップショットを通じて進捗状況を共有します。つまり、オポチュニティなどの基盤となるリソースから特定のフィールドのポイントインタイムのイミュータブルコピーです。スナップショットはエンゲージメント内で作成され、メンバーと共有されます。基盤となるリソースが変更されると、所有者は更新を反映する新しいスナップショットリビジョンを作成できます。AWSは、リソースが変更されると新しいリビジョンを自動的に作成するスナップショットジョブを提供します。共有されると、スナップショットはエンゲージメントメンバーが永続的にアクセスできるようになります。
## のカスタムポリシーの作成 ResourceSnapshotJobRole
マルチパートナーの機会に協力するには、エンゲージメントで他のパートナーと機会のスナップショットを共有する必要があります。最新のオポチュニティの詳細へのアクセスを維持するには、 というカスタムロールを作成する必要があります`ResourceSnapshotJobRole`。このロールにより、システムはユーザーに代わってオポチュニティのスナップショットを作成し、同じエンゲージメントの他のパートナーからスナップショットを取得できます。このロールがない場合、オポチュニティに加えた更新は、エンゲージメント内の他のパートナーには表示されず、オポチュニティデータの古いスナップショットが引き続き表示されます。
**注記**
以外の名前を使用できます`ResourceSnapshotJobRole`。別の名前を使用する場合は、次のポリシー`ResourceSnapshotJobRole`の のすべてのインスタンスをポリシー名に置き換えます。
このロールを作成するには、IAM コンソールに移動し、次のカスタム信頼ポリシーを使用して`ResourceSnapshotJobRole`ロールを作成します。
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Principal": {
"Service": "resource-snapshot-job.partnercentral-selling.amazonaws.com"
},
"Action": "sts:AssumeRole"
}
]
}
```
------
このロールを作成したら、 [AWSPartnerCentralSellingResourceSnapshotJobExecutionRolePolicy](https://docs.aws.amazon.com/aws-managed-policy/latest/reference/AWSPartnerCentralSellingResourceSnapshotJobExecutionRolePolicy.html)AWS管理ポリシーをアタッチするか、次のアクセス許可ポリシーをアタッチする必要があります。
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Action": [
"partnercentral:CreateResourceSnapshot"
],
"Resource": [
"arn:aws:partnercentral:*::catalog/AWS/engagement/*"
]
},
{
"Effect": "Allow",
"Action": [
"partnercentral:GetOpportunity"
],
"Resource": [
"arn:aws:partnercentral:*:{{111122223333}}:catalog/AWS/opportunity/*"
]
}
]
}
```
------
`{account}` は自分の AWS アカウント ID に置き換えます。
`ResourceSnapshotJobRole` ロールを作成してアクセス許可をアタッチしたら、組織の `ResourceSnapshotJobRole` を設定する必要があります。[PutSellingSystemSettings](https://docs.aws.amazon.com/partner-central/latest/APIReference/API_PutSellingSystemSettings.html) アクションを使用して、会社の (AWSアカウントによって識別される) `ResourceSnapshotJobRole` として作成したロールを設定します。
```
aws-cli/2.13.5 Python/3.11.4 Linux/4.14.255-314-253.539.amzn2.x86_64
Host: partner-central.aws.amazon.com
Content-Type: application/json
{
"ResourceSnapshotJobRoleIdentifier": "arn:aws:iam::{account}:role/ResourceSnapshotJobRole"
}
```
をAWSアカウント ID `{account}`に、 を作成したロールの名前`ResourceSnapshotJobRole`に置き換えます。このロールは、リソーススナップショットジョブによって暗黙的に引き受けられ、機会にアクセスし、エンゲージメント内の他のパートナーと共有するためのスナップショットを作成します。
## パートナーをオポチュニティに招待する
パートナーは、エンゲージメントの招待を開始することで、パートナーとAWSの両方から生じる機会にコラボレーションできます。最大 9 つのパートナーを 1 つのオポチュニティに招待できます。
**パートナーをオポチュニティに招待するには**
1. Partner *AWS Central 販売ガイド*の[「パートナーの検索と接続](https://docs.aws.amazon.com/partner-central/latest/sales-guide/partner-connections.html#finding-partners)」の手順に従います。パートナーを機会に招待する前に、パートナーに接続する必要があります。この接続により、互いのアカウント IDs への相互アクセスが許可され、招待が目的のパートナーアカウントに到達できるようになります。
1. [StartEngagementFromOpportunityTask](https://docs.aws.amazon.com/partner-central/latest/APIReference/API_StartEngagementFromOpportunityTask.html) アクションを使用してエンゲージメントを作成し、そのエンゲージメントにオポチュニティを関連付けます。この非同期アクションは、次のタスクを順番に実行します。
1. エンゲージメントを作成します。
1. 機会をエンゲージメントに関連付けます。
1. [CreateEngagementInvitation](https://docs.aws.amazon.com/partner-central/latest/APIReference/API_CreateEngagementInvitation.html) アクションを に呼び出しますAWS。
1. オポチュニティを に送信しますAWS。
1. を起動`ResourceSnapshotJob`してスナップショットを作成します。
1. 他のパートナーを招待して参加させます。
1. オポチュニティに関連付けられたエンゲージメント ID を取得するには、前のステップで`TaskIdentifier`返された でフィルタリングされた [ListEngagementFromOpportunityTasks](https://docs.aws.amazon.com/partner-central/latest/APIReference/API_ListEngagementFromOpportunityTasks.html)アクションを使用します。
1. で招待を送信するには、受信パートナーのエンゲージメント ID とアカウント ID を使用します`CreateEngagementInvitation`。
招待が成功すると、エンゲージメント招待作成イベントが受信側パートナーに送信されます。
## エンゲージメントの招待の詳細の取得
エンゲージメント招待作成イベントを受け取ったら、 [GetEngagementInvitation](https://docs.aws.amazon.com/partner-central/latest/APIReference/API_GetEngagementInvitation.html)アクションを使用して招待の詳細を取得します。レスポンスには、エンゲージメントに関連する顧客機会に関する重要な情報が含まれます。
招待の詳細、特に `InvitationMessage`、、`Project.CustomerUseCase`、および `Project.Title``Project.CustomerBusinessProblem`フィールドを確認します。この情報は、顧客の機会と招待パートナーのコラボレーションへの期待に関するコンテキストを提供します。
これらの詳細を使用して、エンゲージメントの招待を承諾または拒否して機会を追求するかどうかを評価します。
## エンゲージメントの招待への応答
パートナーがエンゲージメント招待を送信すると、招待を通知するエンゲージメント招待作成イベントが作成されます。招待を受け入れるか拒否するかを選択できます。この決定により、マルチパートナーの機会への関与が決まります。
**エンゲージメントの招待を拒否するには:**
[RejectEngagementInvitation](https://docs.aws.amazon.com/partner-central/latest/APIReference/API_RejectEngagementInvitation.html) アクションを使用して招待を拒否します。決定を説明する`RejectionReason`パラメータを指定する必要があります。拒否されると、招待の詳細にアクセスできなくなり、エンゲージメント招待拒否イベントは、招待を拒否したことを送信側パートナーに通知します。
**エンゲージメントの招待を受け入れるには:**
招待を受け入れ、マルチパートナーオポチュニティに進むには、 [StartEngagementByAcceptingInvitationTask](https://docs.aws.amazon.com/partner-central/latest/APIReference/API_StartEngagementByAcceptingInvitationTask.html)アクションを使用します。この非同期アクションは、次のタスクを順番に実行します。
1. エンゲージメントの招待を受け入れます。
1. 送信パートナーのオポチュニティのデータを使用して、パートナーアカウントに新しいオポチュニティを作成します。オポチュニティ作成イベントを受け取ります。
1. アカウントの顧客を識別するために必要な追加の詳細が含まれます。
1. 招待を承諾し、エンゲージメントに追加されたことをパートナーに通知するエンゲージメント招待承諾イベントを発行します。
**期限切れのエンゲージメントの招待**
エンゲージメントの招待に 15 日以内に応答しない場合、その招待は期限切れになり、マルチパートナー機会に参加することはできません。エンゲージメント招待の有効期限が切れたイベントは、招待の有効期限が切れたことを送信パートナーに通知します。
**注記**
それでもコラボレーションする場合は、送信側パートナーが新しいエンゲージメントの招待を開始する必要があります。
## マルチパートナーの機会の確認と更新
パートナーがオポチュニティでエンゲージメントを開始すると、受信パートナーのアカウントで新しく作成されたオポチュニティのレビューステータスは、送信パートナーのオポチュニティステータスによって決まります。
**レビューステータスが送信されたオポチュニティ:**
送信パートナーのオポチュニティが に`Lifecycle.ReviewStatus`設定されている場合`Submitted`、次のプロセスが発生します。
1. 受信パートナーのアカウントで作成された新しいオポチュニティは に`Lifecycle.ReviewStatus`設定されます`Submitted`。
1. `Submitted` ステータスは、送信パートナーのオポチュニティが になるまで残ります`Approved`。
1. 送信パートナーのオポチュニティが検証され、 `Lifecycle.ReviewStatus`が に設定されると`Approved`、他のパートナーのオポチュニティは自動的に`Approved`ステータスを継承します。
このプロセスにより、マルチパートナーの機会全体で一貫した機会の詳細が確保され、複数のレビューが不要になります。
完了すると、オポチュニティ作成イベントが、対応するオポチュニティ ID でトリガーされます。パートナーは、この ID を `GetOpportunity`アクションとともに使用して、オポチュニティの詳細全体を取得できます。
**承認されたレビューステータスのオポチュニティ:**
送信側パートナーが を `Lifecycle.ReviewStatus`に設定してオポチュニティでエンゲージメントを開始すると`Approved`、次のプロセスが発生します。
1. 受信パートナーのアカウントで作成された新しいオポチュニティは に`Lifecycle.ReviewStatus`設定されます`Approved`。
1. オポチュニティ作成イベントは、対応するオポチュニティ ID でトリガーされます。
1. パートナーは、オポチュニティ ID で [GetOpportunity](https://docs.aws.amazon.com/partner-central/latest/APIReference/API_GetOpportunity.html)アクションを使用して、オポチュニティの詳細全体を取得できます。
ただし、承認されたオポチュニティには、送信側パートナーのオポチュニティからコピーされなかったパートナー固有の詳細がない場合があります。受信側パートナーは、オポチュニティステージが `Qualified`以降のステージに更新されたときに、 [UpdateOpportunity](https://docs.aws.amazon.com/partner-central/latest/APIReference/API_UpdateOpportunity.html)アクションを使用してこれらの詳細を更新する必要があります。
+ `Project.CustomerUseCase`
+ `Project.DeliveryModels`
+ `Solution`
+ `PrimaryNeedsFromAws`
+ `LifeCycle.TargetCloseDate`
+ `Project.ExpectedCustomerSpend.Amount`
+ `Project.ExpectedCustomerSpend.Currency`
+ `Marketing.source`
+ `Marketing.AwsFundingUsed`
オポチュニティが受信パートナーのアカウントで作成されると、パートナーのシステム内の他のオポチュニティと同様に管理および更新できます。パートナーは、 [UpdateOpportunity](https://docs.aws.amazon.com/partner-central/latest/APIReference/API_UpdateOpportunity.html)アクションを使用して変更を行ったり、機会への関与に関する詳細情報を提供したりできます。
## スナップショットを使用してパートナーの更新を受け取る
エンゲージメント内では、パートナーは機会を個別に維持および更新します。オポチュニティの追加など、エンゲージメントのリソースを変更すると、エンゲージメントリソーススナップショット作成イベントが公開されます。
変更を常に把握し、他のパートナーの機会から最新の情報にアクセスするには、次のアクションを使用できます。
+ [ListEngagementResourceAssociations](https://docs.aws.amazon.com/partner-central/latest/APIReference/API_ListEngagementResourceAssociations.html) – このアクションを使用して、オポチュニティに関連付けられたエンゲージメント ID を取得します。
+ [ListResourceSnapshots](https://docs.aws.amazon.com/partner-central/latest/APIReference/API_ListResourceSnapshots.html) – このアクションを使用して、エンゲージメントに関連するすべてのオポチュニティスナップショットの包括的なリストを取得し、すべてのパートナーで利用可能なスナップショットの概要を提供します。
+ [GetResourceSnapshot](https://docs.aws.amazon.com/partner-central/latest/APIReference/API_GetResourceSnapshot.html) – このアクションを使用して、特定のオポチュニティスナップショットのリアルタイムの概要を取得し、別のパートナーのオポチュニティに直接アクセスすることなくup-to-date最新の情報を表示できます。
別のパートナーのオポチュニティから、自身に反映すべき関連する変更や更新を特定した場合は、 [UpdateOpportunity](https://docs.aws.amazon.com/partner-central/latest/APIReference/API_UpdateOpportunity.html)アクションを使用します。このアクションにより、関連するデータをオポチュニティに選択的に組み込むことが容易になり、エンゲージメント全体で整合性と一貫性が確保されます。
## エンゲージメントメンバーの表示
マルチパートナーオポチュニティへのエンゲージメントには、最大 10 のパートナーを含めることができます。新しいパートナーがエンゲージメントの招待を受け入れるたびに、エンゲージメントメンバーが追加したイベントが公開され、現在のすべてのメンバーに変更が通知されます。
エンゲージメント内でコラボレーションしているすべてのメンバーを表示するには、次の手順に従います。
1. [ListEngagementResourceAssociations](https://docs.aws.amazon.com/partner-central/latest/APIReference/API_ListEngagementResourceAssociations.html) アクションを使用して、オポチュニティに関連付けられたエンゲージメント ID を取得します。
1. ステップ 1 の ID を [ListEngagementMembers](https://docs.aws.amazon.com/partner-central/latest/APIReference/API_ListEngagementMembers.html)アクションに指定して、エンゲージメントメンバーのパートナーの詳細を取得します。
**注記**
エンゲージメントのメンバーのみが `ListEngagementMembers`アクションを呼び出すことができます。
## リソーススナップショットジョブのステータスのモニタリング
マルチパートナーオポチュニティを使用する場合は、他のパートナーのオポチュニティのスナップショットを作成し、エンゲージメント内の他のパートナーからオポチュニティスナップショットを取得できるロールを作成する必要があります。このロールがない場合、オポチュニティに加えた更新は、エンゲージメントの他のパートナーには利用できず、オポチュニティの古いスナップショットが引き続き表示されます。
エンゲージメントのマルチパートナーオポチュニティに関連付けられたリソーススナップショットジョブのステータスを追跡するには、次の手順に従います。
1. [ListEngagementResourceAssociations](https://docs.aws.amazon.com/partner-central/latest/APIReference/API_ListEngagementResourceAssociations.html) アクションを使用して、オポチュニティに関連付けられたエンゲージメント ID を取得します。
1. ステップ 1 の ID を [ListResourceSnapshotJobs](https://docs.aws.amazon.com/partner-central/latest/APIReference/API_ListResourceSnapshotJobs.html)アクションに提供して、エンゲージメントで発信者が所有するすべてのスナップショットジョブのリストを生成します。レスポンスからジョブ ID を取得します。
1. [GetResourceSnapshotJob](https://docs.aws.amazon.com/partner-central/latest/APIReference/API_GetResourceSnapshotJob.html) アクションにジョブ ID を指定して、ジョブのステータスを追跡し、実行中かどうかを確認します。
`ResourceSnapshotJob` オペレーションは、非同期オペレーションのメトリクスを Amazon CloudWatch に発行します。CloudWatch は、データを読み取り可能なほぼリアルタイムのメトリクスに処理し、サービスのパフォーマンスとヘルスをモニタリングするのに役立ちます。
以下のメトリクスが利用可能です。
+ **障害** – ジョブ実行中の内部問題をカウントします。このメトリクスを使用して、サービスの安定性をモニタリングし、障害しきい値のアラームを設定します。
+ **エラー** – ジョブ処理中の顧客関連の問題を追跡します。このメトリクスは、顧客の入力または設定に関する問題を特定するのに役立ちます。
+ **呼び出し** – 成功した試行と失敗した試行の両方を含む、ジョブ呼び出しの合計数を表します。これを使用して、時間の経過に伴うサービス使用状況の傾向を追跡します。
**注記**
メトリクスは、`ResourceSnapshotJob`サービスにアクティビティがある場合にのみ CloudWatch に報告されます。特定のメトリクスのジョブまたはデータがない場合、そのメトリクスは報告されません。
オペレーションをスムーズに`ResourceSnapshotJob`操作するには:
+ メトリクスを使用して、サービスが期待どおりに動作することを確認します。
+ CloudWatch アラームを作成して、メトリクスをモニタリングし、メトリクスが許容範囲を超えたときにアクション (通知の送信など) をトリガーします。
+ プロアクティブモニタリングを設定して、問題を特定して解決します。
CloudWatch メトリクスの使用の詳細については、[Amazon CloudWatch ユーザーガイド](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/)」を参照してください。