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.
# 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 mithilfe des SageMaker Rollenmanagers erstellt wurden, ist die `sagemaker:AddTags` Berechtigung vorab ausgefüllt.
+ Für bestehende Domänen, AWS Identity and Access Management die benutzerdefinierte 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 AWS CLI aus können Sie sich für die Verteilung benutzerdefinierter Tags entscheiden, wenn Sie eine Domain erstellen oder eine bestehende Domain 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 Amazon SageMaker AI-Konsole unter [https://console.aws.amazon.com/sagemaker/](https://console.aws.amazon.com/sagemaker/).
1. Wählen Sie im linken Navigationsbereich **Admin-Konfigurationen** aus. Wählen Sie unter **Admin-Konfigurationen** **Domains** aus.
1. Wählen Sie auf der Seite **Domains** die Domain aus, für die Sie die Verbreitung von benutzerdefinierten Tags aktivieren möchten.
1. Wählen Sie auf der Seite mit den **Domain-Details** den Tab **Domaineinstellungen** aus.
1. Navigieren Sie auf der Registerkarte **Domaineinstellungen** zu **Verbreitung von benutzerdefinierten Tags**.
1. Wählen Sie **Bearbeiten** aus.
1. Wählen Sie auf der Seite **Verbreitung von benutzerdefinierten Tags** die Option **Benutzerdefinierte Tags automatisch verbreiten** aus
1. Wählen Sie **Absenden** aus.
### Melden Sie sich an mit dem AWS CLI
Verwenden Sie das `TagPropagation` Attribut im Feld und AWS CLI, um sich für die Weitergabe benutzerdefinierter Tags mit dem zu entscheiden. [CreateDomain[UpdateDomain](https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_UpdateDomain.html)](https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_CreateDomain.html) APIs 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 Amazon SageMaker AI-Konsole unter [https://console.aws.amazon.com/sagemaker/](https://console.aws.amazon.com/sagemaker/).
1. Wählen Sie im linken Navigationsbereich **Admin-Konfigurationen** aus. Wählen Sie unter **Admin-Konfigurationen** **Domains** aus.
1. Wählen Sie auf der Seite **Domains** die Domain aus, der Sie benutzerdefinierte Tags hinzufügen möchten.
1. Wählen Sie auf der Seite mit den **Domain-Details** den Tab **Domaineinstellungen** aus.
1. Navigieren Sie auf der Registerkarte **Domaineinstellungen** zu **Tags**.
1. Wählen Sie **Bearbeiten** aus.
1. 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.
1. Wählen Sie **Speichern** aus. Dieses benutzerdefinierte Tag wird jetzt an die SageMaker KI-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 Amazon SageMaker AI-Konsole unter [https://console.aws.amazon.com/sagemaker/](https://console.aws.amazon.com/sagemaker/).
1. Wählen Sie im linken Navigationsbereich **Admin-Konfigurationen** aus. Wählen Sie unter **Admin-Konfigurationen** **Domains** aus.
1. Wählen Sie auf der Seite **Domains** die Domain mit dem Benutzerprofil aus, der Sie benutzerdefinierte Tags hinzufügen möchten.
1. Wählen Sie auf der Seite mit den **Domaindetails** die Registerkarte **Benutzerprofile** aus.
1. Wählen Sie auf der Registerkarte **Benutzerprofile** das Benutzerprofil aus, dem Sie benutzerdefinierte Tags hinzufügen möchten.
1. Navigieren Sie auf der Registerkarte **Benutzerdetails** zum Abschnitt **Details**.
1. Wählen Sie **Bearbeiten** aus.
1. 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.
1. Wählen Sie **Absenden** aus. Dieses benutzerdefinierte Tag wird jetzt an die SageMaker KI-Ressourcen weitergegeben, die in der Domain erstellt wurden.
### Fügen Sie es mit dem hinzu AWS CLI
Nachdem Sie die Übertragung benutzerdefinierter Tags aktiviert haben, können Sie während der AWS CLI Erstellung oder Aktualisierung benutzerdefinierte Tags hinzufügen, indem Sie die auf Domänen-, Benutzerprofil- oder Bereichsebene verwenden. 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](https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_AddTags.html)API verwenden, um benutzerdefinierte Tags für bestehende Domänen, Benutzerprofile und Leerzeichen wie folgt hinzuzufügen.
```
aws sagemaker add-tags \
--resource-arn resource-arn-to-attach-tags \
--tags Key=key, Value=value
```