View a markdown version of this page

AWS-UpdateLinuxAmi - AWS Systems Manager Referência do Automation Runbook

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

Descrição

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

Execute esta automação (console)

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: {” HttpEndpoint “: “ativado”, "HttpTokens“: “opcional"}

    Descrição: (opcional) as opções de metadados para a instância. Para obter mais informações, consulte InstanceMetadataOptionsRequest.

    Allowed-pattern: ^\{[^<>\$;|&\\]*\}$

    • Deve estar entre colchetes {} 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 _from_ {{SourceAmiId}} _on_ {{global:date_time}}

    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: ( ) [ ] { } . / ' @ _ : -