Visualizza i riepiloghi delle chiamate per Hooks AWS CloudFormation

Questo argomento descrive come visualizzare i riepiloghi delle chiamate per Hooks. AWS CloudFormation La visualizzazione dei riepiloghi delle chiamate può aiutarti a capire come gli Hooks stanno valutando le tue risorse e a risolvere eventuali problemi che potrebbero sorgere durante le operazioni di stack.

Le chiamate sono istanze specifiche in cui la logica di convalida (che si tratti di un controllo AWS Control Tower proattivo, di una regola Guard o di una funzione Lambda) viene eseguita durante il ciclo di vita di una risorsa.

Visualizza i riepiloghi delle chiamate nella console

È possibile visualizzare le informazioni sulle chiamate nella console in due modi: tramite la pagina di riepilogo delle chiamate per tutte le chiamate nell'account o tramite singoli eventi dello stack per chiamate specifiche dello stack.

Visualizza tutti i riepiloghi delle chiamate

La pagina di riepilogo delle chiamate fornisce una visualizzazione completa di tutte le chiamate Hook su tutti gli stack del tuo account e della tua regione negli ultimi 90 giorni.

Per visualizzare i riepiloghi delle chiamate

1. Accedi AWS Management Console e apri la AWS CloudFormation console all'indirizzo /cloudformazione. https://console.aws.amazon.com

2. Nella barra di navigazione nella parte superiore dello schermo, scegli Regione AWS dove vuoi visualizzare le invocazioni di Hook.

3. Dal pannello di navigazione, scegli Riepilogo delle chiamate.

4. La pagina mostra un elenco di tutte le invocazioni di Hook degli ultimi 90 giorni, tra cui:

   • ID di chiamata

   • Gancio

   • Target

   • Modalità (WarnoFail)

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

   • Tempo di invocazione

   • Messaggio del risultato

5. Puoi filtrare l'elenco utilizzando la barra di ricerca nella parte superiore della tabella per trovare chiamate specifiche.

Visualizza informazioni sulle chiamate specifiche dello stack

È inoltre possibile visualizzare le informazioni di chiamata per uno stack specifico tramite la pagina degli eventi dello stack.

Per visualizzare le invocazioni Hook per uno stack specifico

1. Accedi AWS Management Console e apri la AWS CloudFormation console all'indirizzo /cloudformazione. https://console.aws.amazon.com

2. Nella barra di navigazione nella parte superiore dello schermo, scegli Regione AWS dove si è verificata l'operazione stack.

3. Scegli Stack nel riquadro di navigazione.

4. Seleziona lo stack per il quale desideri visualizzare le invocazioni di Hook.

5. Scegli la scheda Stack events.

6. Nell'elenco degli eventi, cerca gli eventi con invocazioni Hook complete nella colonna Status reason. Per ulteriori dettagli sulle invocazioni di Hook, consulta la colonna Invocazioni Hook.

Visualizza i riepiloghi delle chiamate utilizzando il AWS CLI

Usa il list-hook-resultscomando per recuperare informazioni sulle invocazioni di Hook. Questo comando supporta le seguenti opzioni di filtro:

• Ottieni tutti i risultati della chiamata di Hook (nessun parametro richiesto)

• Filtra per Hook ARN (uso) --type-arn

• Filtra per Hook ARN e stato (uso --type-arn e) --status

• Cerca obiettivi specifici (uso --target-type e--target-id)

Filtra i risultati per Hook ARN

Il comando seguente elenca tutti i risultati di invocazione di Hook per un Hook specifico.

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

Output di esempio:

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

Per una descrizione dei campi nella risposta, consulta l'AWS CloudFormation API HookResultSummaryReference.

Filtra i risultati per Hook, ARN e stato

Per filtrare in base a uno stato comune tra i risultati, specifica l'--statusopzione nel comando. I valori validi sono:

• HOOK_IN_PROGRESS: L'Hook è attualmente in esecuzione.

• HOOK_COMPLETE_SUCCEEDED: L'Hook è stato completato con successo.

• HOOK_COMPLETE_FAILED: La convalida dell'Hook è stata completata ma non è riuscita.

• HOOK_FAILED: L'Hook ha riscontrato un errore durante l'esecuzione.

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

Output di esempio:

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

Per una descrizione dei campi della risposta, consulta HookResultSummaryl'AWS CloudFormation API Reference.

Filtra i risultati per tipo e ID di destinazione

Il comando seguente elenca tutti i risultati di invocazione di Hook per una richiesta API Cloud Control specifica.

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

Output di esempio:

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

Per una descrizione dei campi nella risposta, consulta l'AWS CloudFormation API HookResultSummaryReference.