Suporte a parâmetro nativo para imagem de máquina da Amazon IDs - AWS Systems Manager

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

Suporte a parâmetro nativo para imagem de máquina da Amazon IDs

Ao criar um parâmetro String, você pode especificar o tipo de dados como aws:ec2:image para garantir que o valor do parâmetro inserido seja um formato válido de ID da imagem de máquina da Amazon (AMI).

O suporte para formatos de ID de AMI permite que você evite atualizar todos os scripts e modelos com um novo ID sempre que a AMI que deseja usar em seus processos for alterada. Você pode criar um parâmetro com o tipo de dados aws:ec2:image e, em seu valor, inserir o ID de uma AMI. Esta é a AMI a partir da qual você deseja que novas instâncias sejam criadas no momento. Depois, você faz referência a esse parâmetro em seus modelos, comandos e scripts.

Por exemplo, você pode especificar o parâmetro que contém o ID da AMI de sua preferência ao executar o Amazon Elastic Compute Cloud comando Amazon EC2 da (run-instances).

nota

O usuário que executa esse comando deve ter permissões do AWS Identity and Access Management (IAM) que incluam a ação ssm:GetParameters de API para que o valor do parâmetro seja validado. Caso contrário, o processo de criação do parâmetro falhará.

aws ec2 run-instances \ --image-id resolve:ssm:/golden-ami \ --count 1 \ --instance-type t2.micro \ --key-name my-key-pair \ --security-groups my-security-group

Você também pode escolher sua preferência AMI ao criar uma instância usando o Amazon EC2 console do . Para obter mais informações, consulte Usar um Systems Manager parâmetro do para localizar uma AMI no Guia do usuário do Amazon EC2 para instâncias do Windows.

Quando chegar a hora de usar uma AMI diferente em seu fluxo de trabalho de criação de instância, você só precisará atualizar o parâmetro com o novo valor da AMI, e o Parameter Store validará novamente que você inseriu um ID no formato adequado.

Conceder permissões para criar um parâmetro do tipo de dados ec2

Usando políticas do AWS Identity and Access Management (IAM), é possível fornecer ou restringir o acesso do usuário a ações e conteúdo da API do Parameter Store

O exemplo de política a seguir concede aos usuários permissão para chamar a operação PutParameter de API para o aws:ec2:image. Isso significa que o usuário pode adicionar um parâmetro do tipo de dados aws:ec2:image ao sistema.

{ "Version": "2012-10-17", "Statement": [ { "Sid": "VisualEditor0", "Effect": "Allow", "Action": "ssm:PutParameter", "Resource": "*" }, { "Sid": "VisualEditor1", "Effect": "Allow", "Action": "ec2:DescribeImages", "Resource": "*" } ] }

Como funciona a validação de formato da AMI

Quando você especifica aws:ec2:image como o tipo de dados para um parâmetro, o Systems Manager não cria o parâmetro imediatamente. Em vez disso, ele executa uma operação de validação assíncrona para garantir que o valor do parâmetro atenda aos requisitos de formatação para um ID de AMI e que a AMI especificada esteja disponível em sua AWS conta.

É importante observar que um número de versão de parâmetro pode ser gerado antes que a operação de validação seja concluída. Ou seja, um número de versão de parâmetro que está sendo gerado sozinho não é uma indicação de que a operação foi concluída com êxito.

Para monitorar se seus parâmetros foram criados com êxito, recomendamos usar o Amazon EventBridge para enviar notificações sobre suas operações de criação e atualização de parâmetros. Essas notificações relatam se uma operação de parâmetro foi bem-sucedida ou não. Se uma operação falhar, a notificação incluirá uma mensagem de erro que indica o motivo da falha.

{ "version": "0", "id": "eed4a719-0fa4-6a49-80d8-8ac65EXAMPLE", "detail-type": "Parameter Store Change", "source": "aws.ssm", "account": "111122223333", "time": "2020-05-26T22:04:42Z", "region": "us-east-2", "resources": [ "arn:aws:ssm:us-east-2:111122223333:parameter/golden-ami" ], "detail": { "exception": "Unable to Describe Resource", "dataType": "aws:ec2:image", "name": "golden-ami", "type": "String", "operation": "Create" } }

Para obter informações sobre como se inscrever em eventos do Parameter Store no EventBridge, consulte Configurar notificações ou acionar ações com base nos eventos do Parameter Store.