Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

# Utilizar `CopyImage` con una CLI
<a name="example_ec2_CopyImage_section"></a>

Los siguientes ejemplos de código muestran cómo utilizar `CopyImage`.

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

**AWS CLI**  
**Ejemplo 1: copia de una AMI a otra región**  
En el siguiente ejemplo de `copy-image`, se copia la AMI especificada de la región `us-west-2` en la región `us-east-1` y se agrega una breve descripción.  

```
aws ec2 copy-image \
    --region us-east-1 \
    --name ami-name \
    --source-region us-west-2 \
    --source-image-id ami-066877671789bd71b \
    --description "This is my copied image."
```
Salida:  

```
{
    "ImageId": "ami-0123456789abcdefg"
}
```
Para obtener más información, consulte [Copiar una AMI](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/CopyingAMIs.html) en la *Guía del usuario de Amazon EC2*.  
**Ejemplo 2: copia de una AMI en otra región y cifrado de la instantánea respaldada**  
En el siguiente comando `copy-image`, se copia la AMI especificada de la región `us-west-2` en la región actual y se usa la clave de KMS especificada para cifrar la instantánea respaldada.  

```
aws ec2 copy-image \
    --source-region us-west-2 \
    --name ami-name \
    --source-image-id ami-066877671789bd71b \
    --encrypted \
    --kms-key-id alias/my-kms-key
```
Salida:  

```
{
    "ImageId": "ami-0123456789abcdefg"
}
```
Para obtener más información, consulte [Copiar una AMI](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/CopyingAMIs.html) en la *Guía del usuario de Amazon EC2*.  
**Ejemplo 3: inclusión de las etiquetas de AMI definidas por el usuario al copiar una AMI**  
En el siguiente comando `copy-image` se usa el parámetro `--copy-image-tags` para copiar las etiquetas de AMI definidas por el usuario al copiar la AMI.  

```
aws ec2 copy-image \
    --region us-east-1 \
    --name ami-name \
    --source-region us-west-2 \
    --source-image-id ami-066877671789bd71b \
    --description "This is my copied image."
    --copy-image-tags
```
Salida:  

```
{
    "ImageId": "ami-0123456789abcdefg"
}
```
Para obtener más información, consulte [Copiar una AMI](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/CopyingAMIs.html) en la *Guía del usuario de Amazon EC2*.  
+  Para obtener más información sobre la API, consulte [CopyImage](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/copy-image.html)la *Referencia de AWS CLI comandos*. 

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

**Herramientas para la PowerShell versión 4**  
**Ejemplo 1: En este ejemplo se copia la AMI especificada de la región “UE (Irlanda)” en la región “Oeste de EE. UU. (Oregón)”. Si no se especifica -Region, la región predeterminada actual se utiliza como región de destino.**  

```
Copy-EC2Image -SourceRegion eu-west-1 -SourceImageId ami-12345678 -Region us-west-2 -Name "Copy of ami-12345678"
```
**Salida:**  

```
ami-87654321
```
+  Para obtener más información sobre la API, consulte [CopyImage Herramientas de AWS para PowerShell](https://docs.aws.amazon.com/powershell/v4/reference)*Cmdlet Reference (V4)*. 

**Herramientas para la versión 5 PowerShell **  
**Ejemplo 1: En este ejemplo se copia la AMI especificada de la región “UE (Irlanda)” en la región “Oeste de EE. UU. (Oregón)”. Si no se especifica -Region, la región predeterminada actual se utiliza como región de destino.**  

```
Copy-EC2Image -SourceRegion eu-west-1 -SourceImageId ami-12345678 -Region us-west-2 -Name "Copy of ami-12345678"
```
**Salida:**  

```
ami-87654321
```
+  Para obtener más información sobre la API, consulte [CopyImage](https://docs.aws.amazon.com/powershell/v5/reference)la *referencia de Herramientas de AWS para PowerShell cmdlets (*V5). 

------

Para obtener una lista completa de guías para desarrolladores del AWS SDK y ejemplos de código, consulte. [Creación de recursos de Amazon EC2 mediante una AWS SDK](sdk-general-information-section.md) En este tema también se incluye información sobre cómo comenzar a utilizar el SDK y detalles sobre sus versiones anteriores.