Hay más ejemplos de AWS SDK disponibles en el GitHub repositorio de [ejemplos de AWS Doc SDK](https://github.com/awsdocs/aws-doc-sdk-examples). Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés. # Utilizar `ModifyInstanceAttribute` con una CLI Los siguientes ejemplos de código muestran cómo utilizar `ModifyInstanceAttribute`. ------ #### [ CLI ] **AWS CLI** **Ejemplo 1: modificación del tipo de instancia** En el siguiente ejemplo de `modify-instance-attribute` se modifica el tipo de instancia de la instancia especificada. La instancia debe tener el estado `stopped`. ``` aws ec2 modify-instance-attribute \ --instance-id {{i-1234567890abcdef0}} \ --instance-type "{\"Value\": \"m1.small\"}" ``` Este comando no genera ninguna salida. **Ejemplo 2: habilitación de redes mejoradas en una instancia** En el siguiente ejemplo de `modify-instance-attribute` se habilitan las redes mejoradas para la instancia especificada. La instancia debe tener el estado `stopped`. ``` aws ec2 modify-instance-attribute \ --instance-id {{i-1234567890abcdef0}} \ --sriov-net-support {{simple}} ``` Este comando no genera ninguna salida. **Ejemplo 3: Para modificar el DestCheck atributo de origen** En el siguiente ejemplo de `modify-instance-attribute` se establece el atributo `sourceDestCheck` de la instancia especificada en `true`. La instancia debe encontrarse en una VPC. ``` aws ec2 modify-instance-attribute --instance-id {{i-1234567890abcdef0}} --source-dest-check "{\"Value\": true}" ``` Este comando no genera ninguna salida. **Ejemplo 4: Para modificar el OnTermination atributo de eliminación del volumen raíz** El siguiente `modify-instance-attribute` ejemplo establece el `deleteOnTermination` atributo del volumen raíz de la EBS-backed instancia de Amazon especificada en`false`. De forma predeterminada, este atributo es `true` para el volumen raíz. Comando: ``` aws ec2 modify-instance-attribute \ --instance-id {{i-1234567890abcdef0}} \ --block-device-mappings "[{\"DeviceName\": \"/dev/sda1\",\"Ebs\":{\"DeleteOnTermination\":false}}]" ``` Este comando no genera ninguna salida. **Ejemplo 5: modificación de los datos de usuario asociados a una instancia** En el siguiente `modify-instance-attribute` ejemplo, se añade el contenido del archivo `UserData.txt` como el UserData de la instancia especificada. Contenido del archivo original `UserData.txt`: ``` #!/bin/bash yum update -y service httpd start chkconfig httpd on ``` El contenido del archivo debe estar codificado en base64. El primer comando convierte el archivo de texto a base64 y lo guarda como un archivo nuevo. Linux/macOS versión del comando: ``` base64 UserData.txt > UserData.base64.txt ``` Este comando no genera ninguna salida. Versión del comando para Windows: ``` certutil -encode UserData.txt tmp.b64 && findstr /v /c:- tmp.b64 > UserData.base64.txt ``` Salida: ``` Input Length = 67 Output Length = 152 CertUtil: -encode command completed successfully. ``` Ahora puede hacer referencia a ese archivo en el siguiente comando de la CLI: ``` aws ec2 modify-instance-attribute \ --instance-id=i-09b5a14dbca622e76 \ --attribute {{userData}} --value {{file://UserData.base64.txt}} ``` Este comando no genera ninguna salida. Para obtener más información, consulte [Datos de usuario y AWS CLI](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/user-data.html#user-data-api-cli) en la *Guía del usuario de EC2*. + Para obtener más información sobre la API, consulte [ModifyInstanceAttribute](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/modify-instance-attribute.html)la *Referencia de AWS CLI comandos*. ------ #### [ PowerShell ] **Herramientas para la PowerShell versión 4** **Ejemplo 1: En este ejemplo se modifica el tipo de instancia de la instancia especificada.** ``` Edit-EC2InstanceAttribute -InstanceId i-12345678 -InstanceType m3.medium ``` **Ejemplo 2: Este ejemplo permite mejorar las redes para la instancia especificada, especificando «simple» como el valor del parámetro de soporte de red de I/O virtualización de raíz única (SR-IOV), -SriovNetSupport..** ``` Edit-EC2InstanceAttribute -InstanceId i-12345678 -SriovNetSupport "simple" ``` **Ejemplo 3: En este ejemplo se modifican los grupos de seguridad para la instancia especificada. La instancia debe encontrarse en una VPC. Debe especificar el ID de cada grupo de seguridad, no su nombre.** ``` Edit-EC2InstanceAttribute -InstanceId i-12345678 -Group @( "sg-12345678", "sg-45678901" ) ``` **Ejemplo 4: Este ejemplo permite la I/O optimización de EBS para la instancia especificada. Esta característica no está disponible con todos los tipos de instancia. Se aplican cargos de uso adicionales al usar una EBS-optimized instancia.** ``` Edit-EC2InstanceAttribute -InstanceId i-12345678 -EbsOptimized $true ``` **Ejemplo 5: Este ejemplo permite source/destination comprobar la instancia especificada. Para que una instancia de NAT se ejecute, el valor debe ser “false”.** ``` Edit-EC2InstanceAttribute -InstanceId i-12345678 -SourceDestCheck $true ``` **Ejemplo 6: En este ejemplo se deshabilita la terminación de la instancia especificada.** ``` Edit-EC2InstanceAttribute -InstanceId i-12345678 -DisableApiTermination $true ``` **Ejemplo 7: En este ejemplo se cambia la instancia especificada para que termine cuando se inicie el cierre desde la instancia.** ``` Edit-EC2InstanceAttribute -InstanceId i-12345678 -InstanceInitiatedShutdownBehavior terminate ``` + Para obtener más información sobre la API, consulte [ModifyInstanceAttribute Herramientas de AWS para PowerShell](https://docs.aws.amazon.com/powershell/v4/reference)*Cmdlet Reference (V4)*. **Herramientas para la versión 5 PowerShell ** **Ejemplo 1: En este ejemplo se modifica el tipo de instancia de la instancia especificada.** ``` Edit-EC2InstanceAttribute -InstanceId i-12345678 -InstanceType m3.medium ``` **Ejemplo 2: Este ejemplo permite mejorar las redes para la instancia especificada, especificando «simple» como el valor del parámetro de soporte de red de I/O virtualización de raíz única (SR-IOV), -.. SriovNetSupport** ``` Edit-EC2InstanceAttribute -InstanceId i-12345678 -SriovNetSupport "simple" ``` **Ejemplo 3: En este ejemplo se modifican los grupos de seguridad para la instancia especificada. La instancia debe encontrarse en una VPC. Debe especificar el ID de cada grupo de seguridad, no su nombre.** ``` Edit-EC2InstanceAttribute -InstanceId i-12345678 -Group @( "sg-12345678", "sg-45678901" ) ``` **Ejemplo 4: Este ejemplo permite la I/O optimización de EBS para la instancia especificada. Esta característica no está disponible con todos los tipos de instancia. Se aplican cargos de uso adicionales al usar una EBS-optimized instancia.** ``` Edit-EC2InstanceAttribute -InstanceId i-12345678 -EbsOptimized $true ``` **Ejemplo 5: Este ejemplo permite source/destination comprobar la instancia especificada. Para que una instancia de NAT se ejecute, el valor debe ser “false”.** ``` Edit-EC2InstanceAttribute -InstanceId i-12345678 -SourceDestCheck $true ``` **Ejemplo 6: En este ejemplo se deshabilita la terminación de la instancia especificada.** ``` Edit-EC2InstanceAttribute -InstanceId i-12345678 -DisableApiTermination $true ``` **Ejemplo 7: En este ejemplo se cambia la instancia especificada para que termine cuando se inicie el cierre desde la instancia.** ``` Edit-EC2InstanceAttribute -InstanceId i-12345678 -InstanceInitiatedShutdownBehavior terminate ``` + Para obtener más información sobre la API, consulte [ModifyInstanceAttribute Herramientas de AWS para PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet Reference (V5)*. ------