Importation manuelle de ressources AWS dans une pile CloudFormation - AWS CloudFormation

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.

Importation manuelle de ressources AWS dans une pile CloudFormation

Grâce à l’importation de ressources, vous pouvez importer des ressources AWS existantes dans une nouvelle pile CloudFormation ou dans une pile existante. Au cours d'une opération d'importation, vous créez un jeu de modifications qui importe vos ressources existantes dans une pile ou crée une nouvelle pile à partir de vos ressources existantes. Vous fournissez les éléments suivants lors de l'importation.

  • Un modèle qui décrit l'ensemble de la pile, y compris les ressources de la pile d'origine et les ressources que vous importez. Chaque ressource à importer doit avoir un attribut DeletionPolicy.

  • Identifiants des ressources que vous importez et que CloudFormation peut utiliser pour mapper les identifiants logiques du modèle aux ressources existantes.

Note

CloudFormation ne prend en charge qu’un seul niveau d’imbrication à l’aide de l’importation de ressources. Cela signifie que vous ne pouvez pas importer une pile dans une pile enfant ou importer une pile qui a des enfants.

Identifiants de ressource

Vous fournissez deux valeurs pour identifier chaque ressource que vous importez.

  • Une propriété d'identifiant. Il s'agit d'une propriété de ressource qui peut être utilisée pour identifier chaque type de ressource. Par exemple, une ressource AWS::S3::Bucket peut être identifiée à l'aide de son code BucketName.

    La propriété de ressource que vous utilisez pour identifier la ressource que vous importez varie en fonction du type de ressource. Vous trouverez la propriété de ressource dans la console CloudFormation. Après avoir créé un modèle incluant la ressource à importer, vous pouvez lancer le processus d’importation, où vous trouverez les propriétés d’identifiant des ressources que vous importez. Pour certains types de ressources, il peut exister plusieurs façons de les identifier, et vous pouvez sélectionner la propriété à utiliser dans les listes déroulantes.

    Vous pouvez également obtenir les propriétés d’identifiant des ressources que vous importez en appelant la commande CLI get-template-summary et en spécifiant l’URL S3 du modèle de pile comme valeur pour l’option --template-url.

  • Une valeur d'identifiant. Il s’agit de la valeur immobilière réelle de la ressource. Par exemple, la valeur réelle de la propriété BucketName peut être MyS3Bucket.

    Vous pouvez obtenir la valeur de la propriété d’identifiant à partir de la console de service pour la ressource.

Validation de l'importation de ressources

Lors d'une opération d'importation, CloudFormation effectue les validations suivantes.

  • La ressource à importer existe.

  • Les propriétés et les valeurs de configuration de chaque ressource à importer sont conformes au schéma du type de ressource, qui définit ses propriétés acceptées, les propriétés requises et les valeurs de propriété prises en charge.

  • Les propriétés requises sont spécifiées dans le modèle. Les propriétés requises pour chaque type de ressource sont décrites dans la référence des types de ressources et de propriétés AWS.

  • La ressource à importer n'appartient pas à une autre pile dans la même région.

CloudFormation ne vérifie pas que la configuration du modèle correspond à la configuration réelle des propriétés de ressource.

Important

Vérifiez que les ressources et leurs propriétés définies dans le modèle correspondent à la configuration prévue de l'importation de ressources afin d'éviter des modifications inattendues.

Codes d'état de l'importation des ressources

Ce tableau décrit les différents types de statut utilisés avec la fonctionnalité d’importation de ressources.

État de l'opération d'importation Description

IMPORT_IN_PROGRESS

L'opération d'importation est en cours.

IMPORT_COMPLETE

L'opération d'importation a été exécutée pour toutes les ressources de la pile.

IMPORT_ROLLBACK_IN_PROGRESS

L'opération de restauration de l'importation restaure la configuration précédente du modèle.

IMPORT_ROLLBACK_FAILED

L'opération de restauration de l'importation a échoué.

IMPORT_ROLLBACK_COMPLETE

L'importation est restaurée à la configuration précédente du modèle.

Considérations à prendre en compte lors d'une opération d'importation

  • 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, consultez Détection de l'écart sur une pile CloudFormation complète.

  • Les opérations d'importation n'autorisent pas les créations de ressources, les suppressions de ressources ou les modifications apportées aux configurations de propriétés.

  • Chaque ressource à importer doit avoir un attribut DeletionPolicy pour que l'opération d'importation réussisse. L'attribut DeletionPolicy peut être défini sur n'importe quelle valeur possible. Seules les ressources que vous importez ont besoin d’un DeletionPolicy. Les ressources qui font déjà partie de la pile n'ont pas besoin d'un attribut DeletionPolicy.

  • Vous ne pouvez pas importer la même ressource dans plusieurs piles.

  • Vous pouvez utiliser la condition de politique IAM cloudformation:ImportResourceTypes pour contrôler les types de ressources que les utilisateurs peuvent utiliser au cours d'une opération d'importation. Pour de plus amples informations, consultez Clés de conditions de politique pour CloudFormation.

  • Les limites des piles CloudFormation s’appliquent lors de l’importation de ressources. Pour plus d'informations sur les limites , consultez Compréhension des quotas CloudFormation.

Ressources supplémentaires

Pour résoudre le problème de l’écart de pile avec une importation de ressources, voir Résoudre l'écart avec une opération d'importation.