Estrutura de comando no AWS CLI - AWS Command Line Interface
Estrutura do comandoComandos de espera

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

Estrutura de comando no AWS CLI

Este tópico aborda como o comando AWS Command Line Interface (AWS CLI) é estruturado e como usar comandos de espera.

Estrutura do comando

O AWS CLI usa uma estrutura de várias partes na linha de comando que deve ser especificada nesta ordem:

  1. A chamada básica para o programa aws.

  2. O comando de nível superior, que normalmente corresponde a um AWS serviço suportado pelo AWS CLI.

  3. O subcomando que especifica a operação a ser realizada.

  4. AWS CLI Opções ou parâmetros gerais exigidos pela operação. Você pode especificá-los em qualquer ordem, desde que siga as três primeiras partes. Se um parâmetro exclusivo for especificado várias vezes, apenas o último valor se aplicará.

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

Os parâmetros podem assumir vários tipos de valores de entrada, como números, cadeias de caracteres, listas, mapas e JSON estruturas. O que é compatível depende do comando e do subcomando que você especificar.

Amazon S3

O exemplo a seguir lista todos os seus buckets do Amazon S3.

$ aws s3 ls
2018-12-11 17:08:50 my-bucket
2018-12-14 14:55:44 my-bucket2

Para obter mais informações sobre os comandos do Amazon S3, consulte aws s3 na Referência de comandos da AWS CLI .

AWS CloudFormation

O exemplo de comando a seguir altera o nome da pilha cloudformation para my-change-set.

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

Para obter mais informações sobre os AWS CloudFormation comandos, consulte na Referência de AWS CLI Comandos.

Comandos de espera

Alguns AWS serviços têm wait comandos disponíveis. Qualquer comando que usa aws wait normalmente espera até que um comando seja concluído antes de passar para a próxima etapa. Isso é especialmente útil para comandos em várias partes ou scripts, pois você pode usar um comando wait para impedir o avanço para etapas subsequentes se o comando wait falhar.

O AWS CLI usa uma estrutura de várias partes na linha de comando para o wait comando que deve ser especificada nesta ordem:

  1. A chamada básica para o programa aws.

  2. O comando de nível superior, que normalmente corresponde a um AWS serviço suportado pelo AWS CLI.

  3. O comando wait.

  4. O subcomando que especifica a operação a ser realizada.

  5. CLIOpções ou parâmetros gerais exigidos pela operação. Você pode especificá-los em qualquer ordem, desde que siga as três primeiras partes. Se um parâmetro exclusivo for especificado várias vezes, apenas o último valor se aplicará.

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

Os parâmetros podem assumir vários tipos de valores de entrada, como números, cadeias de caracteres, listas, mapas e JSON estruturas. O que é compatível depende do comando e do subcomando que você especificar.

nota

Nem todo AWS serviço oferece suporte a wait comandos. Consulte o guia de de referência da versão 2 para ver se seu serviço oferece suporte a wait comandos.

AWS CloudFormation

Os exemplos de comando a seguir são pausados e retomados somente depois de confirmar que o my-change-set alteração definida no my-stack a pilha está pronta para ser executada.

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

Para obter mais informações sobre os comandos AWS CloudFormation wait, consulte wait na Referência de comandos da AWS CLI .

AWS CodeDeploy

Os exemplos de comando a seguir fazem uma pausa até o d-A1B2C3111 a implantação é concluída com êxito.

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

Para obter mais informações sobre os comandos AWS CodeDeploy wait, consulte wait na Referência de comandos da AWS CLI .