View a markdown version of this page

AWSPremiumSupport-DiagnoseDiskUsageOnWindows - AWS Systems Manager Referência do runbooks de automação

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-DiagnoseDiskUsageOnWindows

Descrição

O AWSPremiumSupport-DiagnoseDiskUsageOnWindows runbook analisa os volumes do Amazon Elastic Block Store (Amazon EBS) da instância de destino do Amazon Elastic Compute Cloud (Amazon EC2) para determinar se eles precisam de expansão. Ele verifica o uso, o tipo de sistema de arquivos e o histórico de expansão de cada volume em relação aos limites definidos nos parâmetros de entrada do runbook. O script considera fatores como modificações recentes, sistemas de arquivos compatíveis e limites AWS de volume. Em seguida, ele gera os volumes, se houver, que são candidatos à expansão, junto com os detalhes relevantes de cada volume.

Como funciona?

Esse runbook executa as seguintes operações:

  • Verifica se a instância de destino é gerenciada pelo Systems Manager.

  • Recupera detalhes da instância, incluindo plataforma e volumes anexados.

  • Ramifica-se na plataforma e prossegue somente se a instância de destino estiver em execuçãoWindows.

  • Descreve todas as modificações de volume do Amazon EBS em andamento ou que falharam recentemente nos volumes da instância.

  • Executa pré-verificações Windows para analisar o uso do disco e determinar os candidatos à expansão.

  • Volumes de saída que são candidatos à expansão com detalhes relevantes.

Importante

O acesso aos AWSPremiumSupport-* runbooks exige uma assinatura Business + Support, Enterprise Support ou Unified Operations. Para obter mais informações, consulte Comparar Planos AWS Support.

Executar esta automação (console)

Tipo de documento

Automação

Proprietário

Amazon

Plataformas

Windows

Parâmetros

Permissões obrigatórias do IAM

O parâmetro AutomationAssumeRole requer as seguintes ações para usar o runbook com êxito.

  • ssm:DescribeInstanceInformation

  • ec2:DescribeInstances

  • ec2:DescribeVolumesModifications

  • ssm:SendCommand

  • ssm:ListCommandInvocations

Exemplo de política do IAM


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

Instruções

Siga estas etapas para configurar a automação:

  1. Abra AWSPremiumSupport-DiagnoseDiskUsageOnWindows no Systems Manager em Documentos.

  2. Escolha Execute automation.

  3. Para os parâmetros de entrada, insira o seguinte:

    • AutomationAssumeRole (Opcional):

      • Descrição: (Opcional) O nome de recurso da Amazon (ARN) da função AWS Identity and Access Management (IAM) que permite que o Systems Manager Automation execute as 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.

      • Tipo: AWS::IAM::Role::Arn

    • InstanceId (Obrigatório):

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

      • Tipo: String

      • Padrão de permissão: ^i-[a-z0-9]{8,17}$

    • VolumeExpansionUsageTrigger (Obrigatório):

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

      • Tipo: String

      • Padrão de permissão: ^[0-9]{1,2}$

    • VolumeExpansionCapSize (Obrigatório):

      • Descrição: (Obrigatório) Tamanho máximo para o qual o volume do Amazon EBS será aumentado (em GiB).

      • Tipo: String

      • Padrão de permissão: ^[0-9]{1,4}$

    • VolumeExpansionGibIncrease (Obrigatório):

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

      • Tipo: String

      • Padrão de permissão: ^[0-9]{1,4}$

    • VolumeExpansionPercentageIncrease (Obrigatório):

      • Descrição: (Obrigatório) Aumento na porcentagem do volume. O maior aumento líquido entre VolumeExpansionGibIncrease e VolumeExpansionPercentageIncrease será usado.

      • Tipo: String

      • Padrão de permissão: ^[0-9]{1,2}$

  4. Clique em Executar.

  5. A automação é iniciada.

  6. O runbook executa as seguintes etapas:

    • AssertInstanceIsManagedInstance:

      Verifica se a instância de destino é gerenciada pelo Systems Manager.

    • DescribeInstance:

      Descreve a instância de destino do Amazon EC2 e recupera os detalhes da instânciaPlatform, incluindoInstanceType, e anexados. VolumeIds

    • BranchOnPlatform:

      Verifica se a plataforma de instância do Amazon EC2 de destino é Windows Server e continua a execução em caso afirmativo.

    • DescribeVolumesModifications:

      Descreve as modificações de volume do Amazon EBS em andamento ou que falharam recentemente nos volumes da instância.

    • RunPreChecksOnWindows:

      Executa o PowerShell script na instância de destino do Amazon EC2 para realizar a análise do uso do disco e gerar recomendações de expansão.

  7. Após a conclusão, revise a seção Saídas para ver os resultados detalhados da execução.

Referências

Automação do Systems Manager