Weitere AWS SDK-Beispiele sind im GitHub Repo [AWS Doc SDK Examples](https://github.com/awsdocs/aws-doc-sdk-examples) verfügbar.
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.
# Verwendung `CreateCollection` mit einem AWS SDK oder CLI
Die folgenden Code-Beispiele zeigen, wie `CreateCollection` verwendet wird.
Weitere Informationen finden Sie unter [Erstellen einer Sammlung](https://docs.aws.amazon.com/rekognition/latest/dg/create-collection-procedure.html).
------
#### [ .NET ]
**SDK für .NET**
Es gibt noch mehr dazu GitHub. Hier finden Sie das vollständige Beispiel und erfahren, wie Sie das [AWS -Code-Beispiel-](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/dotnetv3/Rekognition/#code-examples) einrichten und ausführen.
```
using System;
using System.Threading.Tasks;
using Amazon.Rekognition;
using Amazon.Rekognition.Model;
///
/// Uses Amazon Rekognition to create a collection to which you can add
/// faces using the IndexFaces operation.
///
public class CreateCollection
{
public static async Task Main()
{
var rekognitionClient = new AmazonRekognitionClient();
string collectionId = "MyCollection";
Console.WriteLine("Creating collection: " + collectionId);
var createCollectionRequest = new CreateCollectionRequest
{
CollectionId = collectionId,
};
CreateCollectionResponse createCollectionResponse = await rekognitionClient.CreateCollectionAsync(createCollectionRequest);
Console.WriteLine($"CollectionArn : {createCollectionResponse.CollectionArn}");
Console.WriteLine($"Status code : {createCollectionResponse.StatusCode}");
}
}
```
+ Einzelheiten zur API finden Sie [CreateCollection](https://docs.aws.amazon.com/goto/DotNetSDKV3/rekognition-2016-06-27/CreateCollection)in der *AWS SDK für .NET API-Referenz*.
------
#### [ CLI ]
**AWS CLI**
**So erstellen Sie eine Sammlung**
Der folgende `create-collection`-Befehl erstellt eine Sammlung mit dem angegebenen Namen.
```
aws rekognition create-collection \
--collection-id "MyCollection"
```
Ausgabe:
```
{
"CollectionArn": "aws:rekognition:us-west-2:123456789012:collection/MyCollection",
"FaceModelVersion": "4.0",
"StatusCode": 200
}
```
Weitere Informationen finden Sie unter [Erstellen einer Sammlung](https://docs.aws.amazon.com/rekognition/latest/dg/create-collection-procedure.html) im *Entwicklerhandbuch für Amazon Rekognition*.
+ Einzelheiten zur API finden Sie [CreateCollection](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rekognition/create-collection.html)in der *AWS CLI Befehlsreferenz*.
------
#### [ Java ]
**SDK für Java 2.x**
Es gibt noch mehr dazu GitHub. Hier finden Sie das vollständige Beispiel und erfahren, wie Sie das [AWS -Code-Beispiel-](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/javav2/example_code/rekognition/#code-examples) einrichten und ausführen.
```
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;
/**
* 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 = """
Usage: \s
Where:
collectionName - The name of the collection.\s
""";
if (args.length != 1) {
System.out.println(usage);
System.exit(1);
}
String collectionId = args[0];
Region region = Region.US_WEST_2;
RekognitionClient rekClient = RekognitionClient.builder()
.region(region)
.build();
System.out.println("Creating collection: " + collectionId);
createMyCollection(rekClient, collectionId);
rekClient.close();
}
/**
* Creates a new Amazon Rekognition collection.
*
* @param rekClient the Amazon Rekognition client used to interact with the Rekognition service
* @param collectionId the unique identifier for the collection to be created
*/
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);
}
}
}
```
+ Einzelheiten zur API finden Sie [CreateCollection](https://docs.aws.amazon.com/goto/SdkForJavaV2/rekognition-2016-06-27/CreateCollection)in der *AWS SDK for Java 2.x API-Referenz*.
------
#### [ Kotlin ]
**SDK für Kotlin**
Es gibt noch mehr dazu GitHub. Hier finden Sie das vollständige Beispiel und erfahren, wie Sie das [AWS -Code-Beispiel-](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/kotlin/services/rekognition#code-examples) einrichten und ausführen.
```
suspend fun createMyCollection(collectionIdVal: String) {
val request =
CreateCollectionRequest {
collectionId = collectionIdVal
}
RekognitionClient.fromEnvironment { region = "us-east-1" }.use { rekClient ->
val response = rekClient.createCollection(request)
println("Collection ARN is ${response.collectionArn}")
println("Status code is ${response.statusCode}")
}
}
```
+ Einzelheiten zur API finden Sie [CreateCollection](https://sdk.amazonaws.com/kotlin/api/latest/index.html)in der *API-Referenz zum AWS SDK für Kotlin*.
------
#### [ Python ]
**SDK für Python (Boto3)**
Es gibt noch mehr dazu. GitHub Hier finden Sie das vollständige Beispiel und erfahren, wie Sie das [AWS -Code-Beispiel-](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/python/example_code/rekognition#code-examples) einrichten und ausführen.
```
class RekognitionCollectionManager:
"""
Encapsulates Amazon Rekognition collection management functions.
This class is a thin wrapper around parts of the Boto3 Amazon Rekognition API.
"""
def __init__(self, rekognition_client):
"""
Initializes the collection manager object.
:param rekognition_client: A Boto3 Rekognition client.
"""
self.rekognition_client = rekognition_client
def create_collection(self, collection_id):
"""
Creates an empty collection.
:param collection_id: Text that identifies the collection.
:return: The newly created collection.
"""
try:
response = self.rekognition_client.create_collection(
CollectionId=collection_id
)
response["CollectionId"] = collection_id
collection = RekognitionCollection(response, self.rekognition_client)
logger.info("Created collection %s.", collection_id)
except ClientError:
logger.exception("Couldn't create collection %s.", collection_id)
raise
else:
return collection
```
+ Einzelheiten zur API finden Sie [CreateCollection](https://docs.aws.amazon.com/goto/boto3/rekognition-2016-06-27/CreateCollection)in *AWS SDK for Python (Boto3) API* Reference.
------
#### [ SAP ABAP ]
**SDK für SAP ABAP**
Es gibt noch mehr dazu. GitHub Hier finden Sie das vollständige Beispiel und erfahren, wie Sie das [AWS -Code-Beispiel-](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/sap-abap/services/rek#code-examples) einrichten und ausführen.
```
TRY.
oo_result = lo_rek->createcollection(
iv_collectionid = iv_collection_id ).
MESSAGE 'Collection created successfully.' TYPE 'I'.
CATCH /aws1/cx_rekresrcalrdyexistsex.
MESSAGE 'Collection already exists.' TYPE 'E'.
CATCH /aws1/cx_rekinvalidparameterex.
MESSAGE 'Invalid parameter value.' TYPE 'E'.
ENDTRY.
```
+ Einzelheiten zur API finden Sie [CreateCollection](https://docs.aws.amazon.com/sdk-for-sap-abap/v1/api/latest/index.html)in der *API-Referenz zum AWS SDK für SAP ABAP*.
------