Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

# Etiquetado de colecciones
<a name="tag-collections"></a>

Puede usar etiquetas para identificar, organizar, buscar y filtrar sus colecciones de Amazon Rekognition mediante etiquetas. Cada etiqueta es una marca que consta de una clave y un valor definidos por el usuario.

También puede utilizar etiquetas para controlar el acceso a una colección mediante la Administración de identidad y acceso (IAM). Para obtener más información, consulte [Controlar el acceso a AWS los recursos mediante etiquetas de recursos](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_tags.html).

**Topics**
+ [Agregar etiquetas a una colección nueva](#add-tag-new-collection)
+ [Agregar etiquetas a una colección existente](#add-tag-existing-collection)
+ [Enumerar las etiquetas de una colección](#list-tags-collection)
+ [Eliminar etiquetas de una colección](#delete-tag-collection)

## Agregar etiquetas a una colección nueva
<a name="add-tag-new-collection"></a>

Puede agregar etiquetas a una colección a medida que la crea mediante la operación `CreateCollection`. Indique una o varias etiquetas en el parámetro de entrada `Tags` de la matriz.

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

 Sustituya el valor de `profile_name` de por el nombre de su perfil de desarrollador. 

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

Para los dispositivos de Windows:

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

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

 Sustituya el valor de `profile_name` en la línea que crea la sesión de Rekognition por el nombre de su perfil de desarrollador. 

```
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()
```

------

## Agregar etiquetas a una colección existente
<a name="add-tag-existing-collection"></a>

Para agregar una o varias etiquetas a una colección existente, utilice la operación `TagResource`. Indique el nombre de recurso de Amazon (ARN) de la colección (`ResourceArn`) y las etiquetas (`Tags`) que desea añadir. En el siguiente ejemplo se ve cómo añadir dos etiquetas.

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

 Sustituya el valor de `profile_name` de por el nombre de su perfil de desarrollador. 

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

 Para los dispositivos de Windows: 

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

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

 Sustituya el valor de `profile_name` en la línea que crea la sesión de Rekognition por el nombre de su perfil de desarrollador. 

```
# 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()
```

------

**nota**  
Si no conoce el nombre del recurso de Amazon de la colección, puede usar la operación `DescribeCollection`.

## Enumerar las etiquetas de una colección
<a name="list-tags-collection"></a>

Para enumerar las etiquetas adjuntas a una colección, utilice la operación `ListTagsForResource` y especifique el ARN de la colección (`ResourceArn`). El resultado será la asignación de las claves y los valores de las etiquetas que se asocian a la colección especificada.

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

 Sustituya el valor de `profile_name` de por el nombre de su perfil de desarrollador. 

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

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

 Sustituya el valor de `profile_name` en la línea que crea la sesión de Rekognition por el nombre de su perfil de desarrollador. 

```
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()
```

------

El resultado muestra una lista de etiquetas adjuntas a la colección:

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

## Eliminar etiquetas de una colección
<a name="delete-tag-collection"></a>

Para eliminar una o más etiquetas de una colección, utilice la operación `UntagResource`. Indique el ARN del modelo (`ResourceArn`) y las claves de etiqueta (`Tag-Keys`) que desee eliminar.

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

Sustituya el valor de `profile_name` de por el nombre de su perfil de desarrollador.

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

Si lo prefiere, también puede indicar claves de etiqueta en este formato:

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

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

 Sustituya el valor de `profile_name` en la línea que crea la sesión de Rekognition por el nombre de su perfil de desarrollador. 

```
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()
```

------