本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

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

 **Description** 

`AWSPremiumSupport-TroubleshootEC2DiskUsage` Runbook 可協助您調查並可能修復 Amazon Elastic Compute Cloud (Amazon EC2) 執行個體根和非根磁碟用量的問題。如果可能， Runbook 會嘗試透過擴展磁碟區及其檔案系統來修復問題。為了執行這些任務，此 Runbook 會根據受影響執行個體的作業系統協調執行數個 Runbook。

第一個 Runbook `AWSPremiumSupport-DiagnoseDiskUsageOnWindows`或 會`AWSPremiumSupport-DiagnoseDiskUsageOnLinux`決定磁碟問題是否可以透過擴展磁碟區來緩解。

第二個 Runbook `AWSPremiumSupport-ExtendVolumesOnWindows`或 `AWSPremiumSupport-ExtendVolumesOnLinux`會使用第一個 Runbook 的輸出來執行修改磁碟區的 Python 程式碼。修改磁碟區後，執行手冊會擴展受影響磁碟區的分割區和檔案系統。

**重要**  
存取 `AWSPremiumSupport-*` Runbook 需要 Business \$1 Support、Enterprise Support 或 Unified Operations Subscription。如需詳細資訊，請參閱[比較 AWS 支援 計劃](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

  類型：布林值

  描述：（選用） 用於控制文件是否會擴展受影響的磁碟區和分割區的旗標。

  預設：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 代表您執行動作的 (IAM) 角色的 AWS Identity and Access Management Amazon Resource Name (ARN)。如果未指定角色，Systems Manager Automation 會使用啟動此 Runbook 之使用者的許可。

**必要的 IAM 許可**

`AutomationAssumeRole` 參數需要下列動作才能成功使用 Runbook。
+ `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` Runbook 以診斷執行個體上的磁碟用量問題。

      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` Runbook 以執行磁碟區修改，以及在作業系統 (OS) 中所需的步驟，讓新空間可用。

   1. （平台不是視窗） 如果輸入執行個體不是 Windows：

      1. `aws:executeAutomation` - 執行 `AWSPremiumSupport-DiagnoseDiskUsageOnLinux` Runbook 以診斷執行個體上的磁碟用量問題。

      1. `aws:executeAwsApi` - 取得先前自動化的輸出。

      1. `aws:branch` - 分支是根據診斷的輸出，以及是否有可以擴展的磁碟區來緩解提醒。

         1. 沒有需要擴展的磁碟區：結束自動化。

         1. 有些磁碟區需要擴展：

            1. `aws:executeAwsApi` - 建立執行個體AMI的 。

            1. `aws:waitForAwsResourceProperty` - 等待AMI狀態為 `available`。

            1. `aws:executeAutomation` - 執行 `AWSPremiumSupport-ExtendVolumesOnLinux` Runbook 以執行磁碟區修改，以及作業系統中讓新空間可用的必要步驟。

 **輸出** 

diagnoseDiskUsageAlertOnWindows.Output

extendVolumesOnWindows.Output

diagnoseDiskUsageAlertOnLinux.Output

extendVolumesOnLinux.Output

BackupAMILinux.ImageId

BackupAMIWindows.ImageId