Criar uma coleção

Você pode usar a operação CreateCollection para criar uma coleção.

Para obter mais informações, consulte Gerenciar coleções.

Para criar 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 CreateCollection.

   Java

   O exemplo a seguir cria uma coleção e exibe o Amazon Resource Name (ARN – Nome de recurso da Amazon).

   Altere o valor de collectionId para o nome da coleção que você deseja criar.

   //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 aws.example.rekognition.image;
   
   import com.amazonaws.services.rekognition.AmazonRekognition;
   import com.amazonaws.services.rekognition.AmazonRekognitionClientBuilder;
   import com.amazonaws.services.rekognition.model.CreateCollectionRequest;
   import com.amazonaws.services.rekognition.model.CreateCollectionResult;
   
   
   public class CreateCollection {
   
      public static void main(String[] args) throws Exception {
   
   
         AmazonRekognition rekognitionClient = AmazonRekognitionClientBuilder.defaultClient();
   
         
         String collectionId = "MyCollection";
               System.out.println("Creating collection: " +
            collectionId );
               
           CreateCollectionRequest request = new CreateCollectionRequest()
                       .withCollectionId(collectionId);
              
         CreateCollectionResult createCollectionResult = rekognitionClient.createCollection(request); 
         System.out.println("CollectionArn : " +
            createCollectionResult.getCollectionArn());
         System.out.println("Status code : " +
            createCollectionResult.getStatusCode().toString());
   
      } 
   
   }
       
   
   

   Java V2

   Este código é capturado segundo oAWSExemplos do repositório do GitHub do. Veja o exemplo completoaqui.

       public static void createMyCollection(RekognitionClient rekClient,String collectionId ) {
   
           try {
               CreateCollectionRequest collectionRequest = CreateCollectionRequest.builder()
                       .collectionId(collectionId)
                       .build();
   
               CreateCollectionResponse collectionResponse = rekClient.createCollection(collectionRequest);
               System.out.println("CollectionArn : " +
                       collectionResponse.collectionArn());
               System.out.println("Status code : " +
                       collectionResponse.statusCode().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 create-collection.

   Substitua o valor de collection-id pelo nome da coleção que você deseja criar.

   aws rekognition create-collection \
       --collection-id "collectionname"

   Python

   O exemplo a seguir cria uma coleção e exibe o Amazon Resource Name (ARN – Nome de recurso da Amazon).

   Altere o valor de collection_id para o nome da coleção que você deseja criar.

   #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_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='Collection'
       create_collection(collection_id)
   
   if __name__ == "__main__":
       main()    
   

   .NET

   O exemplo a seguir cria uma coleção e exibe o Amazon Resource Name (ARN – Nome de recurso da Amazon).

   Altere o valor de collectionId para o nome da coleção que você deseja criar.

   //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 CreateCollection
   {
       public static void Example()
       {
           AmazonRekognitionClient rekognitionClient = new AmazonRekognitionClient();
   
           String collectionId = "MyCollection";
           Console.WriteLine("Creating collection: " + collectionId);
   
           CreateCollectionRequest createCollectionRequest = new CreateCollectionRequest()
           {
               CollectionId = collectionId
           };
   
           CreateCollectionResponse createCollectionResponse = rekognitionClient.CreateCollection(createCollectionRequest);
           Console.WriteLine("CollectionArn : " + createCollectionResponse.CollectionArn);
           Console.WriteLine("Status code : " + createCollectionResponse.StatusCode);
   
       }
   }
   

   Node.JS

   No exemplo a seguir, substitua o valor deregioncom o nome da região associada à sua conta e substitua o valor decollectionNamecom o nome desejado da sua coleção.

   import { CreateCollectionCommand} from  "@aws-sdk/client-rekognition";
   import  { RekognitionClient } from "@aws-sdk/client-rekognition";
   
   // Set the AWS Region.
   const REGION = "region"; //e.g. "us-east-1"
   const rekogClient = new RekognitionClient({ region: REGION });
   
   // Name the collecction
   const collection_name = "collectionName"
   
   const createCollection = async (collectionName) => {
       try {
          console.log(`Creating collection: ${collectionName}`)
          const data = await rekogClient.send(new CreateCollectionCommand({CollectionId: collectionName}));
          console.log("Collection ARN:")
          console.log(data.CollectionARN)
          console.log("Status Code:")
          console.log(String(data.StatusCode))
          console.log("Success.",  data);
          return data;
       } catch (err) {
         console.log("Error", err.stack);
       }
     };
   
     createCollection(collection_name)

Solicitação da operação CreateCollection

A entrada para CreationCollection é o nome da coleção que você deseja criar.

{
    "CollectionId": "MyCollection"
}

Resposta da operação CreateCollection

O Amazon Rekognition cria a coleção e retorna o Nome de recurso da Amazon (ARN) da coleção recém-criada.

{
   "CollectionArn": "aws:rekognition:us-east-1:acct-id:collection/examplecollection",
   "StatusCode": 200
}