기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

게이트웨이를 통한 동기식 익스프레스 워크플로우 호출 API

이 샘플 프로젝트는 Amazon API Gateway를 통해 동기식 익스프레스 워크플로를 호출하여 직원 데이터베이스를 관리하는 방법을 보여줍니다.

이 프로젝트에서 Step Functions는 API 게이트웨이 엔드포인트를 사용하여 Step Functions 동기식 익스프레스 워크플로를 시작합니다. 그런 다음 DynamoDB를 사용하여 직원 데이터베이스에서 직원을 검색, 추가 및 제거합니다.

Step Functions 동기 Express 워크플로에 대한 자세한 내용은 Step Functions의 동기식 및 비동기식 익스프레스 워크플로우 섹션을 참조하세요.

1단계: 상태 시스템 만들기

다음 단계는 이전 선택에 따라 달라집니다.

2단계: 상태 시스템 실행

예제 상태 머신 코드

이 샘플 프로젝트의 상태 머신은 API Gateway를 사용하여 동기식 익스프레스 워크플로를 호출함으로써 Gateway 및 DynamoDB와 통합됩니다. 그러면 API DynamoDB를 사용하여 직원 데이터베이스를 업데이트하거나 직원 데이터베이스에서 데이터를 읽습니다.

이 예제 상태 시스템을 살펴보고 Step Functions가 DynamoDB에서 읽고 직원 정보를 검색하는 방법을 확인합니다.

APIGateway를 사용하여 Step Functions를 호출하는 방법에 대한 자세한 내용은 다음을 참조하십시오.

방법에 대한 자세한 내용은 AWS Step Functions 다른 사람을 제어할 수 있습니다. AWS 서비스, 참조Step Functions와 서비스 통합.

{
  "Comment": "This state machine returns an employee entry from DynamoDB",
  "StartAt": "Read From DynamoDB",
  "States": {
    "Read From DynamoDB": {
      "Type": "Task",
      "Resource": "arn:aws:states:::dynamodb:getItem",
      "Parameters": {
        "TableName": "StepFunctionsSample-SynchronousExpressWorkflowAKIAIOSFODNN7EXAMPLE-DynamoDBTable-ANPAJ2UCCR6DPCEXAMPLE",
        "Key": {
          "EmployeeId": {"S.$": "$.employee"}
        }
      },
      "Retry": [
        {
          "ErrorEquals": [
            "DynamoDB.AmazonDynamoDBException"
          ],
          "IntervalSeconds": 3,
          "MaxAttempts": 2,
          "BackoffRate": 1.5
        }
      ],
      "Next": "Is Get Successful"
    },
    "Is Get Successful": {
      "Type": "Choice",
      "Choices": [
        {
          "Variable": "$.Item",
          "IsPresent": true,
          "Next": "Succeed Execution"
        }
      ],
      "Default": "Fail Execution"
    },
    "Succeed Execution": {
      "Type": "Pass",
      "Parameters" : {
        "employee.$": "$.Item.EmployeeId.S",
        "jobTitle.$": "$.Item.JobTitle.S"
      },
      "End": true
    },
    "Fail Execution": {
      "Type": "Fail",
      "Error": "EmployeeDoesNotExist"
    }
  }
}

Step Functions를 다른 기능과 함께 사용할 IAM 때 구성하는 방법에 대한 자세한 내용은 AWS 서비스는 을 참조하십시오Step Functions가 통합 서비스를 위한 IAM 정책을 생성하는 방법.

IAM예시

이 예시 AWS Identity and Access Management 샘플 프로젝트에서 생성된 (IAM) 정책에는 상태 머신 및 관련 리소스를 실행하는 데 필요한 최소 권한이 포함됩니다. IAM정책에 필요한 권한만 포함하는 것이 좋습니다.

{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Effect": "Allow",
            "Action": [
                "logs:CreateLogDelivery",
                "logs:GetLogDelivery",
                "logs:UpdateLogDelivery",
                "logs:DeleteLogDelivery",
                "logs:ListLogDeliveries",
                "logs:PutResourcePolicy",
                "logs:DescribeResourcePolicies",
                "logs:DescribeLogGroups"
            ],
            "Resource": "*"
        }
    ]
}

{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Effect": "Allow",
            "Action": [
                "dynamodb:GetItem",
                "dynamodb:PutItem",
                "dynamodb:UpdateItem",
                "dynamodb:DeleteItem"
            ],
            "Resource": [
                "arn:aws:dynamodb:us-east-1:111122223333:table/Write"
            ]
        }
    ]
}

Step Functions를 다른 기능과 함께 사용할 IAM 때 구성하는 방법에 대한 자세한 내용은 AWS 서비스는 을 참조하십시오Step Functions가 통합 서비스를 위한 IAM 정책을 생성하는 방법.