Cancelar o compartilhamento de uma AMI com sua Conta da AWS - Amazon Elastic Compute Cloud

Cancelar o compartilhamento de uma AMI com sua Conta da AWS

Uma imagem de máquina da Amazon (AMI) pode ser compartilhada com Contas da AWS específicas adicionando as contas às permissões de execução da AMI. Se uma AMI tiver sido compartilhada com sua Conta da AWS e você não quiser mais compartilhá-la com sua conta, poderá remover sua conta das permissões de execução da AMI. Você pode fazer isso executando o comando cancel-image-launch-permission da AWS CLI. Ao executar esse comando, sua Conta da AWS é removida das permissões de execução para a AMI especificada. Para localizar as AMIs que são compartilhadas com sua Conta da AWS, consulte Encontre AMIs compartilhadas para usar em instâncias do Amazon EC2.

Você pode cancelar o compartilhamento de uma AMI com sua conta, p. ex., para reduzir a probabilidade de executar uma instância com uma AMI não utilizada ou obsoleta que tenha sido compartilhada com você. Quando você cancela o compartilhamento de uma AMI com sua conta, ela não aparece mais em nenhuma lista de AMI no console do EC2 ou na saída do comando describe-images.

Limitações

  • Você pode remover sua conta das permissões de inicialização de uma AMI que seja compartilhada apenas com sua Conta da AWS. Você não pode usar cancel-image-launch-permission para remover sua conta das permissões de inicialização de uma AMI compartilhada com uma organização ou unidade organizacional (UO) ou para remover o acesso a AMIs públicas.

  • Você não pode remover permanentemente sua conta das permissões de execução de uma AMI. O proprietário de uma AMI pode compartilhar uma AMI com sua conta novamente.

  • As AMIs são um recurso regional. Ao executar cancel-image-launch-permission, você deve especificar a região na qual a AMI está localizada. Especifique uma região no comando ou use a variável de ambiente AWS_DEFAULT_REGION.

  • Somente a AWS CLI e os SDKs são compatíveis com a remoção de sua conta das permissões de execução de uma AMI. No momento, o console do EC2 não é compatível com essa ação.

Cancelar o compartilhamento de uma AMI com sua conta

nota

Após cancelar o compartilhamento de uma AMI com sua conta, você não poderá desfazer essa ação. Para recuperar o acesso à AMI, o proprietário da AMI deverá compartilhá-la com sua conta.

AWS CLI
Para cancelar o compartilhamento de uma AMI com sua Conta da AWS

Use o comando cancel-image-launch-permission e especifique o ID da AMI.

aws ec2 cancel-image-launch-permission \ --image-id ami-0123456789example \ --region us-east-1

Saída esperada

{ "Return": true }
PowerShell
Para cancelar o compartilhamento de uma AMI com sua Conta da AWS usando o AWS Tools for PowerShell

Use o comando Stop-EC2ImageLaunchPermission e especifique o ID da AMI.

Stop-EC2ImageLaunchPermission ` -ImageId ami-0123456789example ` -Region us-east-1

Saída esperada

True