

기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

# 페이지 매김
<a name="feature-pagination"></a>

많은 AWS 서비스 작업은 단일 응답에 맞는 것보다 더 많은 결과를 반환할 수 있습니다. 이 경우 응답에는 더 많은 결과를 사용할 수 있음을 나타내는 페이지 매김 토큰이 포함됩니다. 결과의 다음 페이지를 검색하려면 후속 요청에 해당 토큰을 포함합니다. 이 프로세스는 토큰이 반환되지 않을 때까지 반복되어 모든 결과를 수신했음을 나타냅니다.

## 페이지 매김 작동 방식
<a name="pagination-how-it-works"></a>

페이지가 지정된 API 작업을 호출하면 서비스는 응답당 고정된 최대 항목 수를 반환합니다. 총 항목 수가이 최대값을 초과하는 경우 서비스는 응답에 페이지 매김 토큰을 포함합니다. 이 토큰의 특정 이름은 서비스에 따라 다릅니다. 일반 이름에는 `NextToken`, `Marker`, 및 `ContinuationToken`가 포함됩니다`ExclusiveStartKey`. 다음 페이지를 요청하려면 다음 호출의 해당 요청 파라미터에이 토큰 값을 전달합니다.

페이지가 매겨진 대부분의 작업은 페이지당 반환되는 최대 항목 수를 제어하는 파라미터도 지원합니다. 이 파라미터의 일반적인 이름에는 `MaxResults`, `MaxItems`, `MaxKeys`, 및 `MaxRecords`가 포함됩니다`Limit`.

페이지 매김 토큰은 동일한 작업의 이전 응답에서 받은 경우에만 유효합니다. 응답에 토큰이 포함되지 않은 경우 검색할 결과가 더 이상 없습니다.

## 페이지네이터 사용
<a name="pagination-paginators"></a>

모든 AWS SDKs 페이지 매김 토큰을 수동으로 추적하는 대신 *페이지 매김기* 추상화를 제공합니다. 페이지네이터는 토큰 관리를 자동으로 처리하여 연속적인 API 호출을 수행하고 모든 페이지가 검색될 때까지 결과를 산출합니다. 페이지네이터를 사용하면 코드를 간소화하고 토큰 전달을 잊어버리거나 잘못 사용하는 등의 오류 위험을 줄일 수 있습니다.

SDKs:
+ 페이지네이터는 기본 API 작업과 동일한 입력 파라미터를 수락합니다.
+ 페이지네이터는 더 많은 페이지를 사용할 수 있는 시기를 자동으로 감지하고 검색합니다.
+ 응답에 페이지 매김 토큰이 반환되지 않으면 페이지 매김기가 요청 생성을 중지합니다.
+ 일부 SDKs 검색된 총 페이지 또는 항목 수를 제한하는 메커니즘을 추가로 제공합니다.

해당 언어로 제공되는 페이지네이터 구문 및 사용 패턴은 특정 SDK의 개발자 안내서를 참조하세요.

## AWS SDKs 도구 지원
<a name="pagination-sdk-compat"></a>

다음 SDK는 이 주제에서 설명하는 기능 및 설정을 지원합니다. 모든 일부 예외가 기록됩니다. 모든 JVM 시스템 속성 설정은 AWS SDK for Java 및 AWS SDK for Kotlin 에서만 지원됩니다.


| SDK | 지원됨 | 참고 또는 추가 정보 | 
| --- | --- | --- | 
| [AWS CLI](https://docs.aws.amazon.com/cli/latest/userguide/) v2 | 예 | 모든 명령에 대한 기본 자동 페이지 매김. --no-paginate를 사용하여 비활성화합니다. | 
| [SDK for C\+\+](https://docs.aws.amazon.com/sdk-for-cpp/latest/developer-guide/) | 아니요 | 수동 토큰 처리가 필요합니다. | 
| [SDK for Go V2 (1.x)](https://docs.aws.amazon.com/sdk-for-go/v2/developer-guide/) | 예 | New<OperationName>Paginator 유형을 사용합니다. | 
| [SDK for Go 1.x (V1)](https://docs.aws.amazon.com/sdk-for-go/latest/developer-guide/) | 예 | <OperationName>Pages 메서드를 사용합니다. | 
| [SDK for Java 2.x](https://docs.aws.amazon.com/sdk-for-java/latest/developer-guide/) | 예 | 클라이언트에서 <operationName>Paginator 메서드를 사용합니다. | 
| [SDK for Java 1.x](https://docs.aws.amazon.com/sdk-for-java/v1/developer-guide/) | 예 |  | 
| [SDK for JavaScript 3.x](https://docs.aws.amazon.com/sdk-for-javascript/latest/developer-guide/) | 예 | paginate<OperationName> 함수를 사용합니다. | 
| [SDK for JavaScript 2.x](https://docs.aws.amazon.com/sdk-for-javascript/v2/developer-guide/) | 아니요 | 수동 토큰 처리가 필요합니다. | 
| [SDK for Kotlin](https://docs.aws.amazon.com/sdk-for-kotlin/latest/developer-guide/) | 예 | <operationName>Paginated 확장 함수를 사용합니다. | 
| [.NET 4.x용 SDK](https://docs.aws.amazon.com/sdk-for-net/latest/developer-guide/) | 예 | IPaginator 인터페이스를 사용합니다. | 
| [SDK for .NET 3.x](https://docs.aws.amazon.com/sdk-for-net/v3/developer-guide/) | 예 | IPaginator 인터페이스를 사용합니다. | 
| [SDK for PHP 3.x](https://docs.aws.amazon.com/sdk-for-php/latest/developer-guide/) | 예 | 클라이언트getPaginator에서를 사용합니다. | 
| [SDK for Python (Boto3)](https://docs.aws.amazon.com/boto3/latest/guide/quickstart.html) | 예 | 클라이언트get\_paginator에서를 사용합니다. | 
| [SDK for Ruby 3.x](https://docs.aws.amazon.com/sdk-for-ruby/latest/developer-guide/) | 예 | 페이지 매김을 지원하는 응답.each에를 사용합니다. | 
| [SDK for Rust](https://docs.aws.amazon.com/sdk-for-rust/latest/dg/) | 예 | 요청 빌더.into\_paginator()에서를 사용합니다. | 
| [SDK for Swift](https://docs.aws.amazon.com/sdk-for-swift/latest/developer-guide/) | 예 | PaginatedSequence 유형을 사용합니다. | 
| [PowerShell V5용 도구](https://docs.aws.amazon.com/powershell/latest/userguide/) | 예 | 기본 제공 자동 페이지 매김. -NoAutoIteration를 사용하여 비활성화합니다. | 
| [PowerShell V4용 도구](https://docs.aws.amazon.com/powershell/v4/userguide/) | 예 |  | 