Lihat ringkasan pemanggilan untuk Hooks AWS CloudFormation

Topik ini menjelaskan cara melihat ringkasan pemanggilan untuk Hooks. AWS CloudFormation Melihat ringkasan pemanggilan dapat membantu Anda memahami bagaimana Hooks mengevaluasi sumber daya Anda dan memecahkan masalah apa pun yang mungkin timbul selama operasi tumpukan.

Pemanggilan adalah contoh spesifik ketika logika validasi Anda (apakah itu kontrol AWS Control Tower proaktif, aturan Penjaga, atau fungsi Lambda) berjalan selama siklus hidup sumber daya.

Lihat ringkasan pemanggilan di konsol

Anda dapat melihat informasi pemanggilan di konsol dengan dua cara: melalui halaman ringkasan Invocation untuk semua pemanggilan di seluruh akun Anda, atau melalui peristiwa tumpukan individual untuk pemanggilan khusus tumpukan.

Lihat semua ringkasan pemanggilan

Halaman ringkasan Doa memberikan tampilan komprehensif dari semua pemanggilan Hook di semua tumpukan di akun dan Wilayah Anda selama 90 hari terakhir.

Untuk melihat ringkasan pemanggilan

1. Masuk ke AWS Management Console dan buka AWS CloudFormation konsol di https://console.aws.amazon.com/cloudformation.

2. Pada bilah navigasi di bagian atas layar, pilih Wilayah AWS tempat Anda ingin melihat pemanggilan Hook.

3. Dari panel navigasi, pilih Ringkasan pemanggilan.

4. Halaman ini menampilkan daftar semua pemanggilan Hook dari 90 hari terakhir, termasuk:

   • ID Doa

   • Kait

   • Target

   • Mode (WarnatauFail)

   • Hasil (Warning,Pass,Failed,In progress)

   • Waktu pemanggilan

   • Pesan hasil

5. Anda dapat memfilter daftar menggunakan bilah pencarian di bagian atas tabel untuk menemukan pemanggilan tertentu.

Lihat informasi pemanggilan khusus tumpukan

Anda juga dapat melihat informasi pemanggilan untuk tumpukan tertentu melalui halaman peristiwa tumpukan.

Untuk melihat pemanggilan Hook untuk tumpukan tertentu

1. Masuk ke AWS Management Console dan buka AWS CloudFormation konsol di https://console.aws.amazon.com/cloudformation.

2. Pada bilah navigasi di bagian atas layar, pilih Wilayah AWS tempat operasi tumpukan terjadi.

3. Dari panel navigasi, pilih Stacks.

4. Pilih tumpukan yang ingin Anda lihat pemanggilan Hook.

5. Pilih tab Stack events.

6. Dalam daftar peristiwa, cari acara dengan pemanggilan Hook lengkap di kolom Alasan status. Untuk detail pemanggilan Hook tambahan, tinjau kolom pemanggilan Hook.

Lihat ringkasan pemanggilan menggunakan AWS CLI

Gunakan list-hook-resultsperintah untuk mengambil informasi tentang pemanggilan Hook. Perintah ini mendukung opsi penyaringan berikut:

• Dapatkan semua hasil pemanggilan Hook (tidak diperlukan parameter)

• Filter oleh Hook ARN (gunakan) --type-arn

• Filter berdasarkan Hook ARN dan status (gunakan --type-arn dan) --status

• Cari target tertentu (penggunaan --target-type dan--target-id)

Filter hasil oleh Hook ARN

Perintah berikut mencantumkan semua hasil pemanggilan Hook untuk Hook tertentu.

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

Contoh output:

{
  "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"
    },
    ...
  ]
}

Untuk deskripsi bidang dalam respons, lihat HookResultSummarydi Referensi AWS CloudFormation API.

Filter hasil berdasarkan Hook ARN dan status

Untuk memfilter status umum di antara hasil, tentukan --status opsi dalam perintah. Nilai yang valid adalah:

• HOOK_IN_PROGRESS: Hook sedang berjalan.

• HOOK_COMPLETE_SUCCEEDED: The Hook berhasil diselesaikan.

• HOOK_COMPLETE_FAILED: Hook selesai tetapi validasi gagal.

• HOOK_FAILED: Hook mengalami kesalahan selama eksekusi.

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

Contoh output:

{
  "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"
    },
    ...
  ]
}

Untuk deskripsi bidang dalam respons, lihat HookResultSummarydi Referensi AWS CloudFormation API.

Filter hasil berdasarkan jenis target dan ID target

Perintah berikut mencantumkan semua hasil pemanggilan Hook untuk permintaan Cloud Control API tertentu.

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

Contoh output:

{
  "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"
        },
        ...
      ]
    }
  ]
}

Untuk deskripsi bidang dalam respons, lihat HookResultSummarydi Referensi AWS CloudFormation API.