Utilizar ModifyInstanceAttribute con una CLI - Amazon Elastic Compute Cloud

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: modificación del atributo sourceDestCheck

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: modificación del atributo deleteOnTermination del volumen raíz

En el siguiente ejemplo de modify-instance-attribute se establece en false el atributo deleteOnTermination para el volumen raíz de la instancia respaldada por Amazon EBS especificada. 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 ejemplo de modify-instance-attribute se agrega el contenido del archivo UserData.txt como 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.

Versión del comando para Linux/macOS:

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 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.medium

Ejemplo 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 $true

Ejemplo 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 $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 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.medium

Ejemplo 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 $true

Ejemplo 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 $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 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.