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à.
Opzioni della riga di comando in AWS CLI
In AWS CLI, le opzioni della riga di comando sono parametri globali che è possibile utilizzare per sovrascrivere le impostazioni di configurazione predefinite, qualsiasi impostazione del profilo corrispondente o l'impostazione della variabile di ambiente per quel singolo comando. Non puoi utilizzare le opzioni della riga di comando per specificare direttamente le credenziali, anche se puoi specificare il profilo da utilizzare.
Argomenti
Come utilizzare le opzioni della riga di comando
La maggior parte delle opzioni della riga di comando sono stringhe semplici, come il nome del profilo profile1 nell’esempio seguente:
$aws s3 ls --profileprofile1amzn-s3-demo-bucket1 amzn-s3-demo-bucket2 ...
Ogni opzione che accetta un argomento richiede uno spazio o un simbolo di uguale ("=") che separa l'argomento dal nome dell'opzione. Se il valore dell'argomento è una stringa che contiene uno spazio, occorre racchiudere l'argomento tra virgolette. Per informazioni dettagliate sui tipi di argomenti e sulla formattazione dei parametri, consulta Specificare dei valori di parametro nella AWS CLI.
AWS CLI opzioni della riga di comando globali supportate
In AWS CLI è possibile utilizzare le seguenti opzioni della riga di comando per sovrascrivere le impostazioni di configurazione predefinite, qualsiasi impostazione del profilo corrispondente o l'impostazione della variabile di ambiente per quel singolo comando.
- --ca-bundle
<string> -
Specificare il bundle di certificati CA (Certificate Authority, autorità di certificazione) da utilizzare per la verifica dei certificati SSL.
Se definita, questa opzione sostituisce il valore per l’impostazione del profilo
ca_bundlee la variabile di ambienteAWS_CA_BUNDLE. - --cli-auto-prompt
-
Abilita la modalità di prompt automatico per un singolo comando. Come illustrato negli esempi seguenti, è possibile specificarlo in qualsiasi momento.
$aws --cli-auto-prompt$aws dynamodb --cli-auto-prompt$aws dynamodb describe-table --cli-auto-promptQuesta impostazione sostituisce la variabile di ambiente
aws_cli_auto_prompte la configurazione del profilocli_auto_prompt.Per informazioni sulla funzionalità di richiesta automatica della AWS CLI versione 2, vedere. Attivazione e utilizzo dei prompt dei comandi in AWS CLI
- --cli-binary-format
-
Specifica in che modo la AWS CLI versione 2 interpreta i parametri di input binari. Può essere uno dei seguenti valori:
-
Base64: si tratta del valore predefinito. Un parametro di input digitato come oggetto binario di grandi dimensioni (BLOB) accetta una stringa con codifica base64. Per passare il contenuto binario vero, inserire il contenuto in un file e fornire il percorso e il nome del file con il prefisso
fileb://come valore del parametro. Per passare il testo codificato in base 64 contenuto in un file, specificare il percorso e il nome del file con il prefissofile://come valore del parametro. -
raw-in-base64-out: impostazione predefinita per la AWS CLI versione 1. Se il valore dell'impostazione è
raw-in-base64-out, i file a cui si fa riferimento utilizzando ilfile://prefisso vengono letti come testo e quindi i AWS CLI tentativi di codificarli in formato binario.
Questo sovrascrive l’impostazione di configurazione del file
cli_binary_format.$aws lambda invoke \ --cli-binary-format raw-in-base64-out \ --function-name my-function \ --invocation-type Event \ --payload '{ "name": "Bob" }' \ response.jsonSe si fa riferimento a un valore binario in un file utilizzando la notazione del
fileb://prefisso, si aspetta AWS CLI sempre che il file contenga contenuto binario non elaborato e non tenta di convertire il valore.Se si fa riferimento a un valore binario in un file utilizzando la notazione del
file://prefisso, AWS CLI gestisce il file in base all'impostazione corrente.cli_binary_formatSe il valore di tale impostazione èbase64(l'impostazione predefinita quando non è impostata in modo esplicito), si AWS CLI aspetta che il file contenga testo con codifica base64. Se il valore di tale impostazione èraw-in-base64-out, la AWS CLI prevede che nel file sia presente contenuto binario non elaborato. -
- --cli-connect-timeout
<integer> -
Specifica il tempo di connessione socket massimo in secondi. Se il valore è impostato su zero (0), la connessione socket attende per un periodo di tempo indefinito (si blocca) e non si verifica alcun timeout. Il valore predefinito è 60 secondi.
- --cli-read-timeout
<integer> -
Specifica il tempo di lettura del socket massimo in secondi. Se il valore è impostato su zero (0), la lettura del socket attende per un periodo di tempo indefinito (si blocca) e non si verifica alcun timeout. Il valore predefinito è 60 secondi.
- --colore
<string> -
Specifica il supporto per l'output di colori. I valori validi sono
on,offeauto. Il valore predefinito èauto. - --debug
-
Un interruttore booleano che abilita la registrazione di debug. Per AWS CLI impostazione predefinita, fornisce informazioni dettagliate su eventuali successi o fallimenti relativi ai risultati dei comandi nell'output del comando. L’opzione
--debugfornisce i log completi di Python. Sono incluse informazioni di diagnosticastderraggiuntive sull’operazione del comando che possono essere utili per capire i motivi per cui un comando restituisce risultati imprevisti. Per visualizzare facilmente i log di debug, suggeriamo di inviare i log in un file per cercare più facilmente le informazioni. Puoi farlo usando i seguenti metodi:Per inviare solo le informazioni di diagnostica
stderr, aggiungi2> debug.txtdovedebug.txtè il nome che desideri utilizzare per il file di debug:$aws2>servicenamecommandnameoptions--debugdebug.txtPer inviare sia le informazioni di output che quelle di diagnostica
stderr, aggiungi&> debug.txtdovedebug.txtè il nome che desideri utilizzare per il file di debug:$aws&>servicenamecommandnameoptions--debugdebug.txt - --endpoint-url
<string> -
Specifica l'URL a cui inviare la richiesta. Per la maggior parte dei comandi, determina AWS CLI automaticamente l'URL in base al servizio selezionato e alla regione specificata. AWS Tuttavia, alcuni comandi ti richiedono di specificare un URL specifico dell'account. Puoi anche configurare alcuni AWS servizi per ospitare un endpoint direttamente all'interno del tuo VPC privato, che potrebbe quindi dover essere specificato.
Il comando di esempio seguente utilizza un URL personalizzato per l’endpoint Amazon S3.
$aws s3 ls --endpoint-urlhttp://localhost:4567Priorità degli endpoint
Le impostazioni di configurazione degli endpoint si trovano in più posizioni, ad esempio le variabili di sistema o di ambiente utente, i file di AWS configurazione locali o sono dichiarate esplicitamente nella riga di comando come parametro. AWS CLI Controlla queste impostazioni dell'endpoint in un ordine particolare e utilizza l'impostazione dell'endpoint con la massima precedenza. Per l’elenco delle priorità degli endpoint, consulta Configurazione dell’endpoint e precedenza delle impostazioni.
- --no-cli-auto-prompt
-
Disabilita la modalità di prompt automatico per un singolo comando.
$aws dynamodb describe-table --table-name Table1 --no-cli-auto-promptQuesta impostazione sostituisce la variabile di ambiente
aws_cli_auto_prompte la configurazione del profilocli_auto_prompt.Per informazioni sulla funzionalità di richiesta automatica della AWS CLI versione 2, vedere. Attivazione e utilizzo dei prompt dei comandi in AWS CLI
- --no-cli-pager
-
Un interruttore booleano che disabilita l’uso di un pager per l’output del comando.
- --no-paginate
-
Uno switch booleano che disattiva le chiamate multiple AWS CLI esegue automaticamente la ricezione di tutti i risultati dei comandi che creano l'impaginazione dell'output. Ciò significa che viene visualizzata solo la prima pagina dell’output.
- --no-sign-request
-
Un interruttore booleano che disabilita la firma delle richieste HTTP all'endpoint del servizio. AWS In questo modo si evita il caricamento delle credenziali.
- --no-verify-ssl
-
Per impostazione predefinita, AWS CLI utilizza SSL per comunicare con i servizi. AWS Per ogni connessione e chiamata SSL, AWS CLI verifica i certificati SSL. L’utilizzo di questa opzione ha la precedenza sul comportamento predefinito di verifica dei certificati SSL.
avvertimento
Questa non è una best practice. Se lo utilizzi
--no-verify-ssl, il traffico tra il cliente e i AWS servizi non è più sicuro. Ciò significa che il traffico rappresenta un rischio per la sicurezza ed è vulnerabile agli man-in-the-middle exploit. Se riscontri problemi con i certificati, è preferibile risolverli. Per la procedura di risoluzione dei problemi relativi ai certificati, consulta Errori di certificato SSL. - --uscita
<string> -
Specifica il formato di output da utilizzare per questo comando. Puoi specificare uno qualsiasi dei valori seguenti:
-
yaml-stream: l’output viene inviato in streaming e formattato come una stringa YAML
. Lo streaming consente una gestione più rapida di tipi di dati di grandi dimensioni. -
text: l’output è formattato come più righe di valori di stringa separati da tabulazioni. Questa formattazione può essere utile per passare l’output a un elaboratore di testi, ad esempio
grep,sedoawk. -
table: l’output è formattato come una tabella in cui si utilizzano i caratteri +|- per formare i bordi delle celle. In genere presenta le informazioni in un formato comprensibile molto più semplice da leggere rispetto ad altri, ma non altrettanto utile a livello programmatico.
- --profilo
<string> -
Specifica il profilo denominato da utilizzare per questo comando. Per impostare profili denominati aggiuntivi, puoi utilizzare il comando
aws configurecon l'opzione--profile.$aws configure --profile<profilename> - --interrogazione
<string> -
Specifica una JMESPath query
da utilizzare per filtrare i dati di risposta. Per ulteriori informazioni, consulta Uscita di filtraggio nel AWS CLI. - --region
<string> -
Speciifica a quale AWS regione inviare la AWS richiesta di questo comando. Per un elenco di tutte le regioni che puoi specificare, consulta Regioni ed endpoint AWS nella Riferimenti generali di Amazon Web Services.
- --v2-debug
-
Abilita la modalità di debug per l'aggiornamento da v1 a v2. In questa modalità, AWS CLI rileverà l'utilizzo delle funzionalità che sono state aggiornate con modifiche sostanziali nella AWS CLI v2 e emetterà avvisi per ogni utilizzo rilevato che è potenzialmente interessato. È possibile utilizzare questa modalità per preparare l'ambiente e l' AWS CLI utilizzo per l'aggiornamento alla v2.
Questa opzione sovrascrive la variabile di ambiente.
AWS_CLI_UPGRADE_DEBUG_MODEPer informazioni sulla modalità di debug di aggiornamento AWS CLI da v1 a v2, consulta Utilizzo della modalità di debug di aggiornamento per aggiornare la CLI versione 1 alla AWS CLI versione 2. AWS
- --version
-
Un interruttore booleano che visualizza la versione corrente del programma in esecuzione. AWS CLI
Utilizzi comuni delle opzioni della riga di comando
Usi comuni per le opzioni della riga di comando includono il controllo delle risorse in più regioni AWS e la modifica del formato di output per maggiore leggibilità o facilità d'uso al momento della creazione di script. Negli esempi seguenti, eseguiamo il comando describe-instances su ciascuna Regione finché non individuiamo in quale Regione si trova la nostra istanza.
$aws ec2 describe-instances --output table --regionus-west-1------------------- |DescribeInstances| +-----------------+$aws ec2 describe-instances --output table --regionus-west-2------------------------------------------------------------------------------ | DescribeInstances | +----------------------------------------------------------------------------+ || Reservations || |+-------------------------------------+------------------------------------+| || OwnerId | 012345678901 || || ReservationId | r-abcdefgh || |+-------------------------------------+------------------------------------+| ||| Instances ||| ||+------------------------+-----------------------------------------------+|| ||| AmiLaunchIndex | 0 ||| ||| Architecture | x86_64 ||| ...