API Gateway를 사용하여 Step Functions API 만들기

IAM 콘솔에 로그인하고 역할, 역할 생성을 선택합니다.

신뢰할 수 있는 엔터티 선택(Select trusted entity) 페이지에서 다음을 수행합니다.

1. 신뢰할 수 있는 엔터티 유형의 경우 AWS 서비스의 기본 선택 항목을 그대로 둡니다.

2. 사용 사례의 드롭다운 목록에서 API Gateway를 선택합니다.

API Gateway를 선택한 다음 다음을 선택합니다.

권한 추가 페이지에서 다음을 선택합니다.

(선택 사항) 이름 지정, 검토 및 생성 페이지에서 역할 이름과 같은 세부 정보를 입력합니다. 예를 들면 APIGatewayToStepFunctions를 입력합니다.

역할 생성을 선택합니다.

역할 목록에 IAM 역할이 표시됩니다.

다음 예제와 같이 역할 이름을 선택하고 역할 ARN을 적어 둡니다.

arn:aws:iam::123456789012:role/APIGatewayToStepFunctions

역할 페이지에서 역할(APIGatewayToStepFunctions)을 찾아 선택합니다.

권한 탭에서 권한 추가, 정책 연결을 차례로 선택합니다.

정책 연결 페이지에서 AWSStepFunctionsFullAccess를 검색하고 정책을 선택한 다음 권한 추가를 선택합니다.

Amazon API Gateway 콘솔을 열고 API 생성을 선택합니다.

API 유형 선택 페이지의 REST API 창에서 빌드를 선택합니다.

REST API 생성 페이지에서 새 API를 선택한 다음 StartExecutionAPI 이름으로 API를 입력합니다.

API 엔드포인트 유형을 리전별로 유지한 다음 API 생성을 선택합니다.

StartExecutionAPI의 리소스 페이지에서 리소스 생성을 선택합니다.

리소스 생성 페이지에서 리소스 이름에 execution을 입력한 다음 리소스 생성을 선택합니다.

/execution 리소스를 선택한 다음 메서드 생성을 선택합니다.

메서드 유형에서 POST를 선택합니다.

통합 유형에서 AWS 서비스를 선택합니다.

AWS 리전의 목록에서 리전을 선택합니다.

AWS 서비스의 목록에서 Step Functions를 선택합니다.

AWS 하위 도메인은 비워 둡니다.

HTTP 메서드 목록에서 POST를 선택합니다.

작업 유형에서 작업 이름 사용을 선택합니다.

함수 이름에 StartExecution를 입력합니다.

다음 예제와 같이 실행 역할에 앞에서 만든 IAM 역할의 역할 ARN을 입력합니다.

arn:aws:iam::123456789012:role/APIGatewayToStepFunctions

보안 인증 캐시 및 기본 제한 시간에 대한 기본 옵션을 유지한 다음 저장을 선택합니다.

/execution - POST - 메서드 실행 페이지에서 테스트 탭을 선택합니다. 탭을 표시하려면 오른쪽 화살표 버튼을 선택해야 할 수도 있습니다.

/execution - POST - 메서드 테스트 탭에서 기존 상태 시스템의 ARN을 사용하여 다음 요청 파라미터를 요청 본문 섹션에 복사하거나 Lambda 함수를 사용하는 새 상태 시스템을 만든 다음 테스트를 선택합니다.

{
   "input": "{}",
   "name": "MyExecution",
   "stateMachineArn": "arn:aws:states:us-east-1:123456789012:stateMachine:HelloWorld"
}

자세한 내용은 AWS Step Functions API 참조의 StartExecution 요청 구문을 참조하세요.

{
    "input": "$util.escapeJavaScript($input.json('$'))",
    "stateMachineArn": "$util.escapeJavaScript($stageVariables.arn)"
}

실행이 시작되고 실행 ARN 및 해당 epoch 날짜가 응답 본문 아래에 표시됩니다.

{
   "executionArn": "arn:aws:states:us-east-1:123456789012:execution:HelloWorld:MyExecution",
   "startDate": 1486768956.878
}

StartExecutionAPI의 리소스 페이지에서 API 배포를 선택합니다.

스테이지에서 새 스테이지를 선택합니다.

단계 이름에 alpha를 입력합니다.

(선택 사항) 설명에 설명을 입력합니다.

배포를 선택합니다.

StartExecutionAPI의 스테이지 페이지에서 알파,/, /실행, POST를 확장한 다음 POST 메서드를 선택합니다.

메서드 재정의에서 복사 아이콘을 선택하여 API의 간접 호출 URL을 복사합니다. 전체 URL은 다음 예제와 비슷해야 합니다.

https://a1b2c3d4e5.execute-api.us-east-1.amazonaws.com/alpha/execution

다음 예제와 같이 명령줄에서 상태 머신의 ARN을 사용하여 curl 명령을 실행하고 배포 URL을 호출합니다.

curl -X POST -d '{"input": "{}","name": "MyExecution","stateMachineArn": "arn:aws:states:us-east-1:123456789012:stateMachine:HelloWorld"}' https://a1b2c3d4e5.execute-api.us-east-1.amazonaws.com/alpha/execution

다음 예제와 같이 실행 ARN 및 해당 epoch 날짜가 반환됩니다.

{"executionArn":"arn:aws:states:us-east-1:123456789012:execution:HelloWorld:MyExecution","startDate":1.486772644911E9}