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-attributea seguir modifica o tipo de instância da instância especificada. A instância deve estar no estadostopped.aws ec2 modify-instance-attribute \ --instance-idi-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-attributea seguir ativa a rede aprimorada para a instância especificada. A instância deve estar no estadostopped.aws ec2 modify-instance-attribute \ --instance-idi-1234567890abcdef0\ --sriov-net-supportsimpleEste comando não produz saída.
Exemplo 3: modificar o atributo sourceDestCheck
O exemplo
modify-instance-attributea seguir define o atributosourceDestCheckpara a instância especificada paratrue. A instância deve estar em uma VPC.aws ec2 modify-instance-attribute --instance-idi-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-attributea seguir define o atributodeleteOnTerminationpara o volume raiz da instância especificada com suporte do Amazon EBS parafalse. Por padrão, esse atributo étruepara o volume raiz.Comando:
aws ec2 modify-instance-attribute \ --instance-idi-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-attributea seguir adiciona o conteúdo do arquivoUserData.txtcomo UserData para a instância especificada.Conteúdo do arquivo
UserData.txtoriginal:#!/bin/bash yum update -y service httpd start chkconfig httpd onO 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.txtEste comando não produz saída.
Versão Windows do comando:
certutil -encode UserData.txt tmp.b64 && findstr /v /c:- tmp.b64 > UserData.base64.txtResultado:
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 \ --attributeuserData--valuefile://UserData.base64.txtEste 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.
-
Para ver detalhes da API, consulte ModifyInstanceAttribute
na Referência de comandos da AWS CLI.
-
- PowerShell
-
- Ferramentas para PowerShell V4
-
Exemplo 1: esse exemplo modifica o tipo da instância especificada.
Edit-EC2InstanceAttribute -InstanceId i-12345678 -InstanceType m3.mediumExemplo 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 $trueExemplo 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 $trueExemplo 6: esse exemplo desabilita o encerramento da instância especificada.
Edit-EC2InstanceAttribute -InstanceId i-12345678 -DisableApiTermination $trueExemplo 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.mediumExemplo 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 $trueExemplo 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 $trueExemplo 6: esse exemplo desabilita o encerramento da instância especificada.
Edit-EC2InstanceAttribute -InstanceId i-12345678 -DisableApiTermination $trueExemplo 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.