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.

# Importez automatiquement AWS des ressources dans une CloudFormation pile
<a name="import-resources-automatically"></a>

Vous pouvez désormais importer automatiquement des *ressources nommées* lors de la création ou de la mise à jour de CloudFormation piles. Une *ressource nommée* est une ressource dotée d’un nom personnalisé. Pour plus d'informations, voir [Type de nom](https://docs.aws.amazon.com/AWSCloudFormation/latest/TemplateReference/aws-properties-name.html) dans la *référence du CloudFormation modèle*.

Lorsque vous lancez l'importation automatique, CloudFormation vérifiez si les ressources existantes correspondent à votre modèle et les importez pendant le déploiement. Pour les piles imbriquées, créez l’ensemble de modifications à partir de la pile racine.

Une fois l’importation terminée et avant d’effectuer les opérations de pile suivantes, nous vous conseillons d’exécuter la détection de l’écart sur les ressources importées. La détection de l'écart garantit que la configuration du modèle correspond à la configuration réelle. Pour de plus amples informations, veuillez consulter [Détectez la dérive sur l'ensemble d'une CloudFormation pile](detect-drift-stack.md).

Pour importer une ressource, ils doivent vous conformer aux exigences suivantes :
+ La ressource doit avoir un nom personnalisé statique défini dans votre modèle. Les noms dynamiques (utilisant \$1Ref ou d’autres fonctions) ne sont actuellement pas pris en charge.
+ La ressource doit avoir une `DeletionPolicy` de `Retain` ou`RetainExceptOnCreate`.
+ La ressource ne doit pas déjà appartenir à une autre CloudFormation pile.
+ Le type de ressource doit prendre en charge les opérations CloudFormation d'importation. Pour de plus amples informations, veuillez consulter [Prise en charge des types de ressources](resource-import-supported-resources.md).
+ L’ID principal du type de ressource doit figurer dans le modèle. Les propriétés principales IDs dotées de propriétés en lecture seule ne sont pas prises en charge. Pour savoir quel est l’ID principal d’un type, recherchez la propriété `primaryIdentifier` dans le schéma de ressource. Pour plus d’informations sur la propriété, consultez [primaryIdentifier](https://docs.aws.amazon.com/cloudformation-cli/latest/userguide/resource-type-schema.html#schema-properties-primaryidentifier).

**Example Exemple d’importation automatique**  
L’exemple suivant utilise un ensemble de modifications, `CreateChangeSet` pour créer une pile appelée `my-stack` basée sur un fichier modèle, `template.yaml`, et importe automatiquement les ressources correspondantes.  

```
aws cloudformation create-change-set \
  --stack-name my-stack \
  --change-set-name CreateChangeSet \
  --change-set-type CREATE \
  --template-body file://template.yaml \
  --import-existing-resources
```

## Résolution des problèmes
<a name="auto-import-troubleshooting"></a>

Si l’importation automatique échoue, procédez comme suit pour résoudre le problème :
+ Vérifiez que le nom de la ressource dans votre modèle correspond exactement au nom de la ressource
+ Vérifiez que la ressource n’est pas déjà gérée par une autre pile
+ Assurez-vous que le type de ressource prend en charge les opérations d’importation
+ Vérifiez que votre modèle inclut toutes les propriétés requises pour le type de ressource