

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
<a name="example_ec2_CopyImage_section"></a>

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 [Copie d’une AMI](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/CopyingAMIs.html) dans le *Guide de l’utilisateur Amazon EC2*.  
**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 [Copie d’une AMI](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/CopyingAMIs.html) dans le *Guide de l’utilisateur Amazon EC2*.  
**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 [Copie d’une AMI](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/CopyingAMIs.html) dans le *Guide de l’utilisateur Amazon EC2*.  
+  Pour plus de détails sur l'API, reportez-vous [CopyImage](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/copy-image.html)à 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](https://docs.aws.amazon.com/powershell/v4/reference)à 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](https://docs.aws.amazon.com/powershell/v5/reference)à 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, consultez[Création de EC2 ressources Amazon à l'aide d'un AWS SDK](sdk-general-information-section.md). Cette rubrique comprend également des informations sur le démarrage et sur les versions précédentes du kit SDK.