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 do Google Cloud faz a paginação automática das listas de buckets e objetos nas páginas Buckets e Detalhes do bucket.
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 a 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.