기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
# HealthOmics 워크플로 공유
프라이빗 워크플로의 소유자는 워크플로를 동일한 리전의와 공유할 수 AWS 계정 있습니다. 워크플로를 둘 이상과 공유하려면 동일한 워크플로의 여러 공유를 AWS 계정생성합니다.
소유자는 공유를 삭제하여 공유 워크플로에 대한 액세스를 취소할 수 있습니다.
**참고**
HealthOmics는 구독자의 계정에서 워크플로가 실행되는 동안 공유 워크플로가 Amazon ECR 리포지토리에 자동으로 액세스할 수 있도록 허용합니다. 공유 워크플로에 대한 추가 리포지토리 액세스 권한을 부여할 필요가 없습니다.
워크플로를 공유하면 구독자는 모든 워크플로 버전을 사용할 수 있습니다. 공유 워크플로에 대한 버전 수준 액세스 제어가 필요한 경우 워크플로 버전을 사용하는 대신 별도의 워크플로를 생성하는 것이 좋습니다.
**Topics**
+ [공유 워크플로 구독](#shared-workflow-subscribe)
+ [워크플로 공유 상태 모니터링](#shared-workflow-monitor)
+ [콘솔을 사용하여 프라이빗 워크플로 공유](#shared-workflow-create-console)
+ [CLI를 사용하여 프라이빗 워크플로 공유](#shared-workflow-create-api)
+ [콘솔을 사용하여 공유 워크플로 수락](#shared-workflow-accept-console)
+ [콘솔을 사용하여 공유 워크플로 실행](#shared-workflow-using-console)
+ [API를 사용하여 공유 워크플로 실행](#shared-workflow-using-api)
## 공유 워크플로 구독
공유 워크플로를 구독하려면 다음 전체 단계에 따라 워크플로를 수락하고 사용합니다.
1. 콘솔 또는 API를 사용하여 공유를 수락합니다. 현재 리전을 공유 요청과 동일한 리전으로 설정합니다.
+ 콘솔에서 공유 요청을 찾으려면 **모든 리소스 공유** 페이지로 이동한 다음 **나와 공유** 탭을 선택합니다.
1. 콘솔 또는 API를 사용하여 공유 워크플로에 대한 실행을 생성합니다.
+ 콘솔에서 워크플로 세부 정보 페이지를 찾으려면 **나와 공유됨**(1단계 참조)으로 이동한 다음 공유 워크플로의 **리소스 링크를** 선택합니다.
1. 워크플로에 대한 자체 입력 데이터를 제공합니다.
1. 공유 워크플로는에서 실행됩니다 AWS 계정.
공유 워크플로의 구독자는 시스템에서 다음 워크플로 작업을 수행하지 못하도록 차단합니다.
+ 공유 워크플로 내보내기
+ 공유 워크플로 다시 실행
+ 공유 워크플로에 대한 새 실행을 생성합니다.
+ 워크플로를 다시 공유합니다.
+ 워크플로에 태그를 할당합니다.
+ 워크플로 삭제.
+ 워크플로가 더 이상 필요하지 않으면 워크플로 공유를 삭제합니다.
리소스 공유에 대한 자세한 내용은 섹션을 참조[의 교차 계정 리소스 공유 AWS HealthOmics](resource-sharing.md)하세요.
## 워크플로 공유 상태 모니터링
HealthOmics는 워크플로 공유의 각 상태 변경에 대해 이벤트를 EventBridge로 전송합니다. 특정 상태 변경에 대한 알림을 받으려면 **워크플로 공유 상태 변경** 이벤트를 모니터링하도록 EventBridge 규칙을 설정합니다. 예제:
+ 워크플로 공유 요청을 수신할 때마다, 그리고 사용자가 워크플로 공유를 취소할 때마다 알림이 필요합니다.
+ 워크플로 공유 요청을 시작한 후 사용자가 요청을 수락하거나 거부할 때 알림을 받으려고 합니다.
이벤트 사용에 대한 자세한 내용은 섹션을 참조하세요[에서 EventBridge 사용 AWS HealthOmics](eventbridge.md).
## 콘솔을 사용하여 프라이빗 워크플로 공유
콘솔에서 프라이빗 워크플로를 워크플로와 동일한 리전 AWS 계정 의와 공유할 수 있습니다.
**프라이빗 워크플로를 공유하려면**
1. [HealthOmics 콘솔](https://console.aws.amazon.com/omics/)을 엽니다.
1. 필요한 경우 왼쪽 탐색 창(™)을 엽니다. **프라이빗 워크플로**를 선택합니다.
1. **프라이빗** **워크플로** 페이지의 워크플로 테이블에서 공유할 워크플로를 선택하고 **공유**를 선택합니다.
1. **워크플로** **공유 페이지의 세부 정보** 공유 패널에서 공유에 대한 설명이 포함된 이름을 입력하고 구독 AWS 계정 자의를 입력합니다.
1. **리소스 공유**를 선택합니다. 콘솔은 **모든 리소스 공유 페이지에 리소스 공유**를 표시합니다.
공유의 초기 상태는 보류 중입니다. 구독자가 공유를 수락하면 상태가 활성으로 변경됩니다.
## CLI를 사용하여 프라이빗 워크플로 공유
**Create-share** API 작업을 사용하여 워크플로 공유를 생성합니다. 보안 주체 구독자는 워크플로 AWS 계정 에 액세스할 수 있는 사용자의 입니다.
```
aws omics create-share \
--resource-arn "arn:aws:omics:us-west-2:555555555555:workflow/123456" \
--principal-subscriber "123456789012" \
--name "my_Share-123"
```
생성에 성공하면 공유 ID 및 상태가 포함된 응답을 받게 됩니다.
```
{
"shareId": "495c21bedc889d07d0ab69d710a6841e-dd75ab7a1a9c384fa848b5bd8e5a7e0a",
"name": "my_Share-123",
"status": "PENDING"
}
```
구독자가 `accept-share` API 작업을 사용하여 수락할 때까지 공유는 보류 상태로 유지됩니다.
다른 API 사용 예제는 섹션을 참조[의 교차 계정 리소스 공유 AWS HealthOmics](resource-sharing.md)하세요.
## 콘솔을 사용하여 공유 워크플로 수락
콘솔을 사용하여 제공된 워크플로 공유를 수락할 수 있습니다. 콘솔을 워크플로와 동일한 리전으로 설정해야 합니다.
1. [HealthOmics 콘솔](https://console.aws.amazon.com/omics/)을 엽니다.
1. 필요한 경우 왼쪽 탐색 창(™)을 엽니다. **모든 리소스 공유**를 선택한 다음 **나와 공유** 탭을 선택합니다.
1. **나와 공유된 리소스** 테이블에서 워크플로 공유를 선택한 다음 **수락**을 선택합니다.
워크플로를 수락한 후 공유 워크플로의 **리소스 링크를** 선택하여 세부 정보를 확인합니다.
## 콘솔을 사용하여 공유 워크플로 실행
워크플로 공유를 수락한 후 워크플로에서 실행을 시작할 수 있습니다.
1. [HealthOmics 콘솔](https://console.aws.amazon.com/omics/)을 엽니다.
1. 필요한 경우 왼쪽 탐색 창(™)을 엽니다. **모든 리소스 공유**를 선택한 다음 **나와 공유** 탭을 선택합니다.
1. **나와 공유된 리소스** 테이블에서 공유 워크플로의 **리소스 링크를** 선택합니다.
1. **워크플로 세부 정보** 페이지에서 **실행 생성을** 선택합니다.
콘솔에서 워크플로 유형(공유)과 **워크플로 ID**가 미리 채워진 **실행 생성** 페이지가 열립니다.
1. **실행 생성** 양식에서 나머지 필드를 구성합니다. 자세한 내용은 [콘솔을 사용하여 실행 시작](starting-a-run.md#starting-a-run-console) 섹션을 참조하세요.
## API를 사용하여 공유 워크플로 실행
get-workflow를 사용하여 공유 워크플로의 ARN을 검색합니다.
```
aws omics get-workflow --id 1234567 \
--workflow-owner-id 55555555555
```
워크플로를 실행할 때 워크플로 소유자의 AWS 계정 ID와 공유 워크플로의 ARN을 제공합니다.
```
aws omics start-run --id 1234567 --workflow-owner-id 55555555555 \
--role-arn arn:aws:iam::1234567892012:role/service-role/OmicsWorkflow-20221004T164236 \
--name ArchiveTest --retention-mode REMOVE
```