本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# 與 共用連線 AWS 帳戶
<a name="connections-share"></a>

您可以使用 資源共用與 AWS RAM 共用，與另一個 AWS 帳戶 或組織中的帳戶共用現有連線。您可以將共用連線與針對第三方來源連線 AWS 所管理的 中的資源搭配使用，例如 CodePipeline。

**重要**  
`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/zh_tw/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)。使用 AWS CLI 執行 **create-resource-share**命令，`--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. 針對每項共用的資源，下列資訊可供使用：
   + **資源 ID** – 資源的 ID。選擇資源的 ID 以開啟新的瀏覽器索引標籤，以檢視其原生服務主控台中的資源。
   + **資源類型** – 資源的類型。
   + **上次共用日期** – 資源上次共用的日期。
   + **資源共用** – 包含資源的資源共用數目。若要查看資源共用的清單，請選擇號碼。
   + **主體** – 可存取資源的主體數量。選擇值以檢視委託人。

## 檢視共用連線 (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
  ```

  輸出會傳回您帳戶的資源共享清單。