

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á.

# `AWSPremiumSupport-TroubleshootEC2DiskUsage`
<a name="automation-awspremiumsupport-troubleshootEC2diskusage"></a>

 **Descrição** 

O runbook `AWSPremiumSupport-TroubleshootEC2DiskUsage` ajuda você a investigar e potencialmente corrigir problemas com o uso de disco raiz e não raiz de instâncias do Amazon Elastic Compute Cloud (Amazon EC2). Se possível, o runbook tenta corrigir os problemas estendendo o volume e seu sistema de arquivos. Para realizar essas tarefas, esse runbook orquestra a execução de vários runbooks com base no sistema operacional da instância afetada.

O primeiro runbook, `AWSPremiumSupport-DiagnoseDiskUsageOnWindows` ou `AWSPremiumSupport-DiagnoseDiskUsageOnLinux`, determina se os problemas de disco podem ser atenuados com a expansão do volume.

O segundo runbook, `AWSPremiumSupport-ExtendVolumesOnWindows` ou `AWSPremiumSupport-ExtendVolumesOnLinux`, usa a saída do primeiro runbook para executar o código Python que modifica o volume. Depois que o volume for modificado, o runbook estende a partição e o sistema de arquivos dos volumes afetados.

**Importante**  
O acesso aos `AWSPremiumSupport-*` runbooks requer uma assinatura Business \$1 Support, Enterprise Support ou Unified Operations. Para obter mais informações, consulte [Comparar Planos AWS Support](https://aws.amazon.com/premiumsupport/plans/).

Este documento foi criado em colaboração com AWS Managed Services (AMS). O AMS ajuda você a gerenciar sua AWS infraestrutura com mais eficiência e segurança. O AMS também oferece flexibilidade operacional, segurança e conformidade aprimoradas, otimização de capacidade e identificação de economia de custos. Para obter mais informações, consulte [AWS Managed Services](https://aws.amazon.com/managed-services/). 

[Execute esta automação (console)](https://console.aws.amazon.com/systems-manager/automation/execute/AWSPremiumSupport-TroubleshootEC2DiskUsage)

**Tipo de documento**

Automação

**Proprietário**

Amazon

**Plataformas**

Linux, Windows

**Parâmetros**
+ InstanceId

  Tipo: string

  Valores permitidos: ^i-[a-z0-9]\$18,17\$1\$1

  Descrição: (obrigatório) ID de sua instância do Amazon EC2.
+ VolumeExpansionEnabled

  Tipo: booliano

  Descrição: (opcional) sinalize para controlar se o documento estenderá os volumes e partições afetados.

  Padrão: verdadeiro
+ VolumeExpansionUsageTrigger

  Tipo: string

  Descrição: (opcional) uso mínimo do espaço de partição necessário para acionar a extensão (em porcentagem).

  Valores permitidos: ^[0-9]\$11,2\$1\$1

   Padrão: 85
+ VolumeExpansionCapSize

  Tipo: string

  Descrição: (opcional) o tamanho máximo para o qual o volume do Amazon Elastic Block Store (Amazon EBS) será aumentado (em GiB).

  Valores permitidos: ^[0-9]\$11,4\$1\$1

  Padrão: 2048
+ VolumeExpansionGibIncrease

  Tipo: string

  Descrição: (opcional) aumento do volume em GiB. O maior aumento líquido entre VolumeExpansionGibIncrease e VolumeExpansionPercentageIncrease será usado.

  Valores permitidos: ^[0-9]\$11,4\$1\$1

  Padrão: 20
+ VolumeExpansionPercentageIncrease

  Tipo: string

  Descrição: (opcional) aumento do volume em porcentagem. O maior aumento líquido entre VolumeExpansionGibIncrease e VolumeExpansionPercentageIncrease será usado.

  Valores permitidos: ^[0-9]\$11,2\$1\$1

  Padrão: 20
+ 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.

**Permissões obrigatórias do IAM**

O parâmetro `AutomationAssumeRole` requer as seguintes ações para usar o runbook com êxito.
+ `ec2:DescribeVolumes`
+ `ec2:DescribeVolumesModifications`
+ `ec2:ModifyVolume`
+ `ec2:DescribeInstances`
+ `ec2:CreateImage`
+ `ec2:DescribeImages`
+ `ec2:DescribeTags`
+ `ec2:CreateTags`
+ `ec2:DeleteTags`
+ `ssm:StartAutomationExecution`
+ `ssm:GetAutomationExecution`
+ `ssm:DescribeAutomationStepExecutions`
+ `ssm:DescribeAutomationExecutions`
+ `ssm:SendCommand`
+ `ssm:DescribeInstanceInformation`
+ `ssm:ListCommands`
+ `ssm:ListCommandInvocations`

 **Etapas do documento** 

1. `aws:assertAwsResourceProperty`: verifica se a instância é gerenciada pelo Systems Manager

1. `aws:executeAwsApi`: descreve a instância para obter a plataforma.

1. `aws:branch`: ramifica a automação com base na plataforma da instância.

   1. Se a instância for Windows:

      1. `aws:executeAutomation`: executa o runbook `AWSPremiumSupport-DiagnoseDiskUsageOnWindows` para diagnosticar problemas de uso de disco na instância.

      1. `aws:executeAwsApi`: obtém a saída da automação anterior.

      1. `aws:branch`: ramifica com base na saída do diagnóstico e se houver volumes que possam ser expandidos para mitigar o alerta.

         1. Não há volumes que precisem ser expandidos: terminar a automação.

         1. Há volumes que precisam ser expandidos:

            1. `aws:executeAwsApi`: cria uma Amazon Machine Image (AMI) da instância.

            1. `aws:waitForAwsResourceProperty`: espera que o estado da AMI seja `available`.

            1. `aws:executeAutomation`: executa o runbook `AWSPremiumSupport-ExtendVolumesOnWindows` para realizar a modificação do volume, bem como as etapas necessárias no sistema operacional (SO) para disponibilizar o novo espaço.

   1. (A plataforma não é Windows) Se a instância de entrada não for Windows:

      1. `aws:executeAutomation`: executa o runbook `AWSPremiumSupport-DiagnoseDiskUsageOnLinux` para diagnosticar problemas de uso de disco na instância.

      1. `aws:executeAwsApi`: obtém a saída da automação anterior.

      1. `aws:branch`: ramifica com base na saída do diagnóstico e se houver volumes que possam ser expandidos para mitigar o alerta.

         1. Não há volumes que precisem ser expandidos: terminar a automação.

         1. Há volumes que precisam ser expandidos:

            1. `aws:executeAwsApi`: cria uma AMI da instância.

            1. `aws:waitForAwsResourceProperty`: espera que o estado da AMI seja `available`.

            1. `aws:executeAutomation`: executa o runbook `AWSPremiumSupport-ExtendVolumesOnLinux` para realizar a modificação do volume, bem como as etapas necessárias no OS para disponibilizar o novo espaço.

 **Saídas** 

diagnoseDiskUsageAlertOnWindows.Saída

extendVolumesOnSaída do Windows

diagnoseDiskUsageAlertOnLinux.Saída

extendVolumesOnSaída Linux

BackupAMILinux. ImageId

BackupAMIWindows. ImageId 