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

Tipi di parametri comuni in AWS CLI

Questa sezione descrive alcuni tipi di parametri comuni e il formato tipico richiesto.

Se hai problemi a formattare un parametro per un comando specifico, consulta l'aiuto inserendo help dopo il nome del comando. L'aiuto per ogni sottocomando include il nome e la descrizione di un'opzione. Il tipo di parametro dell'opzione è elencato tra parentesi. Per ulteriori informazioni sulla visualizzazione della guida, vedere. Accesso all'aiuto e alle risorse per AWS CLI

Stringa

I parametri delle stringhe possono contenere caratteri alfanumerici, simboli e spazi bianchi del set di ASCIIcaratteri. Le stringhe che contengono spazi bianchi devono essere racchiuse tra virgolette. Ti consigliamo di non utilizzare simboli o spazi bianchi diversi dal carattere di spazio standard e di osservare le regole di citazione del tuo terminale per evitare risultati imprevisti.

Alcuni parametri di stringa accettano i dati binari da un file. Consulta File binari per un esempio.

Timestamp

I timestamp sono formattati secondo lo standard 8601. ISO Questi sono spesso denominati parametri "" o DateTime "». Date

$ aws ec2 describe-spot-price-history --start-time 2014-10-13T19:00:00Z

I formati accettabili includono:

Per impostazione predefinita, la AWS CLI versione 2 traduce tutti i DateTime valori di risposta nel formato 8601. ISO

È possibile impostare il formato del timestamp utilizzando l'impostazione del file. cli_timestamp_format

Elenco

Una o più stringhe separate da spazi. Se uno degli elementi della stringa contiene uno spazio, devi racchiuderlo tra virgolette. Osservate le regole di quotazione del vostro terminale per evitare risultati imprevisti.

$ aws ec2 describe-spot-price-history --instance-types m1.xlarge m1.medium

Booleano

Bandiera binaria che attiva o disattiva un'opzione. Ad esempio, ec2 describe-spot-price-history ha un parametro --dry-run booleano che, quando specificato, consente di convalidare la query con il servizio anche senza eseguire la query.

$ aws ec2 describe-spot-price-history --dry-run

L'output indica se il formato del comando è valido. Questo comando include anche una versione --no-dry-run del parametro, che puoi utilizzare per indicare esplicitamente che il comando deve essere eseguito normalmente, anche se non è necessario includerlo poiché questa è l'impostazione predefinita.

Numero intero

Numero intero senza firma.

$ aws ec2 describe-spot-price-history --max-items 5

Binary/blob (oggetto binario di grandi dimensioni) e blob in streaming

In AWS CLI, è possibile passare un valore binario come stringa direttamente sulla riga di comando. Esistono due tipi di blob:

Blob

Per passare un valore a un parametro con tipoblob, è necessario specificare un percorso a un file locale che contiene i dati binari utilizzando il fileb:// prefisso. I file a cui si fa riferimento utilizzando il fileb:// prefisso vengono sempre trattati come file binari non codificati non elaborati. Il percorso specificato viene interpretato come relativo alla directory di lavoro. Ad esempio, il parametro --plaintext per aws kms encrypt è un blob.

$ aws kms encrypt \
    --key-id 1234abcd-12ab-34cd-56ef-1234567890ab \
    --plaintext fileb://ExamplePlaintextFile \
    --output text \
    --query CiphertextBlob | base64 \
    --decode > ExampleEncryptedFile

Blob in streaming

I blob di streaming, ad esempio Do not use aws cloudsearchdomain upload-documents prefissi. Invece, i parametri dello streaming blob vengono formattati utilizzando il percorso diretto del file. L'esempio seguente utilizza il percorso diretto del file document-batch.json per il aws cloudsearchdomain upload-documents comando:

$ aws cloudsearchdomain upload-documents \
    --endpoint-url https://doc-my-domain.us-west-1.cloudsearch.amazonaws.com \
    --content-type application/json \
    --documents document-batch.json

Eseguire la mappatura

Un insieme di coppie chiave-valore specificate in JSON o utilizzando la sintassi abbreviata CLI di. L'JSONesempio seguente legge un elemento da una tabella Amazon DynamoDB denominata my-table con un parametro map,. --key Il parametro specifica la chiave primaria denominata id con un valore numerico pari a 1 in una struttura annidata. JSON

Per un JSON utilizzo più avanzato in una riga di comando, prendi in considerazione l'utilizzo di un JSON processore da riga di comando, ad esempio jq per creare JSON stringhe. Per maggiori informazioni sujq, consulta il repository jq su. GitHub

$ aws dynamodb get-item --table-name my-table --key '{"id": {"N":"1"}}'

{
    "Item": {
        "name": {
            "S": "John"
        },
        "id": {
            "N": "1"
        }
    }
}

Documento

I tipi di documento vengono utilizzati per inviare dati senza la necessità di incorporarli all'interno di stringhe. JSON Il tipo di documento consente ai servizi di fornire schemi arbitrari per l'utilizzo di tipi di dati più flessibili.

Ciò consente l'invio di JSON dati senza la necessità di sfuggire ai valori. Ad esempio, invece di utilizzare il seguente input con escapeJSON:

{"document": "{\"key\":true}"}

È possibile utilizzare il seguente tipo di documento:

{"document": {"key": true}}

Valori validi per i tipi di documento

A causa della natura flessibile dei tipi di documento, esistono più tipi di valori validi. I valori validi includono i seguenti: