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

AWS CloudFormation フックの呼び出しの概要を表示する

このトピックでは、 AWS CloudFormation フックの呼び出しの概要を表示する方法について説明します。呼び出しの概要を表示すると、フックがリソースをどのように評価しているかを理解し、スタックオペレーション中に発生する可能性のある問題のトラブルシューティングに役立ちます。

呼び出しは、検証ロジック (プロアクティブコントロール、ガードルール、Lambda 関数のいずれであっても AWS Control Tower ) がリソースのライフサイクル中に実行される特定のインスタンスです。

コンソールで呼び出しの概要を表示する

コンソールで呼び出し情報を表示するには、2 つの方法があります。アカウント全体のすべての呼び出しの呼び出しの概要ページ、またはスタック固有の呼び出しの個々のスタックイベントです。

すべての呼び出しの概要を表示する

呼び出しの概要ページには、過去 90 日間のアカウントとリージョンのすべてのスタックにわたるすべてのフック呼び出しの包括的なビューが表示されます。

スタック固有の呼び出し情報を表示する

スタックイベントページから特定のスタックの呼び出し情報を表示することもできます。

を使用して呼び出しの概要を表示する AWS CLI

list-hook-results コマンドを使用して、フック呼び出しに関する情報を取得します。このコマンドは、次のフィルタリングオプションをサポートしています。

フック ARN で結果をフィルタリングする

次の コマンドは、特定のフックのすべてのフック呼び出し結果を一覧表示します。

aws cloudformation list-hook-results \
  --type-arn arn:aws:cloudformation:us-west-2:123456789012:type/hook/MyOrg-Security-ComplianceHook \
  --region us-west-2

出力例:

{
  "HookResults": [
    {
      "TypeArn": "arn:aws:cloudformation:us-west-2:123456789012:type/hook/MyOrg-Security-ComplianceHook",
      "HookResultId": "59ef501c-0ac4-47c0-a193-e071cabf748d",
      "TypeName": "MyOrg::Security::ComplianceHook",
      "TypeVersionId": "00000001",
      "HookExecutionTarget": "arn:aws:cloudformation:us-west-2:123456789012:stack/my-stack/39f29d10-73ed-11f0-abc1-0affdfe4aebb",
      "InvokedAt": "2025-08-08T00:18:39.651Z",
      "FailureMode": "WARN",
      "HookStatusReason": "...",
      "InvocationPoint": "PRE_PROVISION",
      "Status": "HOOK_COMPLETE_FAILED"
    },
    ...
  ]
}

レスポンスのフィールドの説明については、 AWS CloudFormation API リファレンスのHookResultSummary」を参照してください。

フック ARN とステータスで結果をフィルタリングする

結果間で共通のステータスをフィルタリングするには、 コマンドで --statusオプションを指定します。次の値を指定できます:

aws cloudformation list-hook-results \
  --type-arn arn:aws:cloudformation:us-west-2:123456789012:type/hook/MyOrg-Security-ComplianceHook \ 
  --status HOOK_COMPLETE_FAILED \
  --region us-west-2

出力例:

{
  "HookResults": [
    {
      "TypeArn": "arn:aws:cloudformation:us-west-2:123456789012:type/hook/MyOrg-Security-ComplianceHook",
      "HookResultId": "59ef501c-0ac4-47c0-a193-e071cabf748d",
      "TypeName": "MyOrg::Security::ComplianceHook",
      "TypeVersionId": "00000001",
      "HookExecutionTarget": "arn:aws:cloudformation:us-west-2:123456789012:stack/my-stack/39f29d10-73ed-11f0-abc1-0affdfe4aebb",
      "InvokedAt": "2025-08-08T00:18:39.651Z",
      "FailureMode": "WARN",
      "HookStatusReason": "...",
      "InvocationPoint": "PRE_PROVISION",
      "Status": "HOOK_COMPLETE_FAILED"
    },
    ...
  ]
}

レスポンスのフィールドの説明については、 AWS CloudFormation API リファレンスのHookResultSummary」を参照してください。

ターゲットタイプとターゲット ID で結果をフィルタリングする

次の コマンドは、特定の Cloud Control API リクエストのすべてのフック呼び出し結果を一覧表示します。

aws cloudformation list-hook-results \
  --target-type CLOUD_CONTROL \
  --target-id d417b05b-9eff-46ef-b164-08c76aec1801 \
  --region us-west-2

出力例:

{
  "HookResults": [
    {
      "TargetType": "CLOUD_CONTROL",
      "TargetId": "d417b05b-9eff-46ef-b164-08c76aec1801",
      "HookResults": [
        {
          "TypeArn": "arn:aws:cloudformation:us-west-2:123456789012:type/hook/MyOrg-Security-ComplianceHook",
          "HookResultId": "4e7f4766-d8fe-44e5-8587-5b327a148abe",
          "TypeName": "MyOrg::Security::ComplianceHook",
          "TypeVersionId": "00000001",
          "FailureMode": "WARN",
          "HookStatusReason": "...",
          "InvocationPoint": "PRE_PROVISION",
          "Status": "HOOK_COMPLETE_FAILED"
        },
        ...
      ]
    }
  ]
}

レスポンスのフィールドの説明については、 AWS CloudFormation API リファレンスのHookResultSummary」を参照してください。