**Dokumentasi ini AWS CLI hanya untuk Versi 1.**

Kami mengumumkan yang akan datang end-of-support untuk AWS CLI versi 1. Kami menyarankan Anda bermigrasi ke AWS CLI versi 2. Untuk tanggal, detail tambahan, dan informasi tentang cara bermigrasi, lihat [pengumuman](https://aws.amazon.com/blogs/developer/cli-v1-maintenance-mode-announcement/). Untuk dokumentasi yang terkait dengan Versi 2 AWS CLI, lihat [Panduan Pengguna Versi 2](https://docs.aws.amazon.com/cli/latest/userguide/).

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

# Menggunakan metadata instans Amazon EC2 sebagai kredensional di AWS CLI
<a name="cli-configure-metadata"></a>

Saat menjalankan instans Amazon Elastic Compute Cloud (Amazon EC2) AWS CLI dari dalam instans Amazon Elastic Compute Cloud (Amazon EC2), Anda dapat menyederhanakan penyediaan kredensi ke perintah Anda. Setiap instans Amazon EC2 berisi metadata yang AWS CLI dapat langsung kueri untuk kredensi sementara. Ketika peran IAM dilampirkan ke instance, AWS CLI secara otomatis dan aman mengambil kredensional dari metadata instance. 

Untuk menonaktifkan layanan ini, gunakan variabel lingkungan [AWS\$1EC2\$1METADATA\$1DISABLED](cli-configure-envvars.md#envvars-list-AWS_EC2_METADATA_DISABLED).

**Topics**
+ [Prasyarat](#cli-configure-metadata-prereqs)
+ [Mengonfigurasi profil untuk metadata Amazon EC2](#cli-configure-metadata-configure)

## Prasyarat
<a name="cli-configure-metadata-prereqs"></a>

Untuk menggunakan kredensi Amazon EC2 dengan AWS CLI, Anda harus menyelesaikan yang berikut ini:
+ Instal dan konfigurasikan AWS CLI. Untuk informasi selengkapnya, lihat [Menginstal, memperbarui, dan menghapus instalasi AWS CLI](cli-chap-install.md) dan [Otentikasi dan akses kredensional untuk AWS CLI](cli-chap-authentication.md).
+ Anda memahami file konfigurasi dan profil bernama. Untuk informasi selengkapnya, lihat [Konfigurasi dan pengaturan file kredensi di AWS CLI](cli-configure-files.md). 
+ Anda telah membuat peran AWS Identity and Access Management (IAM) yang memiliki akses ke sumber daya yang dibutuhkan, dan melampirkan peran tersebut ke instans Amazon EC2 saat Anda meluncurkannya. *Untuk informasi selengkapnya, lihat [kebijakan IAM untuk Amazon](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/iam-policies-for-amazon-ec2.html) EC2 di Panduan *Pengguna Amazon EC2* [dan Pemberian Aplikasi yang Berjalan di Instans Amazon EC2](https://docs.aws.amazon.com/IAM/latest/UserGuide/role-usecase-ec2app.html) Akses ke Sumber Daya di Panduan Pengguna IAM. AWS *

## Mengonfigurasi profil untuk metadata Amazon EC2
<a name="cli-configure-metadata-configure"></a>

Untuk menentukan bahwa Anda ingin menggunakan kredenal yang tersedia di profil instans Amazon EC2 hosting, gunakan sintaks berikut di profil bernama di file konfigurasi Anda. Lihat langkah-langkah berikut untuk petunjuk lebih lanjut. 

```
[profile profilename]
role_arn = arn:aws:iam::123456789012:role/rolename
credential_source = Ec2InstanceMetadata
region = region
```

1. Buat profil di file konfigurasi Anda.

   ```
   [profile profilename]
   ```

1. Tambahkan peran ARN IAM Anda yang memiliki akses ke sumber daya yang dibutuhkan.

   ```
   role_arn = arn:aws:iam::123456789012:role/rolename
   ```

1. Tentukan `Ec2InstanceMetadata` sebagai sumber kredensi Anda.

   ```
   credential_source = Ec2InstanceMetadata
   ```

1. Atur Wilayah Anda.

   ```
   region = region
   ```

**Contoh**

Contoh berikut mengasumsikan *`marketingadminrole`* peran dan menggunakan `us-west-2` Wilayah dalam profil instans Amazon EC2 bernama. `marketingadmin`

```
[profile marketingadmin]
role_arn = arn:aws:iam::123456789012:role/marketingadminrole
credential_source = Ec2InstanceMetadata
region = us-west-2
```