Creazione di integrazioni webhook per Automazione - AWS Systems Manager
Creazione di integrazioni (console)Creazione di integrazioni (riga di comando)Creazione di webhook per integrazioni

• La AWS Systems Manager CloudWatch dashboard non sarà più disponibile dopo il 30 aprile 2026. I clienti possono continuare a utilizzare la CloudWatch console Amazon per visualizzare, creare e gestire le proprie CloudWatch dashboard Amazon, proprio come fanno oggi. Per ulteriori informazioni, consulta la documentazione di Amazon CloudWatch Dashboard.

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

Creazione di integrazioni webhook per Automazione

Creare un'integrazione ti permette di inviare messaggi utilizzando webhook durante un'automazione. Le integrazioni possono essere richiamate durante un'automazione utilizzando l'operazione aws:invokeWebhook nel tuo runbook. Se non hai ancora creato un webhook, consulta Creazione di webhook per integrazioni. Per ulteriori informazioni sulle operazioni di aws:invokeWebhook, consulta aws:invokeWebhook: richiamo dell'integrazione di un webhook di Automation.

Come illustrato nelle procedure seguenti, puoi creare un'integrazione utilizzando la console di Systems Manager Automation o lo strumento a riga di comando desiderato.

Creazione di integrazioni (console)

Creazione di un'integrazione per Automazione (console)

  1. Apri la AWS Systems Manager console all'indirizzo https://console.aws.amazon.com/systems-manager/.

  2. Nel pannello di navigazione, scegli Automazione.

  3. Seleziona la scheda Integrazioni.

  4. Seleziona Aggiungi integrazione e scegli Webhook.

  5. Inserisci i valori obbligatori e tutti i valori facoltativi che desideri includere per l'integrazione.

  6. Scegli Aggiungi per creare l'integrazione.

Creazione di integrazioni (riga di comando)

Per creare un'integrazione utilizzando gli strumenti a riga di comando, devi creare il parametro SecureString obbligatorio per un'integrazione. L'automazione utilizza un namespace riservato in Parameter Store, uno strumento di Systems Manager, per archiviare informazioni sulla tua integrazione. Se crei un'integrazione utilizzando Console di gestione AWS, Automation gestisce questo processo per te. Dopo namespace, devi specificare il tipo di integrazione che desideri creare e quindi il nome dell'integrazione. Attualmente, Automation supporta integrazioni di tipo webhook.

I campi supportati per le integrazioni di tipo webhook sono i seguenti:

  • Description

  • headers

  • payload

  • URL

Prima di iniziare

Se non l'hai già fatto, installa e configura AWS Command Line Interface (AWS CLI) o AWS Strumenti per PowerShell. Per informazioni, consulta le pagine Installazione o aggiornamento della versione più recente di AWS CLI e Installazione di AWS Strumenti per PowerShell.

Per creare un'integrazione per Automazione (riga di comando)

  • Esegui i comandi seguenti per creare il parametro SecureString obbligatorio per un'integrazione. Sostituisci ogni example resource placeholder con le tue informazioni. Il namespace di /d9d01087-4a3f-49e0-b0b4-d568d7826553/ssm/integrations/webhook/ è riservato in Parameter Store per le integrazioni. Il nome del tuo paramento deve utilizzare questo namespace seguito dal nome dell'integrazione. Ad esempio, /d9d01087-4a3f-49e0-b0b4-d568d7826553/ssm/integrations/webhook/myWebhookIntegration.

    Linux & macOS
    aws ssm put-parameter \
    --name "/d9d01087-4a3f-49e0-b0b4-d568d7826553/ssm/integrations/webhook/myWebhookIntegration" \
    --type "SecureString" \
    --data-type "aws:ssm:integration" \
    --value '{"description": "My first webhook integration for Automation.", "url": "myWebHookURL"}'
    Windows
    aws ssm put-parameter ^
    --name "/d9d01087-4a3f-49e0-b0b4-d568d7826553/ssm/integrations/webhook/myWebhookIntegration" ^
    --type "SecureString" ^
    --data-type "aws:ssm:integration" ^
    --value  "{\"description\":\"My first webhook integration for Automation.\",\"url\":\"myWebHookURL\"}"
    PowerShell
    Write-SSMParameter `
    -Name "/d9d01087-4a3f-49e0-b0b4-d568d7826553/ssm/integrations/webhook/myWebhookIntegration" `
    -Type "SecureString"
    -DataType "aws:ssm:integration"
    -Value '{"description": "My first webhook integration for Automation.", "url": "myWebHookURL"}'

Creazione di webhook per integrazioni

Quando crei webhook con il provider, nota quanto segue:

  • Il protocollo deve essere HTTPS.

  • Sono supportate le intestazioni delle richieste personalizzate.

  • È possibile specificare un corpo della richiesta predefinito.

  • Il corpo della richiesta predefinito può essere ignorato quando viene richiamata un'integrazione utilizzando l'operazione aws:invokeWebhook.