Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.
Einbindung vorhandener Ressourcen in das CloudFormation Management
AWS CloudFormation bietet Funktionen, mit denen Sie vorhandene AWS Ressourcen in einen neuen oder vorhandenen Stapel importieren können, indem Sie sie in Ihrer Vorlage beschreiben. Diese Funktion ist nützlich, wenn Sie damit beginnen möchten, Ressourcen CloudFormation zu verwalten, die außerhalb von erstellt wurden CloudFormation, ohne sie löschen und neu erstellen zu müssen.
CloudFormation unterstützt den Import einer Vielzahl von Ressourcen. Weitere Informationen finden Sie unter Unterstützung für Ressourcentypen.
Anmerkung
Informationen dazu, wie Sie stattdessen nach vorhandenen Ressourcen suchen und automatisch eine Vorlage generieren können, mit der Sie vorhandene Ressourcen in ein neues Konto importieren CloudFormation oder Ressourcen in einem neuen Konto replizieren können, finden Sie unterGenerieren von Vorlagen für bestehende Ressourcen.
Themen
Übersicht über den Ressourcenimport
Während eines Importvorgangs erstellen Sie einen Änderungssatz, der Ihre vorhandenen Ressourcen in einen Stack importiert oder einen neuen Stack aus Ihren vorhandenen Ressourcen erstellt. Während des Imports geben Sie Folgendes an.
-
Eine Vorlage, die den gesamten Stack beschreibt, einschließlich der ursprünglichen Stack-Ressourcen und der zu importierenden Ressourcen. Jede zu importierende Ressource muss über eine DeletionPolicy Attribut verfügen.
-
Bezeichner für die zu importierenden Ressourcen. Sie geben zwei Werte an, um jede Zielressource zu identifizieren.
-
Eine Bezeichnereigenschaft. Dies ist eine Ressourceneigenschaft, die verwendet werden kann, um jeden Ressourcentyp zu identifizieren. Beispielsweise kann eine
AWS::S3::Bucket
-Ressource mit ihremBucketName
identifiziert werden. -
Ein Bezeichnerwert. Dies ist der tatsächliche Eigenschaftswert der Zielressource. Beispielsweise könnte der tatsächliche Wert für die
BucketName
-EigenschaftMyS3Bucket
sein.
-
Anmerkung
AWS CloudFormation unterstützt nur eine Verschachtelungsebene unter Verwendungresource import
. Dies bedeutet, dass Sie keinen Stack in einen untergeordneten Stack importieren oder einen Stack importieren können, der untergeordnete Stacks enthält.
Ressourcenimportvalidierung
CloudFormation Führt während eines Importvorgangs die folgenden Validierungen durch.
-
Die zu importierende Ressource ist vorhanden.
-
Die Eigenschaften und Konfigurationswerte für jede zu importierende Ressource entsprechen dem Ressourcentypschema, das die akzeptierten Eigenschaften, erforderlichen Eigenschaften und unterstützten Eigenschaftswerte definiert.
-
Die erforderlichen Eigenschaften werden in der Vorlage angegeben. Die erforderlichen Eigenschaften für jeden Ressourcentyp sind in der aufgeführt. AWS Referenz zu Ressourcen- und Eigenschaftstypen
-
Die zu importierende Ressource gehört nicht zu einem anderen Stack in derselben Region.
CloudFormation überprüft nicht, ob die Vorlagenkonfiguration mit der tatsächlichen Konfiguration der Ressourceneigenschaften übereinstimmt.
Wichtig
Stellen Sie sicher, dass die in der Vorlage definierten Ressourcen und ihre Eigenschaften mit der beabsichtigten Konfiguration des Ressourcen-Imports übereinstimmen, um unerwartete Änderungen zu vermeiden.
Statuscodes für den Ressourcenimport
In dieser Tabelle werden die verschiedenen Statusarten beschrieben, die mit resource import
verwendet werden.
Status des Importvorgangs | Beschreibung |
---|---|
|
Der Importvorgang wird ausgeführt. |
|
Der Importvorgang wurde für alle Ressourcen im Stack abgeschlossen. |
|
Der Rollback-Importvorgang wird zur vorherigen Vorlagenkonfiguration zurückgesetzt. |
|
Der Import-Rollback-Vorgang ist fehlgeschlagen. |
|
Der Import wird zur vorherigen Vorlagenkonfiguration zurückgesetzt. |
Überlegungen während eines Importvorgangs
-
Nachdem der Import abgeschlossen ist und bevor nachfolgende Stack-Vorgänge ausgeführt werden, empfehlen wir, die Abweichungserkennung für importierte Ressourcen auszuführen. Die Abweichungserkennung stellt sicher, dass die Vorlagenkonfiguration mit der tatsächlichen Konfiguration übereinstimmt. Weitere Informationen finden Sie unter Drift auf einem ganzen CloudFormation Stack erkennen.
-
Importvorgänge lassen keine neuen Ressourcenerstellungen, Ressourcenlöschungen oder Änderungen an Eigenschaftskonfigurationen zu.
-
Jede zu importierende Ressource muss über ein
DeletionPolicy
-Attribut verfügen, damit der Importvorgang erfolgreich ausgeführt werden kann. DieDeletionPolicy
kann auf einen beliebigen Wert gesetzt werden. Nur Zielressourcen benötigen eineDeletionPolicy
. Ressourcen, die bereits Teil des Stacks sind, benötigen keineDeletionPolicy
. -
Sie können die gleiche Ressource nicht in mehrere Stacks importieren.
-
Mit der
cloudformation:ImportResourceTypes
-IAM-Richtlinienbedingung können Sie steuern, mit welchen Ressourcentypen Benutzer während eines Importvorgangs arbeiten können. Weitere Informationen finden Sie unter AWS CloudFormation Bedingungen. -
Die AWS CloudFormation Stack-Limits gelten beim Import von Ressourcen. Weitere Informationen zu Grenzwerten finden Sie unterAWS CloudFormation Kontingente.
Weitere Ressourcen
Zusätzliche Importanweisungen, die sich auf Szenarien für das Refactoring vorhandener Stacks konzentrieren, finden Sie in den folgenden Themen:
-
Informationen zum Verschieben von Ressourcen zwischen Stacks finden Sie unter. Verschieben von Ressourcen zwischen Stacks
-
Informationen zum Verschachteln eines vorhandenen Stacks innerhalb eines anderen vorhandenen Stacks finden Sie unterVerschachteln eines vorhandenen Stacks.