Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
# Buat alias
Anda dapat membuat alias di AWS KMS konsol atau dengan menggunakan operasi AWS KMS API.
Alias harus string berisi 1-256 karakter. Ini hanya dapat berisi karakter alfanumerik, garis miring depan (/), garis bawah (\$1), dan tanda garis (-). Nama alias untuk [kunci yang dikelola pelanggan](concepts.md#customer-mgn-key) tidak dapat dimulai dengan`alias/aws/`. `alias/aws/`Awalan dicadangkan untuk [Kunci yang dikelola AWS](concepts.md#aws-managed-key).
Anda dapat membuat alias untuk kunci KMS baru atau untuk kunci KMS yang ada. Anda dapat menambahkan alias sehingga kunci KMS tertentu digunakan dalam proyek atau aplikasi.
Anda juga dapat menggunakan AWS CloudFormation template untuk membuat alias untuk kunci KMS. Untuk informasi selengkapnya, lihat [AWS::KMS::Alias](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-kms-alias.html) di *AWS CloudFormation Panduan Pengguna*.
## Menggunakan AWS KMS konsol
Saat Anda [membuat kunci KMS](create-keys.md) di AWS KMS konsol, Anda harus membuat alias untuk kunci KMS baru. Untuk membuat alias untuk kunci KMS yang ada, gunakan tab **Alias** pada halaman detail untuk kunci KMS.
1. Masuk ke Konsol Manajemen AWS dan buka konsol AWS Key Management Service (AWS KMS) di [https://console.aws.amazon.com/kms](https://console.aws.amazon.com/kms).
1. Untuk mengubah Wilayah AWS, gunakan pemilih Wilayah di sudut kanan atas halaman.
1. Di panel navigasi, pilih **Kunci yang dikelola pelanggan**. Anda tidak dapat mengelola alias untuk Kunci yang dikelola AWS atau Kunci milik AWS.
1. Dalam tabel, pilih ID kunci atau alias kunci KMS. Kemudian, pada halaman detail kunci KMS, pilih tab **Alias**.
*Jika kunci KMS memiliki beberapa alias, kolom **Alias** dalam tabel menampilkan satu alias dan ringkasan alias, seperti **(**\$1 n lebih).* Memilih ringkasan alias akan membawa Anda langsung ke tab **Alias** pada halaman detail kunci KMS.
1. Pada tab **Alias**, pilih **Buat alias**. Masukkan nama alias dan pilih **Buat alias**.
**penting**
Jangan sertakan informasi rahasia atau sensitif di bidang ini. Bidang ini dapat ditampilkan dalam plaintext di CloudTrail log dan output lainnya.
**catatan**
Jangan tambahkan `alias/` awalan. Konsol secara otomatis menambahkannya untuk Anda. Jika Anda memasukkan `alias/ExampleAlias`, nama alias sebenarnya akan `alias/alias/ExampleAlias`.
## Menggunakan AWS KMS API
Untuk membuat alias, gunakan [CreateAlias](https://docs.aws.amazon.com/kms/latest/APIReference/API_CreateAlias.html)operasi. Berbeda dengan proses pembuatan kunci KMS di konsol, [CreateKey](https://docs.aws.amazon.com/kms/latest/APIReference/API_CreateKey.html)operasi tidak membuat alias untuk kunci KMS baru.
**penting**
Jangan sertakan informasi rahasia atau sensitif di bidang ini. Bidang ini dapat ditampilkan dalam plaintext di CloudTrail log dan output lainnya.
Anda dapat menggunakan `CreateAlias` operasi untuk membuat alias untuk kunci KMS baru tanpa alias. Anda juga dapat menggunakan `CreateAlias` operasi untuk menambahkan alias ke kunci KMS yang ada atau untuk membuat ulang alias yang tidak sengaja dihapus.
Dalam operasi AWS KMS API, nama alias harus dimulai dengan `alias/` diikuti dengan nama, seperti`alias/ExampleAlias`. Alias harus unik di akun dan Wilayah. Untuk menemukan nama alias yang sudah digunakan, gunakan [ListAliases](https://docs.aws.amazon.com/kms/latest/APIReference/API_ListAliases.html)operasi. Nama alias peka terhadap huruf besar-kecil.
`TargetKeyId`Dapat berupa [kunci yang dikelola pelanggan](concepts.md#customer-mgn-key) dalam hal yang sama Wilayah AWS. Untuk mengidentifikasi kunci KMS, gunakan [ID kunci](concepts.md#key-id-key-id) atau [kunci ARN](concepts.md#key-id-key-ARN). Anda tidak dapat menggunakan alias lain.
Contoh berikut membuat `example-key` alias dan mengaitkannya dengan kunci KMS tertentu. Contoh-contoh ini menggunakan AWS Command Line Interface (AWS CLI). Untuk contoh dalam beberapa bahasa pemrograman, lihat [Gunakan `CreateAlias` dengan AWS SDK atau CLI](example_kms_CreateAlias_section.md).
```
$ aws kms create-alias \
--alias-name alias/example-key \
--target-key-id 1234abcd-12ab-34cd-56ef-1234567890ab
```
`CreateAlias`tidak mengembalikan output apa pun. Untuk melihat alias baru, gunakan operasi `ListAliases`. Lihat perinciannya di [Menggunakan AWS KMS API](alias-view.md#alias-view-api).