Paginación de resultados

C++

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

C#

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

Go

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

Java

Las bibliotecas de cliente realizan la paginación de forma predeterminada. Cuando llamas a una función que admite la paginación, se devuelve un token de página en la respuesta. Para ver un ejemplo de cómo se usa, consulta la documentación de referencia de Java.

Node.js

Las bibliotecas de cliente realizan la paginación de forma predeterminada. Cuando llamas a una función que admite paginación, se devuelve 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 sobre getFiles().

PHP

Las bibliotecas de cliente realizan la paginación de forma predeterminada. Cuando llamas a una función que admite paginación, se devuelve un iterador en la respuesta. Para ver un ejemplo de cómo se usa este iterador, consulta la documentación de referencia de PHP sobre Objects.

Python

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

Ruby

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

API JSON

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

Por ejemplo, supongamos que tu solicitud para enumerar objetos en un segmento 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==

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

API XML

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

Por ejemplo, supongamos que tu solicitud para enumerar objetos en un segmento 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 tener el valor 2 para devolver un NextContinuationToken al enumerar 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 segmento, consulta la documentación de referencia de XML de List Objects.