Paginar los resultados

C++

Las bibliotecas cliente realizan la paginación de forma predeterminada. Cuando llamas a una función que admite la paginación, el método muestra un iterador. Puedes controlar el tamaño de la página si especificas opciones en la solicitud. 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, el método muestra un iterador. Puedes controlar el tamaño de la página si especificas opciones en la solicitud. 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, el método muestra un iterador. Puedes controlar el tamaño de la página con opciones de consulta o de paginador. 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, el método muestra un token de página. Puedes controlar el tamaño de la página con las opciones pageSize. 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, el método muestra un iterador. Puedes controlar el tamaño de la página con opciones de consulta (como maxResults). 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, el método muestra un iterador. Puedes controlar el tamaño de la página con opciones como maxResults. 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, el método muestra un iterador. Puedes controlar el tamaño de la página con opciones como max_results o page_size. 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, el método muestra un iterador. Puedes controlar el tamaño de la página con opciones como max. 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 JSON

Para controlar la cantidad de resultados que se muestran por página, usa el maxResults parámetro de consulta en las solicitudes a Objects: list o Buckets: list. Por ejemplo, para enumerar un máximo de 5 objetos a la vez, haz lo siguiente:

GET https://storage.s3nsapis.fr/storage/v1/b/BUCKET_NAME/o?maxResults=5

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.

Por ejemplo, una solicitud para enumerar objetos en BUCKET_NAME podría mostrar un nextPageToken en la respuesta:

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

Para mostrar la siguiente página de resultados, comenzando después del último resultado, pasa el valor de nextPageToken al parámetro pageToken de una solicitud posterior:

GET https://storage.s3nsapis.fr/storage/v1/b/BUCKET_NAME/o?pageToken=CgtzaGliYS0yLmpwZw==

Puedes combinar maxResults y pageToken en la misma solicitud para continuar con la lista con un tamaño de página específico.

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

Para controlar la cantidad de resultados que se muestran por página, usa el max-keys parámetro de consulta en las solicitudes a List Objects. Por ejemplo, para enumerar un máximo de 5 objetos a la vez, haz lo siguiente:

GET /?max-keys=5 HTTP/1.1
Host: BUCKET_NAME.storage.s3nsapis.fr

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.

Por ejemplo, una solicitud para enumerar objetos en BUCKET_NAME podría mostrar 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 enumeran objetos.

Para mostrar la siguiente página de resultados, comenzando después del último resultado, pasa el valor de NextContinuationToken al parámetro continuation-token de una solicitud posterior:

GET /?continuation-token=CgtzaGliYS0yLmpwZw==&list-type=2 HTTP/1.1
Host: BUCKET_NAME.storage.s3nsapis.fr

Puedes combinar max-keys y continuation-token en la misma solicitud.

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.