Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.
# Löschen einer Sammlung
Sie können die Operation [DeleteCollection](https://docs.aws.amazon.com/rekognition/latest/APIReference/API_DeleteCollection.html) zum Löschen einer Sammlung verwenden.
Weitere Informationen finden Sie unter [Eine Sammlung verwalten](managing-face-collections.md#managing-collections).
**So löschen Sie eine Sammlung (SDK)**
1. Wenn Sie dies noch nicht getan haben:
1. Erstellen oder aktualisieren Sie einen Benutzer mit `AmazonRekognitionFullAccess`-Berechtigungen. Weitere Informationen finden Sie unter [Schritt 1: Einrichten eines AWS-Kontos und Erstellen eines Benutzers](setting-up.md#setting-up-iam).
1. Installieren und konfigurieren Sie das AWS CLI und das AWS SDKs. Weitere Informationen finden Sie unter [Schritt 2: Richten Sie das AWS CLI und ein AWS SDKs](setup-awscli-sdk.md).
1. Verwenden Sie die folgenden Beispiele zum Aufrufen der `DeleteCollection`-Operation.
------
#### [ Java ]
In diesem Beispiel wird eine Sammlung gelöscht.
Ändern Sie den Wert `collectionId` in die Sammlung, die Sie löschen möchten.
```
//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 ]
Dieser Code stammt aus dem AWS Documentation SDK Examples GitHub Repository. Das vollständige Beispiel finden Sie [hier](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 ]
Dieser AWS CLI Befehl zeigt die JSON-Ausgabe für den `delete-collection` CLI-Vorgang an. Ersetzen Sie den Wert von `collection-id` durch den Namen der Sammlung, die Sie löschen möchten. Ersetzen Sie den Wert von `profile_name` in der Zeile, die die Rekognition-Sitzung erstellt, durch den Namen Ihres Entwicklerprofils.
```
aws rekognition delete-collection --collection-id collection-name --profile profile-name
```
------
#### [ Python ]
In diesem Beispiel wird eine Sammlung gelöscht.
Ändern Sie den Wert `collection_id` in die Sammlung, die Sie löschen möchten. Ersetzen Sie den Wert von `profile_name` in der Zeile, die die Rekognition-Sitzung erstellt, durch den Namen Ihres Entwicklerprofils.
```
# 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 ]
In diesem Beispiel wird eine Sammlung gelöscht.
Ändern Sie den Wert `collectionId` in die Sammlung, die Sie löschen möchten.
```
//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 ]
Ersetzen Sie den Wert von `profile_name` in der Zeile, die die Rekognition-Sitzung erstellt, durch den Namen Ihres Entwicklerprofils.
```
//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 Operationsanforderung
Bei der Eingabe in `DeleteCollection` handelt es sich um die ID der Sammlung, die gelöscht werden soll, wie im folgenden JSON-Beispiel gezeigt.
```
{
"CollectionId": "MyCollection"
}
```
## DeleteCollection Antwort auf die Operation
Die `DeleteCollection`-Antwort enthält einen HTTP-Statuscode, der angibt, ob die Operation erfolgreich ausgeführt wurde. `200` wird zurückgegeben, wenn die Sammlung erfolgreich gelöscht wurde.
```
{"StatusCode":200}
```