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

해결 방법

동일한 리전 내 AWS 계정 간에 사용자 지정 WorkSpaces 이미지를 공유할 수 있습니다. WorkSpaces 이미지를 공유한 후 필요한 경우 수신자 계정에서 이미지를 다른 리전으로 복사할 수 있습니다. WorkSpaces 이미지 전송을 자체 관리하려면 WorkSpaces 콘솔 또는 AWS Command Line Interface(AWS CLI)를 사용하십시오.

참고: AWS CLI 명령을 실행할 때 오류가 발생하면 AWS CLI의 오류 문제 해결을 참조하십시오. 또한 최신 AWS CLI 버전을 사용하고 있는지 확인하십시오.

BYOL 이미지는 동일한 AWS 납부자 계정 ID를 가진 다른 계정과만 공유할 수 있습니다. BYOL 이미지를 다른 리전으로 복사하려면 BYOL 이미지에 대한 대상 리전을 설정해야 합니다.

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

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

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를 호출하여 권한을 확인하고 이미지가 대상 계정과 공유되는지 확인합니다. 다음 명령을 실행하고, ImageId와 region-code를 해당하는 값으로 바꿉니다.

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

4. (선택 사항) 대상 계정에서 DescribeWorkspaceImages API를 호출하여 공유 이미지를 확인합니다. 다음 명령을 실행하고, ImageId와 region-code를 해당하는 값으로 바꿉니다.

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

5. 대상 계정에서 CopyWorkspaceImage API를 호출하여 공유 이미지를 복사합니다. 다음 명령을 실행하고, ImageId와 region-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 콘솔에서 새 이미지로 표시됩니다. 워크플로가 완료되고 이미지 상태가 Pending에서 Available로 변경되는 데 일반적으로 약 15분이 걸립니다.

관련 정보

WorkSpaces 이미지를 생성하려면 어떻게 해야 하나요?

WorkSpaces Personal에서 사용자 지정 이미지 복사