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-attributese modifica el tipo de instancia de la instancia especificada. La instancia debe tener el estadostopped.aws ec2 modify-instance-attribute \ --instance-idi-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-attributese habilitan las redes mejoradas para la instancia especificada. La instancia debe tener el estadostopped.aws ec2 modify-instance-attribute \ --instance-idi-1234567890abcdef0\ --sriov-net-supportsimpleEste comando no genera ninguna salida.
Ejemplo 3: modificación del atributo sourceDestCheck
En el siguiente ejemplo de
modify-instance-attributese establece el atributosourceDestCheckde la instancia especificada entrue. La instancia debe encontrarse en una VPC.aws ec2 modify-instance-attribute --instance-idi-1234567890abcdef0--source-dest-check "{\"Value\": true}"Este comando no genera ninguna salida.
Ejemplo 4: modificación del atributo deleteOnTermination del volumen raíz
En el siguiente ejemplo de
modify-instance-attributese establece enfalseel atributodeleteOnTerminationpara el volumen raíz de la instancia respaldada por Amazon EBS especificada. De forma predeterminada, este atributo estruepara el volumen raíz.Comando:
aws ec2 modify-instance-attribute \ --instance-idi-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 ejemplo de
modify-instance-attributese agrega el contenido del archivoUserData.txtcomo UserData de la instancia especificada.Contenido del archivo original
UserData.txt:#!/bin/bash yum update -y service httpd start chkconfig httpd onEl 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.
Versión del comando para Linux/macOS:
base64 UserData.txt > UserData.base64.txtEste comando no genera ninguna salida.
Versión del comando para Windows:
certutil -encode UserData.txt tmp.b64 && findstr /v /c:- tmp.b64 > UserData.base64.txtSalida:
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 \ --attributeuserData--valuefile://UserData.base64.txtEste comando no genera ninguna salida.
Para obtener más información, consulte Datos de usuario y las AWS CLI en la Guía del usuario de Amazon EC2.
-
Para obtener información sobre la API, consulte ModifyInstanceAttribute
en la Referencia de comandos de la AWS CLI.
-
- PowerShell
-
- Herramientas para PowerShell V4
-
Ejemplo 1: En este ejemplo se modifica el tipo de instancia de la instancia especificada.
Edit-EC2InstanceAttribute -InstanceId i-12345678 -InstanceType m3.mediumEjemplo 2: Este ejemplo permite usar la conexión en red mejorada para la instancia especificada, especificando “simple” como el valor del parámetro de compatibilidad de red de virtualización de E/S 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: En este ejemplo se permite la optimización de E/S de EBS para la instancia especificada. Esta característica no está disponible con todos los tipos de instancia. Se aplicarán cargos por uso adicionales al utilizar una instancia optimizada para EBS.
Edit-EC2InstanceAttribute -InstanceId i-12345678 -EbsOptimized $trueEjemplo 5: En este ejemplo se habilita la comprobación de origen/destino de la instancia especificada. Para que una instancia de NAT se ejecute, el valor debe ser “false'.
Edit-EC2InstanceAttribute -InstanceId i-12345678 -SourceDestCheck $trueEjemplo 6: En este ejemplo se deshabilita la terminación de la instancia especificada.
Edit-EC2InstanceAttribute -InstanceId i-12345678 -DisableApiTermination $trueEjemplo 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 información sobre la API, consulte ModifyInstanceAttribute en la Referencia de cmdlets de Herramientas de AWS para PowerShell (V4).
-
- Herramientas para PowerShell V5
-
Ejemplo 1: En este ejemplo se modifica el tipo de instancia de la instancia especificada.
Edit-EC2InstanceAttribute -InstanceId i-12345678 -InstanceType m3.mediumEjemplo 2: Este ejemplo permite usar la conexión en red mejorada para la instancia especificada, especificando “simple” como el valor del parámetro de compatibilidad de red de virtualización de E/S 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: En este ejemplo se permite la optimización de E/S de EBS para la instancia especificada. Esta característica no está disponible con todos los tipos de instancia. Se aplicarán cargos por uso adicionales al utilizar una instancia optimizada para EBS.
Edit-EC2InstanceAttribute -InstanceId i-12345678 -EbsOptimized $trueEjemplo 5: En este ejemplo se habilita la comprobación de origen/destino de la instancia especificada. Para que una instancia de NAT se ejecute, el valor debe ser “false'.
Edit-EC2InstanceAttribute -InstanceId i-12345678 -SourceDestCheck $trueEjemplo 6: En este ejemplo se deshabilita la terminación de la instancia especificada.
Edit-EC2InstanceAttribute -InstanceId i-12345678 -DisableApiTermination $trueEjemplo 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 información sobre la API, consulte ModifyInstanceAttribute en la Referencia de cmdlets de Herramientas de AWS para PowerShell (V5).
-
Para obtener una lista completa de las guías para desarrolladores de AWS SDK y ejemplos de código, consulte Creación de recursos de Amazon EC2 mediante una AWS SDK. En este tema también se incluye información sobre cómo comenzar a utilizar el SDK y detalles sobre sus versiones anteriores.