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.
# Gesichter und zugehörige Benutzer in einer Sammlung auflisten
Sie können den [ListFaces](https://docs.aws.amazon.com/rekognition/latest/APIReference/API_ListFaces.html)Vorgang verwenden, um Gesichter und die ihnen zugehörigen Benutzer in einer Sammlung aufzulisten.
Weitere Informationen finden Sie unter [Verwalten von Gesichtern in einer Sammlung](managing-face-collections.md#collections-index-faces).
**Auflisten von Gesichtern in einer 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 `ListFaces`-Operation.
------
#### [ Java ]
Dieses Beispiel zeigt eine Liste mit Gesichtern in einer Sammlung an.
Ändern Sie den Wert von `collectionId` in die gewünschte Sammlung.
```
//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.Face;
import com.amazonaws.services.rekognition.model.ListFacesRequest;
import com.amazonaws.services.rekognition.model.ListFacesResult;
import java.util.List;
import com.fasterxml.jackson.databind.ObjectMapper;
public class ListFacesInCollection {
public static final String collectionId = "MyCollection";
public static void main(String[] args) throws Exception {
AmazonRekognition rekognitionClient = AmazonRekognitionClientBuilder.defaultClient();
ObjectMapper objectMapper = new ObjectMapper();
ListFacesResult listFacesResult = null;
System.out.println("Faces in collection " + collectionId);
String paginationToken = null;
do {
if (listFacesResult != null) {
paginationToken = listFacesResult.getNextToken();
}
ListFacesRequest listFacesRequest = new ListFacesRequest()
.withCollectionId(collectionId)
.withMaxResults(1)
.withNextToken(paginationToken);
listFacesResult = rekognitionClient.listFaces(listFacesRequest);
List < Face > faces = listFacesResult.getFaces();
for (Face face: faces) {
System.out.println(objectMapper.writerWithDefaultPrettyPrinter()
.writeValueAsString(face));
}
} while (listFacesResult != null && listFacesResult.getNextToken() !=
null);
}
}
```
------
#### [ 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/ListFacesInCollection.java).
```
// snippet-start:[rekognition.java2.list_faces_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.Face;
import software.amazon.awssdk.services.rekognition.model.ListFacesRequest;
import software.amazon.awssdk.services.rekognition.model.ListFacesResponse;
import software.amazon.awssdk.services.rekognition.model.RekognitionException;
import java.util.List;
// snippet-end:[rekognition.java2.list_faces_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 ListFacesInCollection {
public static void main(String[] args) {
final String usage = "\n" +
"Usage: " +
" \n\n" +
"Where:\n" +
" collectionId - 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("Faces in collection " + collectionId);
listFacesCollection(rekClient, collectionId) ;
rekClient.close();
}
// snippet-start:[rekognition.java2.list_faces_collection.main]
public static void listFacesCollection(RekognitionClient rekClient, String collectionId ) {
try {
ListFacesRequest facesRequest = ListFacesRequest.builder()
.collectionId(collectionId)
.maxResults(10)
.build();
ListFacesResponse facesResponse = rekClient.listFaces(facesRequest);
List faces = facesResponse.faces();
for (Face face: faces) {
System.out.println("Confidence level there is a face: "+face.confidence());
System.out.println("The face Id value is "+face.faceId());
}
} catch (RekognitionException e) {
System.out.println(e.getMessage());
System.exit(1);
}
}
// snippet-end:[rekognition.java2.list_faces_collection.main]
}
```
------
#### [ AWS CLI ]
Dieser AWS CLI Befehl zeigt die JSON-Ausgabe für den `list-faces` CLI-Vorgang an. Ersetzen Sie den Wert von `collection-id` durch den Namen der Sammlung, die Sie auflisten möchten. Ersetzen Sie den Wert von `profile_name` in der Zeile, die die Rekognition-Sitzung erstellt, durch den Namen Ihres Entwicklerprofils.
```
aws rekognition list-faces --collection-id "collection-id" --profile profile-name
```
------
#### [ Python ]
Dieses Beispiel zeigt eine Liste mit Gesichtern in einer Sammlung an.
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 list_faces_in_collection(collection_id):
maxResults = 2
faces_count = 0
tokens = True
session = boto3.Session(profile_name='profile-name')
client = session.client('rekognition')
response = client.list_faces(CollectionId=collection_id,
MaxResults=maxResults)
print('Faces in collection ' + collection_id)
while tokens:
faces = response['Faces']
for face in faces:
print(face)
faces_count += 1
if 'NextToken' in response:
nextToken = response['NextToken']
response = client.list_faces(CollectionId=collection_id,
NextToken=nextToken, MaxResults=maxResults)
else:
tokens = False
return faces_count
def main():
collection_id = 'collection-id'
faces_count = list_faces_in_collection(collection_id)
print("faces count: " + str(faces_count))
if __name__ == "__main__":
main()
```
------
#### [ .NET ]
Dieses Beispiel zeigt eine Liste mit Gesichtern in einer Sammlung an.
Ändern Sie den Wert von `collectionId` in die gewünschte Sammlung.
```
//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 ListFaces
{
public static void Example()
{
String collectionId = "MyCollection";
AmazonRekognitionClient rekognitionClient = new AmazonRekognitionClient();
ListFacesResponse listFacesResponse = null;
Console.WriteLine("Faces in collection " + collectionId);
String paginationToken = null;
do
{
if (listFacesResponse != null)
paginationToken = listFacesResponse.NextToken;
ListFacesRequest listFacesRequest = new ListFacesRequest()
{
CollectionId = collectionId,
MaxResults = 1,
NextToken = paginationToken
};
listFacesResponse = rekognitionClient.ListFaces(listFacesRequest);
foreach(Face face in listFacesResponse.Faces)
Console.WriteLine(face.FaceId);
} while (listFacesResponse != null && !String.IsNullOrEmpty(listFacesResponse.NextToken));
}
}
```
------
## ListFaces Operationsanforderung
Die Eingabe für `ListFaces` ist die ID der Sammlung, für die Sie Gesichter auflisten möchten. `MaxResults`ist die maximale Anzahl von Gesichtern, die zurückgegeben werden sollen. ListFaces nimmt auch eine Liste von Gesichtern auf, IDs nach denen die Ergebnisse gefiltert werden sollen, und eine angegebene Benutzer-ID, um nur Gesichter aufzulisten, die dem angegebenen Benutzer zugeordnet sind.
```
{
"CollectionId": "MyCollection",
"MaxResults": 1
}
```
Wenn die Antwort mehr Gesichter als von `MaxResults` angefordert aufweist, wird ein Token zurückgegeben, das Sie verwenden können, um den nächsten Ergebnissatz in einem nachfolgenden Aufruf an `ListFaces` abzurufen. Beispiel:
```
{
"CollectionId": "MyCollection",
"NextToken": "sm+5ythT3aeEVIR4WA....",
"MaxResults": 1
}
```
## ListFaces Reaktion auf den Vorgang
Bei der Antwort von `ListFaces` handelt es sich um Informationen über die Gesichtsmetadaten, die in der angegebenen Sammlung gespeichert sind.
+ **FaceModelVersion**— Die Version des Gesichtsmodells, das der Kollektion zugeordnet ist. Weitere Informationen finden Sie unter [Grundlegendes zur Modellversionierung](face-detection-model.md).
+ **Gesichter** – Informationen über die Gesichter in der Sammlung. Dies umfasst Informationen über [BoundingBox](https://docs.aws.amazon.com/rekognition/latest/APIReference/API_BoundingBox.html), Vertrauen, Bild-IDs und die Gesichts-ID. Weitere Informationen finden Sie unter [Gesicht](https://docs.aws.amazon.com/rekognition/latest/APIReference/API_Face.html).
+ **NextToken**— Das Token, das verwendet wird, um die nächsten Ergebnisse zu erhalten.
```
{
"FaceModelVersion": "6.0",
"Faces": [
{
"Confidence": 99.76940155029297,
"IndexFacesModelVersion": "6.0",
"UserId": "demoUser2",
"ImageId": "56a0ca74-1c83-39dd-b363-051a64168a65",
"BoundingBox": {
"Width": 0.03177810087800026,
"Top": 0.36568498611450195,
"Left": 0.3453829884529114,
"Height": 0.056759100407361984
},
"FaceId": "c92265d4-5f9c-43af-a58e-12be0ce02bc3"
},
{
"BoundingBox": {
"Width": 0.03254450112581253,
"Top": 0.6080359816551208,
"Left": 0.5160620212554932,
"Height": 0.06347999721765518
},
"IndexFacesModelVersion": "6.0",
"FaceId": "851cb847-dccc-4fea-9309-9f4805967855",
"Confidence": 99.94369506835938,
"ImageId": "a8aed589-ceec-35f7-9c04-82e0b546b024"
},
{
"BoundingBox": {
"Width": 0.03094629943370819,
"Top": 0.4218429923057556,
"Left": 0.6513839960098267,
"Height": 0.05266290158033371
},
"IndexFacesModelVersion": "6.0",
"FaceId": "c0eb3b65-24a0-41e1-b23a-1908b1aaeac1",
"Confidence": 99.82969665527344,
"ImageId": "56a0ca74-1c83-39dd-b363-051a64168a65"
}
]
}
```