

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

# `AWS-UpdateLinuxAmi`
<a name="automation-aws-updatelinuxami"></a>

**Descrição**

Atualizar uma Amazon Machine Image (AMI) com pacotes de distribuição Linux e softwares da Amazon.

[Execute esta automação (console)](https://console.aws.amazon.com/systems-manager/automation/execute/AWS-UpdateLinuxAmi)

**Tipo de documento**

Automação

**Proprietário**

Amazon

**Plataformas**

Linux

**Parâmetros**
+ AutomationAssumeRole

  Tipo: String

  Descrição: (opcional) o nome do recurso da Amazon (ARN) do perfil do AWS Identity and Access Management (IAM) que permite que o Systems Manager Automation realize ações em seu nome. Se nenhum perfil for especificado, o Systems Manager Automation usa as permissões do usuário que inicia este runbook.

  Allowed-pattern: `^$|^arn:aws[a-z0-9-]*:iam::(\d{12}|\{\{global:ACCOUNT_ID\}\}):role/[\w/.@+=,-]{1,1017}$` 
  + Deve ser um ARN de função do IAM válido ou uma string vazia. A variável do sistema `{{global:ACCOUNT_ID}}` pode ser usada no lugar da ID da AWS conta no arn. 
+ ExcludePackages

  Tipo: string

  Padrão: nenhum

  Descrição: (Opcional) Nomes de pacotes para evitar atualizações, em todas as condições. Por padrão ("none"), nenhum pacote é excluído.

  Allowed-pattern: `^(none|[a-zA-Z0-9\s,._+:=<>()\[\]/*-]+)$` 
  + Deve ser “nenhum” OU uma lista de itens separados por vírgulas que consiste em letras, números, espaços e os seguintes caracteres: `, . _ + : = < > ( ) [ ] / * -` 
+ IamInstanceProfileName

  Tipo: string

  Padrão: ManagedInstanceProfile

  Descrição: (obrigatório) o nome do perfil de instância que permite que o Systems Manager gerencie a instância.

  Allowed-pattern: `^[\w+=,.@-]{1,128}$` 
  + Deve ter entre 1 e 128 caracteres e conter somente letras, números e os seguintes caracteres: `+ = , . @ - _` 
+ IncludePackages

  Tipo: string

  Padrão: all

  Descrição: (Opcional) Somente atualiza esses pacotes nomeados. Por padrão ("all"), todas as atualizações disponíveis são aplicadas.

  Allowed-pattern: `^(all|[a-zA-Z0-9\s,._+:=<>()\[\]/*-]+)$` 
  + Deve ser “tudo” OU uma lista de itens separados por vírgulas que consiste em letras, números, espaços e os seguintes caracteres: `, . _ + : = < > ( ) [ ] / * -` 
+ InstanceType

  Tipo: string

  Padrão: t2.micro

  Descrição: (Opcional) O tipo de instância a ser executada como o host do espaço de trabalho. Os tipos de instância variam de acordo com a região.

  Allowed-pattern: `^[a-z0-9]+(-[a-z0-9]+)*\.[a-z0-9]+$` 
  + Deve estar no formato prefixo.suffix em que ambas as partes contêm letras e números minúsculos, e o prefixo pode incluir hífens
+ MetadataOptions

  Tipo: StringMap

  Padrão: \$1” HttpEndpoint “: “ativado”, "HttpTokens“: “opcional"\$1

  Descrição: (opcional) as opções de metadados para a instância. Para obter mais informações, consulte [InstanceMetadataOptionsRequest](https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_InstanceMetadataOptionsRequest.html).

  Allowed-pattern: `^\{[^<>\$;|&\\]*\}$` 
  + Deve estar entre colchetes \$1\$1 e não pode conter os seguintes caracteres: `< > $ ; | & \` 
+ PostUpdateScript

  Tipo: string

  Padrão: nenhum

  Descrição: (Opcional) URL de um script a ser executado depois de as atualizações de pacote serem aplicadas. O padrão ("none") é não executar um script.

  Allowed-pattern: `^(none|https?://[\w\-._~:/?#\[\]@!$&'()*+,;=%]+)$` 
  + Deve ser “nenhum” OU um HTTP/HTTPS URL válido
+ PreUpdateScript

  Tipo: string

  Padrão: nenhum

  Descrição: (Opcional) A URL de um script a ser executado antes de as atualizações serem aplicadas. O padrão ("none") é não executar um script.

  Allowed-pattern: `^(none|https?://[\w\-._~:/?#\[\]@!$&'()*+,;=%]+)$` 
  + Deve ser “nenhum” OU um HTTP/HTTPS URL válido
+ SecurityGroupIds

  Tipo: string

  Descrição: (Obrigatório) Uma lista separada por vírgulas IDs dos grupos de segurança aos quais você deseja aplicar. AMI

  Allowed-pattern: `^sg-[a-z0-9]{8,17}$` 
  + Deve começar com “sg-” seguido por 8 a 17 letras minúsculas ou números
+ SourceAmiId

  Tipo: string

  Descrição: (Obrigatório) O ID de Imagem de máquina da Amazon de origem.

  Allowed-pattern: `^ami-[a-z0-9]{8,17}$` 
  + Deve começar com “ami-” seguido por 8 a 17 letras minúsculas ou números
+ SubnetId

  Tipo: string

  Descrição: (opcional) o ID da sub-rede na qual você deseja iniciar a instância. Se você excluiu sua VPC padrão, esse parâmetro é obrigatório.

  Allowed-pattern: `^$|^subnet-[a-z0-9]{8,17}$` 
  + Deve estar vazio OU começar com “sub-rede-” seguido por 8 a 17 letras minúsculas ou números
+ TargetAmiName

  Tipo: string

  Padrão: UpdateLinuxAmi \$1from\$1 \$1\$1SourceAmiId\$1\$1 \$1on\$1 \$1\$1global:date\$1time\$1\$1

  Descrição: (Opcional) O nome da nova AMI que será criada. O padrão é uma string gerada pelo sistema que inclui o ID da AMI de origem, bem como a data e a hora de criação.

  Allowed-pattern: `^[a-zA-Z0-9()\[\]\{\} ./'@_:-]{3,128}$` 
  + Deve ter entre 3 e 128 caracteres e conter somente letras, números, espaços e os seguintes caracteres: `( ) [ ] { } . / ' @ _ : -` 