Há mais exemplos de AWS SDK disponíveis no repositório [AWS Doc SDK Examples](https://github.com/awsdocs/aws-doc-sdk-examples) GitHub . 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-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: Para modificar o sourceDestCheck atributo** 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: Para modificar o deleteOnTermination atributo 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 `modify-instance-attribute` exemplo a seguir adiciona o conteúdo do arquivo `UserData.txt` como UserData o da 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 a AWS CLI](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/user-data.html#user-data-api-cli) no Guia do usuário do *EC2*. + Para obter detalhes da API, consulte [ModifyInstanceAttribute](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/modify-instance-attribute.html)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.medium ``` **Exemplo 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 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 I/O otimização 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: Este exemplo permite a source/destination verificação 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 ``` + Para obter detalhes da API, consulte [ModifyInstanceAttribute](https://docs.aws.amazon.com/powershell/v4/reference)em *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.medium ``` **Exemplo 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 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 I/O otimização 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: Este exemplo permite a source/destination verificação 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 ``` + Para obter detalhes da API, consulte [ModifyInstanceAttribute](https://docs.aws.amazon.com/powershell/v5/reference)em *Referência de Ferramentas da AWS para PowerShell cmdlet (V5)*. ------