為 Automation 建立 Webhook 整合 - AWS Systems Manager

本文為英文版的機器翻譯版本,如內容有任何歧義或不一致之處,概以英文版為準。

為 Automation 建立 Webhook 整合

若要在自動化過程中使用 Webhook 傳送訊息,請建立整合。在自動化過程中,您可以使用 Runbook 中的 aws:invokeWebhook 動作來叫用整合。若尚未建立 Webhook,請參閱 為整合建立 Webhook。若要進一步了解 aws:invokeWebhook 動作,請參閱 aws:invokeWebhook:叫用 Automation Webhook 整合

如以下程序所示,您可以使用 Systems Manager Automation 主控台或偏好的命令列工具來建立整合。

建立整合 (主控台)

建立 Automation 整合 (主控台)
  1. 開啟位於 https://console.aws.amazon.com/systems-manager/ 的 AWS Systems Manager 主控台。

  2. 在導覽窗格中,選擇 Automation (自動化)。

  3. 選擇 Integrations (整合) 索引標籤。

  4. 選取 Add integration (新增整合),然後選擇 Webhook

  5. 輸入整合要包含的必要值和選用值。

  6. 選擇 Add (新增) 來建立整合。

建立整合 (命令列)

要想使用命令列工具來建立整合,您必須建立必要的 SecureString 參數進行整合。Automation 使用 Parameter Store (Systems Manager 的功能) 中的保留命名空間來存放與整合相關的資訊。如果使用 AWS Management Console 建立整合,Automation 會為您處理此程序。在命名空間之後,您必須指定要建立的整合類型,然後指定整合的名稱。Automation 目前支援 webhook 類型整合。

webhook 類型整合的支援欄位如下所示:

  • 描述

  • 標頭

  • payload

  • URL

開始之前

如果您尚未準備就緒,請安裝並設定 AWS Command Line Interface (AWS CLI) 或 AWS Tools for PowerShell。如需相關資訊,請參閱安裝或更新 AWS CLI 的最新版本安裝 AWS Tools for PowerShell

建立 Automation 整合 (命令列)
  • 執行下列命令來建立整合所需的 SecureString 參數。將每個範例資源預留位置取代為您自己的資訊。/d9d01087-4a3f-49e0-b0b4-d568d7826553/ssm/integrations/webhook/ 命名空間會保留在 Parameter Store 中,以供整合使用。參數名稱必須使用此命名空間,後面接著整合名稱。例如:/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"}'

為整合建立 Webhook

借助提供商建立 Webhook 時,請注意下列事項:

  • 通訊協定必須是 HTTPS。

  • 支援自訂請求標頭。

  • 可以指定預設請求主體。

  • 使用 aws:invokeWebhook 動作叫用整合時,可以覆寫預設請求主體。