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
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,EnvironmentoderProject). Bei Tag-Schlüsseln wird zwischen Groß- und Kleinschreibung unterschieden. -
Ein Tag-Wert (optional) (z. B.
111122223333oderProduction). 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 einemaws:-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.
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 |
|---|---|---|
|
|
|
Das AWS Konto, das Ressourcen erstellt und bereitstellt. AWS Proton |
|
|
|
Der ARN einer ausgewählten Vorlage. |
|
|
|
Der ARN einer ausgewählten Umgebung. |
|
|
|
Der ARN eines ausgewählten Dienstes. |
|
|
|
Der ARN einer ausgewählten Dienstinstanz. |
|
|
|
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_regiondefault_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.
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
-
Öffnen Sie in der AWS Proton Konsole eine AWS Proton Ressourcendetailseite
, auf der Sie eine Liste von Stichwörtern sehen können. -
Wählen Sie Tags verwalten aus.
-
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.
-
Geben Sie einen Schlüssel und einen Wert für das neue Tag ein.
-
Um ein Tag zu bearbeiten, geben Sie einen Wert in das Tag-Wertfeld für einen ausgewählten Schlüssel ein.
-
Um ein Tag zu löschen, wählen Sie Entfernen für ein ausgewähltes Tag.
-
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"