Utilisation de CopyImage avec une CLI - Amazon Elastic Compute Cloud

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

Utilisation de CopyImage avec une CLI

Les exemples de code suivants illustrent comment utiliser CopyImage.

CLI
AWS CLI

Exemple 1 : pour copier une AMI dans une autre région

L’exemple de commande copy-image suivant copie l’AMI spécifiée de la région us-west-2 vers la région us-east-1 et ajoute une brève description.

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

Sortie :

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

Pour plus d'informations, consultez Copier une AMI dans le guide de EC2 l'utilisateur Amazon.

Exemple 2 : pour copier une AMI dans une autre région et chiffrer l’instantané de sauvegarde

La commande copy-image suivante copie l’AMI spécifiée de la région us-west-2 vers la région actuelle et chiffre l’instantané de sauvegarde à l’aide de la clé KMS spécifiée.

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

Sortie :

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

Pour plus d'informations, consultez Copier une AMI dans le guide de EC2 l'utilisateur Amazon.

Exemple 3 : pour inclure des balises d’AMI définies par l’utilisateur lors de la copie d’une AMI

La commande copy-image suivante utilise le paramètre --copy-image-tags pour copier les balises d’AMI définies par l’utilisateur lors de la copie de l’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

Sortie :

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

Pour plus d'informations, consultez Copier une AMI dans le guide de EC2 l'utilisateur Amazon.

  • Pour plus de détails sur l'API, reportez-vous CopyImageà la section Référence des AWS CLI commandes.

PowerShell
Outils pour PowerShell V4

Exemple 1 : cet exemple copie l’AMI spécifiée dans la région « UE (Irlande) » vers la région « USA Ouest (Oregon) ». Si -Region n’est pas spécifiée, la région par défaut actuelle est utilisée comme région de destination.

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

Sortie :

ami-87654321

  • Pour plus de détails sur l'API, reportez-vous CopyImageà la section Référence des Outils AWS pour PowerShell applets de commande (V4).

Outils pour PowerShell V5

Exemple 1 : cet exemple copie l’AMI spécifiée dans la région « UE (Irlande) » vers la région « USA Ouest (Oregon) ». Si -Region n’est pas spécifiée, la région par défaut actuelle est utilisée comme région de destination.

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

Sortie :

ami-87654321

  • Pour plus de détails sur l'API, reportez-vous CopyImageà la section Référence des Outils AWS pour PowerShell applets de commande (V5).

Pour obtenir la liste complète des guides de développement du AWS SDK et des exemples de code, consultezCréation de EC2 ressources Amazon à l'aide d'un AWS SDK. Cette rubrique comprend également des informations sur le démarrage et sur les versions précédentes du kit SDK.