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.
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
nextPageTokende 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
NextContinuationTokenque 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.