使用 API Gateway 创建 Step Functions API

登录到 IAM 控制台，然后依次选择角色、创建角色。

在选择受信任的实体页面上，请执行以下操作：

1. 对于可信实体类型，保留 Amazon Web Service的默认选择。

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。

对于集成类型，选择 Amazon 服务。

对于 Amazon Web Services 区域，从列表中选择一个区域。

对于 Amazon Web Service，从列表中选择 Step Functions。

将 Amazon 子域保留为空白。

对于 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"
}

有关更多信息，请参阅《Amazon Step Functions API 参考》中的请求语法。

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

执行将会启动，并且执行 ARN 及其纪元日期显示在响应正文下。

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

在 StartExecutionAPI 的资源页面上，选择部署 API。

对于阶段，选择新建阶段。

对于阶段名称，输入 alpha。

（可选）对于描述，输入描述。

选择部署。

在 StartExecutionAPI 的 “阶段” 页面上，展开 alpha、/、/exec ution、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 及其纪元日期，如以下示例所示。

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