

• Le AWS Systems Manager CloudWatch tableau de bord ne sera plus disponible après le 30 avril 2026. Les clients peuvent continuer à utiliser CloudWatch la console Amazon pour consulter, créer et gérer leurs CloudWatch tableaux de bord Amazon, comme ils le font aujourd'hui. Pour plus d'informations, consultez la [documentation Amazon CloudWatch Dashboard](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch_Dashboards.html). 

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.

# `aws:copyImage` - Copier ou chiffrer une Amazon Machine Image
<a name="automation-action-copyimage"></a>

Copie un Amazon Machine Image (AMI) à partir de n'importe quel élément Région AWS dans la région actuelle. Cette action peut également chiffrer la nouvelle AMI.

**Note**  
L’action `aws:copyImage` prend en charge la limitation des nouvelles tentatives. Pour de plus amples informations, veuillez consulter [Configuration des nouvelles tentatives automatiques pour les opérations limitées](automation-throttling-retry.md).

**Input**  
Cette action prend en charge la plupart des paramètres `CopyImage`. Pour de plus amples informations, veuillez consulter [CopyImage](https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_CopyImage.html).

L'exemple suivant crée une copie d'une AMI dans la région de Séoul (`SourceImageID`: ami-0fe10819. `SourceRegion`: ap-northeast-2). La nouvelle AMI est copiée dans la région dans laquelle vous avez lancé l'action d'automatisation. L'AMI copiée sera chiffrée, car l'indicateur `Encrypted` facultatif est défini sur `true`.

------
#### [ YAML ]

```
name: createEncryptedCopy
action: aws:copyImage
maxAttempts: 3
onFailure: Abort
inputs:
  SourceImageId: ami-0fe10819
  SourceRegion: ap-northeast-2
  ImageName: Encrypted Copy of LAMP base AMI in ap-northeast-2
  Encrypted: true
```

------
#### [ JSON ]

```
{   
    "name": "createEncryptedCopy",
    "action": "aws:copyImage",
    "maxAttempts": 3,
    "onFailure": "Abort",
    "inputs": {
        "SourceImageId": "ami-0fe10819",
        "SourceRegion": "ap-northeast-2",
        "ImageName": "Encrypted Copy of LAMP base AMI in ap-northeast-2",
        "Encrypted": true
    }   
}
```

------

SourceRegion  
Région dans laquelle l'AMI source existe actuellement.  
Type : Chaîne  
Obligatoire : oui

SourceImageId  
ID d'AMI à copier à partir de la région source.  
Type : Chaîne  
Obligatoire : oui

ImageName  
Nom de la nouvelle image.  
Type : Chaîne  
Obligatoire : oui

ImageDescription  
Description de l'image cible.  
Type : chaîne  
Obligatoire : non

Encrypted  
Chiffrement de l'AMI cible.  
Type : booléen  
Obligatoire : non

KmsKeyId  
Nom complet de la ressource Amazon (ARN) AWS KMS key à utiliser lors du chiffrement des instantanés d'une image lors d'une opération de copie. Pour de plus amples informations, veuillez consulter [CopyImage](https://docs.aws.amazon.com/AWSEC2/latest/APIReference/api_copyimage.html).  
Type : chaîne  
Obligatoire : non

ClientToken  
Identifiant unique, sensible à la casse, que vous devez fournir afin de garantir l'idempotence de la demande. Pour de plus amples informations, veuillez consulter [CopyImage](https://docs.aws.amazon.com/AWSEC2/latest/APIReference/api_copyimage.html).  
Type : chaîne  
Obligatoire : nonOutput

ImageId  
ID de l'image copiée.

ImageState  
État de l'image copiée.  
Valeurs valides : `available` \$1 `pending` \$1 `failed`