Paginação

Algumas AWS chamadas fornecem respostas paginadas para limitar a quantidade de dados retornados com cada resposta. Uma página de dados representa até 1000 itens.

As respostas paginadas são enumeráveis

A maneira mais simples de lidar com dados de respostas paginadas é usar o enumerador interno no objeto de resposta, conforme mostrado no exemplo a seguir.

s3 = Aws::S3::Client.new

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

Isso produz um objeto de resposta por chamada à API feita e enumera objetos no bucket designado. O SDK recupera páginas adicionais de dados para completar a solicitação.

Manipulação manual de respostas paginadas

Para lidar com a paginação por conta própria, use o método next_page? da resposta para verificar se há mais páginas para recuperar ou use o método last_page? para verificar se não há mais páginas para recuperar.

Se houver mais páginas, use o método next_page (observe que não há ?) para recuperar a próxima página de resultados, conforme mostrado no exemplo a seguir.

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

Classes de dados paginadas

Os dados paginados no AWS SDK for Ruby são tratados pela classe Aws::, incluída no SeahorsePageableResponse: :Client: :Response para fornecer acesso aos dados paginados.