翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

# `AWSPremiumSupport-ExtendVolumesOnLinux`
<a name="automation-awspremiumsupport-extendvolumesonlinux"></a>

 **説明** 

`AWSPremiumSupport-ExtendVolumesOnLinux` ランブックは、ターゲット Amazon Elastic Compute Cloud (Amazon EC2) インスタンスの Amazon Elastic Block Store (Amazon EBS) ボリューム、パーティション、ファイルシステムを拡張します。

**重要な考慮事項**  
**オペレーションの影響とボリュームの状態**: Amazon EBS ボリュームの変更は`modifying`、、`optimizing`、 の 3 つのフェーズで行われます`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)」を参照してください。このランブックによって作成されたバックアップ AMI および関連するスナップショットには、サイズと保持期間に基づいて追加料金が発生します。一部のボリュームタイプでは、拡張後に GB あたりの IOPS 比を同じにする必要がある場合、プロビジョニングされた IOPS を変更する必要がある場合があります。RAID デバイスと LVM ボリュームはサポートされていません。
**バックアップとリカバリ**: ランブックは、ボリュームに変更を加える前にバックアップ AMI を作成します。AMI および関連するスナップショットは、アカウントから自動的に削除されません。これらのバックアップが不要になった場合は、手動で削除する必要があります。障害が発生した場合は、「スナップショット[を使用して Amazon EBS ボリュームを置き換える」の説明に従って、関連付けられた AMI のスナップショットからボリュームを](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ebs-restoring-volume.html)復元できます。

 **動作の仕組み** 

このランブックは次のオペレーションを実行します。
+ ターゲットインスタンスが Systems Manager によって管理され、Linux が実行されていることを確認します。
+ 現在の Amazon EC2 インスタンスを対象とするこのランブックの実行が 1 つだけであることを確認します
+ ターゲットインスタンスからバックアップ Amazon マシンイメージ (AMI) を作成します。
+ 拡張用に指定された Amazon EBS ボリュームを拡張します
+ シェルスクリプトコマンドを使用してターゲットインスタンスのファイルシステムを拡張します

**重要**  
`AWSPremiumSupport-*` ランブックにアクセスするには、Business \+ Support、Enterprise Support、または Unified Operations Subscription が必要です。詳細については、[AWS サポート プランの比較](https://aws.amazon.com/premiumsupport/plans/) を参照してください。

 [このオートメーションを実行する (コンソール)](https://console.aws.amazon.com/systems-manager/automation/execute/AWSPremiumSupport-ExtendVolumesOnLinux) 

**ドキュメントタイプ**

オートメーション

**[所有者]**

Amazon

**[Platforms]** (プラットフォーム)

Linux

**パラメータ**

**必要な IAM アクセス許可**

`AutomationAssumeRole` パラメータでは、ランブックを正常に使用するために、次のアクションが必要です。
+ `ec2:DescribeInstances`
+ `ec2:CreateImage`
+ `ec2:DescribeImages`
+ `ec2:DescribeVolumes`
+ `ec2:DescribeVolumesModifications`
+ `ec2:ModifyVolume`
+ `ssm:SendCommand`
+ `ssm:ListCommandInvocations`
+ `ssm:DescribeInstanceInformation`
+ `ssm:DescribeAutomationExecutions`
+ `ssm:GetAutomationExecution`

IAM ポリシーの例:

```
 {
     "Version": "2012-10-17",		 	 	 
     "Statement": [
         {
             "Effect": "Allow",
             "Action": [
                 "ec2:DescribeInstances",
                 "ec2:CreateImage",
                 "ec2:DescribeImages",
                 "ec2:DescribeVolumes",
                 "ec2:DescribeVolumesModifications",
                 "ec2:ModifyVolume",
                 "ssm:SendCommand",
                 "ssm:ListCommandInvocations",
                 "ssm:DescribeInstanceInformation",
                 "ssm:DescribeAutomationExecutions",
                 "ssm:GetAutomationExecution"
             ],
             "Resource": "*"
         }
     ]
 }
```

 **指示** 

次の手順に従って自動化を設定します。

1. Systems Manager のドキュメントで [AWSPremiumSupport-ExtendVolumesOnLinux](https://console.aws.amazon.com/systems-manager/documents/AWSPremiumSupport-ExtendVolumesOnLinux/description) を開きます。

1. [**Execute automation (自動化の実行)**] を選択してください。

1. 入力パラメータには、次のように入力します。
   + **AutomationAssumeRole（オプション):**
     + 説明: (オプション) Systems Manager Automation がユーザーに代わってアクションを実行できるようにする AWS Identity and Access Management (IAM) ロールの Amazon リソースネーム (ARN)。ロールを指定しない場合、Systems Manager Automation はこのランブックを開始するユーザーのアクセス許可を使用します。
     + 型: `AWS::IAM::Role::Arn`
   + **InstanceId (必須):**
     + 説明: (必須) Amazon EC2 インスタンスの ID。
     + 型: `String`
     + 許可パターン: `^i-[a-z0-9]{8,17}$`
   + **VolumeExpansionCapSize (必須):**
     + 説明: (必須) Amazon EBS ボリュームを増やす最大サイズ (GiB 単位）。
     + 型: `String`
     + 許可パターン: `^[0-9]{1,4}$`
   + **DiagnosticResults (必須):**
     + 説明: (必須) 1 行 CSV 形式の`DiagnoseDiskUsage`ドキュメントの事前チェックスクリプトの結果。文字列は で始まり、ボリュームごとにカンマ区切りのボリューム情報が`EXTEND;`続き、ボリュームはセミコロンで区切られます。各ボリュームの情報には、ボリューム ID、パーティション、拡張フラグ (1 を拡張、0 をスキップ）、GB 単位の新しいサイズ、 AWS リージョン、理由/アクションが含まれます。
     + 型: `String`
     + 許可パターン: `^EXTEND;[0-9a-zA-Z\\.;_%:\\-\/,\\s]{7,5400}$`

1. **[実行]** を選択してください。

1. 自動化が開始されます。

1. ランブックは次のステップを実行します。
   + **AssertInstanceIsManagedInstance**:

     ターゲットインスタンスが Systems Manager によって管理されていることを確認します。
   + **DescribeInstance**:

     ターゲット Amazon EC2 インスタンス`Platform`の情報を取得します。
   + **BranchOnPlatform**:

     ターゲット Amazon EC2 インスタンスプラットフォームが Linux であることを確認します。
   + **CheckConcurrency**:

     現在の Amazon EC2 インスタンスを対象とするこのランブックの実行が 1 つだけであることを確認します。
   + **CreateImage**:

     ターゲットインスタンスからバックアップ Amazon マシンイメージ (AMI) を作成します。
   + **WaitUntilImageReady**:

     Amazon マシンイメージ (AMI) の作成が完了し、 `available`状態になるまで待ちます。
   + **ExtendEBSVolume**:

     拡張用に指定されたターゲットインスタンスの Amazon EBS ボリュームを拡張します。
   + **DescribeVolumes**:

     ターゲットインスタンスにアタッチされた Amazon EBS ボリュームについて説明します。
   + **ExtendFilesystem**:

     シェルスクリプトコマンドを使用して、ターゲットインスタンスのファイルシステムを拡張します。

1. 完了したら、**出力**セクションで実行の詳細な結果を確認します。

**リファレンス**

Systems Manager Automation
+ [このオートメーションを実行する (コンソール)](https://console.aws.amazon.com/systems-manager/documents/AWSPremiumSupport-ExtendVolumesOnLinux/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)