AWS Command Line Interface
Guia do usuário

O que é o AWS Command Line Interface?

A AWS Command Line Interface (AWS CLI) é uma ferramenta de código aberto que permite interagir com os serviços da AWS usando comandos no shell da linha de comando. Com o mínimo de configuração, você pode começar a usar uma funcionalidade equivalente à fornecida pelo Console de gerenciamento da AWS baseado em navegador no prompt de comando do seu programa de terminal preferencial:

  • Shells do Linux – Use programas comuns de shell, como bash, zsh e tsch, para executar comandos em Linux, macOS, or Unix.

  • Linha de comando do Windows – No Windows, execute comandos no PowerShell ou no prompt de comando do Windows.

  • Remotamente – Execute comandos em instâncias do Amazon Elastic Compute Cloud (Amazon EC2) por meio de um terminal remoto, como PuTTY ou SSH, ou com o AWS Systems Manager.

Toda a administração, gerenciamento e funções de acesso da AWSIaaS (Infraestrutura como um serviço) no Console de gerenciamento da AWS estão disponíveis na API e CLI da AWS. Os novos recursos e serviços da AWS IaaS fornecem funcionalidade completa do Console de gerenciamento da AWS por meio da API e da CLI no lançamento ou dentro de 180 dias após o lançamento.

A AWS CLI fornece acesso direto às APIs públicas de serviços da AWS. Você pode explorar os recursos de um serviço com a AWS CLI e desenvolver scripts de shell para gerenciar seus recursos. Ou você pode utilizar o que aprender para desenvolver programas em outras linguagens usando SDKs da AWS.

Além dos comandos de nível inferior equivalentes a API, vários serviços da AWS fornecem personalizações para a AWS CLI. As personalizações podem incluir comandos de nível mais elevado que simplificam o uso de um serviço com uma API complexa. Por exemplo, o conjunto de comandos aws s3 fornece uma sintaxe familiar para o gerenciamento de arquivos no Amazon Simple Storage Service (Amazon S3).

exemplo Para fazer upload de um arquivo ao Amazon S3

aws s3 cp fornece um comando de cópia do tipo shell, e automaticamente realiza um multipart upload para transferir arquivos grandes de maneira rápida e resiliente.

$ aws s3 cp myvideo.mp4 s3://mybucket/

Executar a mesma tarefa com os comandos de nível inferior (disponíveis em aws s3api) exigiria muito mais esforço.

Dependendo do seu caso de uso, você pode usar um dos SDKs da AWS ou o AWS Tools para PowerShell:

Você pode ver — e bifurcar — o código-fonte para a AWS CLI no GitHub no repositório aws-cli. Faça parte da comunidade de usuários no GitHub para fornecer feedback, solicitar recursos e enviar suas próprias contribuições!

Usar os exemplos neste guia

Os exemplos neste guia foram formatados por meio das seguintes convenções:

  • Prompt – em geral, o prompt de comando é exibido como um sinal de dólar seguido por um espaço ($ ). Para comandos que são específicos do Windows, C:\> é usado como o prompt. Não inclua o prompt ao digitar comandos.

  • Diretório – Quando comandos devem ser executados de um diretório específico, o nome do diretório é mostrado antes do símbolo do comando.

  • Entrada do usuário – O texto de comando inserido na linha de comando é formatado como user input.

  • Texto de substituição – O texto variável, incluindo nomes de recursos que você escolher ou IDs gerados pelos serviços da AWS, que você deve incluir em comandos é formatado como texto de substituição. Em comandos ou comandos de várias linhas, em que é necessária uma entrada específica do teclado, os comandos do teclado também podem ser exibidos como texto substituível.

  • Saída – A saída retornada pelos serviços da AWS é mostrada sob a entrada do usuário e é formatada como computer output.

Por exemplo, o seguinte comando inclui entradas do usuário, substituição de texto e saída.

$ aws configure AWS Access Key ID [None]: AKIAIOSFODNN7EXAMPLE AWS Secret Access Key [None]: wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY Default region name [None]: us-west-2 Default output format [None]: ENTER

Para usar esse exemplo, insira aws configure na linha de comando e pressione Enter. aws configure é o comando. Este comando é interativo, de modo que o AWS CLI resulta em linhas de textos, solicitando que você fornaça informações adicionais. Insira cada uma de suas chaves de acesso e pressione Enter. Depois, insira um nome de região da AWS no formato mostrado, pressione Enter e pressione Enter uma última vez para ignorar o formato de saída. O comando final Enter é mostrado como texto substituível porque não há entradas do usuário para essa linha. Caso contrário, ele seria implícito.

O exemplo a seguir mostra um comando não interativo simples com a saída de serviço em formato JSON.

$ aws ec2 create-security-group --group-name my-sg --description "My security group" { "GroupId": "sg-903004f8" }

Para usar este exemplo, insira o texto completo do comando (o texto destacado após o prompt) e pressione Enter. O nome do grupo de segurança, my-sg, é substituível. Neste caso, você pode usar o nome do grupo, conforme mostrado, mas use um nome mais descritivo.

nota

Argumentos que devem ser substituídos (como AWS Access Key ID) e aqueles que devem ser substituídos (como group name) aparecem como texto de substituição em itálico. Se um argumento deve ser substituído, ele será mencionado no texto que descreve o exemplo.

O documento JSON, incluindo as chaves, é saída. Se configurar o CLI para resultar em texto ou formato de tabela, a saída será formatada de forma diferente. JSON é o formato de saída padrão.

Sobre a Amazon Web Services

A Amazon Web Services (AWS) é um conjunto de serviços de infraestrutura digital que os desenvolvedores podem utilizar ao desenvolver seus aplicativos. Os serviços incluem computação, armazenamento, banco de dados e sincronização de aplicativos (sistema de mensagens e filas). A AWS usa um modelo de serviço de pagamento por utilização. Você será cobrado apenas pelos serviços que você ou seus aplicativos usarem. Além disso, para tornar AWS mais acessível como plataforma para criação de protótipos e experimentação, a AWS oferece um nível de uso gratuito. Neste nível, os serviços são gratuitos abaixo de um determinado nível de uso. Para obter mais informações sobre os custos da AWS e o nível gratuito, consulte Test-Driving AWS in the Free Usage Tier. Para obter uma conta da AWS, abra a Página inicial da AWS e clique em Cadastrar-se.