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

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'azione aws:invokeWebhook nel tuo runbook. Se non hai ancora creato un webhook, consulta Creazione di webhook per integrazioni. Per ulteriori informazioni sulle azioni 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 Automation (console)

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

  2. Nel pannello di navigazione, scegliere Automation (Automazione).

  3. Seleziona la scheda Integrations (Integrazioni).

  4. Seleziona Add integration (Aggiungi integrazioni) e scegliWebhook.

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

  6. Scegli Add (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 uno spazio dei nomi riservato in Parameter Store, una funzionalità di Systems Manager, per archiviare informazioni sulla tua integrazione. Se crei un'integrazione utilizzando la AWS Management Console, Automation gestisce questo processo al posto tuo. Dopo lo spazio dei nomi, 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:

  • Descrizione

  • headers

  • payload

  • URL

Prima di iniziare

Se non lo hai ancora fatto, installa e configura il AWS Command Line Interface (AWS CLI) o il AWS Tools for PowerShell. Per informazioni, consulta le pagine Installazione o aggiornamento della versione più recente di AWS CLI e Installazione di AWS Tools for PowerShell.

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

  • Esegui i comandi seguenti per creare il parametro SecureString obbligatorio per un'integrazione. Sostituisci ciascun segnaposto delle risorse di esempio con le tue informazioni. Lo spazio dei nomi di /d9d01087-4a3f-49e0-b0b4-d568d7826553/ssm/integrations/webhook/ è riservato in Parameter Store per le integrazioni. Il nome del parametro deve utilizzare questo spazio dei nomi 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.