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.
Erstellen einer Sammlung
Sie können den CreateCollectionVorgang verwenden, um eine Sammlung zu erstellen.
Weitere Informationen finden Sie unter Eine Sammlung verwalten.
So erstellen Sie eine Sammlung (SDK)
-
Wenn Sie dies noch nicht getan haben:
-
Erstellen oder aktualisieren Sie einen Benutzer mit AmazonRekognitionFullAccess
-Berechtigungen. Weitere Informationen finden Sie unter Schritt 1: Richten Sie ein AWS Konto ein und erstellen Sie einen Benutzer.
-
Installieren und konfigurieren Sie die AWS CLI und die AWS SDKs. Weitere Informationen finden Sie unter Schritt 2: Richten Sie das ein AWS CLI and AWS SDKs.
-
Verwenden Sie die folgenden Beispiele zum Aufrufen der CreateCollection
-Operation.
- Java
-
Im folgenden Beispiel wird eine Sammlung erstellt und ihr Amazon-Ressourcenname (ARN) angezeigt.
Ändern Sie den Wert von collectionId
in den Namen der Sammlung, die Sie erstellen 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.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
-
Dieser Code stammt aus dem GitHub Repository mit den AWS SDK Dokumentationsbeispielen. Das vollständige Beispiel finden Sie hier.
Ersetzen Sie den Wert von profile_name
in der Zeile, die die Rekognition-Sitzung erstellt, durch den Namen Ihres Entwicklerprofils.
//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: " +
" <collectionName> \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
-
Dieser AWS CLI Befehl zeigt die JSON Ausgabe für den create-collection
CLI Vorgang an.
Ersetzen Sie den Wert von collection-id
durch den Namen der Sammlung, die Sie erstellen möchten.
Ersetzen Sie den Wert von profile_name
mit dem Namen Ihres Entwicklerprofils.
aws rekognition create-collection --profile profile-name --collection-id "collection-name"
- Python
-
Im folgenden Beispiel wird eine Sammlung erstellt und ihr Amazon-Ressourcenname (ARN) angezeigt.
Ändern Sie den Wert von collection_id
in den Namen der Sammlung, die Sie erstellen 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
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
-
Im folgenden Beispiel wird eine Sammlung erstellt und ihr Amazon-Ressourcenname (ARN) angezeigt.
Ändern Sie den Wert von collectionId
in den Namen der Sammlung, die Sie erstellen 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 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
-
Ersetzen Sie im folgenden Beispiel den Wert von region
durch den Namen der Region, die mit Ihrem Konto verknüpft ist, und ersetzen Sie den Wert von collectionName
durch den gewünschten Namen Ihrer Sammlung.
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 { 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 Operationsanforderung
Bei der Eingabe in CreationCollection
handelt es sich um den Namen der Sammlung, die Sie erstellen möchten.
{
"CollectionId": "MyCollection"
}
CreateCollection Antwort auf die Operation
Amazon Rekognition erstellt die Sammlung und gibt den Amazon-Ressourcennamen (ARN) der neu erstellten Sammlung zurück.
{
"CollectionArn": "aws:rekognition:us-east-1:acct-id:collection/examplecollection",
"StatusCode": 200
}