As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.
Paginação
Muitas operações AWS de serviço podem retornar mais resultados do que cabem em uma única resposta. Quando isso ocorre, a resposta inclui um token de paginação que indica que há mais resultados disponíveis. Para recuperar a próxima página de resultados, você inclui esse token em uma solicitação subsequente. Esse processo se repete até que nenhum token seja retornado, indicando que você recebeu todos os resultados.
Como funciona a paginação
Quando você chama uma operação de API paginada, o serviço retorna um número máximo fixo de itens por resposta. Se o número total de itens exceder esse máximo, o serviço incluirá um token de paginação na resposta. O nome específico desse token varia de acordo com o serviço. Os nomes comuns incluemNextToken,Marker, e. ContinuationToken ExclusiveStartKey Para solicitar a próxima página, você passa esse valor de token no parâmetro de solicitação correspondente da sua próxima chamada.
A maioria das operações paginadas também suporta um parâmetro que controla o número máximo de itens retornados por página. Os nomes comuns desse parâmetro incluem MaxResults MaxItemsMaxKeys,MaxRecords,, Limit e.
Um token de paginação é válido somente se você o tiver recebido em uma resposta anterior da mesma operação. Se a resposta não incluir um token, não haverá mais resultados a serem recuperados.
Usando paginadores
Em vez de rastrear manualmente os tokens de paginação, todos os AWS SDKs fornecem abstrações de paginadores. Um paginador gerencia o gerenciamento de tokens automaticamente, fazendo chamadas sucessivas de API e gerando resultados até que todas as páginas tenham sido recuperadas. Usar um paginador simplifica seu código e reduz o risco de erros, como esquecer de passar o token ou usá-lo incorretamente.
Principais características dos paginadores em todos os SDKs:
-
Os paginadores aceitam os mesmos parâmetros de entrada da operação de API subjacente.
-
Os paginadores detectam automaticamente quando há mais páginas disponíveis e as recuperam.
-
Os paginadores param de fazer solicitações quando nenhum token de paginação é retornado na resposta.
-
Além disso, alguns SDKs fornecem mecanismos para limitar o número total de páginas ou itens recuperados.
Consulte o guia específico do desenvolvedor do SDK para ver a sintaxe do paginador e os padrões de uso disponíveis em seu idioma.
Support by AWS SDKs e ferramentas
Os SDKs a seguir são compatíveis com os recursos e configurações descritos neste tópico. Quaisquer exceções parciais estão anotadas. Todas as configurações de propriedade do sistema JVM são suportadas pelo AWS SDK para Java e pelo AWS SDK for Kotlin único.
| SDK | Compatível | Notas ou mais informações |
|---|---|---|
| AWS CLI v2 | Sim | Built-in paginação automática para todos os comandos. Use --no-paginate para desativar. |
| SDK para C++ | Não | É necessário o manuseio manual de tokens. |
| SDK para Go V2 (1.x) | Sim | New<OperationName>PaginatorTipos de uso. |
| SDK para Go 1.x (V1) | Sim | Use <OperationName>Pages métodos. |
| SDK para Java 2.x | Sim | Use <operationName>Paginator métodos no cliente. |
| SDK para Java 1.x | Sim | |
| SDK para 3.x JavaScript | Sim | Use paginate<OperationName> funções. |
| SDK para 2.x JavaScript | Não | É necessário o manuseio manual de tokens. |
| SDK para Kotlin | Sim | Use as funções <operationName>Paginated de extensão. |
| SDK para .NET 4.x | Sim | Use IPaginator interfaces. |
| SDK para .NET 3.x | Sim | Use IPaginator interfaces. |
| SDK para PHP 3.x | Sim | Use getPaginator no cliente. |
| SDK para Python (Boto3) | Sim | Use get_paginator no cliente. |
| SDK para Ruby 3.x | Sim | Use .each em respostas que oferecem suporte à paginação. |
| SDK para Rust | Sim | Use .into_paginator() sob solicitação, construtores. |
| SDK para Swift | Sim | PaginatedSequenceTipos de uso. |
| Ferramentas para PowerShell V5 | Sim | Built-in paginação automática. Use -NoAutoIteration para desativar. |
| Ferramentas para PowerShell V4 | Sim |
