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.
Importieren Sie AWS-Ressourcen manuell in einen CloudFormation-Stapel
Mit dem Ressourcenimport können Sie bestehende AWS-Ressourcen in einen neuen oder bestehenden CloudFormation-Stack importieren. 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 ein DeletionPolicy Attributhaben.
-
Bezeichner für die Ressourcen, die Sie importieren, die CloudFormation verwenden kann, um die logischen IDs in der Vorlage den vorhandenen Ressourcen zuzuordnen.
Anmerkung
CloudFormation unterstützt nur eine Ebene der Verschachtelung durch Ressourcenimport. Dies bedeutet, dass Sie keinen Stack in einen untergeordneten Stack importieren oder einen Stack importieren können, der untergeordnete Stacks enthält.
Themen
Identifikatoren für Ressourcen
Sie geben zwei Werte an, um jede Ressource, die Sie importieren, 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 ihremBucketNameidentifiziert werden.Die Ressourceneigenschaft, mit der Sie die Ressource identifizieren, die Sie importieren, hängt vom Ressourcentyp ab. Sie können die Ressourceneigenschaft in der CloudFormation-Konsole finden. Nachdem Sie eine Vorlage erstellt haben, die die zu importierende Ressource enthält, können Sie den Importprozess einleiten, in dem Sie die Bezeichner-Eigenschaften für die zu importierenden Ressourcen finden. Für einige Ressourcentypen gibt es möglicherweise mehrere Möglichkeiten, sie zu identifizieren, und Sie können in den Dropdown-Listen auswählen, welche Eigenschaft Sie verwenden möchten.
Alternativ können Sie die Bezeichner-Eigenschaften für die Ressourcen, die Sie importieren, abrufen, indem Sie den CLI-Befehl get-template-summary aufrufen und die S3-URL der Stack-Vorlage als Wert für die Option
--template-urlangeben. -
Ein Bezeichnerwert. Dies ist der tatsächliche Immobilienwert der Ressource. Beispielsweise könnte der tatsächliche Wert für die
BucketName-EigenschaftMyS3Bucketsein.Sie können den Wert der Eigenschaft identifier in der Servicekonsole für die Ressource abrufen.
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. Erforderliche Eigenschaften für jeden Ressourcentyp sind in der Referenz AWS Ressource und Eigenschaftstypenbeschrieben.
-
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
Diese Tabelle beschreibt die verschiedenen Statustypen, die mit dem Feature Ressourcenimport 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 Ermitteln von Abweichungen im gesamten CloudFormation-Stack.
-
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. DieDeletionPolicykann auf einen beliebigen Wert gesetzt werden. Nur die Ressourcen, die Sie importieren, benötigen einDeletionPolicy. 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 Richtlinien-Bedingungsschlüssel für CloudFormation. -
Beim Importieren von Ressourcen gelten die CloudFormation Stack-Grenzen. Weitere Informationen zu -Limits finden Sie unter CloudFormation-Quoten verstehen.
Weitere Ressourcen
Um die Stapeldrift mit einem Ressourcenimport zu beheben, siehe Beheben von Abweichungen mit einer Importoperation.
