使用 API Gateway 建立 Step Functions API

登入 IAM 主控台，然後選擇角色、建立角色。

在 Select trusted entity (選取信任的實體) 頁面上，執行以下作業：

1. 對於信任的實體類型，請保留 的預設選擇AWS 服務。

2. 對於使用案例，從下拉式清單中選擇 API Gateway。

選取 API Gateway，然後選擇下一步。

在 Add permissions (新增許可) 頁面上，選擇 Next (下一步)。

（選用） 在名稱、檢閱和建立頁面上，輸入詳細資訊，例如角色名稱。例如，​輸入 APIGatewayToStepFunctions。

選擇建立角色。

IAM 角色會出現在角色清單中。

選擇您角色的名稱，並記下 Role ARN (角色 ARN)，如以下範例所示。

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

在 Roles (角色) 頁面上，搜尋您的角色 (APIGatewayToStepFunctions)，然後選擇角色。

在許可索引標籤上，選擇新增許可，然後選擇連接政策。

在連接政策頁面上，搜尋 AWSStepFunctionsFullAccess，選擇政策，然後選擇新增許可。

開啟 Amazon API Gateway 主控台，然後選擇建立 API。

在選擇 API 類型頁面上，在 REST API 窗格中，選擇建置。

在建立 REST API 頁面上，選取新 API，然後輸入 API 名稱的 StartExecutionAPI。

將 API 端點類型保留為區域，然後選擇建立 API。

在 StartExecutionAPI 的資源頁面上，選擇建立資源。

在建立資源頁面上，execution輸入 資源名稱，然後選擇建立資源。

選擇 /execution 資源，然後選擇建立方法。

針對方法類型，選擇 POST。

對於整合類型，選擇 AWS 服務。

對於 AWS 區域，從清單中選擇區域。

對於 AWS 服務，從清單中選擇步驟函數。

讓 AWS 子網域保持空白。

對於 HTTP 方法，從清單中選擇 POST。

針對動作類型，選取使用動作名稱。

針對動作名稱，輸入 StartExecution。

針對執行角色，輸入您先前建立之 IAM 角色的角色 ARN，如下列範例所示。

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

保留登入資料快取和預設逾時的預設選項，然後選擇儲存。

在 /execution - POST - Method Execution 頁面上，選擇測試索引標籤。您可能需要選擇向右箭頭按鈕才能顯示此索引標籤。

在 /execution - POST - Method Test 索引標籤上，使用現有狀態機器的 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 的階段頁面上，展開 alpha、/、/execution、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}