Utilizar ModifyImageAttribute con una CLI - Amazon Elastic Compute Cloud

Utilizar ModifyImageAttribute con una CLI

Los siguientes ejemplos de código muestran cómo utilizar ModifyImageAttribute.

CLI
AWS CLI

Ejemplo 1: operación de hacer pública una AMI

En el siguiente ejemplo de modify-instance-attribute se hace pública la AMI especificada.

aws ec2 modify-image-attribute \
    --image-id ami-5731123e \
    --launch-permission "Add=[{Group=all}]"

Este comando no genera ninguna salida.

Ejemplo 2: operación de hacer privada una AMI

En el siguiente ejemplo de modify-instance-attribute se hace privada la AMI especificada.

aws ec2 modify-image-attribute \
    --image-id ami-5731123e \
    --launch-permission "Remove=[{Group=all}]"

Este comando no genera ninguna salida.

Ejemplo 3: concesión de permiso de lanzamiento a una cuenta de AWS

En el siguiente ejemplo de modify-instance-attribute se conceden permisos de lanzamiento a la cuenta de AWS especificada.

aws ec2 modify-image-attribute \
    --image-id ami-5731123e \
    --launch-permission "Add=[{UserId=123456789012}]"

Este comando no genera ninguna salida.

Ejemplo 4: retirada de permiso de lanzamiento a una cuenta de AWS

En el siguiente ejemplo de modify-instance-attribute se retiran los permisos de lanzamiento a la cuenta de AWS especificada.

aws ec2 modify-image-attribute \
    --image-id ami-5731123e \
    --launch-permission "Remove=[{UserId=123456789012}]"

  • Para obtener información sobre la API, consulte ModifyImageAttribute en la Referencia de comandos de la AWS CLI.

PowerShell
Herramientas para PowerShell V4

Ejemplo 1: En este ejemplo se actualiza la descripción de la AMI especificada.

Edit-EC2ImageAttribute -ImageId ami-12345678 -Description "New description"

Ejemplo 2: En este ejemplo se hace pública la AMI (por ejemplo, para que cualquier Cuenta de AWS pueda utilizarla).

Edit-EC2ImageAttribute -ImageId ami-12345678 -Attribute launchPermission -OperationType add -UserGroup all

Ejemplo 3: En este ejemplo se hace privada la AMI (por ejemplo, para que solo usted, como propietario, pueda utilizarla).

Edit-EC2ImageAttribute -ImageId ami-12345678 -Attribute launchPermission -OperationType remove -UserGroup all

Ejemplo 4: En este ejemplo se conceden permisos de lanzamiento a la Cuenta de AWS especificada.

Edit-EC2ImageAttribute -ImageId ami-12345678 -Attribute launchPermission -OperationType add -UserId 111122223333

Ejemplo 5: En este ejemplo se elimina el permiso de lanzamiento de la especificada Cuenta de AWS.

Edit-EC2ImageAttribute -ImageId ami-12345678 -Attribute launchPermission -OperationType remove -UserId 111122223333

  • Para obtener información sobre la API, consulte ModifyImageAttribute en la Referencia de cmdlets de Herramientas de AWS para PowerShell (V4).

Herramientas para PowerShell V5

Ejemplo 1: En este ejemplo se actualiza la descripción de la AMI especificada.

Edit-EC2ImageAttribute -ImageId ami-12345678 -Description "New description"

Ejemplo 2: En este ejemplo se hace pública la AMI (por ejemplo, para que cualquier Cuenta de AWS pueda utilizarla).

Edit-EC2ImageAttribute -ImageId ami-12345678 -Attribute launchPermission -OperationType add -UserGroup all

Ejemplo 3: En este ejemplo se hace privada la AMI (por ejemplo, para que solo usted, como propietario, pueda utilizarla).

Edit-EC2ImageAttribute -ImageId ami-12345678 -Attribute launchPermission -OperationType remove -UserGroup all

Ejemplo 4: En este ejemplo se conceden permisos de lanzamiento a la Cuenta de AWS especificada.

Edit-EC2ImageAttribute -ImageId ami-12345678 -Attribute launchPermission -OperationType add -UserId 111122223333

Ejemplo 5: En este ejemplo se elimina el permiso de lanzamiento de la especificada Cuenta de AWS.

Edit-EC2ImageAttribute -ImageId ami-12345678 -Attribute launchPermission -OperationType remove -UserId 111122223333

  • Para obtener información sobre la API, consulte ModifyImageAttribute 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.