Há mais exemplos de AWS SDK disponíveis no repositório AWS Doc SDK Examples
As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.
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: Para modificar o sourceDestCheck atributo
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: Para modificar o deleteOnTermination atributo 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
modify-instance-attributeexemplo a seguir adiciona o conteúdo do arquivoUserData.txtcomo UserData o da 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.txtSaí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 \ --attributeuserData--valuefile://UserData.base64.txtEste comando não produz saída.
Para obter mais informações, consulte Dados do usuário e a AWS CLI no Guia do EC2 usuário.
-
Para obter detalhes da API, consulte ModifyInstanceAttribute
em Referência de AWS CLI Comandos.
-
- 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.mediumExemplo 2: Este exemplo habilita redes aprimoradas para a instância especificada, especificando “simple” como o valor do parâmetro de suporte de rede de I/O virtualização de 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 a 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 I/O otimização do EBS para a instância especificada. Esse recurso não está disponível em todos os tipos de instância. Taxas de uso adicionais se aplicam ao usar uma instância otimizada para EBS.
Edit-EC2InstanceAttribute -InstanceId i-12345678 -EbsOptimized $trueExemplo 5: Este exemplo permite a source/destination verificação da instância especificada. Para que uma instância NAT realize NAT, o valor deve ser 'false'.
Edit-EC2InstanceAttribute -InstanceId i-12345678 -SourceDestCheck $trueExemplo 6: Este exemplo desativa 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 a partir da instância.
Edit-EC2InstanceAttribute -InstanceId i-12345678 -InstanceInitiatedShutdownBehavior terminate-
Para obter detalhes da API, consulte ModifyInstanceAttributeem Referência de Ferramentas da AWS para PowerShell cmdlet (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.mediumExemplo 2: Este exemplo habilita redes aprimoradas para a instância especificada, especificando “simple” como o valor do parâmetro de suporte de rede de I/O virtualização de 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 a 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 I/O otimização do EBS para a instância especificada. Esse recurso não está disponível em todos os tipos de instância. Taxas de uso adicionais se aplicam ao usar uma instância otimizada para EBS.
Edit-EC2InstanceAttribute -InstanceId i-12345678 -EbsOptimized $trueExemplo 5: Este exemplo permite a source/destination verificação da instância especificada. Para que uma instância NAT realize NAT, o valor deve ser 'false'.
Edit-EC2InstanceAttribute -InstanceId i-12345678 -SourceDestCheck $trueExemplo 6: Este exemplo desativa 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 a partir da instância.
Edit-EC2InstanceAttribute -InstanceId i-12345678 -InstanceInitiatedShutdownBehavior terminate-
Para obter detalhes da API, consulte ModifyInstanceAttributeem Referência de Ferramentas da AWS para PowerShell cmdlet (V5).
-