Utilizar CopyImage con una CLI - Ejemplos de código de AWS SDK

Hay más ejemplos de AWS SDK disponibles en el repositorio de GitHub de ejemplos de AWS SDK de documentos.

Utilizar CopyImage con una CLI

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 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 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 en la Guía del usuario de Amazon EC2.

  • Para obtener información sobre la API, consulte CopyImage en la Referencia de comandos de la AWS CLI.

PowerShell
Herramientas para PowerShell V4

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 información sobre la API, consulte CopyImage en la Referencia de cmdlets de Herramientas de AWS para PowerShell (V4).

Herramientas para PowerShell V5

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 información sobre la API, consulte CopyImage en la Referencia de cmdlets de Herramientas de AWS para PowerShell (V5).