Aufrufzusammenfassungen für Hooks anzeigen AWS CloudFormation

In diesem Thema wird beschrieben, wie Sie Aufrufzusammenfassungen für Hooks anzeigen. AWS CloudFormation Durch das Anzeigen von Aufrufübersichten können Sie besser verstehen, wie Hooks Ihre Ressourcen bewerten, und Probleme beheben, die bei Stack-Vorgängen auftreten können.

Aufrufe sind spezifische Fälle, in denen Ihre Validierungslogik (unabhängig davon, ob es sich um eine AWS Control Tower proaktive Steuerung, eine Guard-Regel oder eine Lambda-Funktion handelt) während des Lebenszyklus einer Ressource ausgeführt wird.

Rufen Sie die Zusammenfassungen der Aufrufe in der Konsole auf

Sie können Aufrufinformationen in der Konsole auf zwei Arten anzeigen: über die Seite mit der Aufrufübersicht für alle Aufrufe in Ihrem Konto oder über einzelne Stack-Ereignisse für stapelspezifische Aufrufe.

Alle Aufruf-Zusammenfassungen anzeigen

Die Seite mit der Zusammenfassung der Aufrufe bietet einen umfassenden Überblick über alle Hook-Aufrufe in allen Stacks in Ihrem Konto und Ihrer Region in den letzten 90 Tagen.

Um Aufruf-Zusammenfassungen anzusehen

1. Melden Sie sich bei der an AWS Management Console und öffnen Sie die AWS CloudFormation Konsole unter https://console.aws.amazon.com /cloudformation.

2. Wählen Sie in der Navigationsleiste oben auf dem Bildschirm den Ort aus, AWS-Region an dem Sie Hook-Aufrufe anzeigen möchten.

3. Wählen Sie im Navigationsbereich die Option Aufrufübersicht aus.

4. Auf der Seite wird eine Liste aller Hook-Aufrufe der letzten 90 Tage angezeigt, darunter:

   • Aufruf-ID

   • Haken

   • Ziel

   • Modus (WarnoderFail)

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

   • Uhrzeit des Aufrufs

   • Meldung des Ergebnisses

5. Sie können die Liste mithilfe der Suchleiste oben in der Tabelle filtern, um nach bestimmten Aufrufen zu suchen.

Stack-spezifische Aufrufinformationen anzeigen

Sie können auch Aufrufinformationen für einen bestimmten Stack auf der Seite mit den Stack-Ereignissen anzeigen.

Um Hook-Aufrufe für einen bestimmten Stack anzuzeigen

1. Melden Sie sich bei der an AWS Management Console und öffnen Sie die AWS CloudFormation Konsole unter https://console.aws.amazon.com /cloudformation.

2. Wählen Sie in der Navigationsleiste oben auf dem Bildschirm den Ort aus, an AWS-Region dem der Stack-Vorgang stattgefunden hat.

3. Wählen Sie im Navigationsbereich Stacks aus.

4. Wählen Sie den Stack aus, für den Sie Hook-Aufrufe anzeigen möchten.

5. Wählen Sie den Tab Stack-Ereignisse.

6. Suchen Sie in der Ereignisliste in der Spalte Statusgrund nach Ereignissen, bei denen die Hook-Aufrufe abgeschlossen sind. Weitere Informationen zu Hook-Aufrufen finden Sie in der Spalte Hook-Aufrufe.

Rufen Sie die Zusammenfassungen der Aufrufe auf, indem Sie AWS CLI

Verwenden Sie den list-hook-resultsBefehl, um Informationen über Hook-Aufrufe abzurufen. Dieser Befehl unterstützt die folgenden Filteroptionen:

• Ruft alle Hook-Aufrufergebnisse ab (keine Parameter erforderlich)

• Nach Hook ARN filtern (verwenden--type-arn)

• Nach Hook-ARN und Status filtern (verwenden --type-arn und--status)

• Suchen Sie nach bestimmten Zielen (verwenden Sie --target-type und--target-id)

Ergebnisse filtern nach Hook ARN

Der folgende Befehl listet alle Hook-Aufrufergebnisse für einen bestimmten Hook auf.

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

Beispielausgabe:

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

Eine Beschreibung der Felder in der Antwort finden Sie HookResultSummaryin der AWS CloudFormation API-Referenz.

Ergebnisse nach Hook-ARN und Status filtern

Um nach einem gemeinsamen Status unter den Ergebnissen zu filtern, geben Sie die --status Option im Befehl an. Gültige Werte für sind:

• HOOK_IN_PROGRESS: Der Hook läuft gerade.

• HOOK_COMPLETE_SUCCEEDED: Der Hook wurde erfolgreich abgeschlossen.

• HOOK_COMPLETE_FAILED: Der Hook wurde abgeschlossen, konnte aber nicht validiert werden.

• HOOK_FAILED: Der Hook ist bei der Ausführung auf einen Fehler gestoßen.

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

Beispielausgabe:

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

Eine Beschreibung der Felder in der Antwort finden Sie HookResultSummaryin der AWS CloudFormation API-Referenz.

Filtern Sie die Ergebnisse nach Zieltyp und Ziel-ID

Der folgende Befehl listet alle Hook-Aufrufergebnisse für eine bestimmte Cloud Control API-Anforderung auf.

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

Beispielausgabe:

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

Eine Beschreibung der Felder in der Antwort finden Sie HookResultSummaryin der AWS CloudFormation API-Referenz.