기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
# 컬렉션 나열
[ListCollections](https://docs.aws.amazon.com/rekognition/latest/APIReference/API_ListCollections.html) 작업을 사용하여 현재 사용하는 리전의 컬렉션을 나열할 수 있습니다.
자세한 내용은 [컬렉션 관리](managing-face-collections.md#managing-collections) 단원을 참조하십시오.
**모음을 나열하려면(SDK)**
1. 아직 설정하지 않았다면 다음과 같이 하세요.
1. `AmazonRekognitionFullAccess` 권한이 있는 사용자를 생성하거나 업데이트합니다. 자세한 내용은 [1단계: AWS 계정 설정 및 사용자 생성](setting-up.md#setting-up-iam) 단원을 참조하십시오.
1. AWS CLI 및 AWS SDKs를 설치하고 구성합니다. 자세한 내용은 [2단계: AWS CLI 및 AWS SDKs 설정](setup-awscli-sdk.md) 단원을 참조하십시오.
1. 다음 예제를 사용하여 `ListCollections` 작업을 호출합니다.
------
#### [ Java ]
다음 예제는 현재 리전의 모음을 나열합니다.
```
//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 ]
이 코드는 AWS 설명서 SDK 예제 GitHub 리포지토리에서 가져온 것입니다. 전체 예제는 [여기](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 ]
이 AWS CLI 명령은 `list-collections` CLI 작업에 대한 JSON 출력을 표시합니다. `profile_name`의 값을 개발자 프로필 이름으로 바꿉니다.
```
aws rekognition list-collections --profile profile-name
```
------
#### [ Python ]
다음 예제는 현재 리전의 모음을 나열합니다.
Rekognition 세션을 생성하는 라인에서 `profile_name`의 값을 개발자 프로필의 이름으로 대체합니다.
```
#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 ]
다음 예제는 현재 리전의 모음을 나열합니다.
```
//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 ]
Rekognition 세션을 생성하는 라인에서 `profile_name`의 값을 개발자 프로필의 이름으로 대체합니다.
```
//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 작업 요청
`ListCollections`에 대한 입력은 반환될 최대 모음 수입니다.
```
{
"MaxResults": 2
}
```
응답의 컬렉션이 `MaxResults`가 요청한 것보다 많으면 후속 `ListCollections` 직접 호출에서 다음 결과 집합을 가져오는 데 사용할 수 있는 토큰이 반환됩니다. 예제:
```
{
"NextToken": "MGYZLAHX1T5a....",
"MaxResults": 2
}
```
## ListCollections 작업 응답
Amazon Rekognition은 컬렉션의 배열(`CollectionIds`)을 반환합니다. 각 모음의 얼굴을 분석하는 데 사용된 얼굴 모델 버전은 별도의 배열(`FaceModelVersions`)로 제공됩니다. 예를 들어 다음 JSON 응답에서 `MyCollection` 모음은 얼굴 모델 버전 2.0을 사용하여 얼굴을 분석합니다. `AnotherCollection`모음은 얼굴 모델 버전 3.0을 사용합니다. 자세한 내용은 [모델 버전 관리 이해](face-detection-model.md) 단원을 참조하십시오.
`NextToken`은 `ListCollections`에 대한 후속 호출에서 다음 결과 집합을 가져오는 데 사용되는 토큰입니다.
```
{
"CollectionIds": [
"MyCollection",
"AnotherCollection"
],
"FaceModelVersions": [
"2.0",
"3.0"
],
"NextToken": "MGYZLAHX1T5a...."
}
```