Step Functions가 실행을 버전 또는 별칭과 연결하는 방법

Step Functions는 작업을 호출하는 데 사용하는 Amazon 리소스 이름 (ARN) 을 기반으로 한 버전 또는 별칭과 실행을 연결합니다. StartExecutionAPI Step Functions는 실행 시작 시간에 이 작업을 수행합니다.

정규화된 시스템 또는 정규화되지 않은 것을 사용하여 상태 머신 실행을 시작할 수 있습니다. ARN

• ARNElified — 버전 번호 또는 별칭 ARN 이름이 접미사로 붙은 상태 머신을 가리킵니다.

  다음은 이름이 지정된 상태 ARN 3 머신의 버전을 가리키는 예제입니다. myStateMachine

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

  다음은 이름이 지정된 PROD 상태 머신의 별칭을 가리키는 ARN 예제입니다. myStateMachine

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

• Unqualified ARN — 버전 번호나 별칭 이름 접미사가 ARN 없는 상태 머신을 가리킵니다.

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

예를 들어, 적격한 ARN 참조 버전이 3 있는 경우 Step Functions는 실행을 이 버전과 연결합니다. 버전 3을 가리키는 별칭과 실행을 연결하지 않습니다.

한정된 사용자가 별칭을 ARN 참조하는 경우 Step Functions는 실행을 해당 별칭 및 별칭이 가리키는 버전과 연결합니다. 실행을 별칭 하나에만 연결할 수 있습니다.

참고

정규화되지 않은 상태로 실행을 시작하면 Step ARN Functions는 버전이 동일한 상태 머신을 revision 사용하더라도 해당 실행을 버전과 연결하지 않습니다. 예를 들어 버전 3에서 최신 버전을 사용하지만 정규화되지 않은 버전으로 실행을 시작하는 경우 Step ARN Functions는 해당 실행을 버전 3과 연결하지 않습니다.

버전 또는 별칭으로 시작된 실행 보기

Step Functions는 버전 또는 별칭으로 시작된 실행을 볼 수 있는 다음과 같은 방법을 제공합니다.

액션 사용 API

및 작업을 호출하여 버전 또는 별칭과 관련된 모든 실행을 볼 수 있습니다. DescribeExecutionListExecutionsAPI 이러한 API 작업은 실행을 ARN 시작하는 데 사용된 버전 또는 별칭을 반환합니다. 이러한 작업은 상태 및 ARN 실행 등의 기타 세부 정보도 반환합니다.

상태 시스템 별칭 또는 버전을 제공하여 특정 별칭 ARN 또는 버전과 관련된 실행을 ARN 나열할 수도 있습니다.

다음 예제 ListExecutionsAPI작업 응답은 다음과 같은 상태 시스템 ARN 실행을 시작하는 데 사용되는 별칭을 보여줍니다.myFirstExecution.

The 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

Qualified ARN으로 시작하는 상태 시스템 실행마다 Step Functions는 현재 내보내는 지표와 동일한 이름 및 값을 가진 추가 지표를 내보냅니다. 이러한 추가 지표에는 실행을 시작하는 데 사용하는 버전 식별자 및 별칭 이름 각각에 대한 차원이 포함됩니다. 이러한 지표를 사용하면 버전 수준에서 상태 시스템 실행을 모니터링하고 롤백 시나리오가 필요한 시기를 결정할 수 있습니다. 이러한 지표를 기반으로 Amazon CloudWatch 경보를 생성할 수도 있습니다.

Step Functions는 별칭 또는 버전으로 시작하는 실행에 대한 다음 지표를 내보냅니다.

• ExecutionTime

• ExecutionsAborted

• ExecutionsFailed

• ExecutionsStarted

• ExecutionsSucceeded

• ExecutionsTimedOut

특정 버전으로 실행을 시작한 경우 Step Functions는 를 사용하여 지표를 게시하고ARN, 두 번째 지표는 StateMachineArn StateMachineArn 및 Version 차원을 사용하여 게시합니다.

별칭으로 실행을 시작한 경우 Step ARN Functions는 다음 지표를 내보냅니다.

• 규격되지 않은 ARN AND 버전에 대한 두 개의 지표.

• StateMachineArn 및 Alias 차원이 포함된 지표