Usar ModifyInstanceAttribute com uma CLI - Amazon Elastic Compute Cloud

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

Resultado:

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 da instância especificada.

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

Exemplo 2: esse exemplo habilita redes aprimoradas para a instância especificada, determinando “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 habilita 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ância. 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 uma instância NAT execute 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 cmdlets do Ferramentas da AWS para PowerShell (V4).

Ferramentas para PowerShell V5

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

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

Exemplo 2: esse exemplo habilita redes aprimoradas para a instância especificada, determinando “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 habilita 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ância. 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 uma instância NAT execute 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 cmdlets do Ferramentas da AWS para PowerShell (V5).

Para ver uma lista completa dos Guias do desenvolvedor e exemplos de código do SDK da AWS, consulte Crie recursos do Amazon EC2 usando um AWS SDK. Este tópico também inclui informações sobre como começar e detalhes sobre versões anteriores do SDK.