Utilizzo delle opzioni di impaginazione in AWS CLI - AWS Command Line Interface
Paginazione lato serverPager lato client

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à.

Utilizzo delle opzioni di impaginazione in AWS CLI

Questo argomento descrive i diversi modi per impaginare l'output di. AWS CLI

Esistono principalmente due modi per controllare l'impaginazione da. AWS CLI

I parametri di paginazione lato server elaborano e qualsiasi output viene inviato alla paginazione lato client.

Paginazione lato server

Per i comandi che possono restituire un ampio elenco di elementi, the AWS Command Line Interface (AWS CLI) ha diverse opzioni per controllare il numero di elementi inclusi nell'output quando viene AWS CLI chiamato un servizio API per compilare l'elenco.

Per impostazione predefinita, AWS CLI utilizza una dimensione di pagina determinata dal singolo servizio e recupera tutti gli elementi disponibili. Ad esempio, Amazon S3 ha una dimensione di pagina predefinita di 1000. Se esegui aws s3api list-objects su un bucket Amazon S3 che contiene 3.500 oggetti, effettua AWS CLI automaticamente quattro chiamate ad Amazon S3, gestendo la logica di impaginazione specifica del servizio in background e restituendo tutti i 3.500 oggetti nell'output finale.

Come usare il parametro --no-paginate

L'--no-paginateopzione disabilita i seguenti token di impaginazione sul lato client. Quando si utilizza un comando, per impostazione predefinita effettua AWS CLI automaticamente più chiamate per restituire tutti i risultati possibili per creare l'impaginazione. Una chiamata per ogni pagina. La disattivazione della paginazione comporta l' AWS CLI unica chiamata per la prima pagina dei risultati del comando.

Ad esempio, se esegui aws s3api list-objects su un bucket Amazon S3 che contiene 3.500 oggetti, effettua AWS CLI solo la prima chiamata ad Amazon S3, restituendo solo i primi 1.000 oggetti nell'output finale.

$ aws s3api list-objects \
    --bucket amzn-s3-demo-bucket \
    --no-paginate
{
    "Contents": [
...

Come usare il parametro --page-size

Se riscontri problemi durante l'esecuzione dei comandi di elenco su un gran numero di risorse, la dimensione predefinita della pagina potrebbe essere troppo alta. Ciò può far sì che le chiamate ai AWS servizi superino il tempo massimo consentito e generare un errore di «timeout». È possibile utilizzare l'--page-sizeopzione per specificare che si AWS CLI richiede un numero inferiore di elementi per ogni chiamata al AWS servizio. Continua AWS CLI a recuperare l'elenco completo, ma esegue un numero maggiore di API chiamate di servizio in background e recupera un numero inferiore di elementi a ogni chiamata. In questo modo, le chiamate individuali hanno una migliore possibilità di completamento prima della scadenza. La modifica delle dimensioni della pagina non influisce sull'output, ma solo sul numero di API chiamate da effettuare per generare l'output.

$ aws s3api list-objects \
    --bucket amzn-s3-demo-bucket \
    --page-size 100
{
    "Contents": [
...

Come usare il parametro --max-items

Per includere meno elementi alla volta nell' AWS CLI output, usa l'opzione. --max-items The AWS CLI still gestisce l'impaginazione con il servizio come descritto in precedenza, ma stampa solo il numero di elementi alla volta specificato.

$ aws s3api list-objects \
    --bucket amzn-s3-demo-bucket \
    --max-items 100
{
    "NextToken": "eyJNYXJrZXIiOiBudWxsLCAiYm90b190cnVuY2F0ZV9hbW91bnQiOiAxfQ==",
    "Contents": [
...

Come usare il parametro --starting-token

Se il numero di elementi output (--max-items) è inferiore al numero totale di elementi restituiti dalle API chiamate sottostanti, l'output include un elemento NextToken che è possibile passare a un comando successivo per recuperare il set di elementi successivo. L'esempio seguente mostra come usare il valore NextToken restituito dall'esempio precedente e consente di recuperare il secondo centinaio di elementi.

Nota

Il parametro --starting-token non può essere null o vuoto. Se il comando precedente non restituisce un valore NextToken, non esistono altre voci da restituire e non dovrai richiamare di nuovo il comando.

$ aws s3api list-objects \
    --bucket amzn-s3-demo-bucket \
    --max-items 100 \
    --starting-token eyJNYXJrZXIiOiBudWxsLCAiYm90b190cnVuY2F0ZV9hbW91bnQiOiAxfQ==
{
    "Contents": [
...

Il AWS servizio specificato potrebbe non restituire gli elementi nello stesso ordine ogni volta che si chiama. Se si specificano valori diversi per --page-size e --max-items, puoi ottenere risultati imprevisti con elementi mancanti o duplicati. Per evitarlo, utilizza lo stesso numero per --page-size e --max-items per sincronizzare la paginazione della AWS CLI con quella del servizio sottostante. Puoi anche recuperare l'intero elenco ed eseguire tutte le operazioni di paginazione necessarie in locale.

Pager lato client

AWS CLI la versione 2 prevede l'uso di un programma pager sul lato client per l'output. Per impostazione predefinita, questa caratteristica restituisce tutto l'output attraverso il programma pager predefinito del sistema operativo.

In ordine di precedenza, è possibile specificare il pager di output nei seguenti modi:

  • Utilizzando l'cli_pagerimpostazione nel config file nel profilo default o denominato.

  • Utilizzando la variabile di ambiente AWS_PAGER.

  • Utilizzando la variabile di ambiente PAGER.

In ordine di precedenza, è possibile disabilitare qualsiasi utilizzo di un programma di paging esterno nei seguenti modi:

  • Utilizzate l'opzione della riga di --no-cli-pager comando per disabilitare il pager per l'utilizzo di un singolo comando.

  • Imposta l'cli_pagerimpostazione o la AWS_PAGER variabile su una stringa vuota.

Argomenti del pager lato client:

Come usare l'impostazione cli_pager

Puoi salvare le impostazioni di configurazione e le credenziali utilizzate di frequente nei file gestiti da AWS CLI. Le impostazioni in un profilo di nome hanno la precedenza sulle impostazioni del profilo. default Per ulteriori informazioni sulle impostazioni di configurazione, vedereImpostazioni dei file di configurazione e credenziali in AWS CLI.

L'esempio seguente imposta il pager di output predefinito sul less programma.

[default]
cli_pager=less

L'esempio seguente configura l'impostazione predefinita per disabilitare l'uso di un pager.

[default]
cli_pager=

Come impostare la variabile di AWS_PAGER ambiente

L'esempio seguente imposta il pager di output predefinito per il less programma. Per ulteriori informazioni sulle variabili di ambiente, vedereConfigurazione delle variabili di ambiente per AWS CLI.

Linux and macOS
$ export AWS_PAGER="less"
Windows
C:\> setx AWS_PAGER "less"

Come usare l'no-cli-pageropzione --

Per disabilitare l'uso di un cercapersone su un singolo comando, utilizzate l'--no-cli-pageropzione. Per ulteriori informazioni sulle opzioni della riga di comando, Opzioni della riga di comando in AWS CLI consultate.

$ aws s3api list-objects \
    --bucket amzn-s3-demo-bucket \
    --no-cli-pager
{
    "Contents": [
...

Come usare i flag del pager

È possibile specificare i flag da utilizzare automaticamente con il programma di paging. I flag dipendono dal programma di paging utilizzato. Gli esempi seguenti riguardano le impostazioni predefinite tipiche di e. less more

Linux and macOS

Se non si specifica diversamente, il pager utilizzato per impostazione predefinita dalla AWS CLI versione 2 è. less Se la variabile di LESS ambiente non è impostata, la AWS CLI versione 2 utilizza i FRX flag. È possibile combinare i flag specificandoli durante l'impostazione del cercapersone. AWS CLI

L'esempio seguente utilizza il flag. S Questo flag si combina quindi con i FRX flag predefiniti per creare un FRXS flag finale.

$ export AWS_PAGER="less -S"

Se non vuoi nessuna delle FRX bandiere, puoi annullarle. L'esempio seguente nega il F flag per creare un flag finale. RX

$ export AWS_PAGER="less -+F"

Per maggiori informazioni sulle less bandiere, consulta meno su manpages.org.

Windows

Se non specificate diversamente, il pager utilizzato di default dalla AWS CLI versione 2 è more senza flag aggiuntivi.

L'esempio seguente utilizza il parametro. /c

C:\> setx AWS_PAGER "more /c"

Per ulteriori informazioni sui more flag, vedere more Microsoft Docs.