查看 Hook 的调用摘要 AWS CloudFormation - AWS CloudFormation
查看调用摘要（控制台）查看调用摘要 ()AWS CLI

本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

查看 Hook 的调用摘要 AWS CloudFormation

本主题介绍如何查看 H AWS CloudFormation ook 的调用摘要。查看调用摘要可以帮助您了解 Hook 如何评估您的资源，并解决堆栈操作期间可能出现的任何问题。

调用是您的验证逻辑（无论是 AWS Control Tower 主动控制、Guard 规则还是 Lambda 函数）在资源的生命周期中运行的特定实例。

在控制台中查看调用摘要

您可以通过两种方式在控制台中查看调用信息：通过调用摘要页面查看账户中所有调用的信息，或者通过单个堆栈事件查看特定于堆栈的调用。

查看所有调用摘要

调用摘要页面提供了过去 90 天内您账户和地区中所有堆栈的所有 Hook 调用的全面视图。

查看调用摘要

  1. 登录 AWS Management Console 并在 https://console.aws.amazon.com/cloudformat ion 上打开 AWS CloudFormation 控制台。

  2. 在屏幕顶部的导航栏上，选择要查看 Hook 调用的 AWS 区域 位置。

  3. 在导航窗格中，选择调用摘要。

  4. 该页面显示了过去 90 天内所有 Hook 调用的列表，包括：

    • 调用 ID

    • Hook

    • 目标

    • 模式（Warn或Fail）

    • 结果 (Warning,Pass,Failed,In progress)

    • 调用时间

    • 结果消息

  5. 您可以使用表格顶部的搜索栏筛选列表以查找特定的调用。

查看特定于堆栈的调用信息

您还可以通过堆栈事件页面查看特定堆栈的调用信息。

查看特定堆栈的 Hook 调用

  1. 登录 AWS Management Console 并在 https://console.aws.amazon.com/cloudformat ion 上打开 AWS CloudFormation 控制台。

  2. 在屏幕顶部的导航栏上，选择堆栈操作发生 AWS 区域 的位置。

  3. 从导航窗格中，选择堆栈。

  4. 选择要查看其的 Hook 调用的堆栈。

  5. 选择堆栈事件选项卡。

  6. 在事件列表中，在 “状态原因” 列中查找 Hook 调用已完成的事件。有关 Hook 调用的其他详细信息，请查看 Hook 调用列。

使用查看调用摘要 AWS CLI

使用list-hook-results命令检索有关 Hook 调用的信息。此命令支持以下过滤选项：

  • 获取所有 Hook 调用结果（无需参数）

  • 按挂钩筛选 ARN（使用）--type-arn

  • 按挂钩 ARN 和状态筛选（使用--type-arn和）--status

  • 搜索特定目标（使用--target-type和--target-id）

按 Hook ARN 筛选结果

以下命令列出了特定 Hook 的所有 Hook 调用结果。

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选项。有效值为：

  • HOOK_IN_PROGRESS: Hook 当前正在运行。

  • HOOK_COMPLETE_SUCCEEDED: Hook 成功完成。

  • HOOK_COMPLETE_FAILED: Hook 已完成但验证失败。

  • HOOK_FAILED: Hook 在执行过程中遇到了错误。

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 请求的所有 Hook 调用结果。

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中的。