

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

# Bagaimana Step Functions mengaitkan eksekusi dengan versi atau alias
<a name="execution-alias-version-associate"></a>

Step Functions mengaitkan eksekusi dengan versi atau alias berdasarkan Amazon Resource Name (ARN) yang Anda gunakan untuk menjalankan tindakan API. [StartExecution](https://docs.aws.amazon.com/step-functions/latest/apireference/API_StartExecution.html) Step Functions melakukan tindakan ini pada waktu mulai eksekusi.

Anda dapat memulai eksekusi mesin negara menggunakan ARN yang memenuhi syarat atau tidak memenuhi syarat.
+ **ARN yang memenuhi syarat** - Mengacu pada ARN mesin negara yang diakhiran dengan nomor versi atau nama alias.

  Contoh ARN yang memenuhi syarat berikut mengacu pada `3` versi mesin negara bernama. `myStateMachine`

  ```
  arn:aws:states:region:account-id:stateMachine:myStateMachine:3
  ```

  Contoh ARN yang memenuhi syarat berikut mengacu pada alias bernama mesin `PROD` negara bernama. `myStateMachine`

  ```
  arn:aws:states:region:account-id:stateMachine:myStateMachine:PROD
  ```
+ **ARN yang tidak memenuhi syarat** - Mengacu pada ARN mesin negara tanpa nomor versi atau akhiran nama alias.

  ```
  arn:aws:states:region:account-id:stateMachine:myStateMachine
  ```

Misalnya, jika ARN Anda yang memenuhi syarat mengacu pada versi`3`, Step Functions mengaitkan eksekusi dengan versi ini. Itu tidak mengaitkan eksekusi dengan alias apa pun yang mengarah ke versi`3`.

Jika ARN Anda yang memenuhi syarat mengacu pada alias, Step Functions mengaitkan eksekusi dengan alias tersebut dan versi yang ditunjuk alias tersebut. Eksekusi hanya dapat dikaitkan dengan satu alias.

**catatan**  
Jika Anda memulai eksekusi dengan ARN yang tidak memenuhi syarat, Step Functions tidak mengaitkan eksekusi tersebut dengan versi meskipun versi tersebut menggunakan mesin status yang sama. [revision](concepts-cd-aliasing-versioning.md#statemachinerev) Misalnya, jika versi 3 menggunakan revisi terbaru, tetapi Anda memulai eksekusi dengan ARN yang tidak memenuhi syarat, Step Functions tidak mengaitkan eksekusi tersebut dengan versi 3.

## Melihat eksekusi dimulai dengan versi atau alias
<a name="view-version-alias-executions"></a>

Step Functions menyediakan cara-cara berikut di mana Anda dapat melihat eksekusi yang dimulai dengan versi atau alias:

### Menggunakan tindakan API
<a name="view-executions-api-actions"></a>

Anda dapat melihat semua eksekusi yang terkait dengan versi atau alias dengan menjalankan tindakan API [DescribeExecution](https://docs.aws.amazon.com/step-functions/latest/apireference/API_DescribeExecution.html)dan [ListExecutions](https://docs.aws.amazon.com/step-functions/latest/apireference/API_ListExecutions.html). Tindakan API ini mengembalikan ARN versi atau alias yang digunakan untuk memulai eksekusi. Tindakan ini juga mengembalikan detail lainnya termasuk status dan ARN eksekusi.

Anda juga dapat memberikan alias mesin status ARN atau versi ARN untuk mencantumkan eksekusi yang terkait dengan alias atau versi tertentu.

Contoh respons tindakan [ListExecutions](https://docs.aws.amazon.com/step-functions/latest/apireference/API_ListExecutions.html)API berikut menunjukkan ARN alias yang digunakan untuk memulai eksekusi mesin status bernama. *myFirstExecution*

*italicized*Teks dalam cuplikan kode berikut mewakili informasi khusus sumber daya.

```
{
    "executions": [
        {
            "executionArn": "arn:aws:states:region:account-id:execution:myStateMachine:myFirstExecution",
            "stateMachineArn": "arn:aws:states:region:account-id:stateMachine:myStateMachine",
            "stateMachineAliasArn": "arn:aws:states:region:account-id:stateMachine:myStateMachine:PROD",
            "name": "myFirstExecution",
            "status": "SUCCEEDED",
            "startDate": "2023-04-20T23:07:09.477000+00:00",
            "stopDate": "2023-04-20T23:07:09.732000+00:00"
        }
    ]
}
```

### Menggunakan konsol Step Functions
<a name="view-executions-console"></a>

Anda juga dapat melihat eksekusi yang dimulai oleh versi atau alias dari konsol [Step Functions](https://console.aws.amazon.com/states/home?region=us-east-1#/). Prosedur berikut menunjukkan bagaimana Anda dapat melihat eksekusi yang dimulai dengan versi tertentu:

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 publikasikan [versinya](concepts-state-machine-version.md#procedure-create-versions) atau buat [alias](concepts-state-machine-alias.md#procedure-create-aliases). Contoh ini menunjukkan cara melihat eksekusi yang dimulai dengan versi mesin status tertentu.

1. Pilih tab **Versi**, lalu pilih versi dari daftar **Versi**.
**Tip**  
Filter berdasarkan properti atau kotak nilai untuk mencari versi tertentu.

1. Pada *halaman Detail versi*, Anda dapat melihat daftar semua eksekusi mesin status yang sedang berlangsung dan sebelumnya yang dimulai dengan versi yang dipilih.

Gambar berikut menunjukkan halaman konsol *Detail Versi*. Halaman ini mencantumkan eksekusi yang dimulai oleh versi *4* dari mesin negara bernama`MathAddDemo`. Daftar ini juga menampilkan eksekusi yang dimulai oleh alias bernama`PROD`. *Alias ini mengarahkan lalu lintas eksekusi ke versi 4.*

![\[Tangkapan layar ilustratif dari halaman konsol detail versi mesin negara.\]](http://docs.aws.amazon.com/id_id/step-functions/latest/dg/images/view-version-executions.png)


### Menggunakan CloudWatch metrik
<a name="view-executions-metrics"></a>

Untuk setiap eksekusi mesin status yang Anda mulai dengan[Qualified ARN](#qualifiedARN), Step Functions memancarkan metrik tambahan dengan nama dan nilai yang sama dengan metrik yang dipancarkan saat ini. Metrik tambahan ini berisi dimensi untuk masing-masing pengenal versi dan nama alias yang Anda gunakan untuk memulai eksekusi. Dengan metrik ini, Anda dapat memantau eksekusi mesin status pada tingkat versi dan menentukan kapan skenario rollback mungkin diperlukan. Anda juga dapat [membuat CloudWatch alarm Amazon](procedure-cw-metrics.md#monitoring-using-cloudwatch-console-set-alarm) berdasarkan metrik ini.

Step Functions memancarkan metrik berikut untuk eksekusi yang Anda mulai dengan alias atau versi:
+ `ExecutionTime`
+ `ExecutionsAborted`
+ `ExecutionsFailed`
+ `ExecutionsStarted`
+ `ExecutionsSucceeded`
+ `ExecutionsTimedOut `

Jika Anda memulai eksekusi dengan versi ARN, Step Functions menerbitkan metrik dengan dan metrik kedua dengan `StateMachineArn` `StateMachineArn` dan dimensi. `Version`

Jika Anda memulai eksekusi dengan alias ARN, Step Functions memancarkan metrik berikut:
+ Dua metrik untuk ARN dan versi yang tidak memenuhi syarat.
+ Sebuah metrik dengan `StateMachineArn` dan `Alias` dimensi.