Paginar resultados

Nesta página, descrevemos como diferentes ferramentas e bibliotecas do Cloud Storage paginam os resultados. A paginação é necessária ao listar um grande número de objetos ou buckets.

Console

O console Google Cloud faz a paginação automática das listas de buckets e objetos nas páginas Buckets e Detalhes do bucket.


Abrir a página "Buckets"

Linha de comando

A Google Cloud CLI faz a paginação automática das listas de buckets e objetos.

Bibliotecas de cliente

C++

As bibliotecas cliente executam a paginação por padrão. Quando você chama uma função compatível com paginação, um iteração é retornado na resposta. Para ver um exemplo de como esse iteração é usado, consulte a documentação de referência do C++ para ListObjects().

C#

As bibliotecas cliente executam a paginação por padrão. Quando você chama uma função compatível com paginação, um iteração é retornado na resposta. Para ver um exemplo de como esse iterador é usado, consulte a documentação de referência do C# para ListObjects().

Go

As bibliotecas cliente executam a paginação por padrão. Quando você chama uma função compatível com paginação, um iteração é retornado na resposta. Para ver um exemplo de como esse iterador é usado, consulte a documentação de referência do Go para Bucket.Objects.

Java

As bibliotecas cliente executam a paginação por padrão. Quando você chama uma função compatível com paginação, um token de página é retornado na resposta. Para ver um exemplo de como isso é usado, consulte a documentação de referência do Java.

Node.js

As bibliotecas cliente executam a paginação por padrão. Quando você chama uma função compatível com paginação, um iteração é retornado na resposta. Para ver um exemplo de como esse iterador é usado, consulte a documentação de referência do Node.js para getFiles().

PHP

As bibliotecas cliente executam a paginação por padrão. Quando você chama uma função compatível com paginação, um iteração é retornado na resposta. Para ver um exemplo de como esse iterador é usado, consulte a documentação de referência do PHP para Objects.

Python

As bibliotecas cliente executam a paginação por padrão. Quando você chama uma função compatível com paginação, um iteração é retornado na resposta. Para um exemplo de como esse iterador é usado, consulte a documentação de referência do Python para iteradores de página.

Ruby

As bibliotecas cliente executam a paginação por padrão. Quando você chama uma função compatível com paginação, um iteração é retornado na resposta. Para ver um exemplo de como esse iterador é usado, consulte a documentação de referência do Ruby para Google::Cloud::Storage::File::List.

APIs REST

API JSON

Quando você chama uma função compatível com paginação, o token de continuação nextPageToken é retornado na resposta se a listagem estiver incompleta. O nextPageToken representa o último resultado retornado. Ao transmitir o valor de nextPageToken para o parâmetro pageToken de uma solicitação subsequente, você retorna a próxima página de resultados, começando após o último.

Por exemplo, digamos que sua solicitação para listar objetos em um bucket chamado my-bucket contenha um nextPageToken na resposta:

{
  "kind": "storage#objects",
  "nextPageToken": "CgtzaGliYS0yLmpwZw==",
  "items": [
    {
      OBJECT_1_METADATA
    },
    {
      OBJECT_2_METADATA
    },
    …
  ]
}

A solicitação HTTP que você usaria para continuar listando objetos em my-bucket seria a seguinte:

GET https://storage.googleapis.com/storage/v1/b/my-bucket/o?pageToken=CgtzaGliYS0yLmpwZw==

Para mais informações sobre resultados de paginação, consulte a documentação de referência do JSON para Objects: list ou Buckets: list.

API XML

Quando você chama uma função compatível com a paginação, o token de continuação NextContinuationToken é retornado na resposta se a listagem estiver incompleta. O NextContinuationToken representa o último resultado retornado. Ao transmitir o valor de NextContinuationToken para o parâmetro continuation-token de uma solicitação subsequente, você retorna a próxima página de resultados, começando após o último.

Por exemplo, digamos que sua solicitação para listar objetos em um bucket chamado my-bucket contenha um NextContinuationToken na resposta:

<?xml version='1.0' encoding='UTF-8'?>
<ListBucketResult xmlns='http://doc.s3.amazonaws.com/2006-03-01'>
  <Name>my-bucket</Name>
  <NextContinuationToken>CgtzaGliYS0yLmpwZw==</NextContinuationToken>
  <KeyCount>2</KeyCount>
  <MaxKeys>2</MaxKeys>
  <IsTruncated>true</IsTruncated>
  <Contents>
    ...
  </Contents>
  ...
</ListBucketResult>

list-type precisa ser definido como 2 para retornar um NextContinuationToken ao listar objetos.

A solicitação HTTP que você usaria para continuar listando objetos em my-bucket incluiria o seguinte:

GET /?continuation-token=CgtzaGliYS0yLmpwZw==&list-type=2 HTTP/1.1
  Host: my-bucket.storage.googleapis.com

Para instruções mais detalhadas sobre a paginação dos resultados de um bucket, consulte a documentação de referência XML para List Objects.

Próximas etapas