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á.
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)
Se ainda não tiver feito isso:
Criar ou atualizar um usuário do IAM comAmazonRekognitionFullAccess
Permissões Para obter mais informações, consulte Etapa 1: Configurar uma conta da AWS e crie um usuário do IAM.
Instale e configure a AWS CLI e os SDKs da AWS. Para obter mais informações, consulte Etapa 2: Configurar aAWS CLIeAWSSDKs da.
-
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 deregion
com o nome da região associada à sua conta e substitua o valor decollectionName
com 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
}