Usar ModifyInstanceAttribute com uma CLI - Exemplos de código do AWS SDK

Há mais exemplos do AWS SDK disponíveis no repositório do GitHub Documento de Exemplos do AWS SDK.

Usar ModifyInstanceAttribute com uma CLI

Os exemplos de código a seguir mostram como usar o ModifyInstanceAttribute.

CLI
AWS CLI

Exemplo 1: modificar o tipo de instância

O exemplo modify-instance-attribute a seguir modifica o tipo de instância da instância especificada. A instância deve estar no estado stopped.

aws ec2 modify-instance-attribute \ --instance-id i-1234567890abcdef0 \ --instance-type "{\"Value\": \"m1.small\"}"

Este comando não produz saída.

Exemplo 2: habilitar a rede aprimorada em uma instância

O exemplo modify-instance-attribute a seguir ativa a rede aprimorada para a instância especificada. A instância deve estar no estado stopped.

aws ec2 modify-instance-attribute \ --instance-id i-1234567890abcdef0 \ --sriov-net-support simple

Este comando não produz saída.

Exemplo 3: modificar o atributo sourceDestCheck

O exemplo modify-instance-attribute a seguir define o atributo sourceDestCheck para a instância especificada para true. A instância deve estar em uma VPC.

aws ec2 modify-instance-attribute --instance-id i-1234567890abcdef0 --source-dest-check "{\"Value\": true}"

Este comando não produz saída.

Exemplo 4: modificar o atributo deleteOnTermination do volume raiz

O exemplo modify-instance-attribute a seguir define o atributo deleteOnTermination para o volume raiz da instância especificada com suporte do Amazon EBS para false. Por padrão, esse atributo é true para o volume raiz.

Comando:

aws ec2 modify-instance-attribute \ --instance-id i-1234567890abcdef0 \ --block-device-mappings "[{\"DeviceName\": \"/dev/sda1\",\"Ebs\":{\"DeleteOnTermination\":false}}]"

Este comando não produz saída.

Exemplo 5: modificar os dados do usuário anexados a uma instância

O exemplo modify-instance-attribute a seguir adiciona o conteúdo do arquivo UserData.txt como UserData para a instância especificada.

Conteúdo do arquivo UserData.txt original:

#!/bin/bash yum update -y service httpd start chkconfig httpd on

O conteúdo do arquivo deve ser codificado em base64. O primeiro comando converte o arquivo de texto em base64 e o salva como um novo arquivo.

Versão Linux/macOS do comando:

base64 UserData.txt > UserData.base64.txt

Este comando não produz saída.

Versão Windows do comando:

certutil -encode UserData.txt tmp.b64 && findstr /v /c:- tmp.b64 > UserData.base64.txt

Saída:

Input Length = 67 Output Length = 152 CertUtil: -encode command completed successfully.

Agora você pode referenciar esse arquivo no comando CLI a seguir:

aws ec2 modify-instance-attribute \ --instance-id=i-09b5a14dbca622e76 \ --attribute userData --value file://UserData.base64.txt

Este comando não produz saída.

Para obter mais informações, consulte Dados do usuário e CLI AWS no Guia do usuário do EC2.

PowerShell
Ferramentas para PowerShell V4

Exemplo 1: esse exemplo modifica o tipo de instância da instância especificada.

Edit-EC2InstanceAttribute -InstanceId i-12345678 -InstanceType m3.medium

Exemplo 2: esse exemplo habilita redes aprimoradas para a instância especificada, especificando “simple” como o valor do parâmetro de suporte de rede de virtualização de E/S raiz única (SR-IOV), -SriovNetSupport.

Edit-EC2InstanceAttribute -InstanceId i-12345678 -SriovNetSupport "simple"

Exemplo 3: esse exemplo modifica os grupos de segurança da instância especificada. A instância deve estar em uma VPC. Você deve especificar o ID de cada grupo de segurança, não o nome.

Edit-EC2InstanceAttribute -InstanceId i-12345678 -Group @( "sg-12345678", "sg-45678901" )

Exemplo 4: esse exemplo permite a otimização de E/S do EBS para a instância especificada. Esse recurso não está disponível com todos os tipos de instâncias. As cobranças de uso adicionais serão aplicadas quando uma instância otimizada para EBS for usada.

Edit-EC2InstanceAttribute -InstanceId i-12345678 -EbsOptimized $true

Exemplo 5: esse exemplo habilita a verificação de origem/destino da instância especificada. Para que a instância execute a NAT, o valor deve ser “false”.

Edit-EC2InstanceAttribute -InstanceId i-12345678 -SourceDestCheck $true

Exemplo 6: esse exemplo desabilita o encerramento da instância especificada.

Edit-EC2InstanceAttribute -InstanceId i-12345678 -DisableApiTermination $true

Exemplo 7: esse exemplo altera a instância especificada para que ela seja encerrada quando o desligamento for iniciado por meio da instância.

Edit-EC2InstanceAttribute -InstanceId i-12345678 -InstanceInitiatedShutdownBehavior terminate
  • Consulte detalhes da API em ModifyInstanceAttribute na Referência de cmdlet do Ferramentas da AWS para PowerShell (V4).

Ferramentas para PowerShell V5

Exemplo 1: esse exemplo modifica o tipo de instância da instância especificada.

Edit-EC2InstanceAttribute -InstanceId i-12345678 -InstanceType m3.medium

Exemplo 2: esse exemplo habilita redes aprimoradas para a instância especificada, especificando “simple” como o valor do parâmetro de suporte de rede de virtualização de E/S raiz única (SR-IOV), -SriovNetSupport.

Edit-EC2InstanceAttribute -InstanceId i-12345678 -SriovNetSupport "simple"

Exemplo 3: esse exemplo modifica os grupos de segurança da instância especificada. A instância deve estar em uma VPC. Você deve especificar o ID de cada grupo de segurança, não o nome.

Edit-EC2InstanceAttribute -InstanceId i-12345678 -Group @( "sg-12345678", "sg-45678901" )

Exemplo 4: esse exemplo permite a otimização de E/S do EBS para a instância especificada. Esse recurso não está disponível com todos os tipos de instâncias. As cobranças de uso adicionais serão aplicadas quando uma instância otimizada para EBS for usada.

Edit-EC2InstanceAttribute -InstanceId i-12345678 -EbsOptimized $true

Exemplo 5: esse exemplo habilita a verificação de origem/destino da instância especificada. Para que a instância execute a NAT, o valor deve ser “false”.

Edit-EC2InstanceAttribute -InstanceId i-12345678 -SourceDestCheck $true

Exemplo 6: esse exemplo desabilita o encerramento da instância especificada.

Edit-EC2InstanceAttribute -InstanceId i-12345678 -DisableApiTermination $true

Exemplo 7: esse exemplo altera a instância especificada para que ela seja encerrada quando o desligamento for iniciado por meio da instância.

Edit-EC2InstanceAttribute -InstanceId i-12345678 -InstanceInitiatedShutdownBehavior terminate
  • Consulte detalhes da API em ModifyInstanceAttribute na Referência de cmdlet do Ferramentas da AWS para PowerShell (V5).