Markieren Ihrer AWS Batch-Ressourcen - AWS Batch

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.

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 bestehendeAWS Batch Rechenumgebungen, Jobs, Jobdefinitionen, Auftragswarteschlangen und Planungsrichtlinien kennzeichnen.

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 BatchRechenumgebungen

Ja

Nein. Compute Environment-Tags werden nicht auf andere Ressourcen verteilt. Die Tags für die Ressourcen werden in den Tag-Elementen des ComputeResources-Objekts angegeben, das bei der CreateComputeEnvironmentAPI-Operation übergeben wird.

Ja

AWS Batch Aufträge

Ja

Nein. Tags werden nicht an untergeordnete Aufgaben mit Array oder MNP (parallel (MNP) -Aufgaben mit mehreren Knoten weitergegeben.

Ja

AWS BatchBerufsdefinitionen

Ja

Nein.

Ja

AWS BatchWarteschlange Warteschlangen

Ja

Nein.

Ja

AWS BatchPlanungsrichtlinien

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 als Ihr tags-per-resource Limit angerechnet.

Arbeiten mit Tags über die Konsole

Mithilfe derAWS Batch Konsole können Sie die Tags verwalten, die neuen oder vorhandenen Rechenumgebungen, Jobs, Jobdefinitionen und Jobwarteschlangen zugeordnet sind.

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

Sie können Tags zuAWS Batch Computerumgebungen, Aufträgen, Jobdefinitionen, Auftragswarteschleifen und Planungsrichtlinien 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 dieAWS Batch Konsole unter https://console.aws.amazon.com/batch/.

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

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

  4. Wähle eine bestimmte Ressource aus und wähle dann „Schlagworte bearbeiten“.

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

    • Um ein Tag hinzuzufügen, geben Sie den Schlüssel und den Wert in den leeren Textfeldern am Ende der Liste an.

    • 
          Delete icon
         Klicken Sie auf, um ein Tag zu löschen.

  6. Wiederholen Sie diesen Vorgang für jedes Tag, das Sie hinzufügen oder löschen möchten, und wählen Sie dann Edit Tags 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

Bat hinzufügenResourceTag

Löschen Sie ein oder mehrere Tags.

UntagResource

untag-resource

Fledermaus entfernenResourceTag

Listet Tags für eine Ressource auf

ListTagsForResource

list-tags-for-resource

Holen Sie sich ein 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 Sie eine Rechenumgebung

CreateComputeEnvironment

create-compute-environment

Neue FledermausComputeEnvironment

Erstellen einer Auftragswarteschlange.

CreateJobQueue

create-job-queue

Neue FledermausJobQueue

Erstellen einer Planungsrichtlinie.

CreateSchedulingPolicy

create-scheduling-policy

Neue FledermausSchedulingPolicy

Registrieren Sie eine Jobdefinition

RegisterJobDefinition

register-job-definition

Registriere BATJobDefinition

Submit einer Aufgabe, einen Job

SubmitJob

Job einreichen

- BATJob abschicken