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. # `AWSPremiumSupport-ExtendVolumesOnWindows` **Description** Le `AWSPremiumSupport-ExtendVolumesOnWindows` runbook étend les volumes Amazon Elastic Block Store (Amazon EBS), leurs partitions et leurs systèmes de fichiers sur une instance Amazon Elastic Compute Cloud (Amazon EC2) cible. **Considérations importantes** **Impact sur le fonctionnement et états du volume** : les modifications du volume Amazon EBS se déroulent en trois phases : `modifying``optimizing`, et`completed`. Cette automatisation se poursuit avec l'extension du système de fichiers lorsque le volume atteint `optimizing` cet état. Au cours de `optimizing` cet état, vous pouvez rencontrer un impact temporaire sur les performances et des perturbations potentielles au niveau du système de fichiers lors du redimensionnement de la partition. Vous pouvez [suivre la progression des modifications des volumes Amazon EBS](https://docs.aws.amazon.com//ebs/latest/userguide/monitoring-volume-modifications.html). **Coût et limites** : l'augmentation de la taille d'un volume Amazon EBS entraîne une augmentation des coûts de stockage mensuels. Pour plus d'informations, consultez les [tarifs Amazon EBS](https://aws.amazon.com/ebs/pricing). L'AMI de sauvegarde et les instantanés associés créés par ce runbook entraîneront des frais supplémentaires en fonction de leur taille et de la durée pendant laquelle vous les conservez. Pour certains types de volumes, si vous devez conserver le même ratio d'IOPS par Go après l'extension, vous devrez peut-être modifier les IOPS provisionnées. **Sauvegarde et restauration** : le runbook crée une AMI de sauvegarde avant d'apporter des modifications aux volumes. L'AMI et les instantanés associés ne sont pas automatiquement supprimés de votre compte. Vous devez supprimer manuellement ces sauvegardes si elles ne sont plus nécessaires. En cas de panne, les volumes peuvent être restaurés à partir des instantanés de l'AMI associée, comme décrit dans [Remplacer un volume Amazon EBS à l'aide d'un](https://docs.aws.amazon.com//AWSEC2/latest/UserGuide/ebs-restoring-volume.html) instantané. **Fonctionnement** Ce runbook effectue les opérations suivantes : + Vérifie que l'instance cible est gérée par Systems Manager et exécute Windows Server + Garantit qu'il n'y a qu'une seule exécution de ce runbook ciblant l'instance Amazon EC2 actuelle + Crée une Amazon Machine Image (AMI) de sauvegarde à partir de l'instance cible + Étend les volumes Amazon EBS spécifiés pour l'extension + Étend les systèmes de fichiers de l'instance cible à l'aide de commandes PowerShell **Important** L'accès aux `AWSPremiumSupport-*` runbooks nécessite un abonnement Business \$1 Support, Enterprise Support ou Unified Operations. Pour plus d'informations, consultez la section [Comparer AWS Support les forfaits](https://aws.amazon.com/premiumsupport/plans/). [Exécuter cette automatisation (console)](https://console.aws.amazon.com/systems-manager/automation/execute/AWSPremiumSupport-ExtendVolumesOnWindows) **Autorisations IAM requises** Le `AutomationAssumeRole` paramètre nécessite les actions suivantes pour utiliser correctement le runbook. + `ec2:DescribeInstances` + `ec2:CreateImage` + `ec2:DescribeImages` + `ec2:DescribeVolumes` + `ec2:ModifyVolume` + `ssm:SendCommand` + `ssm:ListCommandInvocations` + `ssm:DescribeInstanceInformation` Exemple de politique IAM : ``` { "Version": "2012-10-17", "Statement": [ { "Effect": "Allow", "Action": [ "ec2:DescribeInstances", "ec2:CreateImage", "ec2:DescribeImages", "ec2:DescribeVolumes", "ec2:ModifyVolume", "ssm:SendCommand", "ssm:DescribeInstanceInformation", "ssm:ListCommandInvocations" ], "Resource": "*" } ] } ``` **Instructions** Pour configurer l'automatisation, procédez comme suit : 1. Accédez [https://console.aws.amazon.com/systems-manager/documents/AWSPremiumSupport-ExtendVolumesOnWindows/description](https://console.aws.amazon.com/systems-manager/documents/AWSPremiumSupport-ExtendVolumesOnWindows/description)à Systems Manager sous Documents. 1. Sélectionnez **Execute automation** (Exécuter l'automatisation). 1. Pour les paramètres d'entrée, entrez ce qui suit : + **AutomationAssumeRole (Facultatif) :** + Description : (Facultatif) Le nom de ressource Amazon (ARN) du rôle 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. + Type : `AWS::IAM::Role::Arn` + **InstanceId (Obligatoire) :** + Description : (Obligatoire) ID de l'instance Amazon EC2. + Type : `String` + Autoriser le modèle : `^i-[0-9a-f]{8,17}$` + **VolumeExpansionCapSize (Obligatoire) :** + Description : (Obligatoire) Taille maximale (en GiB) à laquelle les volumes Amazon EBS seront augmentés. + Type : `String` + Autoriser le modèle : `^[0-9]{1,4}$` + **DiagnosticResults (Obligatoire) :** + Description : (Obligatoire) Les résultats du script de prévérifications provenant du `DiagnoseDiskUsage` document, au format CSV d'une ligne. La chaîne commence `EXTEND;` par des informations de volume séparées par des virgules pour chaque volume, les volumes étant séparés par des points-virgules. Les informations de chaque volume incluent : l'identifiant du volume, la lettre du lecteur, l'indicateur d'extension (1 pour étendre, 0 pour ignorer), la nouvelle taille en Go, AWS la région et le raison/l'action. + Type : `String` + Autoriser le modèle : `^EXTEND;[0-9a-zA-Z\\.;_%:\\-\/,\\s]{7,5400}$` 1. Sélectionnez **Exécuter**. 1. L'automatisation démarre. 1. Le document exécute les étapes suivantes : + **AssertInstanceIsManagedInstance**: Vérifie que l'instance cible est gérée par Systems Manager. + **DescribeInstance**: Récupère les informations de plate-forme de l'instance Amazon EC2 cible. + **BranchOnPlatform**: Confirme que la plate-forme d'instance Amazon EC2 cible est Windows Server. + **CheckConcurrency**: Garantit qu'il n'y a qu'une seule exécution de ce runbook ciblant l'instance Amazon EC2 actuelle. + **CreateImage**: Crée une Amazon Machine Image (AMI) de sauvegarde à partir de l'instance cible. + **WaitUntilImageReady**: Attend que la création de l'Amazon Machine Image (AMI) soit terminée et atteigne l'`available`état requis. + **Étendre EBSVolume** : Étend les volumes Amazon EBS de l'instance cible spécifiés pour l'extension. + **DescribeVolumes**: Décrit les volumes Amazon EBS de l'instance cible qui ont été spécifiés pour l'extension. + **ExtendFilesystem**: Étend les systèmes de fichiers de l'instance cible à l'aide PowerShell de commandes. 1. Une fois l'exécution terminée, consultez la section **Sorties** pour connaître les résultats détaillés de l'exécution. **Références** Systems Manager Automation + [Exécuter cette automatisation (console)](https://console.aws.amazon.com/systems-manager/documents/AWSPremiumSupport-ExtendVolumesOnWindows/description) + [Exécuter une automatisation](https://docs.aws.amazon.com//systems-manager/latest/userguide/automation-working-executing.html) + [Configuration d'une automatisation](https://docs.aws.amazon.com//systems-manager/latest/userguide/automation-setup.html) + [Support des flux de travail automatisés](https://aws.amazon.com/premiumsupport/technology/saw/) + [Demander des modifications de volume Amazon EBS](https://docs.aws.amazon.com//AWSEC2/latest/UserGuide/requesting-ebs-volume-modifications.html)