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.

# Baliser des collections
<a name="tag-collections"></a>

Vous pouvez identifier, organiser, rechercher et filtrer les collections Amazon Rekognition à l’aide de balises. Chaque balise est une étiquette composée d’une clé définie par l’utilisateur et d’une valeur.

Vous pouvez également utiliser des balises pour contrôler l’accès à une collection à l’aide de Identity and Access Management (IAM). Pour plus d'informations, consultez la section [Contrôle de l'accès aux AWS ressources à l'aide de balises de ressources](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_tags.html).

**Topics**
+ [Ajouter des balises à une nouvelle collection](#add-tag-new-collection)
+ [Ajouter des balises à une collection existante](#add-tag-existing-collection)
+ [Répertorier les balises d’une collection](#list-tags-collection)
+ [Supprimer des balises d’une collection](#delete-tag-collection)

## Ajouter des balises à une nouvelle collection
<a name="add-tag-new-collection"></a>

Vous pouvez ajouter des balises à une collection lors de sa création à l’aide de l’opération `CreateCollection`. Spécifiez une ou plusieurs balises dans le paramètre d’entrée du tableau `Tags`.

------
#### [ AWS CLI ]

 Remplacez la valeur de `profile_name` par le nom de votre profil de développeur. 

```
aws rekognition create-collection --collection-id "collection-name" --tags "{"key1":"value1","key2":"value2"}" --profile profile-name 
```

Pour les appareils Windows :

```
aws rekognition create-collection --collection-id "collection-name" --tags "{\"key1\":\"value1\",\"key2\":\"value2\"}" --profile profile-name
```

------
#### [ Python ]

 Remplacez la valeur de `profile_name` dans la ligne qui crée la session de Rekognition par le nom de votre profil de développeur. 

```
import boto3

def create_collection(collection_id):
    client = boto3.client('rekognition')

    # Create a collection
    print('Creating collection:' + collection_id)
    response = client.create_collection(CollectionId=collection_id)
    print('Collection ARN: ' + response['CollectionArn'])
    print('Status code: ' + str(response['StatusCode']))
    print('Done...')

def main():
    collection_id = 'NewCollectionName'
    create_collection(collection_id)

if __name__ == "__main__":
    main()
```

------

## Ajouter des balises à une collection existante
<a name="add-tag-existing-collection"></a>

Pour ajouter une ou plusieurs balises à une collection existante, utilisez l’opération `TagResource`. Spécifiez l’Amazon Resource Name (ARN) (`ResourceArn`) de la collection et les balises (`Tags`) que vous voulez ajouter. L’exemple suivant vous montre comment ajouter deux balises.

------
#### [ AWS CLI ]

 Remplacez la valeur de `profile_name` par le nom de votre profil de développeur. 

```
aws rekognition tag-resource --resource-arn collection-arn --tags "{"key1":"value1","key2":"value2"}" --profile profile-name 
```

 Pour les appareils Windows : 

```
aws rekognition tag-resource --resource-arn collection-arn --tags "{\"key1\":\"value1\",\"key2\":\"value2\"}" --profile profile-name
```

------
#### [ Python ]

 Remplacez la valeur de `profile_name` dans la ligne qui crée la session de Rekognition par le nom de votre profil de développeur. 

```
# Copyright 2018 Amazon.com, Inc. or its affiliates. All Rights Reserved.
# PDX-License-Identifier: MIT-0 (For details, see https://github.com/awsdocs/amazon-rekognition-developer-guide/blob/master/LICENSE-SAMPLECODE.)

import boto3

def create_tag(collection_id):
    session = boto3.Session(profile_name='default')
    client = session.client('rekognition')
    response = client.tag_resource(ResourceArn=collection_id,
                                   Tags={
                                       "KeyName": "ValueName"
                                   })
    print(response)
    if "'HTTPStatusCode': 200" in str(response):
        print("Success!!")

def main():
    collection_arn = "collection-arn"
    create_tag(collection_arn)

if __name__ == "__main__":
    main()
```

------

**Note**  
Si vous ne connaissez pas le nom de la ressource Amazon de la collection, vous pouvez utiliser l’opération `DescribeCollection`.

## Répertorier les balises d’une collection
<a name="list-tags-collection"></a>

Pour répertorier les balises attachées à une collection, utilisez l’opération `ListTagsForResource` et spécifiez l’ARN de la collection (`ResourceArn`). La réponse est une carte des clés de balise et des valeurs attachées à la collection spécifiée.

------
#### [ AWS CLI ]

 Remplacez la valeur de `profile_name` par le nom de votre profil de développeur. 

```
aws rekognition list-tags-for-resource --resource-arn resource-arn --profile profile-name
```

------
#### [ Python ]

 Remplacez la valeur de `profile_name` dans la ligne qui crée la session de Rekognition par le nom de votre profil de développeur. 

```
import boto3

def list_tags():
    client = boto3.client('rekognition')
    response = client.list_tags_for_resource(ResourceArn="arn:aws:rekognition:region-name:5498347593847598:collection/NewCollectionName")
    print(response)

def main():
    list_tags()

if __name__ == "__main__":
    main()
```

------

La sortie affiche une liste de balises attachées à la collection :

```
                {
    "Tags": {
        "Dept": "Engineering",
        "Name": "Ana Silva Carolina",
        "Role": "Developer"
    }
}
```

## Supprimer des balises d’une collection
<a name="delete-tag-collection"></a>

Pour supprimer une ou plusieurs balises d’une collection, utilisez l’opération `UntagResource`. Spécifiez l’ARN du modèle (`ResourceArn`) et les clés de balise (`Tag-Keys`) que vous souhaitez supprimer.

------
#### [ AWS CLI ]

Remplacez la valeur de `profile_name` par le nom de votre profil de développeur.

```
aws rekognition untag-resource --resource-arn resource-arn --profile profile-name --tag-keys "key1" "key2"
```

Vous pouvez aussi spécifier les clés de balise dans ce format :

```
--tag-keys key1,key2
```

------
#### [ Python ]

 Remplacez la valeur de `profile_name` dans la ligne qui crée la session de Rekognition par le nom de votre profil de développeur. 

```
import boto3

def list_tags():
    client = boto3.client('rekognition')
    response = client.untag_resource(ResourceArn="arn:aws:rekognition:region-name:5498347593847598:collection/NewCollectionName", TagKeys=['KeyName'])
    print(response)

def main():
    list_tags()

if __name__ == "__main__":
    main()
```

------