As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.
# Listar coleções
Você pode usar a operação [ListCollections](https://docs.aws.amazon.com/rekognition/latest/APIReference/API_ListCollections.html) para listar as coleções na região que está usando.
Para obter mais informações, consulte [Gerenciar uma coleção](managing-face-collections.md#managing-collections).
**Para listar coleções (SDK)**
1. Se ainda não tiver feito isso:
1. Crie ou atualize um usuário com permissões `AmazonRekognitionFullAccess`. Para obter mais informações, consulte [Etapa 1: Configure uma conta da AWS e crie um usuário](setting-up.md#setting-up-iam).
1. Instale e configure o AWS CLI e AWS SDKs o. Para obter mais informações, consulte [Etapa 2: configurar o AWS CLI e AWS SDKs](setup-awscli-sdk.md).
1. Use os exemplos a seguir para chamar a operação `ListCollections`.
------
#### [ Java ]
O exemplo a seguir lista as coleções na região atual.
```
//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 java.util.List;
import com.amazonaws.services.rekognition.AmazonRekognition;
import com.amazonaws.services.rekognition.AmazonRekognitionClientBuilder;
import com.amazonaws.services.rekognition.model.ListCollectionsRequest;
import com.amazonaws.services.rekognition.model.ListCollectionsResult;
public class ListCollections {
public static void main(String[] args) throws Exception {
AmazonRekognition amazonRekognition = AmazonRekognitionClientBuilder.defaultClient();
System.out.println("Listing collections");
int limit = 10;
ListCollectionsResult listCollectionsResult = null;
String paginationToken = null;
do {
if (listCollectionsResult != null) {
paginationToken = listCollectionsResult.getNextToken();
}
ListCollectionsRequest listCollectionsRequest = new ListCollectionsRequest()
.withMaxResults(limit)
.withNextToken(paginationToken);
listCollectionsResult=amazonRekognition.listCollections(listCollectionsRequest);
List < String > collectionIds = listCollectionsResult.getCollectionIds();
for (String resultId: collectionIds) {
System.out.println(resultId);
}
} while (listCollectionsResult != null && listCollectionsResult.getNextToken() !=
null);
}
}
```
------
#### [ Java V2 ]
Esse código foi retirado do GitHub repositório de exemplos do SDK de AWS documentação. Veja o exemplo completo [aqui](https://github.com/awsdocs/aws-doc-sdk-examples/blob/master/javav2/example_code/rekognition/src/main/java/com/example/rekognition/ListCollections.java).
```
//snippet-start:[rekognition.java2.list_collections.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.ListCollectionsRequest;
import software.amazon.awssdk.services.rekognition.model.ListCollectionsResponse;
import software.amazon.awssdk.services.rekognition.model.RekognitionException;
import java.util.List;
//snippet-end:[rekognition.java2.list_collections.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 ListCollections {
public static void main(String[] args) {
Region region = Region.US_EAST_1;
RekognitionClient rekClient = RekognitionClient.builder()
.region(region)
.credentialsProvider(ProfileCredentialsProvider.create("profile-name"))
.build();
System.out.println("Listing collections");
listAllCollections(rekClient);
rekClient.close();
}
// snippet-start:[rekognition.java2.list_collections.main]
public static void listAllCollections(RekognitionClient rekClient) {
try {
ListCollectionsRequest listCollectionsRequest = ListCollectionsRequest.builder()
.maxResults(10)
.build();
ListCollectionsResponse response = rekClient.listCollections(listCollectionsRequest);
List collectionIds = response.collectionIds();
for (String resultId : collectionIds) {
System.out.println(resultId);
}
} catch (RekognitionException e) {
System.out.println(e.getMessage());
System.exit(1);
}
}
// snippet-end:[rekognition.java2.list_collections.main]
}
```
------
#### [ AWS CLI ]
Esse AWS CLI comando exibe a saída JSON para a operação da `list-collections` CLI. Substitua o valor de `profile_name` com o nome do seu perfil de desenvolvedor.
```
aws rekognition list-collections --profile profile-name
```
------
#### [ Python ]
O exemplo a seguir lista as coleções na região atual.
Substitua o valor de `profile_name` na linha que cria a sessão do Rekognition pelo nome do seu perfil de desenvolvedor.
```
#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_collections():
max_results=2
client=boto3.client('rekognition')
#Display all the collections
print('Displaying collections...')
response=client.list_collections(MaxResults=max_results)
collection_count=0
done=False
while done==False:
collections=response['CollectionIds']
for collection in collections:
print (collection)
collection_count+=1
if 'NextToken' in response:
nextToken=response['NextToken']
response=client.list_collections(NextToken=nextToken,MaxResults=max_results)
else:
done=True
return collection_count
def main():
collection_count=list_collections()
print("collections: " + str(collection_count))
if __name__ == "__main__":
main()
```
------
#### [ .NET ]
O exemplo a seguir lista as coleções na região atual.
```
//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 ListCollections
{
public static void Example()
{
AmazonRekognitionClient rekognitionClient = new AmazonRekognitionClient();
Console.WriteLine("Listing collections");
int limit = 10;
ListCollectionsResponse listCollectionsResponse = null;
String paginationToken = null;
do
{
if (listCollectionsResponse != null)
paginationToken = listCollectionsResponse.NextToken;
ListCollectionsRequest listCollectionsRequest = new ListCollectionsRequest()
{
MaxResults = limit,
NextToken = paginationToken
};
listCollectionsResponse = rekognitionClient.ListCollections(listCollectionsRequest);
foreach (String resultId in listCollectionsResponse.CollectionIds)
Console.WriteLine(resultId);
} while (listCollectionsResponse != null && listCollectionsResponse.NextToken != null);
}
}
```
------
#### [ Node.js ]
Substitua o valor de `profile_name` na linha que cria a sessão do Rekognition pelo nome do seu perfil de desenvolvedor.
```
//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 { ListCollectionsCommand } 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,}),
});
const listCollection = async () => {
var max_results = 10
console.log("Displaying collections:")
var response = await rekogClient.send(new ListCollectionsCommand({MaxResults: max_results}))
var collection_count = 0
var done = false
while (done == false){
var collections = response.CollectionIds
collections.forEach(collection => {
console.log(collection)
collection_count += 1
});
return collection_count
}
}
var collect_list = await listCollection()
console.log(collect_list)
```
------
## ListCollections solicitação de operação
A entrada para `ListCollections` é o número máximo de coleções a serem retornadas.
```
{
"MaxResults": 2
}
```
Se a resposta tiver mais coleções do que as solicitadas por `MaxResults`, será retornado um token que poderá ser usado para obter o próximo conjunto de resultados, em uma chamada subsequente para `ListCollections`. Por exemplo:
```
{
"NextToken": "MGYZLAHX1T5a....",
"MaxResults": 2
}
```
## ListCollections resposta da operação
O Amazon Rekognition retorna uma matriz de coleções (`CollectionIds`). Uma matriz separada (`FaceModelVersions`) fornece a versão do modelo de face usado para analisar faces em cada coleção. Por exemplo, na resposta JSON a seguir, a coleção `MyCollection` analisa faces usando a versão 2.0 do modelo de face. A coleção `AnotherCollection` usa a versão 3.0 do modelo de face. Para obter mais informações, consulte [Noções básicas do versionamento de modelo](face-detection-model.md).
`NextToken` é o token usado para obter o próximo conjunto de resultados, em uma chamada subsequente para `ListCollections`.
```
{
"CollectionIds": [
"MyCollection",
"AnotherCollection"
],
"FaceModelVersions": [
"2.0",
"3.0"
],
"NextToken": "MGYZLAHX1T5a...."
}
```