Hinzufügen von benutzerdefinierten Tags zu Ressourcen - Amazon SageMaker AI
VoraussetzungenAktivieren der Verbreitung von benutzerdefinierten TagHinzufügen von benutzerdefinierten Tags

Hinzufügen von benutzerdefinierten Tags zu Ressourcen

Auf der folgenden Seite werden die Schritte beschrieben, die zur Verwendung der Verbreitung von benutzerdefinierten Tag erforderlich sind. Die Verbreitung von benutzerdefinierten Tag erfordert die folgenden Schritte:

  • Aktivieren der Verbreitung von benutzerdefinierten Tag

  • Hinzufügen von benutzerdefinierten Tags zu Ressourcen

Wenn Sie die Verbreitung von benutzerdefinierten Tag in einer vorhandenen Domain aktivieren, funktioniert die Verbreitung von Tags für bestehende Anwendungen erst, wenn sie neu gestartet wird. Ebenso werden Tags für eine bestehende Ressource nicht aktualisiert, wenn neue benutzerdefinierte Tags hinzugefügt werden. Nehmen wir zum Beispiel an, eine Domain hat zwei Tags und ein Benutzer erstellt eine Ressource in dieser Domain. Die Ressource hat dann zwei Tags. Wenn der Domain ein neues Tag hinzugefügt wird, wird dieses neue Tag nicht zur vorhandenen Ressource hinzugefügt. Bei jeder neu erstellten Ressource wird jedoch das neue Tag an die Ressource angehängt.

Voraussetzungen

  • Benutzer müssen über die sagemaker:AddTags-Berechtigung zur Erstellung von Ressourcen verfügen.

    • Für neue Domains, die mit der SageMakerFullAccess-verwalteten Richtlinie oder mit dem SageMaker Role Manager erstellt wurden, ist die sagemaker:AddTags-Berechtigung vorab ausgefüllt.

    • Für bestehende Domains, die benutzerdefinierte AWS Identity and Access Management-Richtlinien verwenden, müssen Sie die Richtlinien so aktualisieren, dass sie die sagemaker:AddTags-Berechtigung enthalten, Benutzern das Erstellen von Ressourcen zu ermöglichen.

Aktivieren der Verbreitung von benutzerdefinierten Tag

Das Verfahren zum Aktivieren der Verbreitung von benutzerdefinierten Tags unterscheidet sich je nachdem, ob Sie die Aktivierung über die Konsole oder über AWS CLI vornehmen Von der Konsole aus können Sie die Verbreitung von benutzerdefinierten Tags nur aktivieren, indem Sie eine bestehende Domain aktualisieren. Von der Konsole AWS CLI aus können Sie die Verbreitung von benutzerdefinierten Tags aktivieren, wenn Sie eine Domain erstellen oder eine bestehende aktualisieren.

Aktivieren über die Konsole

In den folgenden Schritten wird beschrieben, wie Sie die Verbreitung von benutzerdefinierten Tags über die Konsole aktivieren. Von der Konsole aus können Sie die Verbreitung von benutzerdefinierten Tags nur aktivieren, indem Sie eine bestehende Domain aktualisieren.

  1. Öffnen Sie die Konsole von Amazon SageMaker AI unter https://console.aws.amazon.com/sagemaker/.

  2. Wählen Sie im linken Navigationsbereich Admin-Konfigurationen aus. Wählen Sie unter Admin-Konfigurationen Domains aus.

  3. Wählen Sie auf der Seite Domains die Domain aus, für die Sie die Verbreitung von benutzerdefinierten Tags aktivieren möchten.

  4. Wählen Sie auf der Seite mit den Domaindetails die Registerkarte Domaineinstellungen aus.

  5. Navigieren Sie auf der Registerkarte Domaineinstellungen zu Verbreitung von benutzerdefinierten Tags.

  6. Wählen Sie Bearbeiten aus.

  7. Wählen Sie auf der Seite Verbreitung von benutzerdefinierten Tags die Option Benutzerdefinierte Tags automatisch verbreiten aus

  8. Wählen Sie Absenden aus.

Aktivieren mit der AWS CLI

Verwenden Sie das TagPropagation-Attribut in den APIs CreateDomainuand UpdateDomain, um die Verbreitung von benutzerdefinierten Tags mithilfe von AWS CLI zu aktivieren. Der Wert für dieses Feld ist standardmäßig DISABLED. Ein leerer Wert ist standardmäßig ebenfalls DISABLED. Das folgende Beispiel zeigt, wie Sie die Verbreitung von benutzerdefinierten Tags aktivieren. 

aws sagemaker update-domain \
--domain-id domain-id \
--region region \
--tag-propagation ENABLED

Hinzufügen von benutzerdefinierten Tags

Das Verfahren zum Hinzufügen der Verbreitung von benutzerdefinierten Tags unterscheidet sich je nachdem, ob Sie die Hinzufügung über die Konsole oder über AWS CLI vornehmen.

Hinzufügen über die Konsole

In den folgenden Schritten wird beschrieben, wie Sie benutzerdefinierte Tags über die Konsole hinzufügen.

  1. Öffnen Sie die Konsole von Amazon SageMaker AI unter https://console.aws.amazon.com/sagemaker/.

  2. Wählen Sie im linken Navigationsbereich Admin-Konfigurationen aus. Wählen Sie unter Admin-Konfigurationen Domains aus.

  3. Wählen Sie auf der Seite Domains die Domain aus, der Sie benutzerdefinierte Tags hinzufügen möchten.

  4. Wählen Sie auf der Seite mit den Domaindetails die Registerkarte Domaineinstellungen aus.

  5. Navigieren Sie auf der Registerkarte Domaineinstellungen zu Tags.

  6. Wählen Sie Bearbeiten aus.

  7. Wählen Sie auf der Seite Tags die Option Tag hinzufügen aus. Fügen Sie ein Schlüssel-Wert-Paar für das benutzerdefinierte Tag hinzu.

  8. Wählen Sie Speichern aus. Dieses benutzerdefinierte Tag wird jetzt an die SageMaker-AI-Ressourcen weitergegeben, die in der Domain erstellt wurden.

In den folgenden Schritten wird beschrieben, wie Sie benutzerdefinierte Tags über die Konsole zu einem Benutzerprofil hinzufügen.

  1. Öffnen Sie die Konsole von Amazon SageMaker AI unter https://console.aws.amazon.com/sagemaker/.

  2. Wählen Sie im linken Navigationsbereich Admin-Konfigurationen aus. Wählen Sie unter Admin-Konfigurationen Domains aus.

  3. Wählen Sie auf der Seite Domains die Domain mit dem Benutzerprofil aus, der Sie benutzerdefinierte Tags hinzufügen möchten.

  4. Wählen Sie auf der Seite mit den Domaindetails die Registerkarte Benutzerprofile aus.

  5. Wählen Sie auf der Registerkarte Benutzerprofile das Benutzerprofil aus, dem Sie benutzerdefinierte Tags hinzufügen möchten.

  6. Navigieren Sie auf der Registerkarte Benutzerdetails zum Abschnitt Details.

  7. Wählen Sie Bearbeiten aus.

  8. Wählen Sie im Abschnitt Tags die Option Tag hinzufügen aus. Fügen Sie ein Schlüssel-Wert-Paar für das benutzerdefinierte Tag hinzu.

  9. Wählen Sie Absenden aus. Dieses benutzerdefinierte Tag wird jetzt an die SageMaker-AI-Ressourcen weitergegeben, die in der Domain erstellt wurden.

Hinzufügen mithilfe der AWS CLI

Nachdem Sie die Verbreitung von benutzerdefinierten Tags aktiviert haben, können Sie diese mithilfe der AWS CLI bei der Erstellung oder Aktualisierung auf Domain-, Benutzerprofil- oder Umgebungsebene hinzufügen. Die Methode zum Hinzufügen benutzerdefinierter Tags unterscheidet sich je nachdem, ob Sie eine neue Ressource erstellen oder einer vorhandenen Ressource Tags hinzufügen.

Im folgenden Beispiel wird gezeigt, wie Sie während der Erstellung benutzerdefinierte Tags auf Domainebene hinzufügen. 

aws sagemaker create-domain \
    --domain-name domain-id \
    --auth-mode IAM \
    --default-user-settings '{"ExecutionRole": "execution-role"}' \
    --subnet-ids subnet-id \
    --vpc-id vpc-id \
    --tags Key=key,Value=value \
    --tag-propagation ENABLED

Sie müssen die AddTags-API verwenden, um benutzerdefinierte Tags für bestehende Domains, Benutzerprofile und Umgebungen wie folgt hinzuzufügen. 

aws sagemaker add-tags \
--resource-arn resource-arn-to-attach-tags \
--tags Key=key, Value=value