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-DiagnoseDiskUsageOnWindows`
<a name="automation-awspremiumsupport-diagnosediskusageonwindows"></a>

 **Description** 

Le `AWSPremiumSupport-DiagnoseDiskUsageOnWindows` runbook analyse les volumes Amazon Elastic Block Store (Amazon EBS) de l'instance Amazon Elastic Compute Cloud (Amazon EC2) cible afin de déterminer s'ils nécessitent une extension. Il vérifie l'utilisation, le type de système de fichiers et l'historique d'extension de chaque volume par rapport aux seuils définis dans les paramètres d'entrée du runbook. Le script prend en compte des facteurs tels que les modifications récentes, les systèmes de fichiers pris en charge et les limites de AWS volume. Il affiche ensuite les volumes, le cas échéant, susceptibles d'être étendus, ainsi que les détails pertinents pour chaque volume.

 **Fonctionnement** 

Ce runbook effectue les opérations suivantes :
+ Vérifie que l'instance cible est gérée par Systems Manager.
+ Récupère les détails de l'instance, y compris la plate-forme et les volumes associés.
+ Branche sur la plateforme et continue uniquement si l'instance cible est en cours d'exécutionWindows.
+ Décrit toutes les modifications de volumes Amazon EBS en cours ou ayant récemment échoué sur les volumes d'instance.
+ Exécute des prévérifications Windows pour analyser l'utilisation du disque et déterminer les extensions possibles.
+ Émet les volumes susceptibles d'être augmentés avec des informations pertinentes.

**Important**  
L'accès aux `AWSPremiumSupport-*` runbooks nécessite un abonnement Business \+ Support, Enterprise Support ou Unified Operations. Pour plus d'informations, consultez la section [ Comparer les AWS Support forfaits](https://aws.amazon.com/premiumsupport/plans/).

 [Exécutez cette automatisation (console) ](https://console.aws.amazon.com/systems-manager/automation/execute/AWSPremiumSupport-DiagnoseDiskUsageOnWindows) 

**Type de document **

 Automatisation

**Propriétaire**

Amazon

**Plateformes**

Windows

**Paramètres**

**Autorisations IAM requises **

Le `AutomationAssumeRole` paramètre nécessite les actions suivantes pour utiliser correctement le runbook.
+ `ssm:DescribeInstanceInformation`
+ `ec2:DescribeInstances`
+ `ec2:DescribeVolumesModifications`
+ `ssm:SendCommand`
+ `ssm:ListCommandInvocations`

Exemple de politique IAM

```
 {
     "Version": "2012-10-17",		 	 	 
     "Statement": [
         {
             "Effect": "Allow",
             "Action": [
                 "ssm:DescribeInstanceInformation",
                 "ec2:DescribeInstances",
                 "ec2:DescribeVolumesModifications",
                 "ssm:SendCommand",
                 "ssm:ListCommandInvocations"
             ],
             "Resource": "*"
         }
     ]
 }
```

 **Instructions** 

Pour configurer l'automatisation, procédez comme suit :

1. Ouvrez [ AWSPremiumSupport-DiagnoseDiskUsageOnWindows ](https://console.aws.amazon.com/systems-manager/documents/AWSPremiumSupport-DiagnoseDiskUsageOnWindows/description) dans le Gestionnaire de systèmes sous Documents.

1. Choisissez **Execute automation (Exécuter l’automatisation)**.

1. Pour les paramètres d'entrée, entrez les informations suivantes :
   + **AutomationAssumeRole (Facultatif) : **
     + 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 démarre ce runbook.
     + Type : `AWS::IAM::Role::Arn`
   + **InstanceId (Obligatoire) : **
     + Description : ID (obligatoire) de votre instance Amazon EC2.
     + Type : `String`
     + Autoriser le schéma : `^i-[a-z0-9]{8,17}$`
   + **VolumeExpansionUsageTrigger (Obligatoire) : **
     + Description : (Obligatoire) Utilisation minimale de l'espace de partition requise pour déclencher l'extension (en pourcentage).
     + Type : `String`
     + Autoriser le schéma : `^[0-9]{1,2}$`
   + **VolumeExpansionCapSize (Obligatoire) : **
     + Description : (Obligatoire) Taille maximale à laquelle le volume Amazon EBS sera augmenté (en GiB).
     + Type : `String`
     + Autoriser le schéma : `^[0-9]{1,4}$`
   + **VolumeExpansionGibIncrease (Obligatoire) : **
     + Description : (Obligatoire) Augmentation du volume en GiB. L'augmentation nette la plus importante entre `VolumeExpansionGibIncrease` et `VolumeExpansionPercentageIncrease` sera utilisée.
     + Type : `String`
     + Autoriser le schéma : `^[0-9]{1,4}$`
   + **VolumeExpansionPercentageIncrease (Obligatoire) : **
     + Description : (Obligatoire) Augmentation du pourcentage du volume. L'augmentation nette la plus importante entre `VolumeExpansionGibIncrease` et `VolumeExpansionPercentageIncrease` sera utilisée.
     + Type : `String`
     + Autoriser le schéma : `^[0-9]{1,2}$`

1. Sélectionnez **Execute (Exécuter)**.

1. L'automatisation démarre.

1. Le runbook exécute les étapes suivantes :
   + **AssertInstanceIsManagedInstance**:

     Vérifie si l'instance cible est gérée par Systems Manager.
   + **DescribeInstance**:

     Décrit l'instance Amazon EC2 cible et extrait les détails de l'instance`Platform`, y compris`InstanceType`, et les pièces jointes. `VolumeIds`
   + **BranchOnPlatform**:

     Vérifie si la plate-forme d'instance Amazon EC2 cible est Windows Server et poursuit l'exécution si c'est le cas.
   + **DescribeVolumesModifications**:

     Décrit les modifications de volume Amazon EBS en cours ou ayant récemment échoué sur les volumes d'instance.
   + **RunPreChecksOnWindows**:

     Exécute le PowerShell script sur l'instance Amazon EC2 cible pour effectuer une analyse de l'utilisation du disque et générer des recommandations d'extension.

1. Une fois l'exécution terminée, consultez la ** section ** Sorties pour obtenir les résultats détaillés de l'exécution.

**Références**

Systems Manager Automation
+ [Exécutez cette automatisation (console) ](https://console.aws.amazon.com/systems-manager/documents/AWSPremiumSupport-DiagnoseDiskUsageOnWindows/description)
+ [Exécutez 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)
+ [Processus d'automatisation du support ](https://aws.amazon.com/premiumsupport/technology/saw/)