As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.
Aplicação de tags nas coleções
Você pode identificar, organizar, pesquisar e filtrar coleções do Amazon Rekognition usando tags. Cada tag é um rótulo que consiste em um valor e uma chave definida pelo usuário.
Você também pode usar tags para controlar o acesso a uma coleção usando o Identity and Access Management (IAM). Para obter mais informações, consulte Controle do acesso aos AWS recursos usando tags de recursos.
Adicionar tags a uma nova coleção
Você pode adicionar tags a uma coleção ao criá-la usando a operação CreateCollection. Especifique uma ou mais tags no parâmetro Tags de entrada da matriz.
- AWS CLI
-
Substitua o valor de profile_name com o nome do seu perfil de desenvolvedor.
aws rekognition create-collection --collection-id "collection-name" --tags "{"key1":"value1","key2":"value2"}" --profile profile-name
Para dispositivos Windows:
aws rekognition create-collection --collection-id "collection-name" --tags "{\"key1\":\"value1\",\"key2\":\"value2\"}" --profile profile-name
- Python
-
Substitua o valor de profile_name na linha que cria a sessão do Rekognition pelo nome do seu perfil de desenvolvedor.
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()
Adicionar tags a uma coleção existente
Para adicionar uma ou mais tags a uma coleção existente, use a operação TagResource. Especifique o nome do recurso da Amazon (ARN) (ResourceArn) e as tags (Tags) da coleção que você deseja adicionar. O exemplo a seguir mostra como adicionar duas tags.
- AWS CLI
-
Substitua o valor de profile_name com o nome do seu perfil de desenvolvedor.
aws rekognition tag-resource --resource-arn collection-arn --tags "{"key1":"value1","key2":"value2"}" --profile profile-name
Para dispositivos Windows:
aws rekognition tag-resource --resource-arn collection-arn --tags "{\"key1\":\"value1\",\"key2\":\"value2\"}" --profile profile-name
- Python
-
Substitua o valor de profile_name na linha que cria a sessão do Rekognition pelo nome do seu perfil de desenvolvedor.
# 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()
Se você não souber o nome do recurso da Amazon da coleção, poderá usar a operação DescribeCollection.
Para listar as tags anexadas a uma coleção, use a operação ListTagsForResource e especifique o ARN da coleção (ResourceArn). A resposta é um mapa de chaves e valores de tags anexados à coleção especificada.
- AWS CLI
-
Substitua o valor de profile_name com o nome do seu perfil de desenvolvedor.
aws rekognition list-tags-for-resource --resource-arn resource-arn --profile profile-name
- Python
-
Substitua o valor de profile_name na linha que cria a sessão do Rekognition pelo nome do seu perfil de desenvolvedor.
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()
A saída exibe uma lista de tags anexadas à coleção:
{
"Tags": {
"Dept": "Engineering",
"Name": "Ana Silva Carolina",
"Role": "Developer"
}
}
Excluir tags de uma coleção
Para remover uma ou mais tags de uma coleção, use a operação UntagResource. Especifique o ARN do modelo (ResourceArn) e das chaves de tag (Tag-Keys) que você deseja remover.
- AWS CLI
-
Substitua o valor de profile_name com o nome do seu perfil de desenvolvedor.
aws rekognition untag-resource --resource-arn resource-arn --profile profile-name --tag-keys "key1" "key2"
Como alternativa, você pode especificar chaves de tag neste formato:
--tag-keys key1,key2
- Python
-
Substitua o valor de profile_name na linha que cria a sessão do Rekognition pelo nome do seu perfil de desenvolvedor.
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()
