

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

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

**Description**

Mettez à jour an Amazon Machine Image (AMI) avec les packages de distribution Linux et le logiciel Amazon.

[Exécuter cette automatisation (console)](https://console.aws.amazon.com/systems-manager/automation/execute/AWS-UpdateLinuxAmi)

**Type de document**

 Automatisation

**Propriétaire**

Amazon

**Plateformes**

Linux

**Paramètres**
+ AutomationAssumeRole

  Type : Chaîne

  Description : (Facultatif) Le nom de ressource Amazon (ARN) du rôle Gestion des identités et des accès AWS (IAM) qui permet à Systems Manager Automation d'effectuer les actions en votre nom. Si aucun rôle n'est spécifié, Systems Manager Automation utilise les autorisations de l'utilisateur qui lance ce runbook.

  Modèle autorisé : `^$|^arn:aws[a-z0-9-]*:iam::(\d{12}|\{\{global:ACCOUNT_ID\}\}):role/[\w/.@+=,-]{1,1017}$` 
  + Il doit s'agir d'un ARN de rôle IAM valide ou d'une chaîne vide. La variable système `{{global:ACCOUNT_ID}}` peut être utilisée à la place de l'ID de AWS compte dans l'arn. 
+ ExcludePackages

  Type : Chaîne

  Par défaut: Aucun

  Description : (Facultatif) noms des packages spécifiques à exclure des mises à jour, sous toutes les conditions. Avec la valeur par défaut ("none"), aucun package n'est exclu.

  Modèle autorisé : `^(none|[a-zA-Z0-9\s,._+:=<>()\[\]/*-]+)$` 
  + Il doit s'agir de « aucun » OU d'une liste d'éléments séparés par des virgules composée de lettres, de chiffres, d'espaces et des caractères suivants : `, . _ + : = < > ( ) [ ] / * -` 
+ IamInstanceProfileName

  Type : Chaîne

  Par défaut : ManagedInstanceProfile

  Description : (Obligatoire) Le profil d'instance qui permet à Systems Manager de gérer l'instance.

  Modèle autorisé : `^[\w+=,.@-]{1,128}$` 
  + Doit comporter entre 1 et 128 caractères et contenir uniquement des lettres, des chiffres et les caractères suivants : `+ = , . @ - _` 
+ IncludePackages

  Type : Chaîne

  Par défaut : all

  Description : (Facultatif) mettez à jour uniquement ces packages nommés. Avec la valeur par défaut ("all"), toutes les mises à jour disponibles sont appliquées.

  Modèle autorisé : `^(all|[a-zA-Z0-9\s,._+:=<>()\[\]/*-]+)$` 
  + Il doit s'agir de « tous » OU d'une liste d'éléments séparés par des virgules composée de lettres, de chiffres, d'espaces et des caractères suivants : `, . _ + : = < > ( ) [ ] / * -` 
+ InstanceType

  Type : Chaîne

  Par défaut : t2.micro

  Description : (Facultatif) type d'instance à lancer en tant qu'hôte d'espace de travail. Les types d'instances varient selon la région.

  Modèle autorisé : `^[a-z0-9]+(-[a-z0-9]+)*\.[a-z0-9]+$` 
  + Doit être au format prefix.suffix où les deux parties contiennent des lettres minuscules et des chiffres, et le préfixe peut inclure des tirets
+ MetadataOptions

  Type : StringMap

  Par défaut : {» HttpEndpoint « : « enabled », "HttpTokens« : « optional"}

  Description : (Facultatif) Les options de métadonnées pour l'instance. Pour de plus amples informations, veuillez consulter [InstanceMetadataOptionsRequest](https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_InstanceMetadataOptionsRequest.html).

  Modèle autorisé : `^\{[^<>\$;|&\\]*\}$` 
  + Doit être enroulé entre accolades {} et ne peut pas contenir les caractères suivants : `< > $ ; | & \` 
+ PostUpdateScript

  Type : Chaîne

  Par défaut: Aucun

  Description : (Facultatif) URL d'un script à exécuter après l'application des mises à jour de package. La valeur par défaut ("none") implique la non-exécution d'un script.

  Modèle autorisé : `^(none|https?://[\w\-._~:/?#\[\]@!$&'()*+,;=%]+)$` 
  + Doit être « none » OU une HTTP/HTTPS URL valide
+ PreUpdateScript

  Type : Chaîne

  Par défaut: Aucun

  Description : (Facultatif) URL d'un script à exécuter avant l'application des mises à jour. La valeur par défaut ("none") implique la non-exécution d'un script.

  Modèle autorisé : `^(none|https?://[\w\-._~:/?#\[\]@!$&'()*+,;=%]+)$` 
  + Doit être « none » OU une HTTP/HTTPS URL valide
+ SecurityGroupIds

  Type : Chaîne

  Description : (Obligatoire) Liste séparée par des virgules IDs des groupes de sécurité auxquels vous souhaitez appliquer. AMI

  Modèle autorisé : `^sg-[a-z0-9]{8,17}$` 
  + Doit commencer par « sg- » suivi de 8 à 17 lettres minuscules ou chiffres
+ SourceAmiId

  Type : Chaîne

  Description : (Obligatoire) ID de l'Amazon Machine Image source.

  Modèle autorisé : `^ami-[a-z0-9]{8,17}$` 
  + Doit commencer par « ami- » suivi de 8 à 17 lettres minuscules ou chiffres
+ SubnetId

  Type : Chaîne

  Description : (Facultatif) L'ID du sous-réseau dans lequel vous souhaitez lancer l'instance. Si vous avez supprimé votre VPC par défaut, ce paramètre est obligatoire.

  Modèle autorisé : `^$|^subnet-[a-z0-9]{8,17}$` 
  + Doit être vide OU commencer par « subnet- » suivi de 8 à 17 lettres minuscules ou chiffres
+ TargetAmiName

  Type : Chaîne

  Par défaut : UpdateLinuxAmi \_from\_ {{SourceAmiId}} \_on\_ {{global:Date\_time}}

  Description : (Facultatif) nom de l'AMI qui sera créée. La valeur par défaut est une chaîne générée par le système qui inclut l'ID de l'AMI source, et les date et heure de création.

  Modèle autorisé : `^[a-zA-Z0-9()\[\]\{\} ./'@_:-]{3,128}$` 
  + Doit comporter entre 3 et 128 caractères et contenir uniquement des lettres, des chiffres, des espaces, ainsi que les caractères suivants : `( ) [ ] { } . / ' @ _ : -` 