View a markdown version of this page

AWSPremiumSupport-DiagnoseDiskUsageOnWindows - AWS Systems Manager オートメーションランブックリファレンス

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

AWSPremiumSupport-DiagnoseDiskUsageOnWindows

説明

AWSPremiumSupport-DiagnoseDiskUsageOnWindows ランブックは、ターゲット Amazon Elastic Compute Cloud (Amazon EC2) インスタンスの Amazon Elastic Block Store (Amazon EBS) ボリュームを分析して、拡張が必要かどうかを判断します。ランブック入力パラメータで定義されているしきい値と照らし合わせて、各ボリュームの使用状況、ファイルシステムタイプ、拡張履歴をチェックします。このスクリプトは、最近の変更、サポートされているファイルシステム、 AWS ボリューム制限などの要因を考慮します。次に、拡張の候補となるボリュームがある場合は、各ボリュームに関連する詳細とともに出力されます。

動作の仕組み

このランブックは次のオペレーションを実行します。

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

  • プラットフォームやアタッチされたボリュームを含むインスタンスの詳細を取得します。

  • プラットフォーム上で分岐し、ターゲットインスタンスが を実行している場合にのみ続行しますWindows。

  • インスタンスボリュームで現在または最近失敗した Amazon EBS ボリュームの変更について説明します。

  • で事前チェックを実行してWindows、ディスクの使用状況を分析し、拡張候補を決定します。

  • 拡張の候補となるボリュームを、関連する詳細とともに出力します。

重要

AWSPremiumSupport-* ランブックにアクセスするには、Business + Support、Enterprise Support、または Unified Operations Subscription が必要です。詳細については、AWS サポート プランの比較 を参照してください。

このオートメーションを実行する (コンソール)

ドキュメントタイプ

オートメーション

[所有者]

Amazon

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

Windows

パラメータ

必要な IAM アクセス許可

AutomationAssumeRole パラメータでは、ランブックを正常に使用するために、次のアクションが必要です。

  • ssm:DescribeInstanceInformation

  • ec2:DescribeInstances

  • ec2:DescribeVolumesModifications

  • ssm:SendCommand

  • ssm:ListCommandInvocations

IAM ポリシーの例


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

指示

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

  1. ドキュメントの Systems Manager で AWSPremiumSupport-DiagnoseDiskUsageOnWindows を開きます。

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

  3. 入力パラメータには、次のように入力します。

    • 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}$

    • VolumeExpansionUsageTrigger (必須):

      • 説明: (必須) 拡張をトリガーするために必要なパーティションスペースの最小使用量 (パーセンテージ）。

      • 型: String

      • 許可パターン: ^[0-9]{1,2}$

    • VolumeExpansionCapSize (必須):

      • 説明: (必須) Amazon EBS ボリュームを増やす最大サイズ (GiB 単位）。

      • 型: String

      • 許可パターン: ^[0-9]{1,4}$

    • VolumeExpansionGibIncrease (必須):

      • 説明: (必須) ボリュームの GiB の増加。VolumeExpansionGibIncrease と の間の最大の純増VolumeExpansionPercentageIncreaseが使用されます。

      • 型: String

      • 許可パターン: ^[0-9]{1,4}$

    • VolumeExpansionPercentageIncrease (必須):

      • 説明: (必須) ボリュームの割合を増やします。VolumeExpansionGibIncrease と の間の最大の純増VolumeExpansionPercentageIncreaseが使用されます。

      • 型: String

      • 許可パターン: ^[0-9]{1,2}$

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

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

  6. ランブックは次のステップを実行します。

    • AssertInstanceIsManagedInstance:

      ターゲットインスタンスが Systems Manager によって管理されているかどうかを確認します。

    • DescribeInstance:

      ターゲット Amazon EC2 インスタンスを記述しPlatform、、InstanceType、およびアタッチされた を含むインスタンスの詳細を取得しますVolumeIds。

    • BranchOnPlatform:

      ターゲット Amazon EC2 インスタンスプラットフォームが であるかどうかを確認しWindows Server、その場合は実行を続行します。

    • DescribeVolumesModifications:

      インスタンスボリュームで現在または最近失敗した Amazon EBS ボリュームの変更について説明します。

    • RunPreChecksOnWindows:

      ターゲット Amazon EC2 インスタンスで PowerShell スクリプトを実行して、ディスク使用量分析を実行し、拡張レコメンデーションを生成します。

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

リファレンス

Systems Manager Automation