Habilitar e usar os prompts de comando na AWS CLI - AWS Command Line Interface
Como funcionaRecursos do prompt automáticoModos de prompt automáticoConfigurar o prompt automático

Habilitar e usar os prompts de comando na AWS CLI

Você pode fazer com que a AWS CLI versão 2 solicite comandos, parâmetros e recursos quando você executa um comando da aws.

Como funciona

Se estiver habilitado, o prompt automático permitirá usar a tecla ENTER para concluir um comando inserido parcialmente. Após pressionar a tecla ENTER, comandos, parâmetros e recursos serão sugeridos com base no que você digitar. As sugestões listam o nome do comando, parâmetro ou recurso à esquerda e uma descrição dele à direita. Para selecionar e usar uma sugestão, use as teclas de setas para realçar uma linha e pressione aBarra de espaço. Após terminar de inserir seu comando, pressione ENTER para executá-lo. O exemplo a seguir demonstra como é a aparência de uma lista sugerida do prompt automático.

$ aws
> aws a
       accessanalyzer                Access Analyzer
       acm                           AWS Certificate Manager
       acm-pca                       AWS Certificate Manager Private Certificate Authority
       alexaforbusiness              Alexa For Business
       amplify                       AWS Amplify

Recursos do prompt automático

O prompt automático contém os seguintes recursos úteis:

Painel de documentação

Fornece a documentação de ajuda para o comando atual. Para abrir a documentação, pressione a tecla F3.

Conclusão de comando

Sugere comandos da aws que podem ser usados. Para ver uma lista, digite parcialmente o comando. O exemplo a seguir está procurando um serviço começando com a letra a.

$ aws
> aws a
       accessanalyzer                Access Analyzer
       acm                           AWS Certificate Manager
       acm-pca                       AWS Certificate Manager Private Certificate Authority
       alexaforbusiness              Alexa For Business
       amplify                       AWS Amplify
Preenchimento automático de parâmetros

Depois que um comando é digitado, o prompt automático começa a sugerir parâmetros. As descrições dos parâmetros incluem o tipo de valor e uma descrição do que é o parâmetro. Os parâmetros obrigatórios são listados primeiro e rotulados conforme necessário. O exemplo a seguir mostra a lista de parâmetros do aws dynamodb describe-table.

$ aws dynamodb describe-table
> aws dynamodb describe-table 
                              --table-name (required)  [string] The name of the table to describe.
                               --cli-input-json         [string] Reads arguments from the JSON string provided. The JSON string follows the format provide...
                               --cli-input-yaml         [string] Reads arguments from the YAML string provided. The YAML string follows the format provide...
                               --generate-cli-skeleton  [string] Prints a JSON skeleton to standard output without sending an API request. If provided wit...
Preenchimento automático de recursos

O prompt automático faz chamadas de API da AWS usando propriedades de recursos da AWS disponíveis para sugerir valores de recursos. Isso permite que o prompt automático sugira possíveis recursos pertencentes a você ao inserir parâmetros. No exemplo a seguir, o prompt automático lista seus nomes de tabela ao preencher o parâmetro --table-name do comando aws dynamodb describe-table.

$ aws dynamodb describe-table
> aws dynamodb describe-table --table-name 
                                            Table1
                                            Table2
                                            Table3
Preenchimento automático de sintaxe abreviada

Para parâmetros que usam sintaxe abreviada, o prompt automático sugere valores a serem usados. No exemplo a seguir, o prompt automático lista os valores de sintaxe abreviada para o parâmetro --placement no comando aws ec2 run-instances.

$ aws ec2 run-instances
> aws ec2 run-instances --placement 
 AvailabilityZone=      [string] The Availability Zone of the instance. If not specified, an Availability Zone wil...
 Affinity=              [string] The affinity setting for the instance on the Dedicated Host. This parameter is no...
 GroupName=             [string] The name of the placement group the instance is in.
 PartitionNumber=       [integer] The number of the partition the instance is in. Valid only if the placement grou...
Preenchimento automático de nomes de arquivos

Ao preencher parâmetros em comandos da aws, o preenchimento automático sugere nomes de arquivos locais após o uso dos prefixos file:// ou fileb://. No exemplo a seguir, o prompt automático sugere arquivos locais depois da inserção de --item file:// para o comando aws ec2 run-instances.

$ aws ec2 run-instances
> aws ec2 run-instances --item file:// 
                         item1.txt
                         file1.json
                         file2.json
Preenchimento automático de regiões

Ao usar o parâmetro global --region, o prompt automático lista as possíveis regiões para seleção. No exemplo a seguir, o prompt automático sugere regiões depois da inserção de --region para o comando aws dynamodb list-tables.

$ aws dynamodb list-tables
> aws dynamodb list-tables --region 
                                     af-south-1
                                     ap-east-1
                                     ap-northeast-1
                                     ap-northeast-2
Preenchimento automático de perfis

Quando o parâmetro global --profile é usado, o prompt automático lista seus perfis. No exemplo a seguir, o prompt automático sugere seus perfis depois da inserção de --profile para o comando aws dynamodb list-tables.

$ aws dynamodb list-tables
> aws dynamodb list-tables --profile 
                                     profile1
                                     profile2
                                     profile3
Pesquisas difusas

Completa comandos e valores que contêm um conjunto específico de caracteres. No exemplo a seguir, o prompt automático sugere regiões que contêm eu depois da inserção de --region eu para o comando aws dynamodb list-tables.

$ aws dynamodb list-tables
> aws dynamodb list-tables --region west
                                         eu-west-1
                                         eu-west-2
                                         eu-west-3
                                         us-west-1
Histórico

Para visualizar e executar comandos usados anteriormente no modo de prompt automático, pressione CTRL + R. O histórico lista os comandos anteriores que você pode selecionar usando as teclas de seta. No exemplo a seguir, o histórico do modo de prompt automático é exibido.

$ aws
> aws 
        dynamodb list-tables
        s3 ls

Modos de prompt automático

O prompt automático para a AWS CLI versão 2 oferece 2 modos configuráveis:

  • Modo completo: usa o prompt automático cada vez que você tenta executar um comando aws, seja quando chamado manualmente via parâmetro --cli-auto-prompt, seja quando habilitado permanentemente. Isso inclui pressionar ENTER após um comando completo ou um comando incompleto.

  • Modo parcial: usa o prompt automático se um comando está incompleto ou não pode ser executado devido a erros de validação no lado do cliente. Esse modo é particularmente útil se você tem scripts pré-existentes, runbooks ou se deseja receber o prompt automático somente para comandos com os quais você não está familiarizado, em vez de ver o prompt para todos os comandos.

Configurar o prompt automático

Para configurar o prompt automático, você pode usar os seguintes métodos em ordem de precedência: