API Gateway-Ressourcen, die mit Tags versehen werden können

Tags können in den folgenden HTTP-API- oder WebSocket-API-Ressourcen in der Amazon API Gateway V2-API 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 festgelegt werden:

• ApiKey

• ClientCertificate

• DomainName

• RestApi

• Stage

• UsagePlan

• VpcLink

Tags können nicht direkt in anderen Ressourcen festgelegt werden. In der Amazon API Gateway V1-API 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 vererbt:

  • Authorizer

  • Deployment

  • Documentation

  • GatewayResponse

  • Integration

  • Method

  • Model

  • Resource

  • ResourcePolicy

  • Setting

  • Stage

• Wenn ein Tag in einem DomainName festgelegt ist, wird dieses Tag von allen BasePathMapping-Ressourcen darunter 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. Beispielsweise können Sie keine vererbten Tags verwenden, um die Kosten in AWS Cost Explorer zu überwachen. API Gateway gibt keine vererbten Tags zurück, wenn Sie GetTags für 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.