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.
# API Gateway-Ressourcen, die mit Tags versehen werden können
Tags können für die folgenden HTTP-API- oder WebSocket API-Ressourcen in der [Amazon API Gateway V2 API](https://docs.aws.amazon.com/apigatewayv2/latest/api-reference/) festgelegt werden:
+ `Api`
+ `DomainName`
+ `Stage`
+ `VpcLink`
Darüber hinaus können Tags für die folgenden REST-API-Ressourcen in der [Amazon API Gateway V1-API](https://docs.aws.amazon.com/apigateway/latest/api/API_Operations.html) festgelegt werden:
+ `ApiKey`
+ `ClientCertificate`
+ `DomainName`
+ `DomainNameAccessAssociation`
+ `RestApi`
+ `Stage`
+ `UsagePlan`
+ `VpcLink`
Tags können nicht direkt in anderen Ressourcen festgelegt werden. In der [Amazon API Gateway V1-API](https://docs.aws.amazon.com/apigateway/latest/api/API_Operations.html) erben untergeordnete Ressourcen die Tags, die für übergeordneten Ressourcen festgelegt sind. Beispiel:
+ Wenn ein Tag in einer `RestApi`-Ressource festgelegt ist, wird dieses Tag an die folgenden untergeordneten Ressourcen dieser `RestApi` für [Attributbasierte Zugriffskontrolle](https://docs.aws.amazon.com/IAM/latest/UserGuide/introduction_attribute-based-access-control.html) vererbt:
+ `Authorizer`
+ `Deployment`
+ `Documentation`
+ `GatewayResponse`
+ `Integration`
+ `Method`
+ `Model`
+ `Resource`
+ `ResourcePolicy`
+ `Setting`
+ `Stage`
+ Wenn ein Tag für einen `DomainName` festgelegt ist, wird dieses Tag von allen untergeordneten `BasePathMapping`-, `ApiMapping`- und `RoutingRule`-Ressourcen geerbt.
+ Wenn ein Tag in einem `UsagePlan` festgelegt ist, wird dieses Tag von allen `UsagePlanKey`-Ressourcen darunter geerbt.
**Anmerkung**
Die Tag-Vererbung gilt nur für [attributbasierte Zugriffskontrolle](https://docs.aws.amazon.com/IAM/latest/UserGuide/introduction_attribute-based-access-control.html). Sie können beispielsweise keine vererbten Tags verwenden, um die Kosten in zu überwachen AWS Cost Explorer. Wenn Sie Tags für Kostenzuweisungen verwenden möchten, empfehlen wir, Tags für untergeordnete Ressourcen zu erstellen, z. B. für die `Stage`-Ressource.
API Gateway gibt keine geerbten Tags zurück, wenn Sie [GetTags](https://docs.aws.amazon.com/cli/latest/reference/apigateway/get-tags.html)eine Ressource aufrufen.
## Tag-Vererbung in der Amazon API Gateway V1-API
Zuvor war es nur möglich, Tags in Stufen festzulegen. Da Sie sie jetzt auch in anderen Ressourcen festlegen können, kann eine `Stage` ein Tag auf zwei Arten erhalten:
+ Das Tag kann direkt in der festgelegt werde `Stage`.
+ Die Stufe kann das Tag von der übergeordneten erbe `RestApi`.
Wenn eine Stufe ein Tag auf beide Arten erhält, hat das Tag den Vorrang, das direkt in der Stufe festgelegt wurde. Nehmen wir beispielsweise an, eine Stufe erbt die folgenden Tags von der übergeordneten REST-API:
```
{
'foo': 'bar',
'x':'y'
}
```
Nehmen wir an, es werden auch die folgenden Tags direkt in ihr festgelegt:
```
{
'foo': 'bar2',
'hello': 'world'
}
```
Die Wirkung für die Stufe wäre, dass sie über folgende Tags mit den folgenden Werten verfügt:
```
{
'foo': 'bar2',
'hello': 'world'
'x':'y'
}
```
## Tag-Einschränkungen und Nutzungskonventionen
Die folgenden Einschränkungen und Nutzungskonventionen gelten für die Verwendung von Tags mit API Gateway-Ressourcen:
+ Jede Ressource kann maximal 50 Tags haben.
+ Jeder Tag muss für jede Ressource eindeutig sein. Jeder Tag kann nur einen Wert haben.
+ Die maximale Länge des Tag-Schlüssels beträgt 128 Unicode-Zeichen in UTF-8.
+ Die maximale Länge des Tag-Wertes beträgt 256 Unicode-Zeichen in UTF-8.
+ Zulässige Zeichen für Schlüssel und Werte sind Buchstaben, Zahlen, Leerzeichen, die in UTF-8 darstellbar sind, und die folgenden Zeichen:*** . : \+ = @ \_ / -*** (Bindestrich). Für Amazon EC2-Ressourcen können beliebige Zeichen verwendet werden.
+ Bei Tag-Schlüsseln und -Werten muss die Groß-/Kleinschreibung beachtet werden. Eine bewährte Methode besteht darin, sich für eine einheitliche Schreibweise der Tag-Benennungen zu entscheiden und diese Strategie für alle Ressourcentypen umzusetzen. Entscheiden Sie sich beispielsweise für `Costcenter`, `costcenter` oder `CostCenter` und verwenden Sie diese Konvention für alle Tags. Vermeiden Sie die Verwendung von ähnlichen Tags mit uneinheitlicher Fallunterscheidung.
+ Das Präfix `aws:` darf nicht für Tags verwendet werden; es ist für die AWS -Verwendung reserviert. Sie können keine Tag-Schlüssel oder -Werte mit diesem Präfix bearbeiten oder löschen. Tags mit diesem Präfix werden nicht als Ihre Tags pro Ressourcenlimit angerechnet.