

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

# `AWSPremiumSupport-ExtendVolumesOnWindows`
<a name="automation-awspremiumsupport-extendvolumesonwindows"></a>

 **Descrizione** 

Il `AWSPremiumSupport-ExtendVolumesOnWindows` runbook estende i volumi Amazon Elastic Block Store (Amazon EBS), le relative partizioni e i file system su un'istanza Amazon Elastic Compute Cloud (Amazon EC2) di destinazione.

**Considerazioni importanti**  
**Impatto operativo e stati del volume**: le modifiche al volume di Amazon EBS avvengono in tre fasi: `modifying``optimizing`, e. `completed` Questa automazione procede con l'estensione del file system quando il volume raggiunge lo stato. `optimizing` Durante lo `optimizing` stato, è possibile che si verifichino un impatto temporaneo sulle prestazioni e potenziali interruzioni a livello di file system durante il ridimensionamento delle partizioni. Puoi [monitorare lo stato di avanzamento delle modifiche ai volumi di Amazon EBS.](https://docs.aws.amazon.com//ebs/latest/userguide/monitoring-volume-modifications.html)
**Costi e limitazioni**: l'aumento delle dimensioni di un volume Amazon EBS comporterà costi di storage mensili più elevati. Per ulteriori informazioni, consulta i [prezzi di Amazon EBS.](https://aws.amazon.com/ebs/pricing) L'AMI di backup e le istantanee associate create da questo runbook comporteranno costi aggiuntivi in base alle dimensioni e al periodo di tempo di conservazione. Per alcuni tipi di volume, se è necessario mantenere lo stesso rapporto IOPS per GB dopo l'espansione, potrebbe essere necessario modificare gli IOPS assegnati.
**Backup e ripristino**: il runbook crea un'AMI di backup prima di apportare modifiche ai volumi. L'AMI e le istantanee associate non vengono rimosse automaticamente dal tuo account. È necessario rimuovere manualmente questi backup se non sono più necessari. In caso di errore, i volumi possono essere recuperati dagli snapshot dell'AMI associata come descritto in [Sostituire un volume Amazon EBS utilizzando uno](https://docs.aws.amazon.com//AWSEC2/latest/UserGuide/ebs-restoring-volume.html) snapshot.

 **Come funziona?** 

Questo runbook esegue le seguenti operazioni:
+ Verifica che l'istanza di destinazione sia gestita da Systems Manager e stia eseguendo Windows Server
+ Assicura che vi sia una sola esecuzione di questo runbook destinata all'istanza corrente di Amazon EC2
+ Crea un'Amazon Machine Image (AMI) di backup dall'istanza di destinazione
+ Estende i volumi Amazon EBS specificati per l'espansione
+ Estende i filesystem sull'istanza di destinazione utilizzando i comandi PowerShell 

**Importante**  
L'accesso ai `AWSPremiumSupport-*` runbook richiede un abbonamento Business \$1 Support, Enterprise Support o Unified Operations. Per ulteriori informazioni, [consulta Confronta Supporto AWS](https://aws.amazon.com/premiumsupport/plans/) i piani.

 [Esegui questa automazione (console)](https://console.aws.amazon.com/systems-manager/automation/execute/AWSPremiumSupport-ExtendVolumesOnWindows) 

**Autorizzazioni IAM richieste**

Il `AutomationAssumeRole` parametro richiede le seguenti azioni per utilizzare correttamente il runbook.
+ `ec2:DescribeInstances`
+ `ec2:CreateImage`
+ `ec2:DescribeImages`
+ `ec2:DescribeVolumes`
+ `ec2:ModifyVolume`
+ `ssm:SendCommand`
+ `ssm:ListCommandInvocations`
+ `ssm:DescribeInstanceInformation`

Policy IAM di esempio:

```
 {
     "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": "*"
         }
     ]
 }
```

 **Istruzioni** 

Segui questi passaggi per configurare l'automazione:

1. Accedere [https://console.aws.amazon.com/systems-manager/documents/AWSPremiumSupport-ExtendVolumesOnWindows/description](https://console.aws.amazon.com/systems-manager/documents/AWSPremiumSupport-ExtendVolumesOnWindows/description)a Systems Manager nella sezione Documenti.

1. Seleziona **Execute automation** (Esegui automazione).

1. Per i parametri di input, immettete quanto segue:
   + **AutomationAssumeRole (Facoltativo):**
     + Descrizione: (Facoltativo) L'Amazon Resource Name (ARN) del ruolo IAM che consente a Systems Manager Automation di eseguire le azioni per tuo conto. Se non viene specificato alcun ruolo, Systems Manager Automation utilizza le autorizzazioni dell'utente che avvia questo runbook.
     + Tipo: `AWS::IAM::Role::Arn`
   + **InstanceId (Obbligatorio):**
     + Descrizione: (obbligatorio) ID dell'istanza Amazon EC2.
     + Tipo: `String`
     + Pattern consentito: `^i-[0-9a-f]{8,17}$`
   + **VolumeExpansionCapSize (Obbligatorio):**
     + Descrizione: (Obbligatorio) La dimensione massima (in GiB) dei volumi Amazon EBS verrà aumentata.
     + Tipo: `String`
     + Pattern consentito: `^[0-9]{1,4}$`
   + **DiagnosticResults (Obbligatorio):**
     + Descrizione: (Obbligatorio) I risultati dello script di precontrollo `DiagnoseDiskUsage` contenuto nel documento, in formato CSV a una riga. La stringa inizia con `EXTEND;` seguita da informazioni sul volume separate da virgole per ogni volume, con i volumi separati da punto e virgola. Le informazioni di ogni volume includono: Volume ID, Drive letter, Extend flag (1 per estendere, 0 per ignorare), Nuova dimensione in GB, regione e Motivo/azione. AWS 
     + Tipo: `String`
     + Pattern consentito: `^EXTEND;[0-9a-zA-Z\\.;_%:\\-\/,\\s]{7,5400}$`

1. Seleziona **Esegui**.

1. L'automazione si avvia.

1. Il documento esegue le seguenti operazioni:
   + **AssertInstanceIsManagedInstance**:

     Verifica che l'istanza di destinazione sia gestita da Systems Manager.
   + **DescribeInstance**:

     Recupera le informazioni sulla piattaforma dell'istanza Amazon EC2 di destinazione.
   + **BranchOnPlatform**:

     Conferma che la piattaforma di istanze Amazon EC2 di destinazione è Windows Server.
   + **CheckConcurrency**:

     Assicura che vi sia una sola esecuzione di questo runbook destinata all'istanza corrente di Amazon EC2.
   + **CreateImage**:

     Crea un'Amazon Machine Image (AMI) di backup dall'istanza di destinazione.
   + **WaitUntilImageReady**:

     Attende che Amazon Machine Image (AMI) completi la creazione e raggiunga lo `available` stato.
   + **Estendi EBSVolume**:

     Estende i volumi Amazon EBS dell'istanza di destinazione specificati per l'espansione.
   + **DescribeVolumes**:

     Descrive i volumi Amazon EBS dell'istanza di destinazione specificati per l'espansione.
   + **ExtendFilesystem**:

     Estende i filesystem dell'istanza di destinazione utilizzando i comandi. PowerShell 

1. Dopo il completamento, consulta la sezione **Output** per i risultati dettagliati dell'esecuzione.

**Riferimenti**

Systems Manager Automation
+ [Esegui questa automazione (console)](https://console.aws.amazon.com/systems-manager/documents/AWSPremiumSupport-ExtendVolumesOnWindows/description)
+ [Esegui un'automazione](https://docs.aws.amazon.com//systems-manager/latest/userguide/automation-working-executing.html)
+ [Configurazione di un'automazione](https://docs.aws.amazon.com//systems-manager/latest/userguide/automation-setup.html)
+ [Flussi di lavoro di Support Automation](https://aws.amazon.com/premiumsupport/technology/saw/)
+ [Richiedi modifiche al volume di Amazon EBS](https://docs.aws.amazon.com//AWSEC2/latest/UserGuide/requesting-ebs-volume-modifications.html)