

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

# AWS SDK for Ruby에서 페이지가 매겨진 결과 사용

페이로드가 너무 커서 단일 응답으로 반환할 수 없는 경우 많은 AWS 작업이 잘린 결과를 반환합니다. 대신 서비스는 데이터의 일부와 토큰을 반환하여 다음 항목 세트를 검색합니다. 이 패턴을 페이지 매김이라고 합니다.

## 페이징된 응답은 열거 가능함
<a name="aws-ruby-sdk-paged-response-enumerable"></a>

페이징된 응답 데이터를 처리하는 가장 간단한 방법은 다음 예제에서와 같이 응답 객체에 기본 제공되는 열거자를 사용하는 것입니다.

```ruby
s3 = Aws::S3::Client.new

s3.list_objects(bucket:'aws-sdk').each do |response|
  puts response.contents.map(&:key)
end
```

이렇게 하면 API 호출당 하나의 응답 개체가 생기며, 명명된 버킷에 객체가 열거됩니다. SDK는 데이터의 추가 페이지를 검색해 요청을 완료합니다.

## 페이징된 응답 수동 처리
<a name="aws-ruby-sdk-handling-paged-response-handling"></a>

페이징을 직접 처리하려면 응답의 `next_page?` 메서드를 사용하여 검색할 페이지가 더 있는지 확인하거나 `last_page?` 메서드를 사용하여 검색할 페이지가 더 이상 없는지 확인하십시오.

페이지가 더 있으면 `next_page`(`?`가 없음) 메서드를 사용하여 다음 예제에서와 같이 다음 결과 페이지를 검색하십시오.

```ruby
s3 = Aws::S3::Client.new

# Get the first page of data
response = s3.list_objects(bucket:'aws-sdk')

# Get additional pages
while response.next_page? do
  response = response.next_page
  # Use the response data here...
end
```

**참고**  
`next_page` 메서드를 호출했는데 검색할 페이지가 더 이상 없으면 SDK가 [Aws::PageableResponse::LastPageError](https://docs.aws.amazon.com/sdk-for-ruby/v3/api/Aws/PageableResponse/LastPageError.html) 예외를 발생시킵니다.

## 페이징된 데이터 클래스
<a name="aws-ruby-sdk-paged-data-classes"></a>

 AWS SDK for Ruby의 페이지가 지정된 데이터는 [Aws::PageableResponse](https://docs.aws.amazon.com/sdk-for-ruby/v3/api/Aws/PageableResponse.html) 클래스에서 처리합니다.이 클래스는 페이지가 지정된 데이터에 대한 액세스를 제공하기 위해 [Seahorse::Client::Response](https://docs.aws.amazon.com/sdk-for-ruby/v3/api/Seahorse/Client/Response.html)에 포함되어 있습니다.