

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

# と接続を共有する AWS アカウント
<a name="connections-share"></a>

とのリソース共有を使用して AWS RAM 、既存の接続を別の AWS アカウント または組織内のアカウントと共有できます。CodePipeline など、サードパーティーのソース接続用に AWS 管理する のリソースと共有接続を使用できます。

**重要**  
接続共有は `codestar-connections `リソースではサポートされていません。これは `codeconnections`リソースでのみサポートされています。

開始する前に:
+ との接続が既に作成されている必要があります AWS アカウント。
+ リソース共有が有効になっている必要があります。
+ 必要なアクセス許可を設定する必要があります。詳細については、「[接続共有でサポートされているアクセス許可](security-iam.md#permissions-reference-connections-sharing)」を参照してください。

**注記**  
接続を共有するには、組織所有者であるか、組織内にない場合はリポジトリ所有者である必要があります。共有しているアカウントには、リポジトリへのアクセス許可も必要です。

**Topics**
+ [接続を共有する (コンソール)](#connections-share-console)
+ [接続を共有する (CLI)](#connections-share-cli)
+ [共有接続を表示する (コンソール)](#connections-view-console)
+ [共有接続を表示する (CLI)](#connections-view-cli)

## 接続を共有する (コンソール)
<a name="connections-share-console"></a>

コンソールを使用して、共有接続リソースを作成できます。

1.  AWS マネジメントコンソールにサインインします。

   コンソールの**[「共有ユーザー : 共有リソース](https://console.aws.amazon.com/ram/home#OwnedResources:)**」ページで**「リソース共有の作成**」を選択します AWS RAM 。

1.  AWS RAM リソース共有は特定の AWS リージョンに存在するため、コンソールの右上隅にあるドロップダウンリストから適切な AWS リージョンを選択します。グローバルリソースを含むリソース共有を作成するには、AWS リージョンを米国東部 (バージニア北部) に設定する必要があります。

   グローバルリソースの共有の詳細については、[「グローバルリソースと比較したリージョンリソースの共有](https://docs.aws.amazon.com/ram/latest/userguide/working-with-regional-vs-global.html)」を参照してください。

1. 作成ページの**「名前**」に、リソース共有の名前を入力します。**リソース**で、**コード接続**を選択します。  
![作成ページでリソースを選択してリソース共有を追加する](http://docs.aws.amazon.com/ja_jp/dtconsole/latest/userguide/images/connections-share-create.png)

1. 接続リソースを選択し、共有するプリンシパルを割り当てます。

1. **[作成]** を選択します。

## 接続を共有する (CLI)
<a name="connections-share-cli"></a>

 AWS Command Line Interface (AWS CLI) を使用して、既存の接続を他のアカウントと共有し、所有している、または共有した接続を表示できます。

これを行うには、 **create-resource-share**および `accept-resource-share-invitation `コマンドを使用します AWS RAM。

**接続を共有するには**

1. 接続を共有するアカウントでサインインします。

1. ターミナル (Linux/macOS/Unix) またはコマンドプロンプト (Windows) を開きます。を使用して **create-resource-share** コマンド AWS CLI を実行し、`--principals`接続共有の `--name`、`--resource-arns`、 を指定します。この例では、名前は `my-shared-resource`で、指定された接続名はリソース ARN `MyConnection`にあります。で`principals`、共有している送信先アカウントを指定します。

   ```
   aws ram create-resource-share --name my-shared-resource --resource-arns {{connection_ARN}} --principals {{destination_account}}
   ```

   成功した場合、このコマンドは次のような接続 ARN 情報を返します。

   ```
   {
       "resourceShare": {
           "resourceShareArn": "arn:aws:ram:us-west-2:111111111111:resource-share/4476c27d-8feb-4b21-afe9-7de23EXAMPLE",
           "name": "MyNewResourceShare",
           "owningAccountId": "111111111111",
           "allowExternalPrincipals": true,
           "status": "ACTIVE",
           "creationTime": 1634586271.302,
           "lastUpdatedTime": 1634586271.302
       }
   }
   ```

1. 共有リクエストは、次の手順で説明されているように承諾できます。

**送信先アカウントとの接続共有を認証して受け入れるには**

次の手順は、同じ組織に属し、Organizations でリソース共有が有効になっている送信先アカウントではオプションです。

1. 招待を受け取る送信先アカウントでサインインします。

1. ターミナル (Linux/macOS/Unix) またはコマンドプロンプト (Windows) を開きます。 AWS CLI を使用して **get-resource-share-invitations** コマンドを実行します。

   ```
   aws ram get-resource-share-invitations
   ```

   次のステップのリソース共有招待 ARN をキャプチャします。

1. コマンドを実行し**accept-resource-share-invitation**、 を指定します`--resource-share-invitation-arn`。

   ```
   aws ram accept-resource-share-invitation --resource-share-invitation-arn {{invitation_ARN}}
   ```

   成功すると、このコマンドは次の出力を返します。

   ```
   {
       "resourceShareInvitation": {
           "resourceShareInvitationArn": "arn:aws:ram:us-west-2:111111111111:resource-share-invitation/1e3477be-4a95-46b4-bbe0-c4001EXAMPLE",
           "resourceShareName": "MyResourceShare",
           "resourceShareArn": "arn:aws:ram:us-west-2:111111111111:resource-share/27d09b4b-5e12-41d1-a4f2-19dedEXAMPLE",
           "senderAccountId": "111111111111",
           "receiverAccountId": "222222222222",
           "invitationTimestamp": "2021-09-22T15:07:35.620000-07:00",
           "status": "ACCEPTED"
       }
   }
   ```

## 共有接続を表示する (コンソール)
<a name="connections-view-console"></a>

コンソールを使用して、共有接続リソースを表示できます。

1.  AWS マネジメントコンソールにサインインします。

   AWS RAM コンソールで**[共有 : 共有リソース](https://console.aws.amazon.com/ram/home#OwnedResources:)**ページを開きます。

1. AWS RAM リソース共有は特定の AWS リージョンに存在するため、コンソールの右上隅にあるドロップダウンリストから適切な AWS リージョンを選択します。グローバルリソースを含むリソース共有を表示するには、AWS リージョンを米国東部 (バージニア北部) に設定する必要があります。

   グローバルリソースの共有の詳細については、[「グローバルリソースと比較したリージョンリソースの共有](https://docs.aws.amazon.com/ram/latest/userguide/working-with-regional-vs-global.html)」を参照してください。

1. 共有リソース別に以下の情報が表示されます。
   + **[Resource ID]** (リソース ID) — リソースの ID。リソースの ID を選択してブラウザで新しいタブを開き、ネイティブサービスのコンソールにリソースを表示します。
   + **[Resource type]** (リソースタイプ) — リソースのタイプ。
   + **[Last share date]** (最終共有日) - リソースが最後に共有された日付。
   + **[Resource shares]** (リソース共有) — リソースを含んでいるリソース共有の数。リソース共有のリストを表示するには、番号を選択します。
   + **[Principals]** (プリンシパル) — リソースにアクセスできるプリンシパルの数。プリンシパルを表示する値を選択します。

## 共有接続を表示する (CLI)
<a name="connections-view-cli"></a>

を使用して AWS CLI 、所有している、または共有した接続を表示できます。

これを行うには、**get-resource-shares** コマンドを使用します。

**共有接続を表示するには**
+ ターミナル (Linux/macOS/Unix) またはコマンドプロンプト (Windows) を開きます。 AWS CLI を使用して **get-resource-shares** コマンドを実行します。

  ```
  aws ram get-resource-shares
  ```

  出力は、アカウントのリソース共有のリストを返します。