Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
# Gunakan tanda air AMI untuk melacak dan mengidentifikasi AMI
Tanda air AMI adalah pengenal yang Anda lampirkan ke AMI pribadi Anda untuk melacak asal usul dan menegakkan kebijakan tata kelola. Tanda air tetap ada di seluruh siklus hidup AMI penuh:
+ Jika Anda membuat AMI baru dari instance yang sedang berjalan yang diluncurkan dari AMI watermark, AMI baru mewarisi tanda air.
+ Jika Anda menyalin AMI watermark, salinannya membawa tanda air.
+ Jika Anda menyimpan AMI watermark ke S3 dan mengembalikannya, AMI yang dipulihkan mempertahankan tanda air.
+ Jika Anda membagikan AMI watermark dengan akun lain, tanda air tetap terlihat oleh penerima.
Menggunakan tanda air AMI membantu Anda:
**Manfaat utama**
+ Lacak sumber di seluruh akun dan Wilayah — identifikasi AMI mana yang berasal dari gambar dasar Anda yang disetujui.
+ Filter dan temukan AMI terkait di seluruh akun Anda.
+ Bantu konsumen AMI menemukan dan mengidentifikasi AMI tepercaya yang terkait dengan proyek atau organisasi.
**Topics**
+ [Cara kerja tanda air AMI](#ami-watermark-how-it-works)
+ [Izin yang diperlukan](#ami-watermark-permissions)
+ [Pasang tanda air ke AMI](#ami-watermark-attach)
+ [Lepaskan tanda air dari AMI](#ami-watermark-detach)
+ [Lihat tanda air AMI](#ami-watermark-view)
+ [Filter AMI dengan tanda air](#ami-watermark-filter)
## Cara kerja tanda air AMI
Tanda air AMI adalah pengidentifikasi terstruktur yang Anda lampirkan ke AMI Anda. Berikut ini menjelaskan karakteristik utama tanda air:
+ **Bertahan** — Saat Anda melampirkan tanda air ke AMI, itu akan diteruskan ke semua AMI turunan.
+ **Owner-only**— Hanya pemilik AMI yang dapat melampirkan tanda air ke AMI.
+ **Terlihat oleh semua orang** — Siapa pun yang memiliki akses ke AMI dapat melihat tanda airnya.
+ **Batas 5** — AMI dapat memiliki hingga total 5 tanda air.
+ **Tidak tersedia di AMI publik** — Anda tidak dapat melampirkan tanda air ke AMI publik atau membuat AMI publik jika mereka memiliki tanda air.
+ Dapat **disaring - Anda dapat** memfilter AMI dengan tanda air saat menggunakan. `describe-images`
### Format tanda air
Tanda air adalah objek terstruktur dengan bidang berikut:
+ `WatermarkKey`— Pengidentifikasi unik untuk tanda air, terdiri dari. `{{account-id}}:{{watermark-name}}` Bagian ID akun adalah 12 digit ID AWS akun pemilik AMI. Bagian nama watermark adalah nama yang ditentukan pelanggan.
+ `SourceImageRegion`— Wilayah AMI tempat Anda awalnya memasang tanda air.
+ `SourceImageId`— AMI tempat Anda awalnya memasang tanda air.
+ `SourceImageCreationDate`— Tanggal pembuatan AMI tempat Anda awalnya melampirkan tanda air.
+ `WatermarkCreationTime`— Stempel waktu saat Anda menerapkan tanda air.
Nama watermark harus 3—128 karakter dan dapat berisi karakter alfanumerik, tanda kurung (()), tanda kurung siku ([]), spasi, titik (.), garis miring (/), tanda hubung (-), tanda kutip tunggal ('), at-tanda (@), atau garis bawah (\_).
## Izin yang diperlukan
Untuk bekerja dengan tanda air AMI, Anda memerlukan izin IAM berikut:
+ `ec2:AttachImageWatermark`— Untuk melampirkan tanda air ke AMI.
+ `ec2:DetachImageWatermark`— Untuk melepaskan tanda air dari AMI.
+ `ec2:DescribeImages`— Untuk melihat tanda air di AMI.
## Pasang tanda air ke AMI
Anda dapat melampirkan tanda air ke AMI dengan menggunakan konsol, AWS CLI, atau PowerShell.
------
#### [ Console ]
**Untuk melampirkan tanda air ke 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.
1. Pada tab **Detail**, di bagian **Tanda Air**, pilih **Kelola tanda air**.
1. Masukkan nama watermark dan pilih **Lampirkan**.
------
#### [ AWS CLI ]
**Untuk melampirkan tanda air ke AMI**
Gunakan perintah [attach-image-watermark](https://docs.aws.amazon.com/cli/latest/reference/ec2/attach-image-watermark.html).
```
aws ec2 attach-image-watermark \
--image-id {{ami-1111111111EXAMPLE}} \
--image-watermark-name "{{prod-baseline}}"
```
Berikut ini adalah output contoh.
```
{
"WatermarkKey": "123456789012:prod-baseline"
}
```
------
#### [ PowerShell ]
**Untuk melampirkan tanda air ke AMI**
Gunakan [Add-EC2ImageWatermark](https://docs.aws.amazon.com/powershell/latest/reference/items/Add-EC2ImageWatermark.html)cmdlet.
```
Add-EC2ImageWatermark `
-ImageId {{ami-1111111111EXAMPLE}} `
-ImageWatermarkName "{{prod-baseline}}"
```
------
Anda dapat melampirkan hingga 5 tanda air ke satu AMI.
## Lepaskan tanda air dari AMI
Anda dapat melepaskan tanda air dari AMI dengan menggunakan konsol,, atau. AWS CLI PowerShell
------
#### [ Console ]
**Untuk melepaskan tanda air dari 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.
1. Pada tab **Detail**, di bagian **Tanda Air**, pilih **Kelola tanda air**.
1. Pilih tanda air yang akan dihapus, lalu pilih **Hapus**.
------
#### [ AWS CLI ]
**Untuk melepaskan tanda air dari AMI**
Gunakan perintah [detach-image-watermark](https://docs.aws.amazon.com/cli/latest/reference/ec2/detach-image-watermark.html).
```
aws ec2 detach-image-watermark \
--image-id {{ami-1111111111EXAMPLE}} \
--image-watermark-key "{{111122223333:prod-baseline}}"
```
------
#### [ PowerShell ]
**Untuk melepaskan tanda air dari AMI**
Gunakan [Remove-EC2ImageWatermark](https://docs.aws.amazon.com/powershell/latest/reference/items/Remove-EC2ImageWatermark.html)cmdlet.
```
Remove-EC2ImageWatermark `
-ImageId {{ami-1111111111EXAMPLE}} `
-ImageWatermarkKey "{{111122223333:prod-baseline}}"
```
------
**catatan**
Melepaskan tanda air dari AMI tidak menghapusnya dari AMI turunan yang sudah membawa tanda air. Untuk memastikan tanda air tetap ada, berikan `ec2:DetachImageWatermark` izin hanya kepada administrator tepercaya yang perlu mengelola tanda air.
## Lihat tanda air AMI
Anda dapat melihat tanda air untuk AMI dengan menggunakan konsol, AWS CLI, atau PowerShell.
------
#### [ Console ]
**Untuk melihat tanda air untuk 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.
1. Lihat tanda air di bagian **Tanda Air** pada tab **Detail**.
------
#### [ AWS CLI ]
**Untuk melihat tanda air untuk AMI**
Gunakan perintah [describe-images](https://docs.aws.amazon.com/cli/latest/reference/ec2/describe-images.html).
```
aws ec2 describe-images \
--image-ids {{ami-046863d776a820ccd}} \
--region {{us-east-1}}
```
Responsnya mencakup `ImageWatermarks` array untuk setiap AMI.
```
{
"Images": [
{
"ImageId": "ami-046863d776a820ccd",
"Public": false,
"OwnerId": "123456789012",
...
"ImageWatermarks": [
{
"WatermarkKey": "111122223333:prod-baseline",
"Region": "us-east-1",
"SourceImageId": "ami-0b752bf1df193a6c4",
"SourceImageCreationDate": "2024-07-10T08:15:00",
"CreationDate": "2024-07-12T14:30:00"
},
{
"WatermarkKey": "222222222222:security-approved",
"Region": "eu-north-1",
"SourceImageId": "ami-12345678",
"SourceImageCreationDate": "2024-06-01T10:00:00",
"CreationDate": "2024-06-05T09:45:00"
}
]
}
]
}
```
------
#### [ PowerShell ]
**Untuk melihat tanda air untuk AMI**
Gunakan [Get-EC2Image](https://docs.aws.amazon.com/powershell/latest/reference/items/Get-EC2Image.html)cmdlet.
```
(Get-EC2Image -ImageId {{ami-046863d776a820ccd}}).ImageWatermarks
```
------
## Filter AMI dengan tanda air
Anda dapat memfilter AMI berdasarkan tanda air dengan menggunakan konsol, AWS CLI, atau PowerShell.
------
#### [ Console ]
**Untuk memfilter AMI dengan tanda air**
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. Di bilah pencarian, pilih filter **kunci Watermark** dan masukkan nilai kunci watermark.
------
#### [ AWS CLI ]
**Untuk memfilter AMI dengan tanda air**
Gunakan [perintah deskripsi-gambar](https://docs.aws.amazon.com/cli/latest/reference/ec2/describe-images.html) dengan filter. `image-watermark-key`
```
aws ec2 describe-images \
--filters "Name=image-watermark-key,Values={{111122223333:prod-baseline}}"
```
Ini mengembalikan semua AMI yang dapat Anda akses yang membawa tanda air yang ditentukan, termasuk AMI turunan yang mewarisinya melalui operasi penyalinan.
------
#### [ PowerShell ]
**Untuk memfilter AMI dengan tanda air**
Gunakan [Get-EC2Image](https://docs.aws.amazon.com/powershell/latest/reference/items/Get-EC2Image.html)cmdlet dengan parameter. `-Filter`
```
Get-EC2Image `
-Filter @{Name="image-watermark-key"; Values="{{111122223333:prod-baseline}}"}
```
Ini mengembalikan semua AMI yang dapat Anda akses yang membawa tanda air yang ditentukan, termasuk AMI turunan yang mewarisinya melalui operasi penyalinan.
------