

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á.

# Importar imagem
<a name="import-image"></a>

Você pode criar imagens de WorkSpaces aplicativos importando suas AMIs ou imagens personalizadas do EC2. WorkSpaces Como isso funciona:

1. Personalize sua AMI do EC2 usando qualquer método preferido, incluindo o [EC2 Image Builder](https://docs.aws.amazon.com/imagebuilder/).

1. Importe sua AMI ou WorkSpaces imagens personalizadas em WorkSpaces aplicativos para criar uma imagem de WorkSpaces aplicativos

1. Opcionalmente, use o Image Builder para personalização adicional de imagens

WorkSpaces As imagens de aplicativos criadas por meio da importação de imagens do EC2 AMI ou do WorkSpaces Windows Server são de`type = "custom"`. WorkSpaces A importação de imagens BYOL do Windows criará imagens de WorkSpaces aplicativos com`type = "BYOL"`. WorkSpaces As imagens fornecidas pelos aplicativos são de`type = "native"`.

Você pode usar tipos de instância stream.\* para imagens com e. `type = "native"` `type = "BYOL"` Para usar qualquer um dos seguintes tipos de instância, você deve importar sua AMI e criar uma imagem com`type = "custom"`.
+ GeneralPurpose.\*
+ MemoryOptimized.\*
+ ComputeOptimized.\*
+ Acelerado. \*

**Importante**  
WorkSpaces imagens com aplicativos incluídos na licença instalados não são suportadas. Você deve desinstalar esses aplicativos da imagem usando [Gerenciar aplicativos](https://docs.aws.amazon.com/workspaces/latest/adminguide/manage-applications.html) e configurá-los usando[Gerencie aplicativos com licença incluída em sua imagem nos WorkSpaces aplicativos da Amazon](license-included-applications.md).

## Pré-requisitos para importação de imagens do EC2 AMI
<a name="import-image-prerequisites"></a>

Todos esses pré-requisitos são importantes para uma execução bem-sucedida do fluxo de trabalho. As configurações de AMI do EC2 suportadas e outros requisitos obrigatórios estão listados abaixo. Observe que eles não se aplicam à importação de WorkSpaces imagens, pois isso é gerenciado pelo WorkSpaces serviço.

### Propriedades obrigatórias da AMI
<a name="required-ami-properties"></a>

EBS  
+ Tamanho menor ou igual a 500 GB
  + Você pode importar uma AMI com < 200 GB, no entanto, a imagem importada usará no mínimo 200 GB.
+ GP2
  + Você pode importar uma AMI com o tipo de volume EBS gp2 ou gp3, mas a imagem importada usará gp2.
+ Um volume por imagem
+ `/dev/sda1`Nome do dispositivo raiz
+ Tipo de imagem: Máquina
+ Arquitetura: x86\_64
+ Tipo de virtualização: HVM
+ Modo de inicialização: UEFI
+ Suporte ao TPM: v2.0. Isso é necessário. Consulte [https://docs.aws.amazon.com/ec2/latest/windows-ami-reference/ami-windows-tpm.html\#ami -windows-tpm-find para encontrar uma AMI habilitada para TPM](https://docs.aws.amazon.com/ec2/latest/windows-ami-reference/ami-windows-tpm.html#ami-windows-tpm-find).
+ Suporte da ENA: verdadeiro
+ Plataforma: Windows
+ Detalhes da plataforma: Windows

### Propriedades do sistema operacional
<a name="operating-system-properties"></a>

**Base 2022/2025 completa** do Windows Server  
+ O Windows Server **Core** não é suportado
+ O Windows com SQL Server não é suportado

Agentes  
+ EC2 Launch V2
  + Instalado por padrão no Windows Server 2022/2025

Library Support  
+ .NET Framework 4.8 ou superior
  + Instalado por padrão no Windows Server 2022/2025
+ PowerShell 5.1 ou superior
  + Instalado por padrão no Windows Server 2022/2025
+ Recursos do Windows: O licenciamento de serviços de área de trabalho remota e o host da sessão de serviços de área de trabalho remota não devem ser instalados
+ Portas: as portas 8000, 8300 e 8443 devem estar desbloqueadas e desocupadas
+ Modo de inicialização: UEFI

Se você quiser usar imagens com instâncias gráficas Accelerated.g4dn, como,, Accelerated.g5 Accelerated.G6, ou Accelerated.G6e você deve instalar o driver GRID adequado na sua AMI. Para obter mais detalhes, consulte [https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/nvidia-GRID-driver.html](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/nvidia-GRID-driver.html). Se os drivers não estiverem configurados corretamente, o streaming funcionará, no entanto, a placa gráfica pode não estar disponível.

**Importante**  
O “ID da conta do proprietário” da AMI deve ser o ID AWS da sua conta. Você não pode importar uma AMI pública do EC2.  
Execute todas as atualizações do Windows e desative as atualizações automáticas do Windows antes de importar a imagem.  
Atualmente, não há suporte para a importação de AMIs EC2 criptografadas

### Requisitos da função do IAM
<a name="iam-role-requirements"></a>

**Importante**  
Crie uma função do IAM com as seguintes permissões para usar na importação de imagens:

```
{  
    "Version": "2012-10-17",		 	 	   
    "Statement": [  
        {  
            "Sid": "AllowModifyImageAttributeWithTagCondition",  
            "Effect": "Allow",  
            "Action": "ec2:ModifyImageAttribute",  
            "Resource": "*"  
        },  
        {  
            "Sid": "AllowDescribeImages",  
            "Effect": "Allow",  
            "Action": "ec2:DescribeImages",  
            "Resource": "*"  
        }  
    ]  
}
```

Adicione a seguinte relação de confiança para essa função do IAM

```
{  
    "Version": "2012-10-17",		 	 	   
    "Statement": [  
        {  
            "Effect": "Allow",  
            "Principal": {  
                "Service": "appstream.amazonaws.com"  
            },  
            "Action": "sts:AssumeRole"  
        }  
    ]  
}
```

## Requisitos para importação WorkSpaces de imagens
<a name="import-workspaces-image-requirements"></a>

Ao importar uma WorkSpaces imagem da Amazon para WorkSpaces aplicativos, os seguintes requisitos de sistema operacional e protocolo se aplicam:
+ Windows Server 2022 — Somente imagens WSP (WorkSpaces Streaming Protocol) são suportadas. Não há suporte para imagens PCoIP.
+ Windows Server 2025 — Todas as imagens são suportadas.
+ Windows 11 — Somente versão 24H2 ou mais recente.

## Para importar uma imagem
<a name="import-image-procedure"></a>

1. Abra o console de WorkSpaces aplicativos em [https://console.aws.amazon.com/appstream2](https://console.aws.amazon.com/appstream2).
**nota**  
Sua função de console também precisará incluir a `workspaces:DescribeWorkspaceImages` permissão para importar uma WorkSpaces imagem da Amazon.

1. No painel de navegação esquerdo, escolha **Imagens** e, em seguida, escolha **Registro de imagens**.

1. Escolha **Importar imagem**.

1. **Fonte da imagem** - escolha entre as opções abaixo com base no tipo de imagem que você deseja importar
   + **ID da AMI** - insira uma ID da AMI para a AMI que você gostaria de importar para os WorkSpaces aplicativos. Você também pode pesquisar sua AMI usando esse campo.
   + **Amazon WorkSpaces Image** - Insira um ID de WorkSpaces imagem (começa com “wsi-”). Você também pode pesquisar seu ID de WorkSpaces imagem usando esse campo.

1. **Nome da imagem** - insira um nome exclusivo para a imagem que será criada devido à operação de importação.

1. **Nome de exibição** *(opcional)* - insira um nome de exibição para a imagem.

1. **Descrição** *(opcional)* — Insira uma descrição para a imagem.

1. **Função do IAM** - Selecione a função do IAM que você criou para importação de imagens. Para obter mais detalhes, consulte[Requisitos da função do IAM](#iam-role-requirements).
   + Obrigatório para importação do EC2 AMI
   + Não aplicável para importação WorkSpaces de imagens

1. **Agente de gerenciamento de WorkSpaces aplicativos** — selecione essa opção se quiser sempre usar a versão mais recente do agente de WorkSpaces aplicativos, suas instâncias de streaming serão atualizadas automaticamente com os recursos mais recentes, melhorias de desempenho e atualizações de segurança disponíveis a partir do AWS lançamento de uma nova versão do agente.

1. **Validação de tempo de execução** *(opcional)*: selecione essa opção e o serviço provisionará uma instância com a imagem que está sendo importada e executará testes de streaming.
   + 
**nota**  
Esses testes de streaming serão executados em segundo plano. Você não pode se conectar a essa instância por meio do cliente WorkSpaces Applications.
   + Recomendamos usar essa opção para ter mais certeza de que sua imagem é adequada para WorkSpaces aplicativos.
   + Você será cobrado pelo preço por hora dessa instância.
   + Você pode evitar a execução da validação do tempo de execução se estiver reimportando sua AMI depois de fazer pequenas alterações que talvez não afetem o teste de streaming. Se a validação do tempo de execução for aprovada pela última vez, você importou essa AMI.
   + **Escolha o tipo de instância** *(opcional)*: selecione a família, o tipo e o tamanho de instâncias corretos para executar o teste de streaming. É recomendável que você use a mesma instância que planeja usar para a criação da frota.

1. **Catálogo de aplicativos e manifesto de desempenho de lançamento** *(opcional)*: forneça detalhes para criar um catálogo de aplicativos para seus usuários finais e melhorar o desempenho de lançamento de seus aplicativos.
   + **Catálogo de aplicativos**: Para criar um catálogo de aplicativos, especifique detalhes sobre os aplicativos instalados em sua imagem. Para cada aplicativo que pretende fazer streaming, você pode especificar o nome, o nome de exibição, o arquivo executável para iniciar e o ícone para exibição.
   + **Desempenho do lançamento**: adicionar arquivos ao manifesto de otimização do aplicativo reduz o tempo necessário para que o aplicativo seja iniciado pela primeira vez em uma nova instância de frota. O manifesto de otimização é um arquivo de texto delimitado por linha que é exclusivo de cada aplicativo.

   Para saber mais, consulte[Detalhes dos aplicativos](applications-details.md).

1. **Tags** *(opcional)* - escolha **Adicionar tag** e digite a chave e o valor da tag. Para adicionar mais tags, repita esta etapa. Para obter mais informações, consulte [Marcando seus recursos de WorkSpaces aplicativos da Amazon](tagging-basic.md).

1. **Importar imagem** — Revise todas as informações inseridas e escolha **Importar imagem**. O serviço executará verificações de compatibilidade para garantir que a AMI seja compatível com WorkSpaces os aplicativos.
   + Se as verificações estáticas falharem, você receberá um erro imediatamente.
   + Se as verificações estáticas forem aprovadas, sua solicitação de importação será enviada e, dependendo das opções selecionadas, pode levar de 30 a 60 minutos para criar uma nova imagem de WorkSpaces aplicativos com `type = "custom"` ou `type = "BYOL"`