Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

Aufrufergebnisse für CloudFormation Hooks anzeigen

In diesem Thema wird beschrieben, wie Sie Aufrufergebnisse für CloudFormation Hooks anzeigen. Durch die Anzeige der Aufrufergebnisse können Sie besser verstehen, wie Hooks Ihre Ressourcen bewerten, und alle Probleme lösen, die bei der Überprüfung einer Ressource durch Hooks festgestellt werden.

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.

Aufrufergebnisse in der Konsole anzeigen

Sie können Aufrufergebnisse in der Konsole auf drei Arten anzeigen: über die Seite mit der Aufruf-Zusammenfassung, über die Aufrufhistorien für einzelne Hooks oder über einzelne Stack-Ereignisse für stapelspezifische Aufrufe.

Ergebnisse für alle Hooks anzeigen

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

Den Aufrufverlauf für einzelne Hooks anzeigen

Sie können die Aufrufergebnisse auch in den Aufruflisten einzelner Hooks einsehen.

Ergebnisse für stapelspezifische Aufrufe anzeigen

Sie können die Aufrufergebnisse für einen bestimmten Stack auch auf der Seite Stack-Ereignisse anzeigen.

Rufen Sie die Ergebnisse des Aufrufs auf, indem Sie AWS CLI

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

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. Folgende sind gültige Werte:

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.

Rufen Sie detaillierte Ergebnisse für einen bestimmten Aufruf ab

Verwenden Sie den get-hook-resultBefehl, um detaillierte Informationen zu einem bestimmten Hook-Aufruf abzurufen, einschließlich Anmerkungen mit Ergebnissen der Konformitätsprüfung und Anleitungen zur Problembehebung.

aws cloudformation get-hook-result \
  --hook-result-id 59ef501c-0ac4-47c0-a193-e071cabf748d \
  --region us-west-2

Beispielausgabe:

{
  "HookResultId": "59ef501c-0ac4-47c0-a193-e071cabf748d",
  "InvocationPoint": "PRE_PROVISION",
  "FailureMode": "WARN",
  "TypeName": "MyOrg::Security::ComplianceHook",
  "TypeVersionId": "00000001",
  "TypeArn": "arn:aws:cloudformation:us-west-2:123456789012:type/hook/MyOrg-Security-ComplianceHook",
  "Status": "HOOK_COMPLETE_FAILED",
  "HookStatusReason": "Hook completed with failed validations",
  "InvokedAt": "2025-08-08T00:18:39.651Z",
  "Target": {
    "TargetType": "RESOURCE",
    "TargetTypeName": "AWS::S3::Bucket",
    "TargetId": "my-s3-bucket",
    "Action": "CREATE"
  },
  "Annotations": [
    {
      "AnnotationName": "BlockPublicAccessCheck",
      "Status": "FAILED",
      "StatusMessage": "Bucket does not block public access",
      "RemediationMessage": "Enable block public access settings on the S3 bucket",
      "SeverityLevel": "HIGH"
    },
    {
      "AnnotationName": "BucketEncryptionCheck", 
      "Status": "PASSED",
      "StatusMessage": "Bucket has encryption configured correctly"
    }
  ]
}

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