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 --profile
profile1
amzn-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, vedere. Specificazione dei valori dei parametri nel 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>
-
Speciifica il pacchetto di certificati dell'autorità di certificazione (CA) da utilizzare per la verifica dei certificati. SSL
Se definita, questa opzione sostituisce il valore per l'impostazione del profilo e la variabile di ambiente
ca_bundle
.AWS_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-prompt
Questa opzione sostituisce la variabile di
aws_cli_auto_prompt
ambiente e l'impostazione delcli_auto_prompt
profilo.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 — Questo è il 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 versione 1. AWS CLI 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 binario.
Ciò ha la precedenza sull'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.json
Se 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_format
Se 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
, si AWS CLI aspetta che il file contenga 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.
- --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.
- --colore
<string>
-
Specifica il supporto per l'output di colori. I valori validi sono
on
,off
eauto
. 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'
--debug
opzione fornisce i log completi di Python. Ciò include informazionistderr
diagnostiche aggiuntive sul funzionamento del comando che possono essere utili per la risoluzione dei motivi per cui un comando fornisce risultati imprevisti. Per visualizzare facilmente i log di debug, si consiglia di inviare i log in un file per facilitare la ricerca delle informazioni. È possibile eseguire questa operazione utilizzando uno dei seguenti metodi.Per inviare solo le informazioni di
stderr
diagnostica, aggiungi2> debug.txt
debug.txt
dov'è il nome che vuoi usare per il tuo file di debug:$
aws
2>servicename
commandname
options
--debugdebug.txt
Per inviare sia le informazioni di output che quelle di
stderr
diagnostica, aggiungi&> debug.txt
dovedebug.txt
è il nome che vuoi usare per il tuo file di debug:$
aws
&>servicename
commandname
options
--debugdebug.txt
- --endpoint-url
<string>
-
Specifica a chi inviare la URL richiesta. Per la maggior parte dei comandi, determina AWS CLI automaticamente il URL valore in base al servizio selezionato e alla AWS regione specificata. Tuttavia, alcuni comandi richiedono la specificazione di un account specifico. URL Puoi anche configurare alcuni AWS servizi per ospitare un endpoint direttamente all'interno del tuo account privato VPC, cosa che potrebbe quindi dover essere specificata.
Il seguente esempio di comando utilizza un endpoint Amazon S3 personalizzato. URL
$
aws s3 ls --endpoint-url
http://localhost:4567
Le impostazioni di configurazione degli endpoint si trovano in più posizioni, ad esempio nelle variabili di sistema o di ambiente utente, nei file di AWS configurazione locali, oppure sono dichiarate esplicitamente nella riga di comando come parametro. Le impostazioni di configurazione AWS CLI degli endpoint hanno la precedenza nell'ordine seguente:
-
L'opzione della
--endpoint-url
riga di comando. -
Se abilitata, la variabile di ambiente
AWS_IGNORE_CONFIGURED_ENDPOINT_URLS
globale dell'endpoint o l'impostazione del profiloignore_configure_endpoint_urls
per ignorare gli endpoint personalizzati. -
Il valore fornito da una variabile
AWS_ENDPOINT_URL_<SERVICE>
di ambiente specifica del servizio, ad esempio.AWS_ENDPOINT_URL_DYNAMODB
-
I valori forniti dalle variabili
AWS_USE_DUALSTACK_ENDPOINT
AWS_USE_FIPS_ENDPOINT
, e diAWS_ENDPOINT_URL
ambiente. -
Il valore dell'endpoint specifico del servizio fornito dall'
endpoint_url
impostazione all'interno di unaservices
sezione del file condiviso.config
-
Il valore fornito dall'
endpoint_url
impostazione all'interno di unoprofile
dei file condivisi.config
-
use_dualstack_endpoint
use_fips_endpoint
eendpoint_url
impostazioni. -
Qualsiasi endpoint predefinito URL per il rispettivo dispositivo Servizio AWS viene utilizzato per ultimo. Per un elenco degli endpoint del servizio standard disponibili in ogni regione, consulta Regioni ed endpoint AWS nella Riferimenti generali di Amazon Web Services.
-
- --no-cli-auto-prompt
-
Disattiva la modalità di prompt automatico per un singolo comando.
$
aws dynamodb describe-table --table-name Table1 --no-cli-auto-prompt
Questa opzione sostituisce la variabile di
aws_cli_auto_prompt
ambiente e l'impostazione del profilo.cli_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'utilizzo di un cercapersone per l'output del comando.
- --no-paginate
-
Un interruttore booleano che disabilita le chiamate multiple esegue automaticamente la ricezione di tutti i risultati dei comandi AWS CLI 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 HTTP richieste all'endpoint del AWS servizio. In questo modo si evita il caricamento delle credenziali.
- --no-verify-ssl
-
Per impostazione predefinita, vengono AWS CLI utilizzati SSL quando si comunica con i servizi. AWS Per ogni SSL connessione e chiamata, AWS CLI verifica i SSL certificati. L'utilizzo di questa opzione sostituisce il comportamento predefinito di verifica dei certificati. SSL
avvertimento
Questa opzione non è una procedura consigliata. Se la utilizzi
--no-verify-ssl
, il traffico tra il cliente e AWS i 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, è meglio risolvere invece tali problemi. Per la procedura di risoluzione dei problemi relativi ai certificati, consultaSSLerrori nei certificati. - --output
<string>
-
Specifica il formato di output da utilizzare per questo comando. Puoi specificare uno qualsiasi dei valori seguenti:
-
yaml-stream— L'output viene trasmesso in streaming e formattato come 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. Questo può essere utile per passare l'output a un elaboratore di testi, ad esempio
grep
,sed
o.awk
-
table— L'output viene formattato come tabella utilizzando 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.
- --profile
<string>
-
Specifica il profilo denominato da utilizzare per questo comando. Per impostare profili denominati aggiuntivi, puoi utilizzare il comando
aws configure
con l'opzione--profile
.$
aws configure --profile
<profilename>
- --query
<string>
-
Specifica una JMESPathquery
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 richiesta di AWS questo comando. Per un elenco di tutte le regioni che puoi specificare, consulta Regioni ed endpoint AWS nella Riferimenti generali di Amazon Web Services.
- --versione
-
Un interruttore booleano che visualizza la versione corrente del AWS CLI programma in esecuzione.
Usi 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 --region
us-west-1
------------------- |DescribeInstances| +-----------------+
$aws ec2 describe-instances --output table --region
us-west-2
------------------------------------------------------------------------------ | DescribeInstances | +----------------------------------------------------------------------------+ || Reservations || |+-------------------------------------+------------------------------------+| || OwnerId | 012345678901 || || ReservationId | r-abcdefgh || |+-------------------------------------+------------------------------------+| ||| Instances ||| ||+------------------------+-----------------------------------------------+|| ||| AmiLaunchIndex | 0 ||| ||| Architecture | x86_64 ||| ...