Descrição de uma coleção - Amazon Rekognition

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á.

Descrição de uma coleção

Você pode usar a operação DescribeCollection para obter as seguintes informações sobre uma coleção:

  • O número de faces que são indexados na coleção.

  • A versão do modelo de face mais recente sendo usado com a coleção. Para obter mais informações, consulte Versionamento de modelo.

  • O nome de recurso da Amazon (ARN) da coleção.

  • A data e a hora da criação da coleção.

Para descrever uma coleção (SDK)

  1. Se ainda não tiver feito isso:

    1. Criar ou atualizar um usuário do IAM comAmazonRekognitionFullAccesspermissões. Para obter mais informações, consulte Etapa 1: Configurar uma conta da AWS e crie um usuário do IAM.

    2. Instale e configure a AWS CLI e os SDKs da AWS. Para obter mais informações, consulte Etapa 2: Configurar aAWS CLIeAWSSDKs da.

  2. Use os exemplos a seguir para chamar a operação DescribeCollection.

    Java

    Este exemplo descreve uma coleção.

    Altere o valor de collectionId para o ID da coleção desejada.

    //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.) package com.amazonaws.samples; import com.amazonaws.services.rekognition.AmazonRekognition; import com.amazonaws.services.rekognition.AmazonRekognitionClientBuilder; import com.amazonaws.services.rekognition.model.DescribeCollectionRequest; import com.amazonaws.services.rekognition.model.DescribeCollectionResult; public class DescribeCollection { public static void main(String[] args) throws Exception { String collectionId = "CollectionID"; AmazonRekognition rekognitionClient = AmazonRekognitionClientBuilder.defaultClient(); System.out.println("Describing collection: " + collectionId ); DescribeCollectionRequest request = new DescribeCollectionRequest() .withCollectionId(collectionId); DescribeCollectionResult describeCollectionResult = rekognitionClient.describeCollection(request); System.out.println("Collection Arn : " + describeCollectionResult.getCollectionARN()); System.out.println("Face count : " + describeCollectionResult.getFaceCount().toString()); System.out.println("Face model version : " + describeCollectionResult.getFaceModelVersion()); System.out.println("Created : " + describeCollectionResult.getCreationTimestamp().toString()); } }
    Java V2

    Este código é capturado segundo oAWSExemplos de SDK de documentação do repositório GitHub. Veja o exemplo completoaqui.

    public static void describeColl(RekognitionClient rekClient, String collectionName) { try { DescribeCollectionRequest describeCollectionRequest = DescribeCollectionRequest.builder() .collectionId(collectionName) .build(); DescribeCollectionResponse describeCollectionResponse = rekClient.describeCollection(describeCollectionRequest); System.out.println("Collection Arn : " + describeCollectionResponse.collectionARN()); System.out.println("Created : " + describeCollectionResponse.creationTimestamp().toString()); } catch(RekognitionException e) { System.out.println(e.getMessage()); System.exit(1); } }
    AWS CLI

    Esse comando da AWS CLI exibe a saída JSON da operação da CLI describe-collection. Altere o valor de collection-id para o ID da coleção desejada.

    aws rekognition describe-collection --collection-id collectionname
    Python

    Este exemplo descreve uma coleção.

    Altere o valor de collection_id para o ID da coleção desejada.

    #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 from botocore.exceptions import ClientError def describe_collection(collection_id): print('Attempting to describe collection ' + collection_id) client=boto3.client('rekognition') try: response=client.describe_collection(CollectionId=collection_id) print("Collection Arn: " + response['CollectionARN']) print("Face Count: " + str(response['FaceCount'])) print("Face Model Version: " + response['FaceModelVersion']) print("Timestamp: " + str(response['CreationTimestamp'])) except ClientError as e: if e.response['Error']['Code'] == 'ResourceNotFoundException': print ('The collection ' + collection_id + ' was not found ') else: print ('Error other than Not Found occurred: ' + e.response['Error']['Message']) print('Done...') def main(): collection_id='MyCollection' describe_collection(collection_id) if __name__ == "__main__": main()
    .NET

    Este exemplo descreve uma coleção.

    Altere o valor de collectionId para o ID da coleção desejada.

    //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.) using System; using Amazon.Rekognition; using Amazon.Rekognition.Model; public class DescribeCollection { public static void Example() { AmazonRekognitionClient rekognitionClient = new AmazonRekognitionClient(); String collectionId = "CollectionID"; Console.WriteLine("Describing collection: " + collectionId); DescribeCollectionRequest describeCollectionRequest = new DescribeCollectionRequest() { CollectionId = collectionId }; DescribeCollectionResponse describeCollectionResponse = rekognitionClient.DescribeCollection(describeCollectionRequest); Console.WriteLine("Collection ARN: " + describeCollectionResponse.CollectionARN); Console.WriteLine("Face count: " + describeCollectionResponse.FaceCount); Console.WriteLine("Face model version: " + describeCollectionResponse.FaceModelVersion); Console.WriteLine("Created: " + describeCollectionResponse.CreationTimestamp); } }
    Node.js
    import { DescribeCollectionCommand } from "@aws-sdk/client-rekognition"; import { RekognitionClient } from "@aws-sdk/client-rekognition"; import { stringify } from "querystring"; // Set the AWS Region. const REGION = "region"; //e.g. "us-east-1" const rekogClient = new RekognitionClient({ region: REGION }); // Name the collection const collection_name = "collectionName" const resourceArn = "resourceArn" const describeCollection = async (collectionName) => { try { console.log(`Attempting to describe collection named - ${collectionName}`) var response = await rekogClient.send(new DescribeCollectionCommand({CollectionId: collectionName})) console.log('Collection Arn:') console.log(response.CollectionARN) console.log('Face Count:') console.log(response.FaceCount) console.log('Face Model Version:') console.log(response.FaceModelVersion) console.log('Timestamp:') console.log(response.CreationTimestamp) return response; // For unit tests. } catch (err) { console.log("Error", err.stack); } }; describeCollection(collection_name)

Solicitação da operação DescribeCollection

A entrada para DescribeCollection é o ID da coleção desejada, conforme mostrado no exemplo JSON a seguir.

{ "CollectionId": "MyCollection" }

Resposta da operação DescribeCollection

A resposta inclui:

  • O número de faces que são indexados na coleção, FaceCount.

  • A versão do último modelo facial que está sendo usada com a coleção,FaceModelVersion. Para obter mais informações, consulte Versionamento de modelo.

  • A coleção do nome de recurso da Amazon, CollectionARN.

  • A data e a hora da criação da coleção, CreationTimestamp. O valor de CreationTimestamp é o número de milissegundos desde o horário Unix até a criação da coleção. O horário epoch Unix é 00:00:00 UTC (Tempo Universal Coordenado), quinta-feira, 1° de janeiro de 1970. Para obter mais informações, consulte Hora Unix.

{ "CollectionARN": "arn:aws:rekognition:us-east-1:nnnnnnnnnnnn:collection/MyCollection", "CreationTimestamp": 1.533422155042E9, "FaceCount": 200, "FaceModelVersion": "1.0" }