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

# Amazon WorkSpaces
<a name="automation-ref-wsp"></a>

 AWS Systems Manager 자동화는 Amazon WorkSpaces에 사전 정의된 실행서를 제공합니다. 실행서에 대한 자세한 내용은 [실행서 작업](https://docs.aws.amazon.com/systems-manager/latest/userguide/automation-documents.html)을 참조하세요. 실행서 콘텐츠를 보는 방법에 대한 자세한 내용은 [실행서 콘텐츠 보기](automation-runbook-reference.md#view-automation-json)(을)를 참조하세요.

**Topics**
+ [`AWS-CreateWorkSpace`](aws-create-workspace.md)
+ [`AWSSupport-RecoverWorkSpace`](automation-awssupport-recover-workspace.md)

# `AWS-CreateWorkSpace`
<a name="aws-create-workspace"></a>

 **설명** 

 `AWS-CreateWorkSpace` 실행서는 입력 파라미터에 대해 지정하는 값을 기반으로 WorkSpace라고 하는 새로운 Amazon WorkSpaces 가상 데스크톱을 생성합니다. WorkSpaces에 대한 자세한 내용은 *Amazon WorkSpaces 관리 안내서*의 [Amazon WorkSpaces란 무엇입니까?](https://docs.aws.amazon.com/workspaces/latest/adminguide/amazon-workspaces.html)를 참조하세요.

 [이 자동화 실행(콘솔)](https://console.aws.amazon.com/systems-manager/automation/execute/AWS-CreateWorkspace) 

**문서 유형**

자동화

**소유자**

Amazon

**플랫폼**

Linux, macOS, Windows 

**파라미터**
+ AutomationAssumeRole

  유형: 문자열

  설명: (선택 사항) 사용자를 대신하여 Systems Manager Automation을 통해 작업을 수행할 수 있도록 허용하는 AWS Identity and Access Management (IAM) 역할의 Amazon 리소스 이름(ARN)입니다. 역할을 지정하지 않은 경우, Systems Manager Automation에서는 이 실행서를 시작하는 사용자의 권한을 사용합니다.
+ BundleId

  유형: 문자열

  설명: (필수) WorkSpace에 사용할 번들의 ID입니다.
+ ComputeTypeName

  유형: 문자열

  유효한 값: VALUE \$1 STANDARD \$1 PERFORMANCE \$1 POWER \$1 GRAPHICS \$1 POWERPRO \$1 GRAPHICSPRO

  설명: (선택 사항) WorkSpace의 컴퓨팅 유형입니다.
+ DirectoryId

  유형: 문자열

  설명: (필수) WorkSpace를 추가할 디렉터리의 ID입니다.
+ RootVolumeEncryptionEnabled

  유형: Boolean

  유효한 값: true \$1 false

  기본값: false

  설명: (선택 사항) WorkSpace의 루트 볼륨이 암호화되는지 여부를 결정합니다.
+ RootVolumeSizeGib

  유형: 정수

  설명: (필수) WorkSpace에 대한 루트 볼륨의 크기입니다.
+ RunningMode

  유형: 문자열

  유효한 값: ALWAYS\$1ON \$1 AUTO\$1STOP

  설명: (필수) WorkSpace의 실행 모드입니다.
+ RunningModeAutoStopTimeoutInMinutes

  유형: 정수

  설명: (선택 사항) WorkSpaces가 중지될 때 사용자가 로그오프한 후의 시간입니다. 60분 간격으로 값을 지정합니다.
+ Tags

  유형: 문자열

  설명: (선택 사항) WorkSpace에 적용하려는 태그입니다.
+ UserName

  유형: 문자열

  설명: (필수) WorkSpace에 연결할 사용자 이름입니다.
+ UserVolumeEncryptionEnabled

  유형: Boolean

  유효한 값: true \$1 false

  기본값: false

  설명: (선택 사항) WorkSpace의 사용자 볼륨이 암호화되는지 여부를 결정합니다.
+ UserVolumeSizeGib

  유형: 정수

  설명: (필수) WorkSpace의 사용자 볼륨 크기입니다.
+ VolumeEncryptionKey

  유형: 문자열

  설명: (선택 사항) WorkSpace에 저장된 데이터를 암호화하는 데 사용할 대칭 AWS Key Management Service 키입니다.

**필수 IAM 권한**

실행서를 성공적으로 사용하려면 `AutomationAssumeRole` 파라미터에 다음 작업이 필요합니다.
+  `workspaces:CreateWorkspaces` 
+  `workspaces:DescribeWorkspaces` 

 **문서 단계** 
+  `aws:executeScript` - 입력 파라미터에 대해 지정하는 값을 기반으로 WorkSpace를 생성합니다.
+  `aws:waitForAwsResourceProperty` - WorkSpace의 상태가 `AVAILABLE`인지 확인합니다.

 **출력** 

`CreateWorkspace.WorkspaceId`

# `AWSSupport-RecoverWorkSpace`
<a name="automation-awssupport-recover-workspace"></a>

 **설명** 

 `AWSSupport-RecoverWorkSpace` 실행서는 지정하는 WorkSpace라고 하는 Amazon WorkSpaces 가상 데스크톱에서 복구 단계를 수행합니다. 실행서는 WorkSpace를 재부팅하고, 상태가 여전히 `UNHEALTHY`이면 입력 파라미터에서 지정하는 값을 기반으로 WorkSpace를 복원하거나 재빌드합니다. 이 실행서를 사용하기 전에 *Amazon WorkSpaces 관리 안내서*의 [WorkSpaces 문제 해결](https://docs.aws.amazon.com/workspaces/latest/adminguide/amazon-workspaces-troubleshooting.html)을 검토하는 것이 좋습니다.

**중요**  
WorkSpace를 복원하거나 재빌드하는 작업은 데이터 손실을 초래할 수 있는 잠재적으로 파괴적인 작업입니다. 이는 WorkSpace가 사용 가능한 마지막 스냅샷에서 복원되고 스냅샷에서 복구되는 데이터가 12시간 가량 경과된 내용일 수 있기 때문입니다.  
 복원 옵션은 최신 스냅샷을 기반으로 루트 볼륨과 사용자 볼륨을 모두 재생성합니다. 재빌드 옵션은 가장 최근 스냅샷에서 사용자 볼륨을 재생성하고 WorkSpace가 생성된 번들과 연결된 이미지에서 WorkSpace를 다시 생성합니다. WorkSpace가 생성된 이후에 변경된 시스템 설정 또는 설치된 애플리케이션이 손실됩니다. 작업 영역 복원 및 재빌드에 대한 자세한 내용은 *Amazon WorkSpaces 관리 안내서*의 [WorkSpace 복원](https://docs.aws.amazon.com/workspaces/latest/adminguide/restore-workspace.html) 및 [WorkSpace 재빌드](https://docs.aws.amazon.com/workspaces/latest/adminguide/rebuild-workspace.html)를 참조하세요.

 [이 자동화 실행(콘솔)](https://console.aws.amazon.com/systems-manager/automation/execute/AWSSupport-RecoverWorkSpace) 

**문서 유형**

자동화

**소유자**

Amazon

**플랫폼**

Linux, macOS, Windows 

**파라미터**
+ AutomationAssumeRole

  유형: 문자열

  설명: (선택 사항) 사용자를 대신하여 Systems Manager Automation을 통해 작업을 수행할 수 있도록 허용하는 AWS Identity and Access Management (IAM) 역할의 Amazon 리소스 이름(ARN)입니다. 역할을 지정하지 않은 경우, Systems Manager Automation에서는 이 실행서를 시작하는 사용자의 권한을 사용합니다.
+ 확인

  유형: 문자열

  유효한 값: Yes

  설명: (필수) 'yes'를 입력하면 복원 및 재빌드 작업이 가장 최근 스냅샷에서 WorkSpace를 복구하려고 시도하고 이러한 스냅샷에서 복원되는 데이터가 12시간 가량 경과된 내용일 수 있음을 이해한다는 의미입니다.
+ 재부팅

  유형: 문자열

  유효한 값: Yes \$1 No

  기본값: Yes

  설명: (필수) WorkSpace를 재부팅할지 여부를 결정합니다.
+ 재빌드

  유형: 문자열

  유효한 값: Yes \$1 No

  기본값: 아니요

  설명: (필수) WorkSpace를 재빌드할지 여부를 결정합니다.
+ 복원

  유형: 문자열

  유효한 값: Yes \$1 No

  기본값: 아니요

  설명: (필수) WorkSpace의 복원 여부를 결정합니다.
+ WorkspaceId

  유형: 문자열

  설명: (필수) 복구하려는 WorkSpace의 ID입니다.

**필수 IAM 권한**

실행서를 성공적으로 사용하려면 `AutomationAssumeRole` 파라미터에 다음 작업이 필요합니다.
+  `ssm:StartAutomationExecution` 
+  `ssm:GetAutomationExecution` 
+  `workspaces:DescribeWorkspaces` 
+  `workspaces:DescribeWorkspaceSnapshots` 
+  `workspaces:RebootWorkspaces` 
+  `workspaces:RebuildWorkspaces` 
+  `workspaces:RestoreWorkspace` 
+  `workspaces:StartWorkspaces` 

 **문서 단계** 
+  `aws:executeAwsApi` - `WorkspaceId` 파라미터에서 지정하는 WorkSpace의 상태를 수집합니다.
+  `aws:assertAwsResourceProperty` - WorkSpace의 상태가 `AVAILABLE` , `ERROR` , `IMPAIRED` , `STOPPED` 또는 `UNHEALTHY`인지 확인합니다.
+  `aws:branch` - WorkSpace의 상태를 기반으로 분기합니다.
+  `aws:executeAwsApi` - WorkSpace를 시작합니다.
+  `aws:branch` - `Action` 파라미터에 대해 지정하는 값을 기반으로 분기합니다.
+  `aws:waitForAwsResourceProperty` - 시작 후 WorkSpace 상태가 표시될 때까지 기다립니다.
+  `aws:waitForAwsResourceProperty` - 시작 후 WorkSpace 상태가 `AVAILABLE`, `ERROR`, `IMPAIRED` 또는 `UNHEALTHY`로 변경될 때까지 기다립니다.
+  `aws:executeAwsApi` - WorkSpace가 시작된 후의 상태를 수집합니다.
+  `aws:branch` - 시작 후 WorkSpace의 상태를 기반으로 분기합니다.
+  `aws:executeAwsApi` - WorkSpace를 복원하거나 재빌드하는 데 사용할 수 있는 스냅샷을 수집합니다.
+  `aws:branch` - `Reboot` 파라미터에 대해 지정하는 값을 기반으로 분기합니다.
+  `aws:executeAwsApi` - WorkSpace를 재부팅합니다.
+  `aws:executeAwsApi` - WorkSpace가 시작된 후의 상태를 수집합니다.
+  `aws:waitForAwsResourceProperty` - WorkSpace의 상태가 `REBOOTING`(으)로 변경될 때까지 기다립니다.
+  `aws:waitForAwsResourceProperty` - 재부팅 후 WorkSpace 상태가 `AVAILABLE` `ERROR` 또는 `UNHEALTHY`로 변경될 때까지 기다립니다.
+  `aws:executeAwsApi` - WorkSpace가 재부팅된 후의 상태를 수집합니다.
+  `aws:branch` - 재부팅 후 WorkSpace의 상태를 기반으로 분기합니다.
+  `aws:branch` - `Restore` 파라미터에 대해 지정하는 값을 기반으로 분기합니다.
+  `aws:executeAwsApi` - WorkSpace를 복원합니다. 복원이 실패하면 Runbook은 WorkSpace를 재빌드하려고 시도합니다.
+  `aws:waitForAwsResourceProperty` - WorkSpace의 상태가 `RESTORING`(으)로 변경될 때까지 기다립니다.
+  `aws:waitForAwsResourceProperty` - 복원 후 WorkSpace 상태가 `AVAILABLE`, `ERROR` 또는 `UNHEALTHY`로 변경될 때까지 기다립니다.
+  `aws:executeAwsApi` - 복원 후 WorkSpace 상태를 수집합니다.
+  `aws:branch` - 복원 후 WorkSpace의 상태를 기반으로 분기합니다.
+  `aws:branch` - `Rebuild` 파라미터에 대해 지정하는 값을 기반으로 분기합니다.
+  `aws:executeAwsApi` - WorkSpace를 재빌드합니다.
+  `aws:waitForAwsResourceProperty` - WorkSpace의 상태가 `REBUILDING`(으)로 변경될 때까지 기다립니다.
+  `aws:waitForAwsResourceProperty` - 다시 빌드된 후 WorkSpace 상태가 `AVAILABLE` , `ERROR` 또는 `UNHEALTHY`로 변경될 때까지 기다립니다.
+  `aws:executeAwsApi` - WorkSpace가 재빌드된 후의 상태를 수집합니다.
+  `aws:assertAwsResourceProperty` - WorkSpace의 상태가 `AVAILABLE`인지 확인합니다.