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

# API를 사용하여 HealthOmics Ready2Run 워크플로 시작
<a name="Ready2Run-workflows-API"></a>

대부분의 API 작업은 Ready2Run 워크플로와 프라이빗 워크플로에서 유사한 방식으로 작동합니다.

사용 가능한 Ready2Run 워크플로 목록을 반환하려면 `type` 파라미터가 READY2RUN으로 설정된 **list-workflows**를 사용합니다.

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

**list-workflows** 응답에서 실행할 워크플로를 식별한 후 `--id` 파라미터와 함께 **get-workflow**를 사용하여 자세한 내용을 가져올 수 있습니다.

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

Ready2Run 워크플로를 실행하려면 다음 예제와 `READY2RUN`같이 워크플로 유형 파라미터가 로 설정된 **상태에서 시작-실행** API 작업을 사용할 수 있습니다.

```
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
```

워크플로 버전을 지정하려면이 예제와 같이 **워크플로 버전** 파라미터를 사용합니다.

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

다음과 같이 실행을 모니터링하기 위해 **get-run** API 작업을 사용할 수 있습니다.

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