WorkSpaces 이미지 또는 BYOL 이미지를 다른 AWS 계정과 공유하려면 어떻게 해야 합니까?

최종 업데이트 날짜: 2022년 10월 6일

Amazon WorkSpaces 이미지 또는 WorkSpaces의 기존 라이선스 가져오기(BYOL) 이미지를 동일한 AWS 리전의 다른 Amazon Web Services(AWS) 계정에 공유하려 합니다. 어떻게 해야 합니까?

해결 방법

동일한 리전 내에 위치한 AWS 계정 간 사용자 지정 WorkSpaces 이미지를 공유할 수 있습니다. WorkSpaces 이미지를 공유한 후 수신자 계정은 필요에 따라 이미지를 다른 리전으로 복사할 수 있습니다. WorkSpaces 콘솔 또는 AWS Command Line Interface(AWS CLI)를 사용하여 WorkSpaces 이미지 전송을 자체 관리할 수 있습니다.

BYOL 이미지는 AWS 지급인 계정 ID가 동일한 그 밖의 계정에 한하여 공유할 수 있습니다. BYOL 이미지를 다른 리전으로 복사하려면 BYOL 이미지에 대해 대상 리전을 설정해야 합니다.

WorkSpaces 콘솔을 사용하여 이미지 공유

WorkSpaces 콘솔을 사용하여 동일한 리전의 다른 계정과 이미지를 공유하거나 공유 해제할 수 있습니다. 지침은 사용자 정의 WorkSpaces 이미지 공유 또는 공유 해제를 참조하십시오.

AWS CLI를 사용하여 이미지 공유

API 호출과 AWS CLI를 사용하여 프로그래밍 방식으로 이미지를 공유하거나 공유 해제할 수 있습니다.

중요: 다음 프로세스의 명령에는 AWS CLI 버전 2가 필요합니다. 설치 지침은 AWS CLI의 최신 버전 설치 또는 업데이트를 참조하십시오.

WorkSpaces 이미지를 같은 리전 내 다른 계정에 복사하려면 다음 단계를 따르십시오.

1.    소스 계정에서 원본 이미지의 이미지 ID를 확인합니다. 다음 명령을 실행하여 region-code를 WorkSpaces 리전 코드로 바꿉니다.

aws workspaces describe-workspace-images --region region-code

그런 다음 출력의 ImageId를 기록해 둡니다.

2.    소스 계정에서 UpdateWorkspaceImagePermission API를 호출하여 원본 이미지를 대상 계정과 공유합니다. 다음 명령을 실행합니다. 이때 ImageId는 1단계의 출력으로, region-code는 WorkSpaces 리전 코드로, target-account는 대상 계정 번호로 대체합니다.

aws workspaces update-workspace-image-permission --image-id ImageId --region region-code --shared-account-id target-account --allow-copy-image

3.    (선택 사항) 소스 계정에서 DescribeWorkspaceImagePermissions API를 호출하여 권한을 보고 이미지가 대상 계정과 공유되는지 확인합니다. 다음 명령을 실행합니다. 이때 ImageIdregion-code는 적절한 값으로 대체합니다.

aws workspaces describe-workspace-image-permissions --image-id ImageId --region region-code

4.    (선택 사항) 대상 계정에서 DescribeWorkspaceImages API를 호출하여 공유 이미지를 봅니다. 다음 명령을 실행합니다. 이때 ImageIdregion-code는 적절한 값으로 대체합니다.

aws workspaces describe-workspace-images --image-ids ImageId --region region-code --image-type SHARED

5.    대상 계정에서 CopyWorkspaceImage API를 호출하여 공유 이미지를 복사합니다. 다음 명령을 실행합니다. 이때 ImageIdregion-code는 적절한 값으로 대체합니다. 또한 new-image-name은 대상 계정의 이미지에 사용할 이름으로 대체합니다.

aws workspaces copy-workspace-image --source-image-id ImageId --source-region region-code --name new-image-name --region region-code

이제 대상 계정은 WorkSpaces 콘솔에서 새 이미지를 볼 수 있습니다. 워크플로가 완료되면 이미지 상태가 대기 중에서 사용 가능으로 변경됩니다. 이 과정은 일반적으로 15분 정도 걸립니다.