View a markdown version of this page

Etiquetado de colecciones - Amazon Rekognition

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

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.

Agregar etiquetas a una colección nueva

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

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

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

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