Importieren Sie AWS-Ressourcen automatisch in einen CloudFormation-Stapel - AWS CloudFormation
Fehlerbehebung

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 automatisch in einen CloudFormation-Stapel

Sie können jetzt benannte Ressourcen automatisch importieren, wenn Sie CloudFormation Stacks erstellen oder aktualisieren. Eine benannte Ressource ist eine Ressource mit einem benutzerdefinierten Namen. Weitere Informationen finden Sie unter Name type in der CloudFormation Template Reference.

Wenn Sie den automatischen Import initiieren, sucht CloudFormation nach vorhandenen Ressourcen, die Ihrer Vorlage entsprechen, und importiert sie während der Bereitstellung. Bei verschachtelten Stapeln erstellen Sie den Änderungssatz vom Stammstapel aus.

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.

Um eine Ressource zu importieren, müssen sie die folgenden Voraussetzungen erfüllen:

  • Die Ressource muss einen statischen benutzerdefinierten Namen haben, der in Ihrer Vorlage definiert ist. Dynamische Namen (mit !Ref oder anderen Funktionen) werden derzeit nicht unterstützt.

  • Die Ressource muss einen DeletionPolicy von Retain oder RetainExceptOnCreatehaben.

  • Die Ressource darf nicht bereits zu einem anderen CloudFormation Stack gehören.

  • Der Ressourcentyp muss CloudFormation-Importvorgänge unterstützen. Weitere Informationen finden Sie unter Unterstützung für Ressourcentypen.

  • Die primäre ID für den Ressourcentyp muss in der Vorlage enthalten sein. Primäre IDs mit schreibgeschützten Eigenschaften werden nicht unterstützt. Um herauszufinden, wie die primäre ID für einen Typ lautet, suchen Sie im Ressourcenschema nach der Eigenschaft primaryIdentifier . Weitere Informationen zu dieser Eigenschaft finden Sie unter primaryIdentifier.

Beispiel Auto-Import

Das folgende Beispiel verwendet einen Änderungssatz CreateChangeSet, um einen Stapel namens my-stack auf der Grundlage einer Vorlagendatei template.yamlzu erstellen, und importiert automatisch die passenden Ressourcen.

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

Fehlerbehebung

Wenn der automatische Import fehlschlägt, gehen Sie wie folgt vor, um das Problem zu beheben:

  • Stellen Sie sicher, dass der Ressourcenname in Ihrer Vorlage genau mit dem Namen der Ressource übereinstimmt

  • Überprüfen Sie, ob die Ressource nicht bereits von einem anderen Stack verwaltet wird

  • Stellen Sie sicher, dass der Ressourcentyp Importvorgänge unterstützt

  • Stellen Sie sicher, dass Ihre Vorlage alle erforderlichen Eigenschaften für den Ressourcentyp enthält