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

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

 **Description** 

`AWSPremiumSupport-ExtendVolumesOnWindows` Runbook 會在目標 Amazon Elastic Compute Cloud (Amazon EC2) 執行個體上擴展 Amazon Elastic Block Store (Amazon EBS) 磁碟區、其分割區和檔案系統。

**重要考量**  
**操作影響和磁碟區狀態**：Amazon EBS 磁碟區修改分為三個階段：`modifying`、 `optimizing`和 `completed`。當磁碟區達到 `optimizing` 狀態時，此自動化會繼續進行檔案系統延伸。在 `optimizing` 狀態期間，您可能會在分割區調整大小期間遇到暫時效能影響和潛在的檔案系統層級中斷。您可以[監控 Amazon EBS 磁碟區修改的進度](https://docs.aws.amazon.com//ebs/latest/userguide/monitoring-volume-modifications.html)。
**成本和限制**：增加 Amazon EBS 磁碟區大小會導致更高的每月儲存成本。如需詳細資訊，請參閱 [Amazon EBS 定價](https://aws.amazon.com/ebs/pricing)。此 Runbook 建立的備份 AMI 和相關聯的快照，會根據其大小和保留時間長度而產生額外費用。對於某些磁碟區類型，如果您在擴展後需要維持相同的每 GB IOPS 比率，您可能需要修改佈建的 IOPS。
**備份與復原**：執行手冊會先建立備份 AMI，再對磁碟區進行任何變更。AMI 和相關聯的快照不會自動從您的帳戶中移除。如果不再需要，您應該手動移除這些備份。如果失敗，可以從相關聯 AMI 的快照復原磁碟區，如[使用快照取代 Amazon EBS 磁碟區](https://docs.aws.amazon.com//AWSEC2/latest/UserGuide/ebs-restoring-volume.html)中所述。

 **如何運作？** 

此 Runbook 會執行下列操作：
+ 驗證目標執行個體是由 Systems Manager 管理，且正在執行 Windows Server
+ 確保只有一個針對目前 Amazon EC2 執行個體的 Runbook 執行
+ 從目標執行個體建立備份 Amazon Machine Image (AMI)
+ 擴展指定用於擴展的 Amazon EBS 磁碟區
+ 使用 PowerShell 命令擴展目標執行個體上的檔案系統

**重要**  
存取 `AWSPremiumSupport-*` Runbook 需要 Business \$1 Support、Enterprise Support 或 Unified Operations Subscription。如需詳細資訊，請參閱[比較 AWS 支援 計劃](https://aws.amazon.com/premiumsupport/plans/)。

 [執行此自動化 （主控台）](https://console.aws.amazon.com/systems-manager/automation/execute/AWSPremiumSupport-ExtendVolumesOnWindows) 

**必要的 IAM 許可**

`AutomationAssumeRole` 參數需要下列動作才能成功使用 Runbook。
+ `ec2:DescribeInstances`
+ `ec2:CreateImage`
+ `ec2:DescribeImages`
+ `ec2:DescribeVolumes`
+ `ec2:ModifyVolume`
+ `ssm:SendCommand`
+ `ssm:ListCommandInvocations`
+ `ssm:DescribeInstanceInformation`

IAM 政策範例：

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

 **指示** 

請依照下列步驟設定自動化：

1. 在文件下的 Systems Manager [https://console.aws.amazon.com/systems-manager/documents/AWSPremiumSupport-ExtendVolumesOnWindows/description](https://console.aws.amazon.com/systems-manager/documents/AWSPremiumSupport-ExtendVolumesOnWindows/description)中導覽至 。

1. 選擇 **Execute automation** (執行自動化)。

1. 針對輸入參數，輸入下列內容：
   + **AutomationAssumeRole （選用）：**
     + 描述：（選用） 允許 Systems Manager Automation 代表您執行動作的 IAM 角色的 Amazon Resource Name (ARN)。如果未指定角色，Systems Manager Automation 會使用啟動此 Runbook 之使用者的許可。
     + 類型：`AWS::IAM::Role::Arn`
   + **InstanceId （必要）：**
     + 描述：(必要) Amazon EC2 執行個體的 ID。
     + 類型：`String`
     + 允許模式： `^i-[0-9a-f]{8,17}$`
   + **VolumeExpansionCapSize （必要）：**
     + 描述：（必要） Amazon EBS 磁碟區將增加的大小上限 （以 GiB 為單位）。
     + 類型：`String`
     + 允許模式： `^[0-9]{1,4}$`
   + **DiagnosticResults （必要）：**
     + 描述：（必要） 預先檢查`DiagnoseDiskUsage`文件中指令碼的結果，格式為單行 CSV。字串以 開頭，`EXTEND;`後面接著每個磁碟區的逗號分隔磁碟區資訊，磁碟區以分號分隔。每個磁碟區的資訊包括：磁碟區 ID、磁碟機代號、延伸旗標 (1 為擴展、0 為略過）、以 GB 為單位的新大小、 AWS 區域和原因/動作。
     + 類型：`String`
     + 允許模式： `^EXTEND;[0-9a-zA-Z\\.;_%:\\-\/,\\s]{7,5400}$`

1. 選取**執行**。

1. 自動化會啟動。

1. 文件會執行下列步驟：
   + **AssertInstanceIsManagedInstance**：

     驗證目標執行個體是否由 Systems Manager 管理。
   + **DescribeInstance**：

     擷取目標 Amazon EC2 執行個體的平台資訊。
   + **BranchOnPlatform**：

     確認目標 Amazon EC2 執行個體平台是 Windows Server。
   + **CheckConcurrency**：

     確保只有一個針對目前 Amazon EC2 執行個體的 Runbook 執行。
   + **CreateImage**：

     從目標執行個體建立備份 Amazon Machine Image (AMI)。
   + **WaitUntilImageReady**：

     等待 Amazon Machine Image (AMI) 完成建立並達到 `available` 狀態。
   + **ExtendEBSVolume**：

     擴展指定用於擴展之目標執行個體的 Amazon EBS 磁碟區。
   + **DescribeVolumes**：

     描述指定用於擴展之目標執行個體的 Amazon EBS 磁碟區。
   + **ExtendFilesystem**：

     使用 PowerShell 命令擴展目標執行個體的檔案系統。

1. 完成後，請檢閱**輸出**區段以取得執行的詳細結果。

**參考**

Systems Manager Automation
+ [執行此自動化 （主控台）](https://console.aws.amazon.com/systems-manager/documents/AWSPremiumSupport-ExtendVolumesOnWindows/description)
+ [執行自動化](https://docs.aws.amazon.com//systems-manager/latest/userguide/automation-working-executing.html)
+ [設定自動化](https://docs.aws.amazon.com//systems-manager/latest/userguide/automation-setup.html)
+ [支援自動化工作流程](https://aws.amazon.com/premiumsupport/technology/saw/)
+ [請求 Amazon EBS 磁碟區修改](https://docs.aws.amazon.com//AWSEC2/latest/UserGuide/requesting-ebs-volume-modifications.html)