Ajout de balises personnalisées aux ressources - Amazon SageMaker AI
PrérequisInscription à la propagation des balises personnaliséesAjout de balises personnalisées

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.

Prérequis

  • Les utilisateurs doivent disposer de l’autorisation sagemaker:AddTags pour toute création de ressource.

    • Pour les nouveaux domaines créés avec la politique gérée SageMakerFullAccess ou à l’aide du Gestionnaire de rôles SageMaker, l’autorisation sagemaker:AddTags est préremplie.

    • Pour les domaines existants utilisant des politiques Gestion des identités et des accès AWS personnalisées, vous devez mettre à jour les politiques afin d’inclure l’autorisation sagemaker:AddTags 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. Depuis l’AWS CLI, vous ne pouvez vous inscrire à la propagation des balises personnalisées qu’en créant un domaine ou en mettant à jour 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.

Inscription à l’aide de l’AWS CLI

Pour vous inscrire à la propagation des balises personnalisées à l’aide de l’AWS CLI, utilisez l’attribut TagPropagation dans les API CreateDomain et UpdateDomain. 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. Sélectionnez Save. Cette balise personnalisée est désormais propagée aux ressources SageMaker AI 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 SageMaker AI créées dans le domaine.

Ajout à l’aide de l’AWS CLI

Après avoir activé la propagation des balises personnalisées, vous pouvez ajouter des balises personnalisées à l’aide de l’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’API AddTags 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