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.
# Suppression d’une collection
Vous pouvez utiliser l'opération [DeleteCollection](https://docs.aws.amazon.com/rekognition/latest/APIReference/API_DeleteCollection.html) pour supprimer une collection.
Pour de plus amples informations, veuillez consulter [Gérer une collection](managing-face-collections.md#managing-collections).
**Pour supprimer 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 `DeleteCollection`.
------
#### [ Java ]
Cet exemple supprime une collection.
Remplacez la valeur de `collectionId` par la collection que vous souhaitez supprimer.
```
//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.DeleteCollectionRequest;
import com.amazonaws.services.rekognition.model.DeleteCollectionResult;
public class DeleteCollection {
public static void main(String[] args) throws Exception {
AmazonRekognition rekognitionClient = AmazonRekognitionClientBuilder.defaultClient();
String collectionId = "MyCollection";
System.out.println("Deleting collections");
DeleteCollectionRequest request = new DeleteCollectionRequest()
.withCollectionId(collectionId);
DeleteCollectionResult deleteCollectionResult = rekognitionClient.deleteCollection(request);
System.out.println(collectionId + ": " + deleteCollectionResult.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/DeleteCollection.java).
```
// snippet-start:[rekognition.java2.delete_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.DeleteCollectionRequest;
import software.amazon.awssdk.services.rekognition.model.DeleteCollectionResponse;
import software.amazon.awssdk.services.rekognition.model.RekognitionException;
// snippet-end:[rekognition.java2.delete_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 DeleteCollection {
public static void main(String[] args) {
final String usage = "\n" +
"Usage: " +
" \n\n" +
"Where:\n" +
" collectionId - The id of the collection to delete. \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("Deleting collection: " + collectionId);
deleteMyCollection(rekClient, collectionId);
rekClient.close();
}
// snippet-start:[rekognition.java2.delete_collection.main]
public static void deleteMyCollection(RekognitionClient rekClient,String collectionId ) {
try {
DeleteCollectionRequest deleteCollectionRequest = DeleteCollectionRequest.builder()
.collectionId(collectionId)
.build();
DeleteCollectionResponse deleteCollectionResponse = rekClient.deleteCollection(deleteCollectionRequest);
System.out.println(collectionId + ": " + deleteCollectionResponse.statusCode().toString());
} catch(RekognitionException e) {
System.out.println(e.getMessage());
System.exit(1);
}
}
// snippet-end:[rekognition.java2.delete_collection.main]
}
```
------
#### [ AWS CLI ]
Cette AWS CLI commande affiche la sortie JSON pour l'opération `delete-collection` CLI. Remplacez la valeur de `collection-id` par le nom de la collection que vous souhaitez supprimer. 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.
```
aws rekognition delete-collection --collection-id collection-name --profile profile-name
```
------
#### [ Python ]
Cet exemple supprime une collection.
Remplacez la valeur de `collection_id` par la collection que vous souhaitez supprimer. 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
from botocore.exceptions import ClientError
def delete_collection(collection_id):
print('Attempting to delete collection ' + collection_id)
session = boto3.Session(profile_name='default')
client = session.client('rekognition')
status_code = 0
try:
response = client.delete_collection(CollectionId=collection_id)
status_code = response['StatusCode']
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'])
status_code = e.response['ResponseMetadata']['HTTPStatusCode']
return (status_code)
def main():
collection_id = 'collection-name'
status_code = delete_collection(collection_id)
print('Status code: ' + str(status_code))
if __name__ == "__main__":
main()
```
------
#### [ .NET ]
Cet exemple supprime une collection.
Remplacez la valeur de `collectionId` par la collection que vous souhaitez supprimer.
```
//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 DeleteCollection
{
public static void Example()
{
AmazonRekognitionClient rekognitionClient = new AmazonRekognitionClient();
String collectionId = "MyCollection";
Console.WriteLine("Deleting collection: " + collectionId);
DeleteCollectionRequest deleteCollectionRequest = new DeleteCollectionRequest()
{
CollectionId = collectionId
};
DeleteCollectionResponse deleteCollectionResponse = rekognitionClient.DeleteCollection(deleteCollectionRequest);
Console.WriteLine(collectionId + ": " + deleteCollectionResponse.StatusCode);
}
}
```
------
#### [ Node.js ]
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 { DeleteCollectionCommand } 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 rekogClient = new RekognitionClient({region: REGION,
credentials: fromIni({profile: profileName,}),
});
// Name the collection
const collection_name = "collection-name"
const deleteCollection = async (collectionName) => {
try {
console.log(`Attempting to delete collection named - ${collectionName}`)
var response = await rekogClient.send(new DeleteCollectionCommand({CollectionId: collectionName}))
var status_code = response.StatusCode
if (status_code = 200){
console.log("Collection successfully deleted.")
}
return response; // For unit tests.
} catch (err) {
console.log("Error", err.stack);
}
};
deleteCollection(collection_name)
```
------
## DeleteCollection demande d'opération
La valeur d’entrée de `DeleteCollection` est l’ID de la collection à supprimer, comme l’illustre l’exemple JSON suivant.
```
{
"CollectionId": "MyCollection"
}
```
## DeleteCollection réponse à l'opération
La réponse `DeleteCollection` contient un code de statut HTTP qui indique la réussite ou l’échec de l’opération. `200` est renvoyée si la collection est supprimée avec succès.
```
{"StatusCode":200}
```