Usar ModifyImageAttribute com uma CLI - Amazon Elastic Compute Cloud

Usar ModifyImageAttribute com uma CLI

Os exemplos de código a seguir mostram como usar o ModifyImageAttribute.

CLI
AWS CLI

Exemplo 1: tornar uma AMI pública

O exemplo modify-instance-attribute a seguir torna pública a AMI especificada.

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

Este comando não produz saída.

Exemplo 2: tornar uma AMI privada

O exemplo modify-instance-attribute a seguir torna a AMI especificada privada.

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

Este comando não produz saída.

Exemplo 3: conceder permissão de lançamento a uma conta AWS

O exemplo modify-instance-attribute a seguir concede permissões de lançamento para a conta AWS especificada.

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

Este comando não produz saída.

Exemplo 4: remover a permissão de lançamento de uma conta AWS

O exemplo modify-instance-attribute a seguir remove as permissões de lançamento da conta AWS especificada.

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

Exemplo 1: esse exemplo atualiza a descrição da AMI especificada.

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

Exemplo 2: esse exemplo torna a AMI pública (por exemplo, para que qualquer Conta da AWS possa usá-la).

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

Exemplo 3: esse exemplo torna a AMI privada (por exemplo, para que somente você, como proprietário, possa usá-la).

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

Exemplo 4: esse exemplo concede permissão de execução à Conta da AWS especificada.

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

Exemplo 5: esse exemplo remove a permissão de execução da Conta da AWS especificada.

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

  • Consulte detalhes da API em ModifyImageAttribute na Referência de cmdlets do Ferramentas da AWS para PowerShell (V4).

Ferramentas para PowerShell V5

Exemplo 1: esse exemplo atualiza a descrição da AMI especificada.

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

Exemplo 2: esse exemplo torna a AMI pública (por exemplo, para que qualquer Conta da AWS possa usá-la).

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

Exemplo 3: esse exemplo torna a AMI privada (por exemplo, para que somente você, como proprietário, possa usá-la).

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

Exemplo 4: esse exemplo concede permissão de execução à Conta da AWS especificada.

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

Exemplo 5: esse exemplo remove a permissão de execução da Conta da AWS especificada.

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

  • Consulte detalhes da API em ModifyImageAttribute na Referência de cmdlets do Ferramentas da AWS para PowerShell (V5).

Para ver uma lista completa dos Guias do desenvolvedor e exemplos de código do SDK da AWS, consulte Crie recursos do Amazon EC2 usando um AWS SDK. Este tópico também inclui informações sobre como começar e detalhes sobre versões anteriores do SDK.