As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

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

 **Descrição** 

 O `AWS-CreateWorkSpace` runbook cria um novo desktop WorkSpaces virtual da Amazon, conhecido como a WorkSpace, com base nos valores que você especifica para os parâmetros de entrada. Para obter informações sobre WorkSpaces, consulte [O que é a Amazon WorkSpaces?](https://docs.aws.amazon.com/workspaces/latest/adminguide/amazon-workspaces.html) no *Guia de WorkSpaces administração da Amazon*.

 [Executar esta automação (console)](https://console.aws.amazon.com/systems-manager/automation/execute/AWS-CreateWorkspace) 

**Tipo de documento**

Automação

**Proprietário**

Amazon

**Plataformas**

Linux, macOS, Windows

**Parâmetros**
+ AutomationAssumeRole

  Tipo: String

  Descrição: (opcional) o nome do recurso da Amazon (ARN) do perfil do AWS Identity and Access Management (IAM) que permite que o Systems Manager Automation realize ações em seu nome. Se nenhum perfil for especificado, o Systems Manager Automation usa as permissões do usuário que inicia este runbook.
+ BundleId

  Tipo: string

  Descrição: (Obrigatório) O ID do pacote a ser usado para o. WorkSpace
+ ComputeTypeName

  Tipo: string

  Valores válidos: VALUE \| STANDARD \| PERFORMANCE \| POWER \| GRAPHICS \| POWERPRO \| GRAPHICSPRO

  Descrição: (Opcional) O tipo de computação para o seu WorkSpace.
+ DirectoryId

  Tipo: string

  Descrição: (Obrigatório) O ID do diretório ao qual você WorkSpace deve ser adicionado.
+ RootVolumeEncryptionEnabled

  Tipo: booliano

  Valores válidos: True \| False

  Padrão: False

  Descrição: (Opcional) Determina se o volume raiz do WorkSpace está criptografado.
+ RootVolumeSizeGib

  Tipo: inteiro

  Descrição: (Obrigatório) O tamanho do volume raiz do WorkSpace.
+ RunningMode

  Tipo: string

  Valores válidos: ALWAYS\_ON \| AUTO\_STOP

  Descrição: (Obrigatório) O modo de execução do WorkSpace.
+ RunningModeAutoStopTimeoutInMinutes

  Tipo: inteiro

  Descrição: (Opcional) O tempo após o usuário se desconectar quando o sistema é WorkSpaces interrompido. Especifique um valor em intervalos de 60 minutos.
+ Tags

  Tipo: string

  Descrição: (Opcional) Tags que você deseja aplicar ao WorkSpace.
+ UserName

  Tipo: string

  Descrição: (Obrigatório) O nome de usuário a ser associado ao WorkSpace.
+ UserVolumeEncryptionEnabled

  Tipo: booliano

  Valores válidos: True \| False

  Padrão: False

  Descrição: (Opcional) Determina se o volume do usuário do WorkSpace está criptografado.
+ UserVolumeSizeGib

  Tipo: inteiro

  Descrição: (Obrigatório) O tamanho do volume do usuário para WorkSpace o.
+ VolumeEncryptionKey

  Tipo: string

  Descrição: (Opcional) A AWS Key Management Service chave simétrica que você deseja usar para criptografar dados armazenados no seu. WorkSpace

**Permissões obrigatórias do IAM**

O parâmetro `AutomationAssumeRole` requer as seguintes ações para usar o runbook com êxito.
+  `workspaces:CreateWorkspaces` 
+  `workspaces:DescribeWorkspaces` 

 **Etapas do documento** 
+  `aws:executeScript`- Cria um WorkSpace com base nos valores que você especifica para os parâmetros de entrada.
+  `aws:waitForAwsResourceProperty`- Verifica o estado do WorkSpace é`AVAILABLE`.

 **Saídas** 

`CreateWorkspace.WorkspaceId`