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

# Usar `RegisterImage` com uma CLI
<a name="example_ec2_RegisterImage_section"></a>

Os exemplos de código a seguir mostram como usar o `RegisterImage`.

------
#### [ CLI ]

**AWS CLI**  
**Exemplo 1: registrar uma AMI usando um arquivo de manifesto**  
O exemplo `register-image` a seguir registra uma AMI usando o arquivo de manifesto especificado no Amazon S3.  

```
aws ec2 register-image \
    --name {{my-image}} \
    --image-location {{amzn-s3-demo-bucket/myimage/image.manifest.xml}}
```
Saída:  

```
{
    "ImageId": "ami-1234567890EXAMPLE"
}
```
Para obter mais informações, consulte [Imagens de máquina da Amazon (AMIs)](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/AMIs.html) no *Guia do usuário do Amazon EC2*.  
**Exemplo 2: registrar uma AMI usando um snapshot de um dispositivo raiz**  
O exemplo `register-image` a seguir registra uma AMI usando o snapshot especificado de um volume raiz do EBS como um dispositivo `/dev/xvda`. O mapeamento de dispositivos de blocos também inclui um volume EBS vazio de 100 GiB como dispositivo `/dev/xvdf`.  

```
aws ec2 register-image \
    --name {{my-image}} \
    --root-device-name {{/dev/xvda}} \
    --block-device-mappings {{DeviceName=/dev/xvda,Ebs={SnapshotId=snap-0db2cf683925d191f}}} {{DeviceName=/dev/xvdf,Ebs={VolumeSize=100}}}
```
Saída:  

```
{
    "ImageId": "ami-1a2b3c4d5eEXAMPLE"
}
```
Para obter mais informações, consulte [Imagens de máquina da Amazon (AMIs)](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/AMIs.html) no *Guia do usuário do Amazon EC2*.  
+  Para obter detalhes da API, consulte [RegisterImage](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/register-image.html)na *Referência de AWS CLI Comandos*. 

------
#### [ PowerShell ]

**Ferramentas para PowerShell V4**  
**Exemplo 1: esse exemplo registra uma AMI usando o arquivo de manifesto especificado no Amazon S3.**  

```
Register-EC2Image -ImageLocation amzn-s3-demo-bucket/my-web-server-ami/image.manifest.xml -Name my-web-server-ami
```
+  Para obter detalhes da API, consulte [RegisterImage](https://docs.aws.amazon.com/powershell/v4/reference)em *Referência de Ferramentas da AWS para PowerShell cmdlet (V4)*. 

**Ferramentas para PowerShell V5**  
**Exemplo 1: esse exemplo registra uma AMI usando o arquivo de manifesto especificado no Amazon S3.**  

```
Register-EC2Image -ImageLocation amzn-s3-demo-bucket/my-web-server-ami/image.manifest.xml -Name my-web-server-ami
```
+  Para obter detalhes da API, consulte [RegisterImage](https://docs.aws.amazon.com/powershell/v5/reference)em *Referência de Ferramentas da AWS para PowerShell cmdlet (V5)*. 

------

Para obter uma lista completa dos guias do desenvolvedor do AWS SDK e exemplos de código, consulte[Crie recursos do Amazon EC2 usando um AWS SDK](sdk-general-information-section.md). Este tópico também inclui informações sobre como começar e detalhes sobre versões anteriores do SDK.