Struttura di comando in AWS CLI - AWS Command Line Interface
Struttura di comandoComandi wait

Struttura di comando in AWS CLI

Questo argomento illustra come è strutturato il comando AWS Command Line Interface (AWS CLI) e come utilizzare i comandi wait.

Struttura di comando

La AWS CLI utilizza una struttura in più parti nella riga di comando che deve essere specificata in questo ordine:

  1. La chiamata di base al programma aws.

  2. Il comando di livello superiore, che in genere corrisponde a un servizio AWS supportato dall'AWS CLI.

  3. Il sottocomando che specifica l'operazione da eseguire.

  4. Le opzioni o i parametri della AWS CLI generali necessari per l’operazione. Possono essere specificati in qualsiasi ordine, purché seguano le prime tre parti. Se un parametro esclusivo viene specificato più volte, si applica solo l'ultimo valore.

$ aws <command> <subcommand> [options and parameters]

I parametri possono utilizzare vari tipi di valori di input, ad esempio numeri, stringhe, elenchi, mappe e strutture JSON. Quanto supportato dipende dal comando e dal sottocomando specificati.

Amazon S3

L’esempio seguente elenca tutti i tuoi bucket Amazon S3.

$ aws s3 ls
2018-12-11 17:08:50 amzn-s3-demo-bucket1
2018-12-14 14:55:44 amzn-s3-demo-bucket2

Per ulteriori informazioni sull’utilizzo dei comandi Amazon S3, consulta aws s3 in AWS CLI Command Reference.

AWS CloudFormation

Il seguente esempio del comando create-change-set modifica il nome dello stack in my-change-set.

$ aws cloudformation create-change-set --stack-name my-stack --change-set-name my-change-set

Per ulteriori informazioni sui comandi AWS CloudFormation, consulta aws cloudformation in AWS CLI Command Reference.

Comandi wait

Alcuni servizi AWS dispongono dei comandi wait. Qualsiasi comando che utilizza aws wait in genere attende il completamento di un comando prima di passare alla fase successiva. Ciò è particolarmente utile per i comandi multiparte o gli script, poiché è possibile utilizzare un comando wait per evitare di passare alle fasi successive se il comando wait ha esito negativo.

La AWS CLI utilizza una struttura in più parti nella riga di comando per il comando wait che deve essere specificata in questo ordine:

  1. La chiamata di base al programma aws.

  2. Il comando di livello superiore, che in genere corrisponde a un servizio AWS supportato dall'AWS CLI.

  3. Il comando wait.

  4. Il sottocomando che specifica l'operazione da eseguire.

  5. Le opzioni o i parametri dell'interfaccia a riga di comando necessari per l'operazione. Possono essere specificati in qualsiasi ordine, purché seguano le prime tre parti. Se un parametro esclusivo viene specificato più volte, si applica solo l'ultimo valore.

$ aws <command> wait <subcommand> [options and parameters]

I parametri possono utilizzare vari tipi di valori di input, ad esempio numeri, stringhe, elenchi, mappe e strutture JSON. Quanto supportato dipende dal comando e dal sottocomando specificati.

Nota

Non tutti i servizi AWS supportano i comandi wait. Consulta la AWS CLI version 2 reference guide per verificare se il tuo servizio supporta i comandi wait.

AWS CloudFormation

I seguenti esempi di comandi wait change-set-create-complete si interrompono e riprendono solo dopo aver confermato che il set di modifiche my-change-set nello stack my-stack è pronto per l’esecuzione.

$ aws cloudformation wait change-set-create-complete --stack-name my-stack --change-set-name my-change-set

Per ulteriori informazioni sui comandi AWS CloudFormation wait, consulta wait in AWS CLI Command Reference.

AWS CodeDeploy

I seguenti esempi di comando wait deployment-successful si mettono in pausa finché l’implementazione d-A1B2C3111 viene completata correttamente.

$ aws deploy wait deployment-successful --deployment-id d-A1B2C3111

Per ulteriori informazioni sui comandi AWS CodeDeploy wait, consulta wait in AWS CLI Command Reference.