기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
페이지 매김
많은 AWS 서비스 작업은 단일 응답에 맞는 것보다 더 많은 결과를 반환할 수 있습니다. 이 경우 응답에는 더 많은 결과를 사용할 수 있음을 나타내는 페이지 매김 토큰이 포함됩니다. 결과의 다음 페이지를 검색하려면 후속 요청에 해당 토큰을 포함합니다. 이 프로세스는 토큰이 반환되지 않을 때까지 반복되어 모든 결과를 수신했음을 나타냅니다.
페이지 매김 작동 방식
페이지가 지정된 API 작업을 호출하면 서비스는 응답당 고정된 최대 항목 수를 반환합니다. 총 항목 수가이 최대값을 초과하는 경우 서비스는 응답에 페이지 매김 토큰을 포함합니다. 이 토큰의 특정 이름은 서비스에 따라 다릅니다. 일반 이름에는 NextToken, Marker, 및 ContinuationToken가 포함됩니다ExclusiveStartKey. 다음 페이지를 요청하려면 다음 호출의 해당 요청 파라미터에이 토큰 값을 전달합니다.
페이지가 매겨진 대부분의 작업은 페이지당 반환되는 최대 항목 수를 제어하는 파라미터도 지원합니다. 이 파라미터의 일반적인 이름에는 MaxResults, MaxItems, MaxKeys, 및 MaxRecords가 포함됩니다Limit.
페이지 매김 토큰은 동일한 작업의 이전 응답에서 받은 경우에만 유효합니다. 응답에 토큰이 포함되지 않은 경우 검색할 결과가 더 이상 없습니다.
페이지네이터 사용
모든 AWS SDKs 페이지 매김 토큰을 수동으로 추적하는 대신 페이지 매김기 추상화를 제공합니다. 페이지네이터는 토큰 관리를 자동으로 처리하여 연속적인 API 호출을 수행하고 모든 페이지가 검색될 때까지 결과를 산출합니다. 페이지네이터를 사용하면 코드를 간소화하고 토큰 전달을 잊어버리거나 잘못 사용하는 등의 오류 위험을 줄일 수 있습니다.
SDKs:
-
페이지네이터는 기본 API 작업과 동일한 입력 파라미터를 수락합니다.
-
페이지네이터는 더 많은 페이지를 사용할 수 있는 시기를 자동으로 감지하고 검색합니다.
-
응답에 페이지 매김 토큰이 반환되지 않으면 페이지 매김기가 요청 생성을 중지합니다.
-
일부 SDKs 검색된 총 페이지 또는 항목 수를 제한하는 메커니즘을 추가로 제공합니다.
해당 언어로 제공되는 페이지네이터 구문 및 사용 패턴은 특정 SDK의 개발자 안내서를 참조하세요.
AWS SDKs 도구 지원
다음 SDK는 이 주제에서 설명하는 기능 및 설정을 지원합니다. 모든 일부 예외가 기록됩니다. 모든 JVM 시스템 속성 설정은 AWS SDK for Java 및 AWS SDK for Kotlin 에서만 지원됩니다.
| SDK | 지원됨 | 참고 또는 추가 정보 |
|---|---|---|
| AWS CLI v2 | 예 | 모든 명령에 대한 기본 자동 페이지 매김. --no-paginate를 사용하여 비활성화합니다. |
| SDK for C++ | 아니요 | 수동 토큰 처리가 필요합니다. |
| SDK for Go V2 (1.x) | 예 | New<OperationName>Paginator 유형을 사용합니다. |
| SDK for Go 1.x (V1) | 예 | <OperationName>Pages 메서드를 사용합니다. |
| SDK for Java 2.x | 예 | 클라이언트에서 <operationName>Paginator 메서드를 사용합니다. |
| SDK for Java 1.x | 예 | |
| SDK for JavaScript 3.x | 예 | paginate<OperationName> 함수를 사용합니다. |
| SDK for JavaScript 2.x | 아니요 | 수동 토큰 처리가 필요합니다. |
| SDK for Kotlin | 예 | <operationName>Paginated 확장 함수를 사용합니다. |
| .NET 4.x용 SDK | 예 | IPaginator 인터페이스를 사용합니다. |
| SDK for .NET 3.x | 예 | IPaginator 인터페이스를 사용합니다. |
| SDK for PHP 3.x | 예 | 클라이언트getPaginator에서를 사용합니다. |
| SDK for Python (Boto3) | 예 | 클라이언트get_paginator에서를 사용합니다. |
| SDK for Ruby 3.x | 예 | 페이지 매김을 지원하는 응답.each에를 사용합니다. |
| SDK for Rust | 예 | 요청 빌더.into_paginator()에서를 사용합니다. |
| SDK for Swift | 예 | PaginatedSequence 유형을 사용합니다. |
| PowerShell V5용 도구 | 예 | 기본 제공 자동 페이지 매김. -NoAutoIteration를 사용하여 비활성화합니다. |
| PowerShell V4용 도구 | 예 |
