Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
# Referensi AMIs menggunakan parameter Systems Manager
Saat meluncurkan instance menggunakan wizard instans EC2 peluncuran di EC2 konsol Amazon, Anda dapat memilih AMI dari daftar, atau Anda dapat memilih AWS Systems Manager parameter 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 Gambar Mesin Amazon IDs](https://docs.aws.amazon.com/systems-manager/latest/userguide/parameter-store-ec2-aliases.html) di *Panduan AWS Systems Manager Pengguna*.
**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
Bila Anda menggunakan parameter Systems Manager untuk menunjuk ke AMI IDs, akan lebih mudah bagi pengguna Anda untuk memilih AMI yang benar saat meluncurkan instance. 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 AMI IDs 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
AMIs dan parameter Systems Manager adalah Region spesifik. 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 uniknya. 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 terbaru AMIs menggunakan parameter publik Systems Manager](finding-an-ami-parameter-store.md).
------
#### [ Console ]
**Untuk menemukan AMI menggunakan parameter Systems Manager**
1. Buka EC2 konsol Amazon 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 (Gambar Mesin Amazon)**, pilih **Jelajahi lebih banyak AMIs**.
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**. AMIs 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"
```
------