Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.
Paginazione
Molte operazioni AWS di assistenza possono restituire più risultati di quelli contenuti in una singola risposta. In questo caso, la risposta include un token di impaginazione che indica che sono disponibili più risultati. Per recuperare la pagina successiva dei risultati, includi quel token in una richiesta successiva. Questo processo si ripete finché non viene restituito alcun token, a indicare che hai ricevuto tutti i risultati.
Come funziona l'impaginazione
Quando si chiama un'operazione API impaginata, il servizio restituisce un numero massimo fisso di elementi per risposta. Se il numero totale di elementi supera questo massimo, il servizio include un token di impaginazione nella risposta. Il nome specifico di questo token varia in base al servizio: i nomi comuni includonoNextToken,, e. Marker ContinuationToken ExclusiveStartKey Per richiedere la pagina successiva, passate questo valore del token nel parametro di richiesta corrispondente della prossima chiamata.
La maggior parte delle operazioni impaginate supporta anche un parametro che controlla il numero massimo di elementi restituiti per pagina. I nomi comuni per questo parametro includono MaxResultsMaxItems, MaxKeysMaxRecords, eLimit.
Un token di impaginazione è valido solo se lo hai ricevuto in una risposta precedente dalla stessa operazione. Se la risposta non include un token, non ci sono altri risultati da recuperare.
Usare gli impaginatori
Anziché tracciare manualmente i token di impaginazione, tutti gli AWS SDK forniscono astrazioni di impaginazione. Un paginatore gestisce automaticamente la gestione dei token, effettuando chiamate API successive e producendo risultati fino al recupero di tutte le pagine. L'uso di un paginatore semplifica il codice e riduce il rischio di errori, come dimenticare di passare il token o utilizzarlo in modo errato.
Caratteristiche chiave degli impaginatori negli SDK:
-
Gli impaginatori accettano gli stessi parametri di input dell'operazione API sottostante.
-
Gli impaginatori rilevano automaticamente quando sono disponibili più pagine e le recuperano.
-
Gli impaginatori smettono di fare richieste quando nella risposta non viene restituito alcun token di paginazione.
-
Alcuni SDK forniscono inoltre meccanismi per limitare il numero totale di pagine o elementi recuperati.
Consulta la guida per sviluppatori del tuo SDK specifico per conoscere la sintassi del paginatore e i modelli di utilizzo disponibili nella tua lingua.
Supporto fornito da AWS SDK e strumenti
I seguenti SDK supportano le funzionalità e le impostazioni descritte in questo argomento. Vengono annotate eventuali eccezioni parziali. Tutte le impostazioni delle proprietà del sistema JVM sono supportate da AWS SDK per Java and the only. AWS SDK per Kotlin
| SDK | Supportata | Note o ulteriori informazioni |
|---|---|---|
| AWS CLI v2 | Sì | Built-in impaginazione automatica per tutti i comandi. Usa per --no-paginate disattivare. |
| SDK per C++ | No | È richiesta la gestione manuale dei token. |
| SDK per Go V2 (1.x) | Sì | Tipi di utilizzo. New<OperationName>Paginator |
| SDK per Go 1.x (V1) | Sì | Metodi di utilizzo. <OperationName>Pages |
| SDK per Java 2.x | Sì | Usa <operationName>Paginator i metodi sul client. |
| SDK per Java 1.x | Sì | |
| SDK per 3.x JavaScript | Sì | Usa le funzionipaginate<OperationName>. |
| SDK per 2.x JavaScript | No | È richiesta la gestione manuale dei token. |
| SDK per Kotlin | Sì | Usa le funzioni di estensione<operationName>Paginated. |
| SDK per .NET 4.x | Sì | Usa le interfacceIPaginator. |
| SDK per .NET 3.x | Sì | Usa le interfacceIPaginator. |
| SDK per PHP 3.x | Sì | Uso getPaginator sul client. |
| SDK per Python (Boto3) | Sì | Usare get_paginator sul client. |
| SDK per Ruby 3.x | Sì | Da utilizzare .each sulle risposte che supportano l'impaginazione. |
| SDK per Rust | Sì | Usa .into_paginator() su richiesta i costruttori. |
| SDK per Swift | Sì | Tipi di utilizzoPaginatedSequence. |
| Strumenti per PowerShell V5 | Sì | Built-in impaginazione automatica. Usa per -NoAutoIteration disattivare. |
| Strumenti per PowerShell V4 | Sì |
