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](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/Welcome.html).
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.
# Freigegebene Ressourceneigenschaftstypen – Referenz
Dieser Abschnitt enthält ausführliche Referenzinformationen für Eigenschaftstypen, die die Verwendung in mehreren Ressourcentypen CloudFormation unterstützen.
**Topics**
+ [CloudFormation benutzerdefinierte Benennung von Ressourcen](aws-properties-name.md)
+ [CloudFormation Verschlagwortung von Ressourcen](aws-properties-resource-tags.md)
# CloudFormation benutzerdefinierte Benennung von Ressourcen
Sie können unterstützten Ressourcentypen in Ihrer CloudFormation Vorlage benutzerdefinierte Namen zuweisen, um sie aussagekräftiger und leichter identifizierbar zu machen. CloudFormation Generiert standardmäßig eine eindeutige physische ID zur Benennung einer Ressource. CloudFormation Könnte beispielsweise einen Amazon S3 S3-Bucket mit der folgenden physischen ID benennen`MyStack-MyBucket-abcdefghijk1`. Mit benutzerdefinierten Namen können Sie einen Namen angeben, der einfacher zu lesen und zu identifizieren ist, z. B. `production-app-logs` oder `business-metrics`.
Nicht alle Ressourcen unterstützen benutzerdefinierte Namen. Jeder AWS Service bestimmt unabhängig, welche Ressourcentypen benutzerdefinierte Namen unterstützen.
Ressourcennamen müssen über alle aktiven Stacks hinweg eindeutig sein. Wenn Sie Vorlagen zum Erstellen mehrerer Stacks wiederverwenden, müssen Sie benutzerdefinierte Namen aus Ihrer Vorlage ändern oder entfernen. Wenn Sie keinen Namen angeben, CloudFormation wird eine eindeutige physische ID generiert, um die Ressource zu benennen. Namen müssen mit einem Buchstaben beginnen, dürfen nur ASCII-Buchstaben, Ziffern und Bindestriche enthalten und dürfen nicht mit einem Bindestrich oder zwei aufeinander folgenden Bindestrichen enden.
Verwalten Sie Stack-Ressourcen auch nicht außerhalb von CloudFormation. Wenn Sie beispielsweise eine Ressource umbenennen, die Teil eines Stacks ist, ohne sie zu verwenden CloudFormation, kann es sein, dass Sie bei jedem Versuch, diesen Stapel zu aktualisieren oder zu löschen, eine Fehlermeldung erhalten.
**Wichtig**
Sie können keine Aktualisierung durchführen, die dazu führt, dass eine Ressourcen mit einem benutzerdefinierten Namen ersetzt wird. Wenn Sie die Ressource austauschen müssen, geben Sie einen neuen Namen an.
## Beispiel
Wenn Sie einen benutzerdefinierten Namen verwenden möchten, geben Sie eine name-Eigenschaft für diese Ressource in Ihrer CloudFormation -Vorlage an. Jede Ressource, die benutzerdefinierte Namen unterstützt, weist eine eigene Eigenschaft auf, die Sie angeben. Um beispielsweise eine DynamoDB-Tabelle zu benennen, verwenden Sie die `TableName`-Eigenschaft wie im folgenden Beispiel dargestellt:
### JSON
```
"myDynamoDBTable" : {
"Type" : "AWS::DynamoDB::Table",
"Properties" : {
"KeySchema" : {
"HashKeyElement": {
"AttributeName" : "AttributeName1",
"AttributeType" : "S"
},
"RangeKeyElement" : {
"AttributeName" : "AttributeName2",
"AttributeType" : "N"
}
},
"ProvisionedThroughput" : {
"ReadCapacityUnits" : "5",
"WriteCapacityUnits" : "10"
},
"TableName" : "SampleTable"
}
}
```
### YAML
```
myDynamoDBTable:
Type: AWS::DynamoDB::Table
Properties:
KeySchema:
HashKeyElement:
AttributeName: "AttributeName1"
AttributeType: "S"
RangeKeyElement:
AttributeName: "AttributeName2"
AttributeType: "N"
ProvisionedThroughput:
ReadCapacityUnits: "5"
WriteCapacityUnits: "10"
TableName: "SampleTable"
```
# CloudFormation Verschlagwortung von Ressourcen
Sie können Tags auf Ressourcen anwenden, indem Sie die `Tags` Eigenschaft in Ihrer CloudFormation Vorlage verwenden, was Ihnen dabei helfen kann, 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](https://docs.aws.amazon.com/AWSCloudFormation/latest/TemplateReference/aws-template-resource-type-ref.html). 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.
Erstellt zusätzlich zu allen von Ihnen definierten Tags CloudFormation automatisch die folgenden Tags auf Stapelebene mit dem Präfix: `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 `MyName`gesetzt.
### JSON
```
1. "Tags" : [
2. {
3. "Key" : "Environment",
4. "Value" : { "Ref": "Environment" }
5. },
6. {
7. "Key" : "Owner",
8. "Value" : "MyName"
9. }
10. ]
```
### YAML
```
1. Tags:
2. - Key: Environment
3. Value: !Ref Environment
4. - Key: Owner
5. Value: MyName
```
## Weitere Informationen finden Sie auch unter
+ [Konfigurieren Sie die Stackoptionen](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/cfn-console-create-stack.html#configure-stack-options) im *AWS CloudFormation -Benutzerhandbuch*
+ [Anzeige von CloudFormation Stack-Daten und Ressourcen auf der AWS-Managementkonsole](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/cfn-console-view-stack-data-resources.html) im *AWS CloudFormation Benutzerhandbuch*