Ajouter des balises aux ressources Amazon Personalize

Vous pouvez ajouter, afficher, mettre à jour et supprimer des clés et des valeurs de balise dans les ressources Amazon Personalize à l'aide de la console Amazon Personalize, AWS Command Line Interface (AWS CLI), ou AWS SDKs. Les exemples suivants montrent comment ajouter une balise au groupe de jeux de données Amazon Personalize. Vous pouvez ajouter des balises à d'autres ressources Amazon Personalize de la même manière.

Ajouter des tags (console)

Lorsque vous créez une ressource dans Amazon Personalize, vous pouvez ajouter des balises facultatives à l'aide de la console Amazon Personalize. L'exemple suivant ajoute une balise à un groupe de jeux de données.

L'ajout de balises à une ressource existante est similaire : choisissez votre ressource et utilisez les champs Tags pour ajouter vos balises.

Ajouter des tags (AWS CLI)

Vous pouvez utiliser le AWS Command Line Interface (AWS CLI) pour ajouter des balises lorsque vous créez une ressource ou ajoutez des balises à une ressource existante.

Ajouter des balises lors de la création d'une ressource

Pour créer une nouvelle ressource et y ajouter une balise avec le AWS CLI, utilisez la create commande appropriée pour la ressource et incluez le tags paramètre et les valeurs. Par exemple, la commande suivante crée un nouveau groupe de jeux de données de domaine nommé myDatasetGroup d'après le domaine ECOMMERCE et ajoute les balises suivantes : une clé de Environment balise avec une valeur de Test balise, et une clé de Owner balise et une xyzCorp valeur.

aws personalize create-dataset-group \
--name myDatasetGroup \
--domain ECOMMERCE \
--tags tagKey=Environment,tagValue=Test tagKey=Owner,tagValue=xyzCorp

Pour plus d'informations sur les commandes que vous pouvez utiliser pour créer une ressource Amazon Personalize, consultez le manuel Amazon Personalize AWS CLI Command Reference.

Ajout de balises à une ressource existante

Pour ajouter une balise à une ressource existante, utilisez la tag-resource commande. Spécifiez l'ARN de la ressource et indiquez la clé de balise et la valeur dans le tags paramètre.

aws personalize tag-resource \
--resource-arn resource ARN \
--tags tagKey=key,tagValue=value

Ajouter des tags (AWS SDKs)

Vous pouvez utiliser le AWS SDKs pour ajouter des balises lorsque vous créez une ressource ou pour ajouter des balises à une ressource existante.

Ajouter des balises lors de la création d'une ressource

Pour créer une nouvelle ressource et y ajouter une étiquette avec le AWS SDKs, utilisez la create méthode appropriée. Utilisez le tags paramètre pour spécifier les paires clé-valeur pour chacune de vos balises. Par exemple, le code suivant crée un nouveau groupe de jeux de données de domaine nommé myDatasetGroup d'après le domaine ECOMMERCE et ajoute les balises suivantes : une clé de Environment balise avec une valeur de Test balise, et une clé de Owner balise et une xyzCorp valeur.

import boto3

personalize = boto3.client('personalize')

response = personalize.create_dataset_group(
  name = 'myDatasetGroup',
  domain = 'ECOMMERCE',
  tags = [
    {
      'tagKey': 'Environment',
      'tagValue': 'Test'
    },
    {
      'tagKey': 'Owner',
      'tagValue': 'xyzCorp'    
    }
  ]    
)
dsg_arn = response['datasetGroupArn']

description = personalize.describe_dataset_group(datasetGroupArn = dsg_arn)['datasetGroup']

print('Name: ' + description['name'])
print('ARN: ' + description['datasetGroupArn'])
print('Status: ' + description['status'])

Ajout de balises à une ressource existante

Le code suivant montre comment ajouter une balise à une ressource Amazon Personalize existante. Spécifiez le nom de ressource Amazon (ARN) de la ressource à laquelle vous souhaitez ajouter des balises et spécifiez des paires clé-valeur pour chacune de vos balises.

import boto3
personalize = boto3.client('personalize')

add_tags_response = personalize.tag_resource(
  resourceArn = "resourceArn",
  tags = [
    {
      'tagKey': 'Environment',
      'tagValue': 'Test'
    },
    {
      'tagKey': 'Owner',
      'tagValue': 'xyzCorp'    
    }
  ]    
)