Step Functions 如何將執行與版本或別名相關聯

Step Functions 會根據您用來叫用StartExecutionAPI動作的 Amazon 資源名稱 (ARN)，將執行與版本或別名相關聯。Step Functions 在執行開始時執行此操作。

您可以使用限定或不ARN合格來啟動狀態機執行。

• 限定 ARN — 指以版本號碼或別名ARN後綴的狀態機器。

  下列限定ARN範例是指名為3的狀態機器版本myStateMachine。

  arn:aws:states:us-east-1:123456789012:stateMachine:myStateMachine:3

  下列限定ARN範例是指名為PROD的狀態機器名為的別名myStateMachine。

  arn:aws:states:us-east-1:123456789012:stateMachine:myStateMachine:PROD

• 不合格 ARN — 指ARN沒有版本號碼或別名後綴的狀態機器。

  arn:aws:states:us-east-1:123456789012:stateMachine:myStateMachine

例如，如果您的限定ARN參考版本3，則 Step Functions 會將執行與此版本相關聯。它不會將執行與任何指向版本的別名相關聯3。

如果您的限定ARN參照別名，則 Step Functions 將執行與該別名和別名指向的版本相關聯。一個執行只能與一個別名相關聯。

注意

如果您以不合格的方式啟動執行ARN，即使版本使用相同的狀態機器revision，Step Functions 也不會將該執行與版本相關聯。例如，如果版本 3 使用最新的修訂版，但您以不合格的方式啟動執行ARN，則 Step Functions 不會將該執行與版本 3 產生關聯。

檢視以版本或別名開始的執行

Step Functions 提供了以下方法，您可以在其中查看以版本或別名開始的執行：

使用API動作

您可以呼叫DescribeExecution和ListExecutionsAPI動作，來檢視與版本或別名相關聯的所有執行項目。這些API動作會傳回用來啟動執行ARN的版本或別名。這些動作也會傳回其他詳細資訊，包括狀態和ARN執行項目。

您也可以提供狀態機器別名ARN或版本，ARN以列出與特定別名或版本相關聯的執行。

下列ListExecutionsAPI動作的範例回應顯示了用來啟動狀態機執行ARN的別名的別名 myFirstExecution.

所以此 italicized 下列程式碼片段中的文字代表資源特定的資訊。

{
    "executions": [
        {
            "executionArn": "arn:aws:states:us-east-1:123456789012:execution:myStateMachine:myFirstExecution",
            "stateMachineArn": "arn:aws:states:us-east-1:123456789012:stateMachine:myStateMachine",
            "stateMachineAliasArn": "arn:aws:states:us-east-1:123456789012: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"
        }
    ]
}

使用 Step Functions 主控台

您也可以從 Step Functions 主控台檢視由版本或別名開始的執行。下列程序顯示如何檢視以特定版本開始的執行項目：

1. 開啟 Step Functions 主控台，然後選擇您已針對其發佈版本或建立別名的現有狀態機器。此範例顯示如何檢視以特定狀態機器版本開始的執行。

2. 選擇 [版本] 索引標籤，然後從 [版本] 清單中選擇版本。

   提示

   依內容或值方塊進行篩選，以搜尋特定版本。

3. 在 [版本詳細資料] 頁面上，您可以看到以所選版本開始的所有進行中和過去狀態機器執行的清單。

下圖顯示 [版本詳細資料] 主控台頁面。此頁面列出了名為MathAddDemo的狀態機器的第 4 版啟動的執行。此清單也會顯示由名稱為的別名所啟動的執行項目PROD。此別名將執行流量路由至第 4 版。

使用 CloudWatch 指標

對於您以 a 開始的每個狀態機器執行Qualified ARN，Step Functions 會發出與當前發出的指標相同的名稱和值的其他度量。這些額外量度包含您開始執行時所使用的每個版本識別碼和別名名稱的維度。使用這些指標，您可以在版本層級監視狀態機器執行，並判斷何時可能需要復原案例。您也可以根據這些指標建立 Amazon CloudWatch 警示。

Step Functions 會針對您以別名或版本開始的執行發出下列量度：

• ExecutionTime

• ExecutionsAborted

• ExecutionsFailed

• ExecutionsStarted

• ExecutionsSucceeded

• ExecutionsTimedOut

如果您使用某個版本開始執行ARN，則「Step Functions」會發佈具有StateMachineArn和維度的StateMachineArn第二個量Version度。

如果您使用別名開始執行ARN，則 Step Functions 會發出以下指標：

• 不合格ARN和版本的兩個指標。

• 具有StateMachineArn和維度的量Alias度。