Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.
Paginación
Muchas operaciones AWS de servicio pueden arrojar más resultados de los que caben en una sola respuesta. Cuando esto ocurre, la respuesta incluye un token de paginación que indica que hay más resultados disponibles. Para recuperar la siguiente página de resultados, debes incluir ese token en una solicitud posterior. Este proceso se repite hasta que no se devuelva ningún token, lo que indica que has recibido todos los resultados.
Cómo funciona la paginación
Cuando llamas a una operación de API paginada, el servicio devuelve un número máximo fijo de elementos por respuesta. Si el número total de elementos supera este máximo, el servicio incluye un token de paginación en la respuesta. El nombre específico de este token varía según el servicio; los nombres comunes incluyenNextToken,Marker, ContinuationToken y. ExclusiveStartKey Para solicitar la página siguiente, debes pasar este valor de token al parámetro de solicitud correspondiente de tu próxima llamada.
La mayoría de las operaciones paginadas también admiten un parámetro que controla el número máximo de elementos devueltos por página. Los nombres comunes de este parámetro son MaxResultsMaxItems, MaxKeysMaxRecords, yLimit.
Un token de paginación solo es válido si lo recibiste en una respuesta anterior de la misma operación. Si la respuesta no incluye un token, no hay más resultados que recuperar.
Uso de paginadores
En lugar de realizar un seguimiento manual de los tokens de paginación, todos los AWS SDK proporcionan abstracciones de paginación. Un paginador gestiona la administración de los tokens automáticamente, realizando llamadas sucesivas a la API y arrojando resultados hasta que se hayan recuperado todas las páginas. El uso de un paginador simplifica el código y reduce el riesgo de errores, como olvidar pasar el token o usarlo de forma incorrecta.
Características clave de los paginadores de los SDK:
-
Los paginadores aceptan los mismos parámetros de entrada que la operación de API subyacente.
-
Los paginadores detectan automáticamente cuándo hay más páginas disponibles y las recuperan.
-
Los paginadores dejan de realizar solicitudes cuando no se devuelve ningún token de paginación en la respuesta.
-
Algunos SDK también proporcionan mecanismos para limitar el número total de páginas o elementos recuperados.
Consulta la guía para desarrolladores de tu SDK específico para conocer la sintaxis del paginador y los patrones de uso disponibles en tu idioma.
Soporte de AWS SDK y herramientas
Los siguientes SDK admiten las características y los ajustes descritos en este tema. Se anotan todas las excepciones parciales. Cualquier configuración de propiedades del sistema JVM solo es compatible con AWS SDK para Java y AWS SDK para Kotlin solo.
| SDK | compatible | Notas o más información |
|---|---|---|
| AWS CLI v2 | Sí | Built-in paginación automática para todos los comandos. Se usa para --no-paginate deshabilitar. |
| SDK para C++ | No | Se requiere el manejo manual de los tokens. |
| SDK para Go V2 (1.x) | Sí | New<OperationName>PaginatorTipos de uso. |
| SDK para Go 1.x (V1) | Sí | Usa <OperationName>Pages métodos. |
| SDK para Java 2.x | Sí | Usa <operationName>Paginator métodos en el cliente. |
| SDK para Java 1.x | Sí | |
| SDK para 3.x JavaScript | Sí | Usa funcionespaginate<OperationName>. |
| SDK para 2.x JavaScript | No | Se requiere el manejo manual de los tokens. |
| SDK para Kotlin | Sí | Usa las funciones de <operationName>Paginated extensión. |
| SDK para .NET 4.x | Sí | Usa interfacesIPaginator. |
| SDK para .NET 3.x | Sí | Usa IPaginator interfaces. |
| SDK para PHP 3.x | Sí | getPaginatorÚselo en el cliente. |
| SDK para Python (Boto3) | Sí | get_paginatorÚselo en el cliente. |
| SDK para Ruby 3.x | Sí | Úselo .each en respuestas que admitan la paginación. |
| SDK para Rust | Sí | .into_paginator()Utilízalo bajo petición. |
| SDK para Swift | Sí | PaginatedSequenceTipos de uso. |
| Herramientas para PowerShell V5 | Sí | Built-in paginación automática. Utilízalo -NoAutoIteration para desactivar. |
| Herramientas para la PowerShell V4 | Sí |
