

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
<a name="feature-pagination"></a>

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
<a name="pagination-how-it-works"></a>

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 incluem`NextToken`,`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` `MaxItems``MaxKeys`,`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
<a name="pagination-paginators"></a>

*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
<a name="pagination-sdk-compat"></a>

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](https://docs.aws.amazon.com/cli/latest/userguide/) | Sim | Built-in paginação automática para todos os comandos. Use --no-paginate para desativar. | 
| [SDK para C\+\+](https://docs.aws.amazon.com/sdk-for-cpp/latest/developer-guide/) | Não | É necessário o manuseio manual de tokens. | 
| [SDK para Go V2 (1.x)](https://docs.aws.amazon.com/sdk-for-go/v2/developer-guide/) | Sim | New<OperationName>PaginatorTipos de uso. | 
| [SDK para Go 1.x (V1)](https://docs.aws.amazon.com/sdk-for-go/latest/developer-guide/) | Sim | Use <OperationName>Pages métodos. | 
| [SDK para Java 2.x](https://docs.aws.amazon.com/sdk-for-java/latest/developer-guide/) | Sim | Use <operationName>Paginator métodos no cliente. | 
| [SDK para Java 1.x](https://docs.aws.amazon.com/sdk-for-java/v1/developer-guide/) | Sim |  | 
| [SDK para 3.x JavaScript ](https://docs.aws.amazon.com/sdk-for-javascript/latest/developer-guide/) | Sim | Use paginate<OperationName> funções. | 
| [SDK para 2.x JavaScript ](https://docs.aws.amazon.com/sdk-for-javascript/v2/developer-guide/) | Não | É necessário o manuseio manual de tokens. | 
| [SDK para Kotlin](https://docs.aws.amazon.com/sdk-for-kotlin/latest/developer-guide/) | Sim | Use as funções <operationName>Paginated de extensão. | 
| [SDK para .NET 4.x](https://docs.aws.amazon.com/sdk-for-net/latest/developer-guide/) | Sim | Use IPaginator interfaces. | 
| [SDK para .NET 3.x](https://docs.aws.amazon.com/sdk-for-net/v3/developer-guide/) | Sim | Use IPaginator interfaces. | 
| [SDK para PHP 3.x](https://docs.aws.amazon.com/sdk-for-php/latest/developer-guide/) | Sim | Use getPaginator no cliente. | 
| [SDK para Python (Boto3)](https://docs.aws.amazon.com/boto3/latest/guide/quickstart.html) | Sim | Use get\_paginator no cliente. | 
| [SDK para Ruby 3.x](https://docs.aws.amazon.com/sdk-for-ruby/latest/developer-guide/) | Sim | Use .each em respostas que oferecem suporte à paginação. | 
| [SDK para Rust](https://docs.aws.amazon.com/sdk-for-rust/latest/dg/) | Sim | Use .into\_paginator() sob solicitação, construtores. | 
| [SDK para Swift](https://docs.aws.amazon.com/sdk-for-swift/latest/developer-guide/) | Sim | PaginatedSequenceTipos de uso. | 
| [Ferramentas para PowerShell V5](https://docs.aws.amazon.com/powershell/latest/userguide/) | Sim | Built-in paginação automática. Use -NoAutoIteration para desativar. | 
| [Ferramentas para PowerShell V4](https://docs.aws.amazon.com/powershell/v4/userguide/) | Sim |  | 