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 aux ressources Amazon Personalize
<a name="tags-add"></a>

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. 

**Topics**
+ [Ajouter des tags (console)](#add-tag-console)
+ [Ajouter des tags (AWS CLI)](#add-tag-cli)
+ [Ajouter des tags (AWS SDKs)](#add-tag-sdk)

## Ajouter des tags (console)
<a name="add-tag-console"></a>



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 [https://console.aws.amazon.com/personalize/chez](https://console.aws.amazon.com/personalize/home) vous et connectez-vous à votre compte.

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

1. Pour **Nom**, entrez un nom.

1. Pour **Domaine**, choisissez un domaine.

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

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

   Par exemple, respectivement, **Environment** et **Test**.

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

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

1. 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)
<a name="add-tag-cli"></a>

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.

**Topics**
+ [Ajouter des balises lors de la création d'une ressource](#create-resource-with-tags-cli)
+ [Ajout de balises à une ressource existante](#add-tag-existing-resource-cli)

### Ajouter des balises lors de la création d'une ressource
<a name="create-resource-with-tags-cli"></a>

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](https://docs.aws.amazon.com/cli/latest/reference/personalize/).

### Ajout de balises à une ressource existante
<a name="add-tag-existing-resource-cli"></a>

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)
<a name="add-tag-sdk"></a>

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

**Topics**
+ [Ajouter des balises lors de la création d'une ressource](#create-resource-with-tags-sdk)
+ [Ajout de balises à une ressource existante](#add-tag-existing-resource-sdk)

### Ajouter des balises lors de la création d'une ressource
<a name="create-resource-with-tags-sdk"></a>

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. 

------
#### [ 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
<a name="add-tag-existing-resource-sdk"></a>

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 "";
}
```

------