

• AWS Systems Manager CloudWatch ダッシュボードは、2026 年 4 月 30 日以降は利用できなくなります。お客様は、これまでと同様に Amazon CloudWatch コンソールを使用して、Amazon CloudWatch ダッシュボードの表示、作成、管理を継続できます。詳細については、「[Amazon CloudWatch ダッシュボードのドキュメント](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch_Dashboards.html)」を参照してください。

# 独自のランブックの作成
<a name="automation-documents"></a>

オートメーションランブックは、オートメーションの実行時にマネージドインスタンスおよびその他の AWS リソースで Systems Manager が実行する*アクション*を定義します。Automation は AWS Systems Manager のツールです。ランブックには、順次実行されるステップが 1 つ以上含まれています。各ステップは、1 つのアクションを中心に構築されます。1 つのステップからの出力は、後のステップで入力として使用できます。

これらのアクションとそのステップを実行するプロセスは、*オートメーション*と呼ばれます。

ランブックでサポートされているアクションタイプを使用すると、AWS 環境でのさまざまなオペレーションを自動化できます。たとえば、`executeScript` アクションタイプを使用すると、Python または PowerShell スクリプトをランブックに直接埋め込むことができます。(カスタムランブックを作成するときは、スクリプトをインラインで追加するか、S3 バケットまたはローカルマシンからアタッチできます)。AWS CloudFormation および `createStack` アクションタイプを使用すると、`deleteStack` リソースの管理を自動化できます。また、`executeAwsApi` アクションタイプを使用すると、ステップは AWS リソースの作成または削除、他のプロセスの開始、通知の開始など、任意の AWS のサービスで任意の API オペレーションを実行できます。

オートメーションでサポートされている 20 種類のアクションタイプの一覧については、「[Systems Manager Automation アクションのリファレンス](automation-actions.md)」を参照してください。

AWS Systems Manager Automation では、1 つ以上の Amazon Elastic Compute Cloud (Amazon EC2) インスタンスの再起動や、Amazon Machine Image (AMI) の作成といった一般的なタスクを実行する際に使用することができる事前定義されたステップを含むいくつかのランブックが用意されています。また、独自のランブックを作成して他の AWS アカウント と共有したり、すべての Automation ユーザーに公開したりすることもできます。

ランブックは YAML または JSON を使用して記述されます。ただし、Systems Manager Automation コンソールの [**Document Builder (ドキュメントビルダー)**] を使用すると、ネイティブの JSON または YAML で作成しなくても、ランブックを作成できます。

**重要**  
AWS Identity and Access Management (IAM) サービスロールを使用して他のサービスを呼び出す自動化ワークフローを実行する場合は、それらのサービスを呼び出すためのアクセス許可をサービスロールに設定する必要がある点に注意してください。この要件は、`AWS-ConfigureS3BucketLogging`、`AWS-CreateDynamoDBBackup`、`AWS-RestartEC2Instance` ランブックなど、すべての AWS オートメーションランブック (`AWS-*` ランブック) に適用されます。この要件は、他のサービスを呼び出すアクションを使用して他の AWS のサービスを呼び出すように作成したカスタムオートメーションランブックにも適用されます。例えば、`aws:executeAwsApi`、`aws:createStack`、または `aws:copyImage` のアクションを使用する場合は、それらのサービスを呼び出すためのアクセス許可を持つサービスロールを設定します。ロールに IAM インラインポリシーを追加することで、他の AWS のサービスへのアクセス許可を有効にできます。詳細については、「[(オプション) 他の AWS のサービス を呼び出すためのオートメーションインラインポリシーまたはカスタマー管理ポリシーを追加する](automation-setup-iam.md#add-inline-policy)」を参照してください。

ランブックで指定できるアクションまたはプラグインに関する情報を表示するには、「[Systems Manager Automation アクションのリファレンス](automation-actions.md)」を参照してください。

AWS Toolkit for Visual Studio Code を使用してランブックを作成する方法については、 *AWS Toolkit for Visual Studio Code ユーザーガイド*の「[Systems Manager Automation ドキュメントの使用](https://docs.aws.amazon.com/toolkit-for-vscode/latest/userguide/systems-manager-automation-docs.html)」を参照してください。

ビジュアルデザイナーを使用したカスタムランブックの作成については、「[オートメーションランブックのビジュアルデザインエクスペリエンス](automation-visual-designer.md)」を参照してください。

**Contents**
+ [オートメーションランブックのビジュアルデザインエクスペリエンス](automation-visual-designer.md)
  + [ビジュアルデザインエクスペリエンスのインターフェースの概要](visual-designer-interface-overview.md)
    + [アクションブラウザー](visual-designer-interface-overview.md#visual-designer-actions)
    + [キャンバス](visual-designer-interface-overview.md#visual-designer-canvas)
    + [フォーム](visual-designer-interface-overview.md#visual-designer-form)
    + [キーボードショートカット](visual-designer-interface-overview.md#visual-designer-keyboard-shortcuts)
  + [ビジュアルデザインエクスペリエンスの活用](visual-designer-use.md)
    + [ランブックワークフローを作成する](visual-designer-use.md#visual-designer-create-runbook-workflow)
    + [ランブックを作成する](visual-designer-use.md#visual-designer-build)
    + [ランブックを更新する](visual-designer-use.md#visual-designer-update-runbook)
    + [ランブックのエクスポート](visual-designer-use.md#visual-designer-export-runbook)
  + [アクションの入力と出力を構成する](visual-designer-action-inputs-outputs.md)
    + [アクションの入力データを提供する。](visual-designer-action-inputs-outputs.md#providing-input)
    + [アクションの出力データを定義します。](visual-designer-action-inputs-outputs.md#defining-output)
  + [ビジュアルデザインエクスペリエンスによるエラー処理](visual-designer-error-handling.md)
    + [エラー発生時にアクションを再試行してください。](visual-designer-error-handling.md#retry-actions)
    + [タイムアウト](visual-designer-error-handling.md#timeout-seconds)
    + [失敗したアクション](visual-designer-error-handling.md#failure-actions)
    + [キャンセルされたアクション](visual-designer-error-handling.md#cancel-actions)
    + [重要なアクション](visual-designer-error-handling.md#critical-actions)
    + [アクションを終了する](visual-designer-error-handling.md#end-actions)
  + [チュートリアル: ビジュアルデザインエクスペリエンスを使用したランブックの作成](visual-designer-tutorial.md)
    + [ステップ 1: ビジュアルデザインエクスペリエンスに移動](visual-designer-tutorial.md#navigate-console)
    + [ステップ 2: ワークフローを作成する](visual-designer-tutorial.md#create-workflow)
    + [ステップ 3: 自動生成されたコードを確認する](visual-designer-tutorial.md#view-generated-code)
    + [ステップ 4: 新しいランブックを実行する](visual-designer-tutorial.md#use-tutorial-runbook)
    + [ステップ 5：クリーンアップ](visual-designer-tutorial.md#cleanup-tutorial-runbook)
+ [オートメーションランブックのオーサリング](automation-authoring-runbooks.md)
  + [ユースケースの特定](automation-authoring-runbooks.md#automation-authoring-runbooks-use-case)
  + [開発環境をセットアップする](automation-authoring-runbooks.md#automation-authoring-runbooks-environment)
  + [ランブックコンテンツの開発](automation-authoring-runbooks.md#automation-authoring-runbooks-developing-content)
  + [例 1: 親子のランブックの作成](automation-authoring-runbooks-parent-child-example.md)
    + [子ランブックの作成](automation-authoring-runbooks-parent-child-example.md#automation-authoring-runbooks-child-runbook)
    + [親ランブックの作成](automation-authoring-runbooks-parent-child-example.md#automation-authoring-runbooks-parent-runbook)
  + [例 2: スクリプト化されたランブック](automation-authoring-runbooks-scripted-example.md)
  + [その他のランブックの例](automation-document-examples.md)
    + [VPC アーキテクチャと Microsoft Active Directory ドメインコントローラーのデプロイ](automation-document-architecture-deployment-example.md)
    + [最新のスナップショットからルートボリュームを復元する](automation-document-instance-recovery-example.md)
    + [AMI とクロスリージョンコピーの作成](automation-document-backup-maintenance-example.md)
+ [AWS リソースを設定する入力パラメーターの作成](populating-input-parameters.md)
+ [ランブック作成のためのドキュメントビルダーの使用](automation-document-builder.md)
  + [ドキュメントビルダーを使用してランブックを作成する](automation-document-builder.md#create-runbook)
  + [スクリプトを実行するランブックを作成する](automation-document-builder.md#create-runbook-scripts)
+ [ランブックでのスクリプトの使用](automation-document-script-considerations.md)
  + [ランブックを使用するためのアクセス許可](automation-document-script-considerations.md#script-permissions)
  + [スクリプトをランブックに追加する](automation-document-script-considerations.md#adding-scripts)
  + [ランブックのスクリプト制約](automation-document-script-considerations.md#script-constraints)
+ [ランブックでの条件文の使用](automation-branch-condition.md)
  + [`aws:branch` アクションの使用](automation-branch-condition.md#branch-action-explained)
    + [ランブック `aws:branch` でのステップの作成](automation-branch-condition.md#create-branch-action)
      + [出力変数の作成について](automation-branch-condition.md#branch-action-output)
    + [`aws:branch` ランブックの例](automation-branch-condition.md#branch-runbook-examples)
    + [演算子を使用した複雑な分岐オートメーションの作成](automation-branch-condition.md#branch-operators)
  + [条件オプションの使用例](automation-branch-condition.md#conditional-examples)
+ [アクション出力の入力としての使用](automation-action-outputs-inputs.md)
  + [ランブックでの JSONPath の使用](automation-action-outputs-inputs.md#automation-action-json-path)
+ [Automation 向けのウェブフック統合の作成](creating-webhook-integrations.md)
  + [統合の作成 (コンソール)](creating-webhook-integrations.md#creating-integrations-console)
  + [統合の作成 (コマンドライン)](creating-webhook-integrations.md#creating-integrations-commandline)
  + [統合用のウェブフックの作成](creating-webhook-integrations.md#creating-webhooks)
+ [ランブックでのタイムアウトの処理](automation-handling-timeouts.md)