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

# Kelola berbagi AMI dengan organisasi atau OU
<a name="share-amis-org-ou-manage"></a>

Anda dapat mengelola berbagi AMI dengan organisasi dan unit organisasi (OU) untuk mengontrol apakah mereka dapat meluncurkan instans Amazon EC2.

## Melihat organisasi dan OU yang berbagi AMI Anda
<a name="decribe-ami-launch-permissions"></a>

Anda dapat menemukan organisasi dan OU yang telah Anda bagikan AMI Anda.

------
#### [ Console ]

**Untuk memeriksa dengan organisasi dan OU mana yang telah Anda bagikan AMI**

1. Buka konsol Amazon EC2 di. [https://console.aws.amazon.com/ec2/](https://console.aws.amazon.com/ec2/)

1. Di panel navigasi, pilih **AMI**.

1. Pilih AMI Anda dalam daftar, pilih tab **Izin**, dan gulir ke bawah ke **Shared organizations/OUs**.

   Untuk mencari AMI yang dibagikan dengan Anda, lihat [Temukan AMI bersama untuk digunakan untuk instans Amazon EC2](usingsharedamis-finding.md).

------
#### [ AWS CLI ]

**Untuk memeriksa dengan organisasi dan OU mana yang telah Anda bagikan AMI**  
Gunakan [https://docs.aws.amazon.com/cli/latest/reference/ec2/describe-image-attribute.html](https://docs.aws.amazon.com/cli/latest/reference/ec2/describe-image-attribute.html)perintah dengan `launchPermission` atribut.

```
aws ec2 describe-image-attribute \
    --image-id {{ami-0abcdef1234567890}} \
    --attribute launchPermission
```

Berikut ini adalah contoh respons.

```
{
    "ImageId": "ami-0abcdef1234567890",
    "LaunchPermissions": [
        {
            "OrganizationalUnitArn": "arn:aws:organizations::111122223333:ou/o-123example/ou-1234-5example"
        }
    ]
}
```

------
#### [ PowerShell ]

**Untuk memeriksa dengan organisasi dan OU mana yang telah Anda bagikan AMI**  
Gunakan [Get-EC2ImageAttribute](https://docs.aws.amazon.com/powershell/latest/reference/items/Get-EC2ImageAttribute.html)cmdlet.

```
Get-EC2ImageAttribute `
    -ImageId {{ami-0abcdef1234567890}} `
    -Attribute launchPermission
```

------

## Berbagi AMI dengan organisasi atau OU
<a name="share-amis-org-ou"></a>

Anda dapat berbagi AMI dengan organisasi atau OU.

**catatan**  
Anda tidak perlu membagikan snapshot Amazon EBS yang dirujuk oleh AMI untuk membagikan AMI. Hanya AMI itu sendiri yang perlu dibagikan, dan sistem secara otomatis menyediakan instance dengan akses ke snapshot EBS yang direferensikan untuk peluncuran. Namun, Anda perlu berbagi kunci KMS yang digunakan untuk mengenkripsi snapshot yang ditunjuk oleh AMI. Untuk informasi selengkapnya, lihat [Mengizinkan organisasi dan OU untuk menggunakan kunci KMS](allow-org-ou-to-use-key.md).

------
#### [ Console ]

**Untuk berbagi AMI dengan organisasi atau OU**

1. Buka konsol Amazon EC2 di. [https://console.aws.amazon.com/ec2/](https://console.aws.amazon.com/ec2/)

1. Di panel navigasi, pilih **AMI**.

1. Pilih AMI Anda dalam daftar, lalu pilih **Tindakan**, **Ubah izin AMI**.

1. Di bawah **Ketersediaan AMI**, pilih **Privat**.

1. Di samping **Shared organizations/OUs**, pilih **Add organization/OU ARN**.

1. **Untuk **Organization/OU ARN**, masukkan organisasi ARN atau OU ARN yang ingin Anda bagikan AMI, lalu pilih Bagikan AMI.** Perhatikan bahwa Anda harus menentukan ARN lengkap, bukan hanya ID-nya.

   Untuk membagikan AMI ini kepada beberapa organisasi atau OU, ulangi langkah ini hingga Anda telah menambahkan semua organisasi atau OU yang diperlukan.

1. Setelah selesai, pilih **Simpan perubahan**.

1. (Opsional) Untuk melihat organisasi atau OU yang telah Anda bagikan AMI, pilih AMI dalam daftar, pilih tab **Izin**, dan gulir ke bawah ke **Dibagikan organizations/OUs**. Untuk mencari AMI yang dibagikan dengan Anda, lihat [Temukan AMI bersama untuk digunakan untuk instans Amazon EC2](usingsharedamis-finding.md).

------
#### [ AWS CLI ]

**Untuk berbagi AMI dengan organisasi**  
Gunakan [https://docs.aws.amazon.com/cli/latest/reference/ec2/modify-image-attribute.html](https://docs.aws.amazon.com/cli/latest/reference/ec2/modify-image-attribute.html)perintah untuk memberikan izin peluncuran untuk AMI yang ditentukan ke organisasi yang ditentukan.

```
aws ec2 modify-image-attribute \
    --image-id {{ami-0abcdef1234567890}} \
    --launch-permission "Add=[{OrganizationArn=arn:aws:organizations::{{123456789012}}:organization/{{o-123example}}}]"
```

**Untuk berbagi AMI dengan OU**  
Perintah [modify-image-attribute](https://docs.aws.amazon.com/cli/latest/reference/ec2/modify-image-attribute.html) memberikan izin peluncuran untuk AMI yang ditentukan ke OU tertentu. Perhatikan bahwa Anda harus menentukan ARN lengkap, bukan hanya ID-nya.

```
aws ec2 modify-image-attribute \
    --image-id {{ami-0abcdef1234567890}} \
    --launch-permission "Add=[{OrganizationalUnitArn=arn:aws:organizations::{{123456789012}}:ou/{{o-123example}}/{{ou-1234-5example}}}]"
```

------
#### [ PowerShell ]

Gunakan [https://docs.aws.amazon.com/powershell/latest/reference/items/Edit-EC2ImageAttribute.html](https://docs.aws.amazon.com/powershell/latest/reference/items/Edit-EC2ImageAttribute.html)perintah (Alat untuk Windows PowerShell) untuk berbagi AMI seperti yang ditunjukkan pada contoh berikut.

**Untuk berbagi AMI dengan organisasi atau OU**  
Perintah berikut memberikan izin peluncuran untuk AMI yang ditentukan ke organisasi tertentu.

```
Edit-EC2ImageAttribute `
    -ImageId {{ami-0abcdef1234567890}} `
    -Attribute launchPermission `
    -OperationType add `
    -OrganizationArn "arn:aws:organizations::{{123456789012}}:organization/{{o-123example}}"
```

**Untuk berhenti berbagi AMI dengan organisasi atau OU**  
Perintah berikut menghapus izin peluncuran untuk AMI yang ditentukan dari organisasi tertentu:

```
Edit-EC2ImageAttribute `
    -ImageId {{ami-0abcdef1234567890}} `
    -Attribute launchPermission `
    -OperationType remove `
    -OrganizationArn "arn:aws:organizations::{{123456789012}}:organization/{{o-123example}}"
```

**Untuk berhenti berbagi AMI dengan semua organisasi, OU, dan Akun AWS**  
Perintah berikut ini menghapus semua izin peluncuran publik dan eksplisit dari AMI yang ditentukan. Perhatikan bahwa pemilik AMI selalu memiliki izin peluncuran sehingga tidak terpengaruh oleh perintah ini.

```
Reset-EC2ImageAttribute `
    -ImageId {{ami-0abcdef1234567890}} `
    -Attribute launchPermission
```

------

## Berhenti berbagi AMI dengan organisasi atau OU
<a name="stop-sharing-amis-org-ou"></a>

Anda dapat berhenti berbagi AMI dengan organisasi atau OU.

**catatan**  
Anda tidak dapat berhenti berbagi AMI dengan akun tertentu jika akun tersebut berada di organisasi atau OU yang dengannya AMI dibagikan. Jika Anda mencoba untuk berhenti berbagi AMI dengan menghapus izin peluncuran untuk akun tersebut, Amazon EC2 akan menampilkan pesan sukses. Namun, AMI terus dibagikan dengan akun tersebut.

------
#### [ Console ]

**Untuk berhenti berbagi AMI dengan organisasi atau OU**

1. Buka konsol Amazon EC2 di. [https://console.aws.amazon.com/ec2/](https://console.aws.amazon.com/ec2/)

1. Di panel navigasi, pilih **AMI**.

1. Pilih AMI Anda dalam daftar, lalu pilih **Tindakan**, **Ubah izin AMI**.

1. Di bawah **Dibagikan organizations/OUs**, pilih organisasi atau OU yang ingin Anda hentikan berbagi AMI, lalu pilih **Hapus yang dipilih**.

1. Setelah selesai, pilih **Simpan perubahan**.

1. (Opsional) Untuk mengonfirmasi bahwa Anda telah berhenti membagikan AMI dengan organisasi atau OU, pilih AMI dalam daftar, pilih tab **Izin**, dan gulir ke bawah ke **Dibagikan organizations/OUs**.

------
#### [ AWS CLI ]

**Untuk berhenti berbagi AMI dengan organisasi atau OU**  
Gunakan perintah [modify-image-attribute](https://docs.aws.amazon.com/cli/latest/reference/ec2/modify-image-attribute.html). Contoh ini menghapus izin peluncuran untuk AMI yang ditentukan dari organisasi yang ditentukan.

```
aws ec2 modify-image-attribute \
    --image-id {{ami-0abcdef1234567890}} \
    --launch-permission "Remove=[{OrganizationArn=arn:aws:organizations::{{123456789012}}:organization/{{o-123example}}}]"
```

**Untuk berhenti berbagi AMI dengan semua organisasi, OU, dan Akun AWS**  
Gunakan perintah [https://docs.aws.amazon.com/cli/latest/reference/ec2/reset-image-attribute.html](https://docs.aws.amazon.com/cli/latest/reference/ec2/reset-image-attribute.html). Contoh ini menghapus semua izin peluncuran publik dan eksplisit dari AMI yang ditentukan. Perhatikan bahwa pemilik AMI selalu memiliki izin peluncuran sehingga tidak terpengaruh oleh perintah ini.

```
aws ec2 reset-image-attribute \
    --image-id {{ami-0abcdef1234567890}} \
    --attribute launchPermission
```

------
#### [ PowerShell ]

**Untuk berhenti berbagi AMI dengan organisasi atau OU**  
Gunakan [Edit-EC2ImageAttribute](https://docs.aws.amazon.com/powershell/latest/reference/items/Edit-EC2ImageAttribute.html)cmdlet. Contoh ini menghapus izin peluncuran untuk AMI yang ditentukan dari organisasi yang ditentukan.

```
Edit-EC2ImageAttribute `
    -ImageId {{ami-0abcdef1234567890}} `
    -Attribute launchPermission `
    -OperationType remove `
    -OrganizationArn "arn:aws:organizations::{{123456789012}}:organization/{{o-123example}}"
```

**Untuk berhenti berbagi AMI dengan semua organisasi, OU, dan Akun AWS**  
Gunakan [Reset-EC2ImageAttribute](https://docs.aws.amazon.com/powershell/latest/reference/items/Reset-EC2ImageAttribute.html)cmdlet. Contoh ini menghapus semua izin peluncuran publik dan eksplisit dari AMI yang ditentukan. Perhatikan bahwa pemilik AMI selalu memiliki izin peluncuran sehingga tidak terpengaruh oleh perintah ini.

```
Reset-EC2ImageAttribute `
    -ImageId {{ami-0abcdef1234567890}} `
    -Attribute LaunchPermission
```

------