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 des SDK. 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.

Pour ajouter des balises à un nouveau groupe de jeux de données

1. Ouvrez la console Amazon Personalize à l'adresse https://console.aws.amazon.com/personalize/home et connectez-vous à votre compte.

2. Choisissez Create dataset group (Créer un groupe d'ensembles de données).

3. Pour Nom, entrez un nom.

4. Pour Domaine, choisissez un domaine.

5. Développez la section Tags et choisissez Ajouter un nouveau tag.

6. Pour Clé et Valeur, entrez les valeurs appropriées.

   Par exemple, respectivement, Environment et Test.

7. Pour ajouter d'autres balises, choisissez Ajouter une nouvelle étiquette.

   Vous pouvez ajouter jusqu'à 50 balises à une ressource.

8. Choisissez Next pour continuer à créer votre ressource.

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.

Rubriques

• Ajouter des balises lors de la création d'une ressource
• Ajout de 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 balises (AWS SDK)

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

Rubriques

• Ajouter des balises lors de la création d'une ressource
• Ajout de 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 les AWS SDK, 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.

SDK for Python (Boto3)

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'])

SDK for Java 2.x

public static String createDomainDatasetGroup(PersonalizeClient personalizeClient, 
                                              String datasetGroupName,
                                              String domain) {
    
    try {
         
        ArrayList <Tag> tags = new ArrayList<>();

        Tag tag1 = Tag.builder()
                .tagKey("Environment")
                .tagValue("Test")
                .build();
        tags.add(tag1);
        Tag tag2 = Tag.builder()
                .tagKey("Owner")
                .tagValue("xyzCorp")
                .build();
        tags.add(tag2);
    
        CreateDatasetGroupRequest createDatasetGroupRequest = CreateDatasetGroupRequest.builder()
                .name(datasetGroupName)
                .domain(domain)
                .tags(tags)
                .build();
        return personalizeClient.createDatasetGroup(createDatasetGroupRequest).datasetGroupArn();
    } catch (PersonalizeException e) {
        System.out.println(e.awsErrorDetails().errorMessage());
    }
    return "";
}

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.

SDK for Python (Boto3)

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

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

SDK for Java 2.x

public static void tagResource(PersonalizeClient personalizeClient, 
                                              String resourceArn,
                                              String domain) {
    
    try {
         
         ArrayList <Tag> tagList = new ArrayList<>();

          Tag tag1 = Tag.builder()
                  .tagKey("Environment")
                  .tagValue("Test")
                  .build();
          tags.add(tag1);
          Tag tag2 = Tag.builder()
                  .tagKey("Owner")
                  .tagValue("xyzCorp")
                  .build();
          tags.add(tag2);
    
        TagResourceRequest tagResourceRequest = TagResourceRequest.builder()
                .resourceArn(resourceArn)
                .tags(tagList)
                .build();
                
        personalizeClient.tagResource(tagResourceRequest);
        System.out.println("Tags have been added to "+ resourceArn);
        
    } catch (PersonalizeException e) {
        System.out.println(e.awsErrorDetails().errorMessage());
    }
    return "";
}