Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.
# Ajout de balises personnalisées aux ressources
La page suivante décrit les étapes nécessaires à l’utilisation de la propagation des balises personnalisées. La propagation des balises personnalisées nécessite les étapes suivantes :
+ Inscription à la propagation des balises personnalisées
+ Ajout de balises personnalisées aux ressources
Lorsque vous activez la propagation des balises personnalisées dans un domaine existant, la propagation des balises ne fonctionne pas pour les applications existantes tant que l’application n’est pas redémarrée. De même, les balises ne sont pas mises à jour sur une ressource existante lorsque de nouvelles balises personnalisées sont ajoutées. Supposons, par exemple, qu’un domaine possède deux balises et qu’un utilisateur crée une ressource dans ce domaine. La ressource possède alors deux balises. Si une nouvelle balise est ajoutée au domaine, elle n’est pas ajoutée à la ressource existante. Toutefois, la nouvelle balise sera attachée à toute nouvelle ressource créée.
## Conditions préalables
+ Les utilisateurs doivent disposer de l’autorisation `sagemaker:AddTags` pour toute création de ressource.
+ Pour les nouveaux domaines créés avec la politique `SageMakerFullAccess` gérée ou à l'aide du gestionnaire de SageMaker rôles, l'`sagemaker:AddTags`autorisation est préremplie.
+ Pour les domaines existants utilisant des Gestion des identités et des accès AWS politiques personnalisées, vous devez mettre à jour les politiques afin d'inclure l'`sagemaker:AddTags`autorisation permettant aux utilisateurs de créer des ressources.
## Inscription à la propagation des balises personnalisées
Le processus d’inscription à la propagation des balises personnalisées varie selon que vous vous inscrivez depuis la console ou depuis l’ AWS CLI. Depuis la console, vous ne pouvez vous inscrire à la propagation des balises personnalisées qu’en mettant à jour un domaine existant. À partir du AWS CLI, vous pouvez opter pour la propagation personnalisée des balises lors de la création d'un domaine ou de la mise à jour d'un domaine existant.
### Inscription à partir de la console
Les étapes suivantes expliquent comment s’inscrire à la propagation des balises personnalisées depuis la console. Vous ne pouvez vous inscrire à la propagation des balises personnalisées qu’en mettant à jour un domaine existant.
1. Ouvrez la console Amazon SageMaker AI à l'adresse [https://console.aws.amazon.com/sagemaker/](https://console.aws.amazon.com/sagemaker/).
1. Dans le panneau de navigation de gauche, sélectionnez **Configurations d’administrateur**. Sous **Configurations d’administrateur**, sélectionnez **Domaines**.
1. Sur la page **Domaines**, sélectionnez le domaine pour lequel vous souhaitez activer la propagation des balises personnalisées.
1. Sur la page **Domain details** (Détails du domaine), sélectionnez l’onglet **Domain settings** (Paramètres du domaine).
1. Dans l’onglet **Paramètres du domaine**, accédez à **Propagation des balises personnalisées**.
1. Tâche de sélection **Modifier**.
1. Sur la page **Modifier la propagation des balises personnalisées**, sélectionnez **Propagation automatique des balises personnalisées**
1. Sélectionnez **Soumettre**.
### Inscrivez-vous à l'aide du AWS CLI
Pour activer la propagation personnalisée des balises à l'aide de AWS CLI, utilisez l'`TagPropagation`attribut dans le [CreateDomain](https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_CreateDomain.html)et [UpdateDomain](https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_UpdateDomain.html) APIs. Par défaut, la valeur de ce champ est `DISABLED`. Une valeur vide définit également par défaut `DISABLED`. L’exemple suivant montre comment activer la propagation des balises personnalisées.
```
aws sagemaker update-domain \
--domain-id domain-id \
--region region \
--tag-propagation ENABLED
```
## Ajout de balises personnalisées
Le processus d’ajout de la propagation des balises personnalisées varie selon que vous les ajoutez depuis la console ou depuis l’ AWS CLI.
### Ajout depuis la console
Les étapes suivantes expliquent comment ajouter des balises personnalisées à un domaine depuis la console.
1. Ouvrez la console Amazon SageMaker AI à l'adresse [https://console.aws.amazon.com/sagemaker/](https://console.aws.amazon.com/sagemaker/).
1. Dans le panneau de navigation de gauche, sélectionnez **Configurations d’administrateur**. Sous **Configurations d’administrateur**, sélectionnez **Domaines**.
1. Sur la page **Domaines**, sélectionnez le domaine auquel vous souhaitez ajouter des balises personnalisées.
1. Sur la page **Domain details** (Détails du domaine), sélectionnez l’onglet **Domain settings** (Paramètres du domaine).
1. Dans l’onglet **Paramètres du domaine**, accédez à **Balises**.
1. Tâche de sélection **Modifier**.
1. Sur la page **Balises**, sélectionnez **Ajouter une balise**. Ajoutez une paire clé/valeur pour la balise personnalisée.
1. Cliquez sur **Enregistrer**. Cette balise personnalisée est désormais propagée aux ressources d' SageMaker IA créées dans le domaine.
Les étapes suivantes expliquent comment ajouter des balises personnalisées à un profil utilisateur depuis la console.
1. Ouvrez la console Amazon SageMaker AI à l'adresse [https://console.aws.amazon.com/sagemaker/](https://console.aws.amazon.com/sagemaker/).
1. Dans le panneau de navigation de gauche, sélectionnez **Configurations d’administrateur**. Sous **Configurations d’administrateur**, sélectionnez **Domaines**.
1. Sur la page **Domaines**, sélectionnez le domaine contenant le profil utilisateur auquel vous souhaitez ajouter des balises personnalisées.
1. Sur la page **Détails du domaine**, sélectionnez l’onglet **Profils utilisateur**.
1. Dans l’onglet **Profils utilisateur**, sélectionnez le profil utilisateur auquel vous souhaitez ajouter des balises personnalisées.
1. Dans l’onglet **Détails de l’utilisateur**, accédez à la section **Détails**.
1. Tâche de sélection **Modifier**.
1. Dans la section **Balises**, sélectionnez **Ajouter une balise**. Ajoutez une paire clé/valeur pour la balise personnalisée.
1. Sélectionnez **Soumettre**. Cette balise personnalisée est désormais propagée aux ressources d' SageMaker IA créées dans le domaine.
### Ajoutez à l'aide du AWS CLI
Après avoir activé la propagation des balises personnalisées, vous pouvez ajouter des balises personnalisées AWS CLI au niveau du domaine, du profil utilisateur ou de l'espace lors de la création ou de la mise à jour. La méthode d’ajout des balises personnalisées varie selon que vous créez une nouvelle ressource ou que vous ajoutez des balises à une ressource existante.
L’exemple suivant montre comment ajouter des balises personnalisées au niveau du domaine lors de la création.
```
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
```
Vous devez utiliser l'[AddTags](https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_AddTags.html)API pour ajouter des balises personnalisées pour le domaine, le profil utilisateur et les espaces existants, comme suit.
```
aws sagemaker add-tags \
--resource-arn resource-arn-to-attach-tags \
--tags Key=key, Value=value
```