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 Cuenta de AWS especificada.

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 Cuenta de AWS especificada.

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