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

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

# パートナーアカウント接続の使用
<a name="working-with-account-connections"></a>

パートナーは、 Partner Connection API を使用して AWS 、自分のアカウント間の接続または他のパートナーの AWS アカウントとの接続を管理できます。このプロセスには 2 つのフェーズがあります。

1. **接続招待フェーズ:** 接続リクエストの開始と応答

1. **アクティブ接続フェーズ:** 確立された接続とそれに関連するビジネスアクティビティの管理

## 接続招待の作成と送信
<a name="creating-and-sending-connection-invitation"></a>

### ステップ 1: 接続招待を作成する
<a name="step-1-create-connection-invitation"></a>

パートナー接続を確立する最初のステップは、 `CreateConnectionInvitation`アクションを使用して接続招待を作成して送信することです。招待を作成するときは、以下を指定する必要があります。
+ **カタログ:** AWS 接続が管理されるカタログ (AWS またはサンドボックス)
+ **ConnectionType:** 確立する関係のタイプ。次のいずれかを選択します。
  + **`OPPORTUNITY_COLLABORATION`:** 別のパートナーのアカウントに接続リクエストを送信して、オポチュニティコラボレーションのためのオポチュニティエンゲージメントの招待を送信できるようにする場合は、このタイプを使用します。
  + **`SUBSIDIARY`:** このタイプは、所有している複数の AWS Marketplace 販売者アカウントを、APN にリンクした「プライマリ」アカウントまたはパートナーとして登録されている「プライマリ」アカウントに接続する場合に使用します。
+ **ReceiverIdentifier:** レシーバーのパブリックパートナープロファイル ID (オポチュニティコラボレーション接続タイプの場合) または AWS アカウント ID (子会社接続タイプの場合)
+ **E メール:** 通信用の連絡先 E メールアドレス
+ **名前:** 送信者としての名前
+ **メッセージ:** 接続リクエストの目的を説明する説明

作成されると、招待は保留中状態になり、受信者からのアクションを待ちます。

**重要**  
接続の招待を送信することで、受信者が招待を承諾した場合に、受信者に AWS アカウント ID を公開することに同意したものとみなされます。この開示は、アカウントレベルの接続を確立するために必要です。

### ステップ 2: 送信された招待をモニタリングする
<a name="step-2-monitor-sent-invitations"></a>

`ParticipantType` パラメータを に設定して、 `ListConnectionInvitations`アクションを使用して送信した招待のステータスを追跡できます`SENDER`。これにより、次のことが可能になります。
+ すべての送信招待を表示する
+ ステータス (`PENDING`、`ACCEPTED`、、`EXPIRED`) でフィルタリング`REJECTED`する
+ 接続タイプでフィルタリングする
+ 他のパートナーへの特定の招待を確認する

### ステップ 3: 招待をキャンセルする (オプション)
<a name="step-3-cancel-invitation"></a>

承諾する前に保留中の招待を取り消す必要がある場合は、 `CancelConnectionInvitation`アクションを使用できます。以下の点に注意してください。
+ 保留中状態の招待のみをキャンセルできます
+ 招待が承諾され、接続が確立されると、キャンセルすることはできません。
+ 確立された接続を終了するには、代わりに `CancelConnection`アクションを使用する必要があります。

## 接続招待の受信と応答
<a name="receiving-and-responding-to-invitations"></a>

### ステップ 1: 着信招待を一覧表示する
<a name="list-incoming-invitations"></a>

受信した接続の招待を表示するには、 ParticipantType パラメータを に設定して `ListConnectionInvitations`アクションを使用します`RECEIVER`。次の方法でフィルタリングできます。
+ [接続タイプ]
+ ステータス (`PENDING`、`ACCEPTED`、`REJECTED`)
+ 送信者の識別子

### ステップ 2: 招待の詳細を確認する
<a name="review-invitation-details"></a>

`GetConnectionInvitation` アクションを使用して、次のような特定の招待の完全な詳細を表示します。
+ 送信者の名前と連絡先 E メール
+ 目的を説明する招待メッセージ
+ リクエストされている接続タイプ
+ 有効期限日
+ 送信者のパブリックプロファイル情報

### ステップ 3: 招待を承諾または拒否する
<a name="accept-or-reject-invitation"></a>

招待の詳細を確認したら、次の 2 つのオプションがあります。

#### オプション A: 招待を受け入れる
<a name="option-a-accept-invitation"></a>

`AcceptConnectionInvitation` アクションを使用して接続を確立します。受け入れる場合:
+ 新しい接続がアクティブ状態で作成されます
+ 招待のステータスが Accepted に変わります
+  AWS アカウント ID が送信者に公開される
+ 接続タイプで有効になっているビジネスアクティビティの実行を開始できます。

**重要**  
**重要な同意:** 接続の招待を受け入れることで、送信者に AWS アカウント ID を公開することに同意します。この開示は、アカウントレベルの接続を確立するために必要です。

#### オプション B: 招待を拒否する
<a name="option-b-reject-invitation"></a>

接続を確立しない場合は、 `RejectConnectionInvitation`アクションを使用します。オプションで拒否の理由を指定できます。拒否された場合:
+ 招待のステータスが拒否済みに変わります
+ 接続が確立されていない
+ 保留中の招待のリストに招待が表示されなくなります。

### 自動有効期限
<a name="automatic-expiration"></a>

有効期限内にアクションが実行されない場合、招待は自動的に期限切れ状態に移行します。期限切れの招待は承諾または拒否できません。

## アクティブな接続の管理
<a name="managing-active-connections"></a>

### 接続の表示
<a name="viewing-your-connections"></a>

接続が確立されると、両者は次のアクションを使用して接続を表示および管理できます。

**`ListConnections`:** フィルタリングオプションを使用して接続のリストを取得します。
+ 接続タイプとステータスでフィルタリングする (例: `OPPORTUNITY_COLLABORATION:ACTIVE`)
+ 他のユーザーの識別子でフィルタリングする
+ 各接続の概要情報を表示する

**`GetConnection`:** 以下を含む、特定の接続の完全な詳細を取得します。
+ このパートナー関係に関連付けられているすべての接続タイプ
+ 各接続タイプのステータス (アクティブまたは終了)
+ 元の招待の連絡先情報
+ AWS 両方の アカウント IDs とパブリックプロファイル IDs 
+ 各接続タイプの作成と終了のタイムスタンプ

### 既存の接続への接続タイプの追加
<a name="adding-connection-types"></a>

パートナーとのアクティブな接続がすでにあり、新しいタイプの関係を確立する場合は、別の接続タイプの新しい接続招待を送信できます。承諾時:
+ 新しい接続タイプが既存の接続に追加されます。
+ どちらの接続タイプも個別に管理できます。
+ 関係に対して同じ接続 ID が維持されます

**注記**  
特定のカタログ内の 2 つのアカウント間では、任意のタイプのアクティブな接続が常に 1 つしか存在できません。

### 接続タイプの終了
<a name="terminating-connection-types"></a>

どちらの当事者も、 `CancelConnection`アクションを使用して特定の接続タイプを終了できます。終了する場合:
+ 終了する接続 ID と接続タイプを指定する
+ 終了の理由を入力します。
+ 接続タイプのステータスが に変わります。 `CANCELED`
+ 同じ接続内の他の接続タイプは影響を受けません

### 接続の終了を完了する
<a name="complete-connection-termination"></a>

接続内のすべての接続タイプが終了すると、接続自体は終了状態に移行します。完全に終了した接続:
+ 再アクティブ化することはできませんが、そのアカウントとのビジネスを継続するために新しい接続リクエストを送信できます
+ 履歴レコード保持のためにシステムに残ります
+ `GetConnection` API を使用して表示可能
+ 関係を再確立するには、新しい招待が必要です

## 接続イベントのモニタリング
<a name="monitoring-connection-events"></a>

パートナーは、Amazon EventBridge を使用して接続関連のイベントをモニタリングし、次の情報を常に把握する必要があります。
+ 新しい受信接続の招待
+ 送信された招待のステータスの変更 (`ACCEPTED`、`REJECTED`、`EXPIRED`)
+ 相手側によって開始された接続終了

イベントを受信したら、適切な Get API アクションを使用して最新の詳細を取得します。
+ `GetConnectionInvitation` 招待の更新用
+ `GetConnection` 接続更新用

### 考えられるイベント
<a name="possible-events"></a>
+ **Connection Invitation Created:** 受信接続の招待を受信者アカウントに通知します。
+ **Connection Invitation Cancelled:** 送信者が受信接続の招待をキャンセルすると、受信者アカウントに通知します。
+ **接続招待の有効期限切れ:** 接続招待がアクションなしで期限切れになると、送信者アカウントと受信者アカウントの両方に通知します。
+ **接続招待の拒否:** 接続招待が受信者によって拒否されたときに送信者アカウントに通知します。
+ **Connection Invitation Accepted:** 接続の招待が受け入れられ、接続が確立されると、送信者アカウントに通知します。
+ **Connection Cancelled:** すべての接続が完全に終了すると、接続された両方の当事者に通知します。

## 接続状態について
<a name="understanding-connection-states"></a>

### 接続招待の状態
<a name="connection-invitation-states"></a>


| State | 説明 | に移行可能 | 
| --- | --- | --- | 
| PENDING | 作成時の初期状態、受信者アクションを待機中 | ACCEPTED, REJECTED, EXPIRED, CANCELED | 
| ACCEPTED | 受信者が受け入れられました。接続が作成されました | なし (終了状態) | 
| REJECTED | レシーバーが拒否されました。オプションの拒否理由が含まれています | なし (終了状態) | 
| EXPIRED | 有効期限内にアクションがないためにシステム期限切れになる | なし (終了状態) | 
| CANCELED | 送信者が承諾前に招待を取り消した | なし (終了状態) | 

### 接続タイプの状態
<a name="connection-type-states"></a>


| State | 説明 | 
| --- | --- | 
| ACCEPTED | 接続タイプが動作しており、関連するビジネスアクティビティが有効になっている | 
| CANCELED | いずれかの当事者によって終了される接続タイプ | 

## ベストプラクティス
<a name="best-practices"></a>

1. **明確なコミュニケーション:** 目的と期待されるコラボレーションを説明する詳細な明確なメッセージを接続の招待に入力します。

1. **タイムリーな応答: 自動期限切れを避けるため、接続の招待**をモニタリングして迅速に応答します。

1. **定期的なレビュー:** アクティブな接続を定期的に見直して、現在のビジネスニーズに関連性があることを確認します。

1. **適切な終了:** ビジネス関係を終了するときは、明確な理由とともに CancelConnection アクションを使用して、専門的なコミュニケーションを維持します。

1. **Event Monitoring:** EventBridge ルールを設定して、接続ステータスの変更の通知を自動的に受信し、重要な更新を常に把握できるようにします。

1. **接続タイプ管理:** 接続を確立する前に必要な接続タイプを検討してください。タイプごとに異なるビジネス機能が有効になります。

1. **セキュリティ意識:** 接続を確立すると、当事者間の AWS アカウント IDsが明らかになることに注意してください。信頼できるパートナーとのみ接続します。

## 接続タイプとその目的
<a name="connection-types-and-purposes"></a>


| 接続タイプ | 目的 | ユースケース | 
| --- | --- | --- | 
| OPPORTUNITY\_COLLABORATION | 他のパートナーとの共同販売の機会に関するコラボレーションを可能にする | 他のパートナーがオポチュニティにアクセスできるようにする場合、またはその逆の場合は、この接続タイプを使用します。この接続により、接続されたパートナーにオポチュニティエンゲージメントの招待を送信できます。 | 
| SUBSIDIARY | 複数の AWS Marketplace 販売者アカウントとプライマリパートナーアカウント間の接続を確立します | パートナーおよび販売者として登録されているプライマリアカウントに接続する複数の AWS Marketplace 販売者アカウントがある場合に使用します。 |