Paginar los resultados

En esta página, se describe cómo las diferentes herramientas y bibliotecas de Cloud Storage paginan los resultados. La paginación es necesaria cuando se enumera una gran cantidad de objetos o buckets.

Console

La consola de Google Cloud pagina automáticamente listas de buckets y objetos en las páginas Buckets y Detalles del bucket.


Abrir la página Buckets

Línea de comandos

La CLI de Google Cloud pagina automáticamente las listas de objetos y buckets.

Bibliotecas cliente

C++

Las bibliotecas cliente realizan la paginación de forma predeterminada. Cuando llamas a una función que admite la paginación, se muestra un iterador en la respuesta. Si deseas obtener un ejemplo de cómo se usa este iterador, consulta la documentación de referencia de C++ para ListObjects().

C#

Las bibliotecas cliente realizan la paginación de forma predeterminada. Cuando llamas a una función que admite la paginación, se muestra un iterador en la respuesta. Si deseas obtener un ejemplo de cómo se usa este iterador, consulta la documentación de referencia de C# para ListObjects().

Go

Las bibliotecas cliente realizan la paginación de forma predeterminada. Cuando llamas a una función que admite la paginación, se muestra un iterador en la respuesta. Si deseas obtener un ejemplo de cómo se usa este iterador, consulta la documentación de referencia de Go para Bucket.Objects.

Java

Las bibliotecas cliente realizan la paginación de forma predeterminada. Cuando llamas a una función que admite la paginación, se muestra un iterador en la respuesta. Si deseas obtener un ejemplo de cómo se usa este iterador, consulta la documentación de referencia de Java para Storage.Objects.list.

Node.js

Las bibliotecas cliente realizan la paginación de forma predeterminada. Cuando llamas a una función que admite la paginación, se muestra un iterador en la respuesta. Para ver un ejemplo de cómo se usa este iterador, consulta la documentación de referencia de Node.js para getFiles().

PHP

Las bibliotecas cliente realizan la paginación de forma predeterminada. Cuando llamas a una función que admite la paginación, se muestra un iterador en la respuesta. Si deseas obtener un ejemplo de cómo se usa este iterador, consulta la documentación de referencia de PHP para Objects.

Python

Las bibliotecas cliente realizan la paginación de forma predeterminada. Cuando llamas a una función que admite la paginación, se muestra un iterador en la respuesta. Para ver un ejemplo de cómo se usa este iterador, consulta la documentación de referencia de Python para los iteradores de página.

Ruby

Las bibliotecas cliente realizan la paginación de forma predeterminada. Cuando llamas a una función que admite la paginación, se muestra un iterador en la respuesta. Si deseas obtener un ejemplo de cómo se usa este iterador, consulta la documentación de referencia de Ruby para Google::Cloud::Storage::File::List.

API de REST

API de JSON

Cuando llamas a una función que admite la paginación, el token de continuación nextPageToken se muestra en la respuesta si la lista está incompleta. nextPageToken representa el último resultado que se muestra. Cuando pasas el valor de nextPageToken al parámetro pageToken de una solicitud posterior, muestras la siguiente página de resultados, comenzando después del último resultado.

Respuesta de ejemplo

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

Para obtener más información sobre objects Resource, consulta la documentación de referencia de objetos.

Ejemplo de solicitud

GET https://storage.googleapis.com/storage/v1/b/BUCKET_NAME&pageToken=NEXT_PAGE_TOKEN HTTP/1.1

Authorization: Bearer ACCESS_TOKEN
Accept: application/json

Aquí:

  • NEXT_PAGE_TOKEN es el valor nextPageToken de la respuesta anterior.
  • BUCKET_NAME es el nombre de tu bucket de Cloud Storage.
  • ACCESS_TOKEN es el token de acceso que recibes de OAuth 2.0 Playground.

Si deseas obtener más información sobre cómo paginar los resultados, consulta la documentación de referencia de JSON para Objects: list o Buckets: list.

API de XML

Cuando llamas a una función que admite la paginación, el token de continuación NextContinuationToken se muestra en la respuesta si la lista está incompleta. NextContinuationToken representa el último resultado que se muestra. Cuando pasas el valor de NextContinuationToken al parámetro continuation-token de una solicitud posterior, muestras la siguiente página de resultados, comenzando después del último resultado.

Respuesta de ejemplo

HTTP/1.1 200 OK
X-goog-metageneration: 5
Content-location: https://example-bucket.storage.googleapis.com?max-keys=2&list-type=2
Expires: Wed, 02 Mar 2022 15:58:11 GMT
Content-length: 781
X-guploader-uploadid: ADPycdvFss2qs9wyMrrM2fIIZzTFFnZZM9i9k8TMbHipsxz8PqUjS5Xh_4tLsvb3_YYHTT0HmSYVv1Gtr816HQFnk28HMglyWA
Cache-control: private, max-age=0
Date: Wed, 02 Mar 2022 15:58:11 GMT
Content-type: application/xml; charset=UTF-8

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

Ten en cuenta que list-type debe configurarse en 2 para que se muestre un NextContinuationToken.

Ejemplo de solicitud

GET /?continuation-token=NEXT_CONTINUATION_TOKEN&prefix=t&marker=test&list-type=2 HTTP/1.1 \
  Host: BUCKET_NAME.storage.googleapis.com
  Date: Wed, 02 Mar 2022 16:00:00 GMT
  Content-Length: 0
  Authorization: AUTHENTICATION_STRING

Aquí:

  • NEXT_CONTINUATION_TOKEN es el valor NextContinuationToken que recibes de la respuesta anterior.
  • BUCKET_NAME es el nombre de tu bucket de Cloud Storage.
  • AUTHENTICATION_STRING es el token de acceso que recibes de OAuth 2.0 Playground.

Para obtener instrucciones más detalladas sobre cómo paginar los resultados de un bucket, consulta la documentación de referencia de XML para List Objects.

Próximos pasos