Alterar um tipo de instância do Amazon EC2 com um script bash na AWS CLI - AWS Command Line Interface
Antes de começarSobre este exemploParâmetrosArquivosReferências

Esta documentação é somente para a versão 1 da AWS CLI. Para obter a documentação relacionada à AWS CLI versão 2, consulte o Guia do usuário da versão 2.

Alterar um tipo de instância do Amazon EC2 com um script bash na AWS CLI

Este exemplo de script bash para Amazon EC2 altera o tipo de instância para uma instância do Amazon EC2 usando a AWS Command Line Interface (AWS CLI). Ele interrompe a instância se ela estiver em execução, altera o tipo de instância e, em seguida, se solicitado, a reinicia. Scripts shell são programas desenvolvidos para ser executados em uma interface de linha de comando.

nota

Para obter exemplos de outros comandos, consulte o AWS CLIGuia de referência da .

Antes de começar

Antes que você possa executar qualquer um dos exemplos abaixo, as seguintes tarefas deverão ser concluídas.

  • Instale e configure a AWS CLI. Para ter mais informações, consulte Instalar, atualizar e desinstalar a AWS CLI e Autenticação e credenciais de acesso para a AWS CLI.

  • O perfil utilizado deve ter permissões que garantem as operações da AWS realizadas pelos exemplos.

  • Uma instância do Amazon EC2 em execução na conta para a qual você tem permissão para interromper e modificar. Se você executar o script de teste, ele iniciará uma instância para você, testará alterando o tipo e encerrará a instância.

  • Como prática recomendada da AWS, conceda a esse código privilégio mínimo ou apenas as permissões necessárias para executar uma tarefa. Para obter mais informações, consulte Conceder privilégio mínimo no Manual do usuário do AWS Identity and Access Management (IAM).

  • Este código não foi testado em todas as regiões da AWS. Alguns serviços da AWS só estão disponíveis em regiões específicas. Para obter mais informações, consulte Endpoints de serviço e cotas no Guia de referência geral da AWS.

  • Executar este código pode resultar em cobranças em sua conta da AWS. É sua responsabilidade garantir que todos os recursos criados por este script sejam removidos após você terminar de usá-los.

Sobre este exemplo

Este exemplo é escrito como uma função no arquivo de script shell change_ec2_instance_type.sh que você pode usar como source a partir de outro script ou da linha de comando. Cada arquivo de script contém comentários descrevendo cada uma das funções. Uma vez que a função esteja na memória, você poderá chamá-la via linha de comando. Por exemplo, os seguintes comandos alteram o tipo de instância especificada para t2.nano:

$ source ./change_ec2_instance_type.sh
$ ./change_ec2_instance_type -i *instance-id* -t new-type

Para obter o exemplo completo e arquivos de script para download, consulte Alterar tipo de instância do Amazon EC2 no Repositório de exemplos de código da AWS no GitHub.

Parâmetros

-i: (string) especifica o ID da instância a ser modificada.

-t: (string) especifica o tipo de instância do Amazon EC2 de destino.

-r: (opção) por padrão, não está definida. Se -r estiver definido, reiniciará a instância após a alteração do tipo.

-f: (opção) por padrão, o script solicita ao usuário que confirme o encerramento da instância antes de fazer a mudança. Se -f estiver definida, a função não avisará o usuário antes de encerrar a instância para realizar a alteração de tipo.

-v: (opção) por padrão, o script opera silenciosamente e exibe a saída somente em caso de erro. Se -v estiver definida, a função exibirá o status ao longo de sua operação.

Arquivos

change_ec2_instance_type.sh

O arquivo de script principal contém a função change_ec2_instance_type() que executa as seguintes tarefas:

  • Verifica se a instância do Amazon EC2 especificada existe.

  • A menos que a opção -f esteja selecionada, avisará o usuário antes de interromper a instância.

  • Altera o tipo de instância

  • Se você definir -r, reiniciará a instância e confirmará que a instância está sendo executada

Visualize o código para change_ec2_instance_type.sh no GitHub.

test_change_ec2_instance_type.sh

O script do arquivo test_change_ec2_instance_type.sh testa os vários caminhos de código para a função change_ec2_instance_type. Se todas as etapas no script de teste funcionarem corretamente, ele removerá todos os recursos que criou.

Você pode executar o script de teste com os seguintes parâmetros:

  • -v: (opção) cada teste mostra um status de aprovação/falha conforme eles são executados. Por padrão, os testes são executados silenciosamente e a saída inclui apenas o status final de aprovação/falha.

  • -i: (opção) o script faz uma pausa após cada teste para permitir que você navegue pelos resultados intermediários de cada etapa. Isso permite examinar o status atual da instância usando o console do Amazon EC2. O script avançará para a próxima etapa após você pressionar ENTER no prompt.

Visualize o código para test_change_ec2_instance_type.sh no GitHub.

awsdocs_general.sh

O arquivo de script awsdocs_general.sh contém funções de uso geral usadas em exemplos avançados para a AWS CLI.

Visualize o código para awsdocs_general.sh no GitHub.

Referências

Referência da AWS CLI:

Outra referência: