Creación de una colección

Puede utilizar la operación CreateCollection para crear una colección.

Para obtener más información, consulte Administración de colecciones.

Para crear una colección (SDK)

1. Si aún no lo ha hecho:

   1. Crear o actualizar un usuario de IAM conAmazonRekognitionFullAccesspermisos. Para obtener más información, consulte Paso 1: Configurar una cuenta de AWS y crear un usuario de IAM.

   2. Instale y configure la AWS CLI y los AWS SDK. Para obtener más información, consulte Paso 2: Configurar laAWS CLIyAWSSDK de.

2. Utilice los siguientes ejemplos para llamar a la operación CreateCollection.

   Java

   En el siguiente ejemplo se crea una colección y se muestra el nombre de recurso de Amazon (ARN).

   Cambie el valor de collectionId por el nombre de la colección que desea crear.

   //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 se toma desde laAWSDocumentación Ejemplos del SDK repositorio de GitHub. Ver el ejemplo completoaquí.

       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

   Este comando de la AWS CLI muestra la salida de JSON para la operación create-collection de la CLI.

   Reemplace el valor de collection-id por el nombre de la colección que desea crear.

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

   Python

   En el siguiente ejemplo se crea una colección y se muestra el nombre de recurso de Amazon (ARN).

   Cambie el valor de collection_id por el nombre de la colección que desea crear.

   #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

   En el siguiente ejemplo se crea una colección y se muestra el nombre de recurso de Amazon (ARN).

   Cambie el valor de collectionId por el nombre de la colección que desea crear.

   //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

   En el siguiente ejemplo, sustituya el valor deregioncon el nombre de la región asociada a tu cuenta y reemplaza el valor decollectionNamecon el nombre deseado de tu colección.

   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)

Solicitud de operación CreateCollection

La entrada de CreationCollection es el nombre de la colección que desea crear.

{
    "CollectionId": "MyCollection"
}

Respuesta de la operación CreateCollection

Amazon Rekognition crea la colección y devuelve el nombre de recurso de Amazon (ARN) de la colección que se acaba de crear.

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