기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

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

 **설명** 

`AWSPremiumSupport-TroubleshootEC2DiskUsage` 실행서는 Amazon Elastic Compute Cloud(Amazon EC2) 인스턴스 루트 및 루트가 아닌 디스크 사용과 관련된 문제를 조사하고 잠재적으로 해결하는 데 도움이 됩니다. 가능한 경우, 실행서는 볼륨과 해당 파일 시스템을 확장하여 문제 해결을 시도합니다. 이러한 작업을 수행하기 위해, 이 실행서는 영향을 받는 인스턴스의 운영 체제를 기반으로 여러 실행서의 실행을 조정합니다.

첫 번째 실행서 `AWSPremiumSupport-DiagnoseDiskUsageOnWindows` 또는 `AWSPremiumSupport-DiagnoseDiskUsageOnLinux`는 볼륨을 확장하여 디스크 문제를 완화할 수 있는지 여부를 결정합니다.

두 번째 실행서 `AWSPremiumSupport-ExtendVolumesOnWindows` 또는 `AWSPremiumSupport-ExtendVolumesOnLinux`는 첫 번째 실행서의 출력을 사용하여 볼륨을 수정하는 Python 코드를 실행합니다. 볼륨이 수정되고 난 후, 실행서는 영향을 받는 볼륨의 파티션과 파일 시스템을 확장합니다.

**중요**  
`AWSPremiumSupport-*` 실행서에 액세스하려면 Business \$1 Support, Enterprise Support 또는 통합 운영 구독이 필요합니다. 자세한 내용은 [AWS Support 플랜 비교](https://aws.amazon.com/premiumsupport/plans/)를 참조하세요.

이 문서는 AWS Managed Services (AMS)와 공동으로 작성되었습니다. AMS를 사용하면 AWS 인프라를 보다 효율적이고 안전하게 관리할 수 있습니다. 또한 AMS는 운영 유연성, 향상된 보안 및 규정 준수, 용량 최적화, 비용 절감 식별을 제공합니다. 자세한 내용은 [AWS Managed Services](https://aws.amazon.com/managed-services/) 단원을 참조하십시오.

[이 자동화 실행(콘솔)](https://console.aws.amazon.com/systems-manager/automation/execute/AWSPremiumSupport-TroubleshootEC2DiskUsage)

**문서 유형**

자동화

**소유자**

Amazon

**플랫폼**

Linux, Windows

**파라미터**
+ InstanceId

  유형: 문자열

  허용되는 값: ^i-[a-z0-9]\$18,17\$1\$1

  설명: (필수) Amazon EC2 인스턴스의 ID입니다.
+ VolumeExpansionEnabled

  유형: Boolean

  설명: (선택 사항) 문서가 영향을 받는 볼륨 및 파티션을 확장할지 여부를 제어하는 플래그입니다.

  기본값: true
+ VolumeExpansionUsageTrigger

  유형: 문자열

  설명: (선택 사항) 확장을 트리거하는 데 필요한 파티션 공간의 최소 사용량(백분율)입니다.

  허용되는 값: ^[0-9]\$11,2\$1\$1

   기본값: 85
+ VolumeExpansionCapSize

  유형: 문자열

  설명: (선택 사항) Amazon Elastic Block Store(Amazon EBS) 볼륨이 늘어나는 최대 크기(GiB)입니다.

  허용되는 값: ^[0-9]\$11,4\$1\$1

  기본값: 2048
+ VolumeExpansionGibIncrease

  유형: 문자열

  설명: (선택 사항) 볼륨의 GiB를 늘립니다. VolumeExpansionGibIncrease와 VolumeExpansionPercentageIncrease 사이의 가장 큰 순 증가분이 사용됩니다.

  허용되는 값: ^[0-9]\$11,4\$1\$1

  기본값: 20
+ VolumeExpansionPercentageIncrease

  유형: 문자열

  설명: (선택 사항) 볼륨의 비율을 늘립니다. VolumeExpansionGibIncrease와 VolumeExpansionPercentageIncrease 사이의 가장 큰 순 증가분이 사용됩니다.

  허용되는 값: ^[0-9]\$11,2\$1\$1

  기본값: 20
+ AutomationAssumeRole

  유형: 문자열

  설명: (선택 사항) 사용자를 대신하여 Systems Manager Automation을 통해 작업을 수행할 수 있도록 허용하는 AWS Identity and Access Management (IAM) 역할의 Amazon 리소스 이름(ARN)입니다. 역할을 지정하지 않은 경우, Systems Manager Automation에서는 이 실행서를 시작하는 사용자의 권한을 사용합니다.

**필수 IAM 권한**

실행서를 성공적으로 사용하려면 `AutomationAssumeRole` 파라미터에 다음 작업이 필요합니다.
+ `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`

 **문서 단계** 

1. `aws:assertAwsResourceProperty` - 인스턴스가 Systems Manager에서 관리되는지 확인합니다.

1. `aws:executeAwsApi` - 플랫폼을 가져오는 인스턴스를 설명합니다.

1. `aws:branch` - 인스턴스의 플랫폼을 기반으로 자동화를 분기합니다.

   1. 인스턴스가 Windows인 경우:

      1. `aws:executeAutomation` - `AWSPremiumSupport-DiagnoseDiskUsageOnWindows` 실행서를 실행하여 인스턴스의 디스크 사용 문제를 진단합니다.

      1. `aws:executeAwsApi` - 이전 자동화의 출력을 가져옵니다.

      1. `aws:branch` - 진단 출력 및 경고를 완화하기 위해 확장할 수 있는 볼륨이 있는지 여부를 기반으로 분기합니다.

         1. 확장해야 할 볼륨이 없습니다. 자동화를 종료합니다.

         1. 확장해야 할 볼륨이 있습니다.

            1. `aws:executeAwsApi` - 인스턴스의 Amazon Machine Image(AMI)을 생성합니다.

            1. `aws:waitForAwsResourceProperty` - AMI 상태가 `available`이 될 때까지 기다립니다.

            1. `aws:executeAutomation` - `AWSPremiumSupport-ExtendVolumesOnWindows` 실행서를 실행하여 볼륨 수정 및 운영 체제(OS)에서 새 공간을 사용할 수 있도록 필요한 단계를 수행합니다.

   1. (플랫폼은 Windows가 아님) 입력 인스턴스가 Windows가 아닌 경우:

      1. `aws:executeAutomation` - `AWSPremiumSupport-DiagnoseDiskUsageOnLinux` 실행서를 실행하여 인스턴스의 디스크 사용 문제를 진단합니다.

      1. `aws:executeAwsApi` - 이전 자동화의 출력을 가져옵니다.

      1. `aws:branch` - 진단 출력 및 경고를 완화하기 위해 확장할 수 있는 볼륨이 있는지 여부를 기반으로 분기합니다.

         1. 확장해야 할 볼륨이 없습니다. 자동화를 종료합니다.

         1. 확장해야 할 볼륨이 있습니다.

            1. `aws:executeAwsApi` - 인스턴스의 AMI를 만듭니다.

            1. `aws:waitForAwsResourceProperty` - AMI 상태가 `available`이 될 때까지 기다립니다.

            1. `aws:executeAutomation` - `AWSPremiumSupport-ExtendVolumesOnLinux` 실행서를 실행하여 볼륨 수정 및 OS에서 새 공간을 사용할 수 있도록 필요한 단계를 수행합니다.

 **출력** 

diagnoseDiskUsageAlertOnWindows.Output

extendVolumesOnWindows.Output

diagnoseDiskUsageAlertOnLinux.Output

extendVolumesOnLinux.Output

BackupAMILinux.ImageId

BackupAMIWindows.ImageId