Markieren Ihrer AWS Batch-Ressourcen

Um Sie bei der Verwaltung Ihrer AWS Batch-Ressourcen zu unterstützen, können Sie jeder Ressource eigene Metadaten in Form von Tags zuweisen. In diesem Thema werden Tags (Markierungen) und deren Erstellung beschrieben.

Grundlagen zu Tags (Markierungen)

Ein Tag (Markierung) ist eine Markierung, die Sie einer AWS-Ressource zuordnen. Jeder Tag (Markierung) besteht aus einem Schlüssel und einem optionalen Wert, beides können Sie bestimmen.

Mit Tags können Sie Ihre AWS-Ressourcen kategorisieren, z. B. nach Zweck, Eigentümer oder Umgebung. Wenn Sie viele Ressourcen desselben Typs haben, können Sie bestimmte Ressourcen basierend auf den zugewiesenen Tags schnell bestimmen. Sie können beispielsweise eine Reihe von Tags für Ihre AWS Batch-Cluster definieren. Diese helfen Ihnen, den Besitzer und die Stack-Ebene jedes einzelnen Clusters nachzuverfolgen. Sie sollten für jeden Ressourcentyp einen konsistenten Satz von Tag-Schlüsseln entwickeln.

Tags werden nicht automatisch Ihren Ressourcen zugewiesen. Nachdem Sie ein Tag hinzugefügt haben, können Sie jederzeit Tag-Schlüssel und -Werte bearbeiten oder Tags aus einer Ressource entfernen. Wenn Sie eine Ressource löschen, werden alle Tags (Markierungen) der Ressource ebenfalls gelöscht.

Tags haben keine semantische Bedeutung für AWS Batch und werden ausschließlich als Zeichenfolgen interpretiert. Sie können den Wert eines Tags (Markierung) zwar auf eine leere Zeichenfolge, jedoch nicht null festlegen. Wenn Sie ein Tag (Markierung) mit demselben Schlüssel wie ein vorhandener Tag (Markierung) für die Ressource hinzufügen, wird der alte Wert mit dem neuen überschrieben.

Sie können mit der AWS Management Console, AWS CLI und AWS Batch-API mit Tags arbeiten.

Wenn Sie AWS Identity and Access Management (IAM) verwenden, können Sie steuern, welche Benutzer in Ihrem AWS-Konto Tags erstellen, bearbeiten oder löschen dürfen.

Markieren Ihrer -Ressourcen

Sie können neue oder vorhandene AWS Batch Datenverarbeitungsumgebungen, Aufträge, Auftragsdefinitionen, Auftragswarteschlangen und Planungsrichtlinien markieren.

Wenn Sie die AWS Batch-Konsole verwenden, können Sie Tags auf neue Ressourcen anwenden, wenn sie erstellt werden, oder jederzeit auf bestehende Ressourcen, indem Sie die Registerkarte Tags auf der entsprechenden Ressourcenseite verwenden.

Wenn Sie die AWS Batch-API, die AWS CLI oder ein AWS-SDK verwenden, können Sie Tags mithilfe des Parameters tags auf neue Ressourcen oder mithilfe der API-Aktion TagResource auf vorhandene Ressourcen anwenden. Weitere Informationen finden Sie unter TagResource.

Bei einigen Aktionen zur Ressourcenerstellung können Sie Tags für eine Ressource angeben, wenn die Ressource erstellt wird. Wenn Tags während der Ressourcenerstellung nicht angewendet werden können, schlägt die Ressourcenerstellung fehl. Auf diese Weise wird sichergestellt, dass Ressourcen, die Sie bei der Erstellung markieren möchten, entweder mit angegebenen Tags oder gar nicht erstellt werden. Wenn Sie Ressourcen zum Zeitpunkt der Erstellung markieren, müssen Sie nach der Ressourcenerstellung keine benutzerdefinierten Tagging-Skripts ausführen.

In der folgenden Tabelle werden die markierbaren AWS Batch-Ressourcen und die bei Erstellung markierbaren Ressourcen beschrieben.

Markierungsunterstützung für AWS Batch-Ressourcen
Ressource	Unterstützt Tags (Markierungen)	Unterstützt Tag-Propagierung	Unterstützt das Markieren bei Erstellung (AWS Batch-API, AWS CLI, AWS-SDK)
AWS Batch Datenverarbeitungsumgebungen	Ja	Nein. Tags der Datenverarbeitungsumgebung werden nicht an andere Ressourcen weitergegeben. Tags für die Ressourcen werden im Tags-Mitglied des computeResources-Objekts angegeben, das in der CreateComputeEnvironment API-Operation übergeben wird.	Ja
AWS Batch Aufträge	Ja	Ja	Ja
AWS Batch -Auftragsdefinitionen	Ja	Nein	Ja
AWS Batch-Auftragswarteschlangen	Ja	Nein	Ja
AWS Batch Planungsrichtlinien	Ja	Nein	Ja

Tag (Markierung)-Einschränkungen

Die folgenden grundlegenden Einschränkungen gelten für Tags (Markierungen):

• Maximale Anzahl von Tags (Markierungen) pro Ressource: 50

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

• Maximale Schlüssellänge: 128 Unicode-Zeichen in UTF-8

• Maximale Wertlänge: 256 Unicode-Zeichen in UTF-8

• Wenn Ihr Markierungsschema für mehrere AWS-Services und -Ressourcen verwendet wird, denken Sie daran, dass andere Services möglicherweise Einschränkungen für zulässige Zeichen haben. Allgemein erlaubte Zeichen sind Buchstaben, Zahlen, Leerzeichen, die in UTF-8 darstellbar sind, sowie die folgenden Zeichen: + - = . _ : / @.

• Bei Tag-Schlüsseln und -Werten muss die Groß- und Kleinschreibung beachtet werden.

• Verwenden Sie weder aws: noch AWS: oder Kombinationen aus Groß- und Kleinbuchstaben von diesen als Präfix für Schlüssel oder Werte, da sie für die AWS-Verwendung reserviert sind. Sie können keine Tag-Schlüssel oder -Werte mit diesem Präfix bearbeiten oder löschen. Tags mit diesem Präfix werden nicht auf Ihr tags-per-resource Limit angerechnet.

Arbeiten mit Tags über die Konsole

Mit der AWS BatchKonsole können Sie die Tags verwalten, die neuen oder vorhandenen Datenverarbeitungsumgebungen, Aufträgen, Auftragsdefinitionen und Auftragswarteschlangen zugeordnet sind.

Hinzufügen von Tags zu einer einzelnen Ressource bei der Erstellung

Sie können AWS Batch Datenverarbeitungsumgebungen, Aufträgen, Auftragsdefinitionen, Auftragswarteschlangen und Planungsrichtlinien Tags hinzufügen, wenn Sie sie erstellen.

Hinzufügen und Löschen von Tags für einzelne Ressourcen

Mit AWS Batch können Sie Tags, die Ihren Clustern zugeordnet sind, direkt auf der Seite der Ressource hinzufügen oder löschen.

So fügen Sie ein Tag zu einer einzelnen Ressource hinzu oder löschen es

1. Öffnen Sie die -AWS BatchKonsole unter https://console.aws.amazon.com/batch/.

2. Wählen Sie in der Navigationsleiste die zu verwendende Region aus.

3. Wählen Sie im Navigationsbereich einen Ressourcentyp aus (z. B. Auftragswarteschlangen ).

4. Wählen Sie eine bestimmte Ressource und dann Tags bearbeiten aus.

5. Fügen Sie Ihre Tags nach Bedarf hinzu oder löschen Sie sie.

   • So fügen Sie ein Tag hinzu – geben Sie den Schlüssel und den Wert in den leeren Textfeldern am Ende der Liste an.

   • Um ein Tag zu löschen – wählen Sie die Schaltfläche neben dem Tag.

6. Wiederholen Sie diesen Vorgang für jedes Tag, das Sie hinzufügen oder löschen möchten, und wählen Sie dann Tags bearbeiten aus, um den Vorgang abzuschließen.

Arbeiten mit Tags mittels CLI oder API

Verwenden Sie die folgenden AWS CLI-Befehle oder AWS Batch-API-Operationen, um die Tags für Ihre Ressourcen hinzuzufügen, zu aktualisieren, aufzulisten und zu löschen.

Markierungsunterstützung für AWS Batch-Ressourcen
Aufgabe	API-Aktion	AWS CLI	AWS Tools for Windows PowerShell
Fügen Sie einen oder mehrere Tags hinzu oder überschreiben Sie sie.	TagResource	tag-resource	Add-BATResourceTag
Löschen Sie ein oder mehrere Tags.	UntagResource	untag-resource	Remove-BATResourceTag
Listet Tags für eine Ressource auf	ListTagsForResource	list-tags-for-resource	Get-BATResourceTag

Die folgenden Beispiele zeigen, wie man Tags an Ressourcen mithilfe der AWS CLI hinzufügt oder entfernt.

Beispiel 1: Markieren einer vorhandenen Ressource

Der folgende Befehl markiert eine vorhandene Ressource.

aws batch tag-resource --resource-arn resource_ARN --tags team=devs

Beispiel 2: Entfernen der Markierung einer vorhandenen Ressource

Der folgende Befehl löscht ein Tag aus einer vorhandenen Ressource.

aws batch untag-resource --resource-arn resource_ARN --tag-keys tag_key

Beispiel 3: Tags für eine Ressource auflisten

Der folgende Befehl listet die Tags auf, die einer vorhandenen Ressource zugeordnet sind.

aws batch list-tags-for-resource --resource-arn resource_ARN

Mit einigen Aktionen zur Ressourcenerstellung können Sie Tags beim Erstellen der Ressource angeben. Die folgenden Aktionen unterstützen das Markieren bei der Erstellung.

Aufgabe	API-Aktion	AWS CLI	AWS Tools for Windows PowerShell
Erstellen einer Datenverarbeitungsumgebung	CreateComputeEnvironment	create-compute-environment	Neu-BATComputeEnvironment
Erstellen einer Auftragswarteschlange	CreateJobQueue	create-job-queue	Neu-BATJobQueue
Erstellen einer Planungsrichtlinie	CreateSchedulingPolicy	create-scheduling-policy	Neu-BATSchedulingPolicy
Registrieren einer Auftragsdefinition	RegisterJobDefinition	register-job-definition	Registrieren-BATJobDefinition
Übermitteln eines Auftrags	SubmitJob	Submit-Job	Submit-BATJob