Esta página descreve como as diferentes ferramentas e bibliotecas do Cloud Storage paginam os resultados. A paginação é necessária quando lista um número elevado de objetos ou contentores.
Consola
A Google Cloud consola pagina automaticamente as listas de contentores e objetos nas páginas Contentores e Detalhes do contentor.
Linha de comandos
A CLI do Google Cloud pagina automaticamente as listas de objetos e contentores.
Bibliotecas cliente
C++
As bibliotecas cliente fazem a paginação por predefinição. Quando chama uma função que suporta paginação, é devolvido um iterador na resposta. Para ver um exemplo de como este iterador é usado, consulte a documentação de referência do C++ para ListObjects().
C#
As bibliotecas cliente fazem a paginação por predefinição. Quando chama uma função que suporta paginação, é devolvido um iterador na resposta. Para ver um exemplo de como este iterador é usado, consulte a documentação de referência do C# para ListObjects().
Ir
As bibliotecas cliente fazem a paginação por predefinição. Quando chama uma função que suporta paginação, é devolvido um iterador na resposta. Para ver um exemplo de como este iterador é usado, consulte a documentação de referência do Go para Bucket.Objects.
Java
As bibliotecas cliente fazem a paginação por predefinição. Quando chama uma função que suporta paginação, é devolvido um token de página na resposta. Para ver um exemplo de como isto é usado, consulte a documentação de referência do Java.
Node.js
As bibliotecas cliente fazem a paginação por predefinição. Quando chama uma função que suporta paginação, é devolvido um iterador na resposta. Para ver um exemplo de como este iterador é usado, consulte a documentação de referência do Node.js para getFiles().
PHP
As bibliotecas cliente fazem a paginação por predefinição. Quando chama uma função que suporta paginação, é devolvido um iterador na resposta. Para ver um exemplo de como este iterador é usado, consulte a documentação de referência do PHP para Objects.
Python
As bibliotecas cliente fazem a paginação por predefinição. Quando chama uma função que suporta paginação, é devolvido um iterador na resposta. Para ver um exemplo de como este iterador é usado, consulte a documentação de referência do Python para iteradores de páginas.
Ruby
As bibliotecas cliente fazem a paginação por predefinição. Quando chama uma função que suporta paginação, é devolvido um iterador na resposta. Para ver um exemplo de como este iterador é usado, consulte a documentação de referência do Ruby para Google::Cloud::Storage::File::List.
APIs REST
API JSON
Quando chama uma função que suporta paginação, o token de continuação nextPageToken é devolvido na resposta se a listagem estiver incompleta. O nextPageToken representa o último resultado devolvido. Quando transmite o valor de nextPageToken
ao parâmetro pageToken de um pedido subsequente, devolve a
página seguinte de resultados, começando após o último resultado.
Por exemplo, suponhamos que o seu pedido para listar objetos num contentor denominado
my-bucket contém um nextPageToken na resposta:
{
"kind": "storage#objects",
"nextPageToken": "CgtzaGliYS0yLmpwZw==",
"items": [
{
OBJECT_1_METADATA
},
{
OBJECT_2_METADATA
},
…
]
}O pedido HTTP que usaria para continuar a listar objetos em
my-bucket seria o seguinte:
GET https://storage.googleapis.com/storage/v1/b/my-bucket/o?pageToken=CgtzaGliYS0yLmpwZw==
Para mais informações sobre a paginação dos resultados, consulte a documentação de referência JSON para Objects: list ou Buckets: list.
API XML
Quando chama uma função que suporta paginação, o token de continuação NextContinuationToken é devolvido na resposta se a listagem estiver incompleta. O NextContinuationToken representa o último resultado devolvido. Quando transmite o valor de NextContinuationToken ao parâmetro continuation-token de um pedido subsequente, devolve a página seguinte de resultados, começando após o último resultado.
Por exemplo, suponhamos que o seu pedido para listar objetos num contentor denominado
my-bucket contém 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>Tenha em atenção que list-type tem de ser definido como 2 para devolver um
NextContinuationToken quando listar objetos.
O pedido HTTP que usaria para continuar a listar objetos em
my-bucket incluiria o seguinte:
GET /?continuation-token=CgtzaGliYS0yLmpwZw==&list-type=2 HTTP/1.1 Host: my-bucket.storage.googleapis.com
Para ver instruções mais detalhadas sobre a paginação dos resultados de um contentor, consulte a documentação de referência XML para List Objects.