View a markdown version of this page

AWS Proton Ressourcen und Tagging - AWS Proton

Hinweis zum Ende des Supports: Am 7. Oktober 2026 AWS endet der Support für AWS Proton. Nach dem 7. Oktober 2026 werden Sie nicht mehr auf die AWS Proton Konsole oder AWS Proton die Ressourcen zugreifen können. Ihre bereitgestellte Infrastruktur bleibt intakt. Weitere Informationen finden Sie im AWS Proton Service Deprecation and Migration Guide.

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.

AWS Proton Ressourcen und Tagging

AWS Proton Zu den Ressourcen, denen ein Amazon-Ressourcenname (ARN) zugewiesen wurde, gehören Umgebungsvorlagen und ihre Haupt- und Nebenversionen, Servicevorlagen sowie deren Haupt- und Nebenversionen, Umgebungen, Services, Service-Instances, Komponenten und Repositorys. Sie können diese Ressourcen taggen, um sie besser organisieren und identifizieren zu können. Mithilfe von Stichwörtern können Sie Ressourcen nach Zweck, Besitzer, Umgebung oder anderen Kriterien kategorisieren. Weitere Informationen finden Sie unter Tagging-Strategien in . Um Ihre AWS Proton Ressourcen zu verfolgen und zu verwalten, können Sie die in den folgenden Abschnitten beschriebenen Tagging-Funktionen verwenden.

AWS tagging

Sie können Ihren AWS Ressourcen Metadaten in Form von Tags zuweisen. Jedes Tag besteht aus einem vom Kunden definierten Schlüssel und einem optionalen Wert. Mit Tags können Sie Ressourcen verwalten, identifizieren, organisieren, suchen und filtern.

Wichtig

Fügen Sie keine personenbezogenen Daten (Personally Identifiable Information, PII) oder andere vertrauliche Informationen in Tags hinzu. Tags sind für viele AWS-Services zugänglich, einschließlich der Abrechnung. Tags sind nicht für private oder sensible Daten gedacht.

Jedes -Tag besteht aus zwei Teilen.
  • einem Tag-Schlüssel (z. B. CostCenter, Environment oder Project). Bei Tag-Schlüsseln wird zwischen Groß- und Kleinschreibung unterschieden.

  • Ein Tag-Wert (optional) (z. B. 111122223333 oderProduction). Wie bei Tag-Schlüsseln wird auch bei Tag-Werten zwischen Groß- und Kleinschreibung unterschieden.

Die folgenden grundlegenden Benennungs- und Nutzungsanforderungen gelten für Tags.
  • Eine Ressource kann bis zu 50 Tags besitzen, die von Benutzern erstellt wurden.

    Anmerkung

    Vom System erstellte Tags, die mit dem aws: Präfix beginnen, sind für die AWS Verwendung reserviert und werden nicht auf dieses Limit angerechnet. Tags, die mit dem einem aws:-Präfix beginnen, können nicht bearbeitet oder gelöscht werden.

  • Jeder Tag (Markierung) muss für jede Ressource eindeutig sein. Jeder Tag (Markierung) kann nur einen Wert haben.

  • Der Tag-Schlüssel muss aus mindestens 1 und maximal 128 Unicode-Zeichen bestehen UTF-8.

  • Der Tag-Wert muss mindestens 1 und darf maximal 256 Unicode-Zeichen enthalten UTF-8.

  • Zulässige Zeichen in Tags sind Buchstaben, Zahlen, Leerzeichen UTF-8, darstellbar in und die folgenden Zeichen: * _.:/= + - @.

AWS Proton tagging

Mit AWS Proton können Sie sowohl die von Ihnen erstellten als auch die Tags verwenden, die AWS Proton automatisch für Sie generiert werden.

AWS Proton​ AWS verwaltete Stichwörter

Wenn Sie eine AWS Proton Ressource erstellen, generiert AWS Proton automatisch AWS verwaltete Tags für Ihre neue Ressource, wie im folgenden Diagramm dargestellt. AWS Verwaltete Tags werden später auf andere AWS Proton Ressourcen übertragen, die auf Ihrer neuen Ressource basieren. Beispielsweise werden verwaltete Tags aus einer Umgebungsvorlage an ihre Versionen weitergegeben, und verwaltete Tags aus einem Dienst werden an seine Dienstinstanzen weitergegeben.

Anmerkung

AWS verwaltete Tags werden nicht für Verbindungen mit Umgebungskonten generiert. Weitere Informationen finden Sie unter Verbindungen zu Umgebungskonten.

Ein Diagramm, das die Weitergabe AWS verwalteter Tags beschreibt.

Weitergabe von Tags an bereitgestellte Ressourcen

Wenn bereitgestellte Ressourcen, z. B. die in Service- und Umgebungsvorlagen definierten, AWS Tagging unterstützen, werden die verwalteten Tags als vom Kunden AWS verwaltete Tags an die bereitgestellten Ressourcen weitergegeben. Diese Tags werden nicht an bereitgestellte Ressourcen weitergegeben, die Tagging nicht unterstützen. AWS

AWS Proton wendet Tags auf Ihre Ressourcen nach AWS Proton Konten, registrierten Vorlagen und bereitgestellten Umgebungen sowie nach Diensten und Dienstinstanzen an, wie in der folgenden Tabelle beschrieben. Sie können AWS verwaltete Tags verwenden, um Ihre AWS Proton Ressourcen anzuzeigen und zu verwalten, aber Sie können sie nicht ändern.

AWS Schlüssel für verwaltete Tags Vom Kunden verwalteter Schlüssel weitergegeben Description

aws:proton:account

proton:account

Das AWS Konto, das Ressourcen erstellt und bereitstellt. AWS Proton

aws:proton:template

proton:template

Der ARN einer ausgewählten Vorlage.

aws:proton:environment

proton:environment

Der ARN einer ausgewählten Umgebung.

aws:proton:service

proton:service

Der ARN eines ausgewählten Dienstes.

aws:proton:service-instance

proton:service-instance

Der ARN einer ausgewählten Dienstinstanz.

aws:proton:component

proton:component

Der ARN einer ausgewählten Komponente.

Das Folgende ist ein Beispiel für ein AWS verwaltetes Tag für eine AWS Proton Ressource.

"aws:proton:template" = "arn:aws:proton:region-id:account-id:environment-template/env-template"

Im Folgenden finden Sie ein Beispiel für ein vom Kunden verwaltetes Tag, das auf eine bereitgestellte Ressource angewendet wurde und von einem AWS verwalteten Tag aus weitergegeben wurde.

"proton:environment:database" = "arn:aws:proton:region-id:account-id:rds/env-db"

AWS Proton Wendet bei der AWS verwalteten Bereitstellung propagierte Tags direkt auf bereitgestellte Ressourcen an.

Stellt bei selbstverwalteter Bereitstellung propagierte Tags zusammen mit AWS Proton den gerenderten IaC-Dateien zur Verfügung, die im Bereitstellungs-Pull Request (PR) eingereicht werden. Tags werden in der String-Map-Variablen bereitgestellt. proton_tags Wir empfehlen, dass Sie in Ihrer Terraform-Konfiguration auf diese Variable verweisen, um AWS Proton Tags darin aufzunehmen. default_tags Dadurch werden AWS Proton Tags an alle bereitgestellten Ressourcen weitergegeben.

Das folgende Beispiel zeigt diese Methode der Tag-Weitergabe in einer Terraform-Umgebungsvorlage.

Hier ist die proton_tags Variablendefinition:

proton.environment.variables.tf:

variable "environment" { type = object({ inputs = map(string) name = string }) } variable "proton_tags" { type = map(string) default = null }

So werden dieser Variablen Tag-Werte zugewiesen:

proton.auto.tfvars.json:

{ "environment": { "name": "dev", "inputs": { "ssm_parameter_value": "MyNewParamValue" } } "proton_tags" : { "proton:account" : "123456789012", "proton:template" : "arn:aws:proton:us-east-1:123456789012:environment-template/fargate-env", "proton:environment" : "arn:aws:proton:us-east-1:123456789012:environment/dev" } }

Und so können Sie Ihrer Terraform-Konfiguration AWS Proton Tags hinzufügen, damit sie zu den bereitgestellten Ressourcen hinzugefügt werden:

# Configure the AWS Provider provider "aws" { region = var.aws_region default_tags { tags = var.proton_tags } }

Vom Kunden verwaltete Tags

Jede AWS Proton Ressource hat ein maximales Kontingent von 50 vom Kunden verwalteten Tags. Vom Kunden verwaltete Tags werden auf dieselbe Weise an untergeordnete AWS Proton Ressourcen weitergegeben wie AWS verwaltete Tags, außer dass sie nicht an vorhandene AWS Proton Ressourcen oder bereitgestellte Ressourcen weitergegeben werden. Wenn Sie einer AWS Proton Ressource mit vorhandenen untergeordneten Ressourcen ein neues Tag zuweisen und möchten, dass die vorhandenen untergeordneten Ressourcen mit dem neuen Tag gekennzeichnet werden, müssen Sie jede vorhandene untergeordnete Ressource manuell mit der Konsole oder kennzeichnen. AWS CLI

Erstellen Sie Tags mithilfe der Konsole und der CLI

Wenn Sie eine AWS Proton Ressource mithilfe der Konsole erstellen, haben Sie die Möglichkeit, vom Kunden verwaltete Tags entweder auf der ersten oder zweiten Seite des Erstellungsvorgangs zu erstellen, wie im folgenden Konsolen-Snapshot dargestellt. Wählen Sie Neues Tag hinzufügen, geben Sie den Schlüssel und den Wert ein und fahren Sie fort.

Ein Snapshot der Oberfläche zum Erstellen von Tags in der Konsole.

Nachdem Sie mit der AWS Proton Konsole eine neue Ressource erstellt haben, können Sie die Liste der AWS verwalteten und vom Kunden verwalteten Tags auf der Detailseite einsehen.

Erstellen oder bearbeiten Sie ein Tag
  1. Öffnen Sie in der AWS Proton Konsole eine AWS Proton Ressourcendetailseite, auf der Sie eine Liste von Stichwörtern sehen können.

  2. Wählen Sie Tags verwalten aus.

  3. Auf der Seite „Tags verwalten“ können Sie Tags anzeigen, erstellen, entfernen und bearbeiten. Die oben aufgeführten AWS verwalteten Tags können nicht geändert werden. Sie können die vom Kunden verwalteten Tags jedoch mithilfe von Bearbeitungsfeldern, die nach den verwalteten Stichwörtern aufgeführt sind, ergänzen und ändern. AWS

    Wählen Sie Neues Tag hinzufügen, um ein neues Tag zu erstellen.

  4. Geben Sie einen Schlüssel und einen Wert für das neue Tag ein.

  5. Um ein Tag zu bearbeiten, geben Sie einen Wert in das Tag-Wertfeld für einen ausgewählten Schlüssel ein.

  6. Um ein Tag zu löschen, wählen Sie Entfernen für ein ausgewähltes Tag.

  7. Wenn Sie Ihre Änderungen abgeschlossen haben, wählen Sie Änderungen speichern.

Erstellen Sie Stichwörter mit dem AWS Proton​ AWS CLI

Sie können Tags mithilfe der anzeigen, erstellen, entfernen und bearbeiten AWS Proton AWS CLI.

Sie können ein Tag für eine Ressource erstellen oder bearbeiten, wie im folgenden Beispiel gezeigt.

$ aws proton tag-resource \ --resource-arn "arn:aws:proton:region-id:account-id:service-template/webservice" \ --tags '[{"key":"mykey1","value":"myval1"},{"key":"mykey2","value":"myval2"}]'

Sie können ein Tag für eine Ressource entfernen, wie im nächsten Beispiel gezeigt.

$ aws proton untag-resource \ --resource-arn "arn:aws:proton:region-id:account-id:service-template/webservice" \ --tag-keys '["mykey1","mykey2"]'

Sie können Tags für eine Ressource auflisten, wie im letzten Beispiel gezeigt.

$ aws proton list-tags-for-resource \ --resource-arn "arn:aws:proton:region-id:account-id:service-template/webservice"