Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
# Status alias mesin dalam alur kerja Step Functions
*Alias* adalah pointer hingga dua versi mesin state yang sama. Anda dapat membuat beberapa alias untuk mesin negara Anda. Setiap alias memiliki Nama Sumber Daya Amazon (ARN) yang unik. Alias ARN adalah kombinasi dari ARN mesin negara dan nama alias, dipisahkan oleh titik dua (:). Contoh berikut menunjukkan format mesin negara alias ARN.
```
arn:{{partition}}:states:{{region}}:{{account-id}}:stateMachine:{{myStateMachine}}:{{aliasName}}
```
Anda dapat menggunakan alias untuk [merutekan lalu lintas](#alias-routing-config) antara salah satu dari dua versi mesin negara. Anda juga dapat membuat alias yang menunjuk ke satu versi. Alias hanya dapat menunjuk ke versi mesin status. Anda tidak dapat menggunakan alias untuk menunjuk ke alias lain. Anda juga dapat memperbarui alias untuk menunjuk ke versi mesin status yang berbeda.
**Topics**
+ [Membuat alias mesin status (Konsol)](#procedure-create-aliases)
+ [Mengelola alias dengan APIs](#manage-aliases-with-api)
+ [Konfigurasi perutean alias](#alias-routing-config)
+ [Menjalankan mesin status menggunakan alias (Konsol)](#procedure-run-exec-with-alias)
## Membuat alias mesin status (Konsol)
Anda dapat membuat hingga 100 alias untuk setiap state machine dengan menggunakan konsol Step Functions atau dengan menjalankan aksi [CreateStateMachineAlias](https://docs.aws.amazon.com/step-functions/latest/apireference/API_CreateStateMachineAlias.html)API. Untuk meminta peningkatan batas lunak ini, gunakan halaman **Support Center** di halaman [Konsol Manajemen AWS](https://docs.aws.amazon.com/servicequotas/latest/userguide/request-quota-increase.html). Hapus alias yang tidak digunakan dari konsol atau dengan menjalankan tindakan API. [DeleteStateMachineAlias](https://docs.aws.amazon.com/step-functions/latest/apireference/API_DeleteStateMachineAlias.html)
**Untuk membuat alias mesin negara**
1. Buka [konsol Step Functions](https://console.aws.amazon.com/states/home?region=us-east-1#/), lalu pilih state machine yang ada.
1. Pada halaman **detail mesin State**, pilih tab **Alias**.
1. Pilih **Buat alias baru**.
1. Di halaman **Buat alias**, lakukan hal berikut:
1. Masukkan **nama Alias**.
1. (Opsional) Masukkan **Deskripsi** untuk alias.
1. Untuk mengonfigurasi perutean pada alias, lihat Konfigurasi perutean [Alias](#alias-routing-config).
1. Pilih **Buat alias**.
## Mengelola alias dengan operasi Step Functions API
Step Functions menyediakan operasi API berikut yang dapat Anda gunakan untuk membuat dan mengelola alias mesin status atau mendapatkan informasi tentang alias:
+ [CreateStateMachineAlias](https://docs.aws.amazon.com/step-functions/latest/apireference/API_CreateStateMachineAlias.html)— Membuat alias untuk mesin negara.
+ [DescribeStateMachineAlias](https://docs.aws.amazon.com/step-functions/latest/apireference/API_DescribeStateMachineAlias.html)— Mengembalikan rincian tentang alias mesin negara.
+ [ListStateMachineAliases](https://docs.aws.amazon.com/step-functions/latest/apireference/API_ListStateMachineAliases.html)— Daftar alias untuk ARN mesin negara yang ditentukan.
+ [UpdateStateMachineAlias](https://docs.aws.amazon.com/step-functions/latest/apireference/API_UpdateStateMachineAlias.html)— Memperbarui konfigurasi alias mesin status yang ada dengan memodifikasi atau. `description` `routingConfiguration`
+ [DeleteStateMachineAlias](https://docs.aws.amazon.com/step-functions/latest/apireference/API_DeleteStateMachineAlias.html)— Menghapus alias mesin negara.
Untuk membuat alias bernama `{{PROD}}` yang menunjuk ke versi 1 dari mesin negara bernama `{{myStateMachine}}` menggunakan AWS Command Line Interface, gunakan `create-state-machine-alias` perintah.
```
aws stepfunctions create-state-machine-alias --name PROD --routing-configuration "[{\"stateMachineVersionArn\":\"arn:aws:states:{{region}}:{{account-id}}:stateMachine:{{myStateMachine}}:{{1}}\",\"weight\":100}]"
```
## Konfigurasi perutean alias
Anda dapat menggunakan alias untuk merutekan lalu lintas eksekusi antara dua versi mesin negara. Misalnya, Anda ingin meluncurkan versi baru mesin status Anda. Anda dapat mengurangi risiko yang terlibat dalam penerapan versi baru dengan mengonfigurasi perutean pada alias. Dengan mengonfigurasi perutean, Anda dapat mengirim sebagian besar lalu lintas Anda ke versi mesin status Anda yang telah diuji sebelumnya. Versi baru kemudian dapat menerima persentase yang lebih kecil, sampai Anda dapat mengonfirmasi bahwa aman untuk meneruskan versi baru.
Untuk menentukan konfigurasi perutean, pastikan Anda memublikasikan kedua versi mesin status yang ditunjuk alias Anda. Saat Anda memulai eksekusi dari alias, Step Functions secara acak memilih versi mesin status untuk dijalankan dari versi yang ditentukan dalam konfigurasi perutean. Ini mendasarkan pilihan ini pada persentase lalu lintas yang Anda tetapkan untuk setiap versi dalam konfigurasi routing alias.
**Untuk mengkonfigurasi konfigurasi routing pada alias**
+ Pada halaman **Create alias**, di bawah **konfigurasi Routing**, lakukan hal berikut:
1. Untuk **Versi**, pilih versi mesin status pertama yang ditunjuk alias.
1. Pilih kotak centang **Pisahkan lalu lintas antara dua versi**.
**Tip**
Untuk menunjuk ke satu versi, kosongkan kotak centang **Split traffic antara dua versi**.
1. Untuk **Versi**, pilih versi kedua yang harus ditunjukkan oleh alias.
1. Di bidang **Persentase lalu lintas**, tentukan persentase lalu lintas untuk merutekan ke setiap versi. Misalnya, masukkan **60** dan **40** rute 60 persen lalu lintas eksekusi ke versi pertama dan 40 persen lalu lintas ke versi kedua.
Persentase lalu lintas gabungan harus sama dengan 100 persen.
## Menjalankan mesin status menggunakan alias (Konsol)
Anda dapat memulai eksekusi mesin status dengan alias baik dari konsol atau dengan menjalankan aksi [StartExecution](https://docs.aws.amazon.com/step-functions/latest/apireference/API_StartExecution.html)API dengan ARN alias. Step Functions kemudian menjalankan versi yang ditentukan oleh alias. Secara default, jika Anda tidak menentukan versi atau alias saat memulai eksekusi mesin status, Step Functions menggunakan revisi terbaru.
**Untuk memulai eksekusi mesin status menggunakan alias**
1. Buka [konsol Step Functions](https://console.aws.amazon.com/states/home?region=us-east-1#/), lalu pilih mesin status yang sudah ada yang telah Anda buat alias. Untuk informasi tentang membuat alias, lihat[Membuat alias mesin status (Konsol)](#procedure-create-aliases).
1. Pada halaman **detail mesin State**, pilih tab **Alias**.
1. Di bagian **Alias**, lakukan hal berikut:
1. Pilih alias yang ingin Anda mulai eksekusi.
1. Pilih **Mulai Eksekusi**.
1. (Opsional) Dalam **Mulai eksekusi** kotak dialog, masukkan nama untuk eksekusi.
1. Jika diperlukan, masukkan input eksekusi, lalu pilih **Mulai eksekusi**.