View a markdown version of this page

CloudFormation Ressourcen-Tagging - AWS CloudFormation
SyntaxEigenschaftenBeispielWeitere Informationen finden Sie auch unter

Dies ist das neue CloudFormation Template Reference Guide. Bitte aktualisieren Sie Ihre Lesezeichen und Links. Hilfe zu den ersten CloudFormation Schritten finden Sie im AWS CloudFormation Benutzerhandbuch.

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.

CloudFormation Ressourcen-Tagging

Mithilfe der Tags Eigenschaft in Ihrer CloudFormation Vorlage können Sie Ressourcen mit Tags versehen. Dies kann Ihnen helfen, diese Ressourcen zu identifizieren und zu kategorisieren.

Informationen darüber, welche Ressourcen die Eigenschaft Tags unterstützen, finden Sie bei den einzelnen Ressourcen in der Referenz AWS -Ressourcen- und Eigenschaftstypen. Wenn eine Ressource die Eigenschaft Tags noch nicht unterstützt, kann der Ressourcendienst die Markierung über seine eigenen API-Vorgänge unterstützen. Weitere Informationen finden Sie in der Dokumentation zu diesem Dienst.

Zusätzlich zu allen von Ihnen definierten Tags CloudFormation werden automatisch die folgenden Tags auf Stackebene mit dem Präfix erstellt: aws:

  • aws:cloudformation:logical-id

  • aws:cloudformation:stack-id

  • aws:cloudformation:stack-name

Das aws: Präfix ist für die Verwendung reserviert. AWS Bei diesem Präfix wird die Groß-/Kleinschreibung nicht beachtet. Wenn Sie dieses Präfix in der Key- oder Value-Eigenschaft verwenden, können Sie das Tag nicht aktualisieren oder löschen. Tags mit diesem Präfix zählen nicht zur Anzahl der Tags pro Ressource.

Die Weitergabe von Tags auf Stack-Ebene an Ressourcen, einschließlich Tags mit dem Präfix aws:, variiert je nach Ressourcentyp. Derzeit werden Tags nicht auf Amazon EBS-Volumes übertragen, die von Block-Gerätezuordnungen erstellt werden.

Anmerkung

Einige Ressourcen erfordern explizite Einstellungen für die Tag-Distribution. Bei der Ressource AWS::AutoScaling::AutoScalingGroup muss beispielsweise die Eigenschaft PropagateAtLaunch auf true gesetzt sein, damit die Tags an die EC2-Instances weitergegeben werden. Tags auf Stack-Ebene werden jedoch automatisch auf EC2-Instances angewendet, unabhängig von der Einstellung PropagateAtLaunch .

Syntax

JSON

{
  "Key" : String,
  "Value" : String
}

YAML

Key: String
Value: String

Eigenschaften

Key

Schlüsselname des Tags. Sie können einen Wert angeben, der aus 1 bis 128 Unicode-Zeichen besteht. Ihm darf nicht aws: vorangestellt werden. Sie können eines der folgenden Zeichen verwenden: Unicode-Zeichen, Ziffern, Leerzeichen, _, ., :, /, =, +, @, - und ".

Erforderlich: Ja

Typ: Zeichenfolge

Value

Der Wert für das Tag. Sie können einen Wert mit einer Länge von 1 bis 256 Zeichen angeben. Sie können eines der folgenden Zeichen verwenden: Unicode-Zeichen, Ziffern, Leerraum, _, ., /, =, + und -.

Erforderlich: Ja

Typ: Zeichenfolge

Beispiel

Dieses Beispiel zeigt eine Tags-Eigenschaft. Sie geben diese Eigenschaft innerhalb des Abschnitts Properties einer Ressource an, von der er unterstützt wird. Bei der Erstellung der Ressource wird das Environment-Tag dynamisch über einen Parameter festgelegt und das Owner-Tag wird statisch auf MyNamegesetzt.

JSON

"Tags" : [
   {
      "Key" : "Environment",
      "Value" : { "Ref": "Environment" }
   },
   {
      "Key" : "Owner",
      "Value" : "MyName"
   }
]

YAML

Tags: 
  - Key: Environment
    Value: !Ref Environment
  - Key: Owner
    Value: MyName

Weitere Informationen finden Sie auch unter