

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

# Berbagi koneksi dengan Akun AWS
<a name="connections-share"></a>

Anda dapat menggunakan berbagi sumber daya AWS RAM untuk berbagi koneksi yang ada dengan orang lain Akun AWS atau dengan akun di organisasi Anda. Anda dapat menggunakan koneksi bersama dengan sumber daya AWS yang Anda kelola untuk koneksi sumber pihak ketiga, seperti di CodePipeline.

**penting**  
Berbagi koneksi tidak didukung untuk `codestar-connections ` sumber daya. Ini hanya didukung untuk `codeconnections` sumber daya.

Sebelum Anda memulai:
+ Anda harus sudah membuat koneksi dengan Anda Akun AWS.
+ Anda harus mengaktifkan berbagi sumber daya.
+ Anda harus memiliki izin yang diperlukan yang dikonfigurasi. Untuk informasi selengkapnya, lihat [Izin yang didukung untuk berbagi koneksi](security-iam.md#permissions-reference-connections-sharing).

**catatan**  
Untuk berbagi koneksi, Anda harus menjadi pemilik organisasi atau pemilik repositori jika tidak di bawah organisasi. Akun yang Anda bagikan juga memerlukan izin ke repositori.

**Topics**
+ [Bagikan koneksi (konsol)](#connections-share-console)
+ [Bagikan koneksi (CLI)](#connections-share-cli)
+ [Lihat koneksi bersama (konsol)](#connections-view-console)
+ [Lihat koneksi bersama (CLI)](#connections-view-cli)

## Bagikan koneksi (konsol)
<a name="connections-share-console"></a>

Anda dapat menggunakan konsol untuk membuat sumber daya koneksi bersama.

1. Masuk ke Konsol Manajemen AWS.

   Pilih **Buat berbagi sumber daya** di halaman **[Dibagikan oleh saya: Sumber daya bersama](https://console.aws.amazon.com/ram/home#OwnedResources:)** di AWS RAM konsol.

1. Karena pembagian AWS RAM sumber daya ada di Wilayah AWS tertentu, pilih Wilayah AWS yang sesuai dari daftar tarik-turun di sudut kanan atas konsol. Untuk membuat pembagian sumber daya yang berisi sumber daya global, Anda harus mengatur Wilayah AWS ke AS Timur (Virginia Utara), 

   Untuk informasi selengkapnya tentang berbagi sumber daya global, lihat [Berbagi sumber daya Regional dibandingkan dengan sumber daya global](https://docs.aws.amazon.com/ram/latest/userguide/working-with-regional-vs-global.html).

1. Pada halaman pembuatan, di **Nama**, masukkan nama untuk berbagi sumber daya Anda. Di bawah **Sumber Daya**, pilih **Koneksi Kode**.  
![\[\]](http://docs.aws.amazon.com/id_id/dtconsole/latest/userguide/images/connections-share-create.png)

1. Pilih sumber daya koneksi Anda dan tetapkan prinsipal dengan siapa Anda ingin berbagi.

1. Pilih **Buat**.

## Bagikan koneksi (CLI)
<a name="connections-share-cli"></a>

Anda dapat menggunakan AWS Command Line Interface (AWS CLI) untuk berbagi koneksi yang ada dengan akun lain dan melihat koneksi yang Anda miliki atau telah berbagi dengan Anda.

Untuk melakukan ini, gunakan `accept-resource-share-invitation ` perintah **create-resource-share** dan untuk AWS RAM.

**Untuk berbagi koneksi**

1. Masuk dengan akun yang akan berbagi koneksi.

1. Buka terminal (Linux, macOS, atau Unix) atau command prompt (Windows). Gunakan AWS CLI untuk menjalankan **create-resource-share** perintah, menentukan, `--name``--resource-arns`, dan `--principals` untuk berbagi koneksi Anda. Dalam contoh ini, namanya `my-shared-resource` dan nama koneksi yang ditentukan ada `MyConnection` di sumber daya ARN. Di`principals`, berikan akun tujuan atau akun yang Anda bagikan.

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

   Jika berhasil, perintah ini mengembalikan informasi ARN koneksi seperti berikut ini.

   ```
   {
       "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. Permintaan untuk berbagi dapat diterima sebagaimana dirinci dalam prosedur selanjutnya.

**Untuk mengautentikasi dan menerima pembagian koneksi dengan akun tujuan**

Prosedur berikut bersifat opsional untuk akun tujuan yang dimiliki oleh organisasi yang sama dan mengaktifkan pembagian sumber daya di Organizations.

1. Masuk dengan akun tujuan yang akan menerima undangan.

1. Buka terminal (Linux, macOS, atau Unix) atau command prompt (Windows). Gunakan AWS CLI untuk menjalankan **get-resource-share-invitations** perintah.

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

   Tangkap ARN undangan berbagi sumber daya untuk langkah selanjutnya.

1. Jalankan **accept-resource-share-invitation** perintah, tentukan. `--resource-share-invitation-arn`

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

   Jika berhasil, perintah ini mengembalikan output berikut.

   ```
   {
       "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"
       }
   }
   ```

## Lihat koneksi bersama (konsol)
<a name="connections-view-console"></a>

Anda dapat menggunakan konsol untuk melihat sumber daya koneksi bersama.

1. Masuk ke Konsol Manajemen AWS.

   Buka halaman **[Shared by me: Shared resources](https://console.aws.amazon.com/ram/home#OwnedResources:)** di AWS RAM console.

1. Karena pembagian sumber daya AWS RAM ada di Wilayah AWS tertentu, pilih Wilayah AWS yang sesuai dari daftar tarik-turun di sudut kanan atas konsol. Untuk melihat pembagian sumber daya yang berisi sumber daya global, Anda harus menetapkan Wilayah AWS ke AS Timur (Virginia Utara), 

   Untuk informasi selengkapnya tentang berbagi sumber daya global, lihat [Berbagi sumber daya Regional dibandingkan dengan sumber daya global](https://docs.aws.amazon.com/ram/latest/userguide/working-with-regional-vs-global.html).

1. Untuk setiap sumber daya bersama, informasi berikut tersedia:
   + **ID Sumber Daya** — ID dari sumber daya. Pilih ID sumber daya untuk membuka tab browser baru untuk melihat sumber daya di konsol layanan aslinya.
   + **Jenis sumber daya** — Jenis sumber daya.
   + **Tanggal berbagi terakhir** — Tanggal di mana sumber daya terakhir dibagikan.
   + **Pembagian sumber daya** — Jumlah pembagian sumber daya yang mencakup sumber daya. Untuk melihat daftar pembagian sumber daya, pilih nomornya.
   + **Prinsipal** — Jumlah kepala sekolah yang dapat mengakses sumber daya. Pilih nilai untuk melihat prinsipal.

## Lihat koneksi bersama (CLI)
<a name="connections-view-cli"></a>

Anda dapat menggunakan AWS CLI untuk melihat koneksi yang Anda miliki atau telah berbagi dengan Anda.

Untuk melakukannya, gunakan perintah **get-resource-shares**.

**Untuk melihat koneksi bersama**
+ Buka terminal (Linux, macOS, atau Unix) atau command prompt (Windows). Gunakan AWS CLI untuk menjalankan **get-resource-shares** perintah.

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

  Output mengembalikan daftar pembagian sumber daya untuk akun Anda.