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 token de página en la respuesta. Si deseas obtener un ejemplo de cómo se usa, consulta la documentación de referencia de Java.

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.

Por ejemplo, supongamos que tu solicitud para crear una lista de objetos en un bucket llamado my-bucket contiene un nextPageToken en la respuesta:

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

La solicitud HTTP que usarías para seguir enumerando objetos en my-bucket sería la siguiente:

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

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.

Por ejemplo, supongamos que tu solicitud para crear una lista de objetos en un bucket llamado my-bucket contiene un NextContinuationToken en la respuesta:

<?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>

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

La solicitud HTTP que usarías para seguir enumerando objetos en my-bucket incluiría lo siguiente:

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

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