Ajout de balises personnalisées aux ressources - Amazon SageMaker AI
Conditions préalablesInscription à la propagation des balises personnaliséesAjout de balises personnalisées

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:AddTagsautorisation est préremplie.

    • Pour les domaines existants utilisant des AWS Identity and Access Management politiques personnalisées, vous devez mettre à jour les politiques afin d'inclure l'sagemaker:AddTagsautorisation 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/.

  2. Dans le panneau de navigation de gauche, sélectionnez Configurations d’administrateur. Sous Configurations d’administrateur, sélectionnez Domaines.

  3. Sur la page Domaines, sélectionnez le domaine pour lequel vous souhaitez activer la propagation des balises personnalisées.

  4. Sur la page Domain details (Détails du domaine), sélectionnez l’onglet Domain settings (Paramètres du domaine).

  5. Dans l’onglet Paramètres du domaine, accédez à Propagation des balises personnalisées.

  6. Tâche de sélection Modifier.

  7. Sur la page Modifier la propagation des balises personnalisées, sélectionnez Propagation automatique des balises personnalisées

  8. 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'TagPropagationattribut dans le CreateDomainet UpdateDomain 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/.

  2. Dans le panneau de navigation de gauche, sélectionnez Configurations d’administrateur. Sous Configurations d’administrateur, sélectionnez Domaines.

  3. Sur la page Domaines, sélectionnez le domaine auquel vous souhaitez ajouter des balises personnalisées.

  4. Sur la page Domain details (Détails du domaine), sélectionnez l’onglet Domain settings (Paramètres du domaine).

  5. Dans l’onglet Paramètres du domaine, accédez à Balises.

  6. Tâche de sélection Modifier.

  7. Sur la page Balises, sélectionnez Ajouter une balise. Ajoutez une paire clé/valeur pour la balise personnalisée.

  8. 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/.

  2. Dans le panneau de navigation de gauche, sélectionnez Configurations d’administrateur. Sous Configurations d’administrateur, sélectionnez Domaines.

  3. Sur la page Domaines, sélectionnez le domaine contenant le profil utilisateur auquel vous souhaitez ajouter des balises personnalisées.

  4. Sur la page Détails du domaine, sélectionnez l’onglet Profils utilisateur.

  5. Dans l’onglet Profils utilisateur, sélectionnez le profil utilisateur auquel vous souhaitez ajouter des balises personnalisées.

  6. Dans l’onglet Détails de l’utilisateur, accédez à la section Détails.

  7. Tâche de sélection Modifier.

  8. Dans la section Balises, sélectionnez Ajouter une balise. Ajoutez une paire clé/valeur pour la balise personnalisée.

  9. 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'AddTagsAPI 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