Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
# Referensi AMI menggunakan parameter Systems Manager
Saat meluncurkan instans menggunakan wizard instans peluncuran EC2 di konsol Amazon EC2, Anda dapat memilih AMI dari daftar, atau Anda dapat memilih parameter AWS Systems Manager yang mengarah ke ID AMI (dijelaskan di bagian ini). Jika menggunakan kode automasi untuk meluncurkan instans, Anda dapat menentukan parameter Systems Manager, bukan AMI ID.
Parameter System Manager adalah pasangan nilai-kunci yang ditentukan pelanggan yang dapat Anda buat di Penyimpanan Parameter System Manager. Penyimpanan Parameter menyediakan penyimpanan pusat untuk mengeksternalisasi nilai konfigurasi aplikasi Anda. Untuk informasi selengkapnya, lihat [Penyimpanan Parameter AWS](https://docs.aws.amazon.com/systems-manager/latest/userguide/systems-manager-parameter-store.html) dalam *Panduan Pengguna AWS Systems Manager *.
Ketika Anda membuat parameter yang menunjuk ke sebuah ID AMI, pastikan Anda menentukan tipe data sebagai `aws:ec2:image`. Menentukan tipe data akan memastikan bahwa ketika parameter dibuat atau dimodifikasi, nilai parameter divalidasi sebagai ID AMI. Untuk informasi selengkapnya, lihat [Dukungan parameter asli untuk ID Amazon Machine Image](https://docs.aws.amazon.com/systems-manager/latest/userguide/parameter-store-ec2-aliases.html) di *Panduan Pengguna AWS Systems Manager *.
**Topics**
+ [Kasus penggunaan](#systems-manager-parameter-use-case)
+ [Izin](#systems-manager-permissions)
+ [Batasan](#AMI-systems-manager-parameter-limitations)
+ [Meluncurkan instans menggunakan parameter Systems Manager](#systems-manager-parameter-launch-instance)
## Kasus penggunaan
Saat Anda menggunakan parameter Systems Manager untuk menunjuk ke ID AMI, pengguna akan lebih mudah memilih AMI yang tepat saat meluncurkan instans. Parameter Systems Manager juga dapat menyederhanakan pemeliharaan kode otomatisasi.
**Lebih mudah bagi pengguna**
Jika suatu instans perlu diluncurkan menggunakan AMI tertentu, dan AMI diperbarui secara rutin, kami sarankan Anda meminta pengguna untuk memilih parameter Systems Manager untuk mencari AMI. Mengharuskan pengguna memilih parameter Systems Manager memastikan AMI terbaru digunakan untuk meluncurkan instans.
Sebagai contoh, setiap bulan di organisasi, Anda dapat membuat versi AMI baru yang memiliki sistem operasi dan patch aplikasi terbaru. Anda juga memerlukan pengguna untuk meluncurkan instans menggunakan AMI versi terbaru Anda. Untuk memastikan pengguna menggunakan versi terbaru, Anda dapat membuat parameter Systems Manager (misalnya, `golden-ami`) yang menunjuk ke ID AMI yang benar. Setiap kali versi baru AMI dibuat, Anda memperbarui nilai ID AMI di parameter sehingga selalu mengarah ke AMI terbaru. Pengguna tidak perlu mengetahui pembaruan berkala untuk AMI karena mereka terus memilih parameter Systems Manager yang sama setiap saat. Penggunaan parameter Systems Manager untuk AMI Anda memudahkan mereka dalam memilih AMI yang benar untuk peluncuran instans.
**Menyederhanakan pemeliharaan kode automasi**
Jika menggunakan kode automasi untuk meluncurkan instans, Anda dapat menentukan parameter Systems Manager, bukan ID AMI. Setiap kali versi baru AMI dibuat, Anda memperbarui nilai ID AMI di parameter sehingga selalu mengarah ke AMI terbaru. Kode otomatisasi yang mengacu pada parameter tidak harus dimodifikasi setiap kali versi baru AMI dibuat. Hal ini menyederhanakan pemeliharaan otomatisasi dan membantu menurunkan biaya deployment.
**catatan**
Instans yang berjalan tidak terpengaruh saat Anda mengubah ID AMI yang ditunjuk oleh parameter Systems Manager.
## Izin
Jika Anda menggunakan parameter Systems Manager yang mengarah ke ID AMI di wizard instans peluncuran, Anda harus menambahkan izin berikut ke kebijakan IAM Anda:
+ `ssm:DescribeParameters`— Memberikan izin untuk melihat dan memilih parameter Systems Manager.
+ `ssm:GetParameters`— Memberikan izin untuk mengambil nilai parameter Systems Manager.
Anda juga dapat membatasi akses ke parameter Systems Manager tertentu. Untuk informasi selengkapnya dan contoh kebijakan IAM, lihat[Contoh: Menggunakan wizard peluncuran instans EC2](iam-policies-ec2-console.md#ex-launch-wizard).
## Batasan
AMI dan parameter Systems Manager bersifat khusus Wilayah. Untuk menggunakan nama parameter Systems Manager yang sama di seluruh Wilayah, buatlah parameter Systems Manager di setiap Wilayah dengan nama yang sama (misalnya, `golden-ami`). Di setiap Wilayah, arahkan parameter Systems Manager ke AMI di dalam Wilayah tersebut.
Nama parameter peka huruf besar/kecil. Garis miring terbalik untuk nama parameter hanya diperlukan jika parameter adalah bagian dari hierarki, misalnya, `/amis/production/golden-ami`. Anda dapat menghilangkan garis miring terbalik jika parameter bukan bagian dari hirarki.
## Meluncurkan instans menggunakan parameter Systems Manager
Saat meluncurkan instance, alih-alih menentukan ID AMI, Anda dapat menentukan parameter Systems Manager yang menunjuk ke ID AMI.
Untuk menentukan parameter secara terprogram, gunakan sintaks berikut, di mana awalan standar dan `resolve:ssm` `parameter-name` merupakan nama parameter unik.
```
resolve:ssm:{{parameter-name}}
```
Parameter Systems Manager memiliki dukungan versi. Setiap iterasi parameter diberi nomor versi unik. Anda dapat mereferensikan versi parameter sebagai berikut, di `version` mana nomor versi unik. Secara default, versi terbaru parameter digunakan ketika tidak ada versi yang ditentukan.
```
resolve:ssm:{{parameter-name}}:{{version}}
```
Untuk meluncurkan instance menggunakan parameter publik yang disediakan oleh AWS, lihat[Referensi AMI terbaru menggunakan parameter publik Systems Manager](finding-an-ami-parameter-store.md).
------
#### [ Console ]
**Untuk menemukan AMI menggunakan parameter Systems Manager**
1. Buka konsol Amazon EC2 di. [https://console.aws.amazon.com/ec2/](https://console.aws.amazon.com/ec2/)
1. Dari bilah navigasi, pilih Wilayah untuk meluncurkan instans Anda. Anda dapat memilih Wilayah yang tersedia untuk Anda, terlepas dari lokasi Anda.
1. Dari dasbor konsol, pilih **Luncurkan instans**.
1. Di bawah **Gambar Aplikasi dan OS (Amazon Machine Image)**, pilih **Telusuri AMI lainnya**.
1. Pilih tombol panah di sebelah kanan bilah pencarian, lalu pilih **parameter Pencarian dengan Systems Manager**.
1. Untuk **Parameter System Manager**, pilih parameter. ID AMI terkait akan muncul di bawah **Saat ini memutuskan ke**.
1. Pilih **Pencarian**. AMI yang cocok dengan ID AMI muncul dalam daftar.
1. Pilih AMI dari daftar, lalu pilih **Pilih**.
Untuk informasi tentang peluncuran instans menggunakan wizard peluncuran instans, lihat [Luncurkan instans EC2 menggunakan wizard instans peluncuran di konsol](ec2-launch-instance-wizard.md).
------
#### [ AWS CLI ]
**Untuk meluncurkan instance menggunakan parameter Systems Manager**
Gunakan perintah [run-instance](https://docs.aws.amazon.com/cli/latest/reference/ec2/run-instances.html) dengan opsi. `--image-id` Contoh ini menggunakan parameter Systems Manager bernama**golden-ami**, yang menentukan ID AMI.
```
--image-id resolve:ssm:/{{golden-ami}}
```
Anda dapat membuat versi parameter Systems Manager. Contoh berikut menentukan versi 2 dari **golden-ami** parameter.
```
--image-id resolve:ssm:/{{golden-ami:2}}
```
------
#### [ PowerShell ]
**Untuk meluncurkan instance menggunakan parameter Systems Manager**
Gunakan [New-EC2Instance](https://docs.aws.amazon.com/powershell/latest/reference/items/New-EC2Instance.html)cmdlet dengan parameter. `-ImageId` Contoh ini menggunakan parameter Systems Manager bernama**golden-ami**, yang menentukan ID AMI.
```
-ImageId "resolve:ssm:/golden-ami"
```
Anda dapat membuat versi parameter Systems Manager. Contoh berikut menentukan versi 2 dari **golden-ami** parameter.
```
-ImageId "resolve:ssm:/golden-ami:2"
```
------