Ajouter des balises personnalisées aux ressources - Amazon SageMaker AI
PrérequisOptez pour la propagation personnalisée des balisesAjouter des tags personnalisés

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.

Ajouter des balises personnalisées aux ressources

La page suivante décrit les étapes nécessaires à l'utilisation de la propagation de balises personnalisées. La propagation de balises personnalisées nécessite les étapes suivantes :

  • Optez pour la propagation personnalisée des balises

  • Ajouter des balises personnalisées aux ressources

Lorsque vous activez la propagation personnalisée des balises 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. Cependant, toute nouvelle ressource créée sera associée à la nouvelle balise.

Prérequis

  • Les utilisateurs doivent avoir l'sagemaker:AddTagsautorisation de créer des ressources.

    • 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.

Optez pour la propagation personnalisée des balises

Le processus d'activation de la propagation des balises personnalisées varie selon que vous vous inscrivez depuis la console ou depuis le. AWS CLI Depuis la console, vous ne pouvez activer 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.

Inscrivez-vous depuis la console

Les étapes suivantes expliquent comment activer la propagation personnalisée des balises depuis la console. Vous ne pouvez activer la propagation des balises personnalisées depuis la console 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 volet de navigation de gauche, sélectionnez Configurations d'administration. Sous Configurations d'administration, sélectionnez Domaines.

  3. Sur la page Domaines, sélectionnez le domaine pour lequel vous souhaitez activer la propagation de 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 de balises personnalisées.

  6. Tâche de sélection Modifier.

  7. Sur la page Modifier la propagation des balises personnalisées, sélectionnez Propager automatiquement les balises personnalisées

  8. Sélectionnez Submit (Envoyer).

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 estDISABLED. Une valeur vide est également définie par défaut sur. DISABLED L'exemple suivant montre comment activer la propagation de balises personnalisées. 

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

Ajouter des tags personnalisés

Le processus de propagation des balises personnalisées varie selon que vous les ajoutez depuis la console ou depuis le AWS CLI.

Ajouter depuis la console

Les étapes suivantes expliquent comment ajouter des balises personnalisées à un domaine à partir de la console.

  1. Ouvrez la console Amazon SageMaker AI à l'adresse https://console.aws.amazon.com/sagemaker/.

  2. Dans le volet de navigation de gauche, sélectionnez Configurations d'administration. Sous Configurations d'administration, 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 à Tags.

  6. Tâche de sélection Modifier.

  7. Sur la page Tags, sélectionnez Ajouter un tag. 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 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 volet de navigation de gauche, sélectionnez Configurations d'administration. Sous Configurations d'administration, 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 des 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 Tags, sélectionnez Ajouter un tag. Ajoutez une paire clé/valeur pour la balise personnalisée.

  9. Sélectionnez Submit (Envoyer). 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 de 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