翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

# Amazon SWF でのワークフローの開始
<a name="swf-dg-start-workflow-exec"></a>

`StartWorkflowExecution` アクションを使用して、任意のアプリケーションから登録されたワークフロータイプのワークフロー実行を開始できます。開始時に、`workflowId` と呼ばれる ID を実行に関連付けます。`workflowId` は、注文処理アプリケーションの注文番号のような、アプリケーションに対して適切な任意の文字列とすることができます。同じドメイン内の複数のオープンなワークフロー実行に対して同じ `workflowId` を使用することはできません。たとえば、`workflowId` `Customer Order 01` でワークフロー実行を開始した場合、2 番目のワークフロー実行は開始されず、リクエストは失敗します。ただし、閉じた実行の `workflowId` を再利用することはできます。Amazon SWF は、`runId` と呼ばれる、システムで生成された一意の識別子をワークフローの実行ごとに関連付けます。

ワークフローおよびアクティビティのタイプが登録されたら、`StartWorkflowExecution` アクションを呼び出してワークフローを起動します。`input` パラメータの値は、ワークフローを開始するアプリケーションによって指定される任意の文字列とすることができます。`executionStartToCloseTimeout` は、ワークフロー実行の開始からクローズまで許可される時間 (秒単位) です。この制限を超えると、ワークフロー実行がタイムアウトします。Amazon SWF の他のタイムアウトパラメータの一部とは異なり、このタイムアウトに値 `NONE` を指定することはできません。ワークフロー実行の時間には、最大 1 年間という制限があります。同様に、*taskStartToCloseTimeout* は、このワークフロー実行に関連付けられた決定タスクがタイムアウトするまで許可される時間 (秒数) です。

```
https://swf.us-east-1.amazonaws.com
StartWorkflowExecution
{
  "domain" : "867530901",
  "workflowId" : "20110927-T-1",
  "workflowType" : {
    "name" : "customerOrderWorkflow", "version" : "1.1"
  },
  "taskList" : { "name" : "specialTaskList" },
  "input" : "arbitrary-string-that-is-meaningful-to-the-workflow",
  "executionStartToCloseTimeout" : "1800",
  "tagList" : [ "music purchase", "digital", "ricoh-the-dog" ],
  "taskStartToCloseTimeout" : "1800",
  "childPolicy" : "TERMINATE"
}
```

 `StartWorkflowExecution` アクションが成功すると、Amazon SWF はワークフロー実行に対して `runId` を返します。ワークフロー実行の `runId` は、特定のリージョン内で一意です。後で、Amazon SWF への呼び出しでこのワークフロー実行を指定する必要がある場合は、`runId` を保存します。たとえば、後でワークフロー実行にシグナルを送信する必要がある場合は、`runId` を使用します。

```
{"runId": "9ba33198-4b18-4792-9c15-7181fb3a8852"}
```