Usar CopyImage com uma CLI

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

CLI

AWS CLI

Exemplo 1: copiar uma AMI para outra região

O comando de exemplo copy-image a seguir copia a AMI especificada da região us-west-2 para a região us-east-1 e adiciona uma breve descrição.

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

Saída:

{
    "ImageId": "ami-0123456789abcdefg"
}

Para obter mais informações, consulte Copiar uma AMI no Guia do usuário do Amazon EC2.

Exemplo 2: copiar uma AMI para outra região e criptografar o snapshot de apoio

O comando copy-image a seguir copia a AMI especificada da região us-west-2 para a região atual e criptografa o snapshot de backup usando a chave KMS especificada.

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

Saída:

{
    "ImageId": "ami-0123456789abcdefg"
}

Para obter mais informações, consulte Copiar uma AMI no Guia do usuário do Amazon EC2.

Exemplo 3: incluir as tags de AMI definidas pelo usuário ao copiar uma AMI

O comando copy-image a seguir usa o parâmetro --copy-image-tags para copiar as tags de AMI definidas pelo usuário ao copiar a 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

Saída:

{
    "ImageId": "ami-0123456789abcdefg"
}

Para obter mais informações, consulte Copiar uma AMI no Guia do usuário do Amazon EC2.

• Para ver detalhes da API, consulte CopyImage na Referência de comandos da AWS CLI.

PowerShell

Ferramentas para PowerShell V4

Exemplo 1: esse exemplo copia a AMI especificada na região “UE (Irlanda)” para a região “Oeste dos EUA (Oregon)”. Se -Region não for especificada, a região padrão atual será usada como a região de destino.

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

Saída:

ami-87654321

• Consulte detalhes da API em CopyImage na Referência de cmdlet do Ferramentas da AWS para PowerShell (V4).

Ferramentas para PowerShell V5

Exemplo 1: esse exemplo copia a AMI especificada na região “UE (Irlanda)” para a região “Oeste dos EUA (Oregon)”. Se -Region não for especificada, a região padrão atual será usada como a região de destino.

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

Saída:

ami-87654321

• Consulte detalhes da API em CopyImage na Referência de cmdlet do Ferramentas da AWS para PowerShell (V5).