Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.
# Création d’une collection
Vous pouvez utiliser l'opération [CreateCollection](https://docs.aws.amazon.com/rekognition/latest/APIReference/API_CreateCollection.html) pour créer une collection.
Pour de plus amples informations, veuillez consulter [Gérer une collection](managing-face-collections.md#managing-collections).
**Pour créer une collection (SDK)**
1. Si vous ne l’avez pas déjà fait :
1. Créez ou mettez à jour un utilisateur avec les autorisations `AmazonRekognitionFullAccess`. Pour de plus amples informations, veuillez consulter [Étape 1 : configurer un compte AWS et créer un utilisateur](setting-up.md#setting-up-iam).
1. Installez et configurez le AWS CLI et le AWS SDKs. Pour de plus amples informations, veuillez consulter [Étape 2 : configurer le AWS CLI et AWS SDKs](setup-awscli-sdk.md).
1. Utilisez les exemples suivants pour appeler l’opération `CreateCollection`.
------
#### [ Java ]
L’exemple suivant crée une collection et affiche son Amazon Resource Name (ARN).
Remplacez la valeur d’`collectionId` par le nom de la collection que vous souhaitez créer.
```
//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 ]
Ce code est extrait du GitHub référentiel d'exemples du SDK de AWS documentation. Voir l’exemple complet [ici](https://github.com/awsdocs/aws-doc-sdk-examples/blob/master/javav2/example_code/rekognition/src/main/java/com/example/rekognition/CreateCollection.java).
Remplacez la valeur de `profile_name` dans la ligne qui crée la session de Rekognition par le nom de votre profil de développeur.
```
//snippet-start:[rekognition.java2.create_collection.import]
import software.amazon.awssdk.auth.credentials.ProfileCredentialsProvider;
import software.amazon.awssdk.regions.Region;
import software.amazon.awssdk.services.rekognition.RekognitionClient;
import software.amazon.awssdk.services.rekognition.model.CreateCollectionResponse;
import software.amazon.awssdk.services.rekognition.model.CreateCollectionRequest;
import software.amazon.awssdk.services.rekognition.model.RekognitionException;
//snippet-end:[rekognition.java2.create_collection.import]
/**
* Before running this Java V2 code example, set up your development environment, including your credentials.
*
* For more information, see the following documentation topic:
*
* https://docs.aws.amazon.com/sdk-for-java/latest/developer-guide/get-started.html
*/
public class CreateCollection {
public static void main(String[] args) {
final String usage = "\n" +
"Usage: " +
" \n\n" +
"Where:\n" +
" collectionName - The name of the collection. \n\n";
if (args.length != 1) {
System.out.println(usage);
System.exit(1);
}
String collectionId = args[0];
Region region = Region.US_EAST_1;
RekognitionClient rekClient = RekognitionClient.builder()
.region(region)
.credentialsProvider(ProfileCredentialsProvider.create("profile-name"))
.build();
System.out.println("Creating collection: " +collectionId);
createMyCollection(rekClient, collectionId );
rekClient.close();
}
// snippet-start:[rekognition.java2.create_collection.main]
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);
}
}
// snippet-end:[rekognition.java2.create_collection.main]
```
------
#### [ AWS CLI ]
Cette AWS CLI commande affiche la sortie JSON pour l'opération `create-collection` CLI.
Remplacez la valeur d’`collection-id` par le nom de la collection que vous souhaitez créer.
Remplacez la valeur de `profile_name` par le nom de votre profil de développeur.
```
aws rekognition create-collection --profile profile-name --collection-id "collection-name"
```
------
#### [ Python ]
L’exemple suivant crée une collection et affiche son Amazon Resource Name (ARN).
Remplacez la valeur de `collection_id` par le nom de la collection que vous souhaitez créer. Remplacez la valeur de `profile_name` dans la ligne qui crée la session de Rekognition par le nom de votre profil de développeur.
```
# 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):
session = boto3.Session(profile_name='profile-name')
client = session.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-id"
create_collection(collection_id)
if __name__ == "__main__":
main()
```
------
#### [ .NET ]
L’exemple suivant crée une collection et affiche son Amazon Resource Name (ARN).
Remplacez la valeur de `collectionId` par le nom de la collection que vous souhaitez créer.
```
//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 ]
Dans l’exemple suivant, remplacez la valeur de `region` par le nom de la région associée à votre compte et remplacez la valeur de `collectionName` par le nom souhaité pour votre collection.
Remplacez la valeur de `profile_name` dans la ligne qui crée la session de Rekognition par le nom de votre profil de développeur.
```
//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 { CreateCollectionCommand} from "@aws-sdk/client-rekognition";
import { RekognitionClient } from "@aws-sdk/client-rekognition";
import {fromIni} from '@aws-sdk/credential-providers';
// Set the AWS Region.
const REGION = "region-name"; //e.g. "us-east-1"
// Set the profile name
const profileName = "profile-name"
// Name the collection
const collectionName = "collection-name"
const rekogClient = new RekognitionClient({region: REGION,
credentials: fromIni({profile: profileName,}),
});
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(collectionName)
```
------
## CreateCollection demande d'opération
La valeur d’entrée de `CreationCollection` est le nom de la collection que vous souhaitez créer.
```
{
"CollectionId": "MyCollection"
}
```
## CreateCollection réponse à l'opération
Amazon Rekognition crée la collection et renvoie l’Amazon Resource Name (ARN) de la collection que vous venez de créer.
```
{
"CollectionArn": "aws:rekognition:us-east-1:acct-id:collection/examplecollection",
"StatusCode": 200
}
```