

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

# Temukan nama alias dan alias ARN untuk kunci KMS
<a name="alias-view"></a>

Alias memudahkan untuk mengenali kunci KMS di konsol. AWS KMS Anda dapat melihat alias untuk kunci KMS di AWS KMS konsol atau dengan menggunakan operasi. [ListAliases](https://docs.aws.amazon.com/kms/latest/APIReference/API_ListAliases.html) [DescribeKey](https://docs.aws.amazon.com/kms/latest/APIReference/API_DescribeKey.html)Operasi, yang mengembalikan properti kunci KMS, tidak termasuk alias.

Prosedur berikut menunjukkan cara melihat dan mengidentifikasi alias yang terkait dengan kunci KMS menggunakan AWS KMS konsol dan AWS KMS API. Contoh AWS KMS API menggunakan [AWS Command Line Interface (AWS CLI)](https://aws.amazon.com/cli/), tetapi Anda dapat menggunakan bahasa pemrograman yang didukung.

## Menggunakan AWS KMS konsol
<a name="alias-view-console"></a>

 AWS KMS Konsol menampilkan alias yang terkait dengan kunci KMS. 

1. Buka AWS KMS konsol 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. Untuk melihat tombol di akun yang Anda buat dan kelola, di panel navigasi pilih **CMK**. Untuk melihat kunci di akun yang AWS membuat dan mengelola untuk Anda, di panel navigasi, pilih **kunci AWS terkelola**.

1. Kolom **Alias** menampilkan alias untuk setiap tombol KMS. Jika kunci KMS tidak memiliki alias, tanda hubung (**-**) muncul di kolom **Alias**.

   *Jika kunci KMS memiliki beberapa alias, kolom **Alias** juga memiliki ringkasan alias, seperti **(\$1** n lebih).* Misalnya, kunci KMS berikut memiliki dua alias, salah satunya adalah. `key-test` 

   **Untuk menemukan nama alias dan alias ARN dari semua alias untuk kunci KMS, gunakan tab Alias.** 
   + Untuk pergi langsung ke tab **Alias**, di kolom **Alias**, pilih ringkasan alias (**\$1*n* lebih banyak**). Ringkasan alias hanya muncul jika kunci KMS memiliki lebih dari satu alias.
   + **Atau, pilih alias atau ID kunci dari kunci KMS (yang membuka halaman detail untuk tombol KMS) dan kemudian pilih tab Alias.** Tab ada di bawah bagian **Konfigurasi umum**.   
![\[Kunci yang dikelola pelanggan interface showing a list with one key and options to create or filter keys.\]](http://docs.aws.amazon.com/id_id/kms/latest/developerguide/images/find-alias-name-1-sm.png)

1. Tab **Alias** menampilkan nama alias dan alias ARN dari semua alias untuk kunci KMS. Anda juga dapat membuat dan menghapus alias untuk tombol KMS pada tab ini.  
![\[Aliases tab showing two key aliases with their names and ARNs listed in a table format.\]](http://docs.aws.amazon.com/id_id/kms/latest/developerguide/images/alias-tab-1.png)

**Kunci yang dikelola AWS**  
Anda dapat menggunakan alias untuk mengenali Kunci yang dikelola AWS, seperti yang ditunjukkan pada **Kunci yang dikelola AWS**halaman contoh ini. Alias untuk Kunci yang dikelola AWS selalu memiliki format:`aws/<service-name>`. Misalnya, alias Kunci yang dikelola AWS untuk Amazon DynamoDB adalah. `aws/dynamodb`

![\[Alias di Kunci yang dikelola AWShalaman konsol AWS KMS\]](http://docs.aws.amazon.com/id_id/kms/latest/developerguide/images/alias-console-aws-managed-sm.png)


## Menggunakan AWS KMS API
<a name="alias-view-api"></a>

[ListAliases](https://docs.aws.amazon.com/kms/latest/APIReference/API_ListAliases.html)Operasi mengembalikan nama alias dan alias ARN alias di akun dan Wilayah. Outputnya mencakup alias untuk Kunci yang dikelola AWS dan untuk kunci yang dikelola pelanggan. Alias untuk Kunci yang dikelola AWS memiliki format`aws/<service-name>`, seperti`aws/dynamodb`.

Respons mungkin juga menyertakan alias yang tidak memiliki bidang `TargetKeyId`. Ini adalah alias yang AWS telah ditentukan sebelumnya yang telah dibuat tetapi belum dikaitkan dengan kunci KMS.

```
$ aws kms list-aliases
{
    "Aliases": [
        {
            "AliasName": "alias/access-key",
            "AliasArn": "arn:aws:kms:us-west-2:111122223333:alias/access-key",
            "TargetKeyId": "0987dcba-09fe-87dc-65ba-ab0987654321",
            "CreationDate": 1516435200.399,
            "LastUpdatedDate": 1516435200.399
        },        
        {
            "AliasName": "alias/ECC-P521-Sign",
            "AliasArn": "arn:aws:kms:us-west-2:111122223333:alias/ECC-P521-Sign",
            "TargetKeyId": "1234abcd-12ab-34cd-56ef-1234567890ab",
            "CreationDate": 1693622000.704,
            "LastUpdatedDate": 1693622000.704
        },
        {
            "AliasName": "alias/ImportedKey",
            "AliasArn": "arn:aws:kms:us-west-2:111122223333:alias/ImportedKey",
            "TargetKeyId": "1a2b3c4d-5e6f-1a2b-3c4d-5e6f1a2b3c4d",
            "CreationDate": 1493622000.704,
            "LastUpdatedDate": 1521097200.235
        },
        {
            "AliasName": "alias/finance-project",
            "AliasArn": "arn:aws:kms:us-west-2:111122223333:alias/finance-project",
            "TargetKeyId": "0987dcba-09fe-87dc-65ba-ab0987654321",
            "CreationDate": 1604958290.014,
            "LastUpdatedDate": 1604958290.014
        },
        {
            "AliasName": "alias/aws/dynamodb",
            "AliasArn": "arn:aws:kms:us-west-2:111122223333:alias/aws/dynamodb",
            "TargetKeyId": "0987ab65-43cd-21ef-09ab-87654321cdef",
            "CreationDate": 1521097200.454,
            "LastUpdatedDate": 1521097200.454
        },
        {
            "AliasName": "alias/aws/ebs",
            "AliasArn": "arn:aws:kms:us-west-2:111122223333:alias/aws/ebs",
            "TargetKeyId": "abcd1234-09fe-ef90-09fe-ab0987654321",
            "CreationDate": 1466518990.200,
            "LastUpdatedDate": 1466518990.200
        }
    ]
}
```

Untuk mendapatkan semua alias yang terkait dengan kunci KMS tertentu, gunakan `KeyId` parameter opsional operasi. `ListAliases` `KeyId`Parameter mengambil [ID kunci](concepts.md#key-id-key-id) atau [kunci ARN](concepts.md#key-id-key-ARN) dari kunci KMS. 

Contoh ini mendapatkan semua alias yang terkait dengan kunci `0987dcba-09fe-87dc-65ba-ab0987654321` KMS.

```
$ aws kms list-aliases --key-id 0987dcba-09fe-87dc-65ba-ab0987654321
{
    "Aliases": [
        {
            "AliasName": "alias/access-key",
            "AliasArn": "arn:aws:kms:us-west-2:111122223333:alias/access-key",
            "TargetKeyId": "0987dcba-09fe-87dc-65ba-ab0987654321",
            "CreationDate": "2018-01-20T15:23:10.194000-07:00",
            "LastUpdatedDate": "2018-01-20T15:23:10.194000-07:00"
        },
        {
            "AliasName": "alias/finance-project",
            "AliasArn": "arn:aws:kms:us-west-2:111122223333:alias/finance-project",
            "TargetKeyId": "0987dcba-09fe-87dc-65ba-ab0987654321",
            "CreationDate": 1604958290.014,
            "LastUpdatedDate": 1604958290.014
        }
    ]
}
```

Parameter `KeyId` tidak mengambil karakter wildcard, tetapi Anda dapat menggunakan fitur bahasa pemrograman Anda untuk menyaring respons. 

Misalnya, AWS CLI perintah berikut hanya mendapatkan alias untuk Kunci yang dikelola AWS.

```
$ aws kms list-aliases --query 'Aliases[?starts_with(AliasName, `alias/aws/`)]'
```

Perintah berikut hanya mendapatkan alias `access-key`. Nama alias peka terhadap huruf besar-kecil.

```
$ aws kms list-aliases --query 'Aliases[?AliasName==`alias/access-key`]'
[
    {
        "AliasName": "alias/access-key",
        "AliasArn": "arn:aws:kms:us-west-2:111122223333:alias/access-key",
        "TargetKeyId": "0987dcba-09fe-87dc-65ba-ab0987654321",
        "CreationDate": "2018-01-20T15:23:10.194000-07:00",
        "LastUpdatedDate": "2018-01-20T15:23:10.194000-07:00"
    }
]
```