本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# 使用 API 啟動 HealthOmics Ready2Run 工作流程
<a name="Ready2Run-workflows-API"></a>

大多數 API 操作的行為方式與 Ready2Run 工作流程和私有工作流程類似。

若要傳回可用的 Ready2Run 工作流程清單，請使用將 `type` 參數設定為 READY2RUN 的 **list-workflows**。

```
aws omics list-workflows --type READY2RUN                            
```

在您識別要從 **list-workflows** 回應執行的工作流程之後，您可以使用 **get-workflow** 搭配 `--id` 參數來取得更多詳細資訊。

```
aws omics get-workflow --type READY2RUN --id {{workflow id}}    
```

若要執行 Ready2Run 工作流程，您可以使用 **start-run** API 操作，並將工作流程類型參數設為 `READY2RUN`，如下列範例所示

```
aws-omics start-run \
  --workflow-type READY2RUN \
  --workflow-id {{workflow id}} \
  --output-uri &example-s3-bucket; \
  --role-arn arn:aws:iam::1234567892012:role/service-role/OmicsWorkflow-20221004T164236 \
  --parameters file:///path/to/parameters.json
```

若要指定工作流程版本，請使用 **workflow-version** 參數，如本範例所示。

```
aws-omics start-run \
  --workflow-type READY2RUN \ 
  ...
  --version-name {{'3.0.0'}}
```

若要監控您的執行，您可以使用 **get-run** API 操作，如下所示。

```
aws-omics get-run \
  --id {{run id}}
```