管理HTTP主題規則目的地 - AWS IoT Core

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

管理HTTP主題規則目的地

您可以使用下列操作來管理HTTP主題規則目的地。

建立HTTP主題規則目的地

您可以透過呼叫 CreateTopicRuleDestination操作或使用 AWS IoT 主控台來建立HTTP主題規則目的地。

建立目的地之後, 會將確認請求 AWS IoT 傳送至確認 URL。確認請求的格式如下:

HTTP POST {confirmationUrl}/?confirmationToken={confirmationToken} Headers: x-amz-rules-engine-message-type: DestinationConfirmation x-amz-rules-engine-destination-arn:"arn:aws:iot:us-east-1:123456789012:ruledestination/http/7a280e37-b9c6-47a2-a751-0703693f46e4" Content-Type: application/json Body: { "arn":"arn:aws:iot:us-east-1:123456789012:ruledestination/http/7a280e37-b9c6-47a2-a751-0703693f46e4", "confirmationToken": "AYADeMXLrPrNY2wqJAKsFNn-…NBJndA", "enableUrl": "https://iot.us-east-1.amazonaws.com/confirmdestination/AYADeMXLrPrNY2wqJAKsFNn-…NBJndA", "messageType": "DestinationConfirmation" }

確認請求的內容包含下列資訊:

arn

要確認之主題規則目的地的 Amazon Resource Name (ARN)。

confirmationToken

傳送的確認字符 AWS IoT Core。範例中的字符會被截斷。您的字符將更長。您需要此字符來使用 AWS IoT Core確認目的地。

enableUrl

您瀏覽以確認主題規則目的地URL的 。

messageType

訊息的類型。

確認HTTP主題規則目的地

若要完成端點確認程序,如果您使用的是 AWS CLI,您必須在確認URL收到確認請求後執行下列步驟。

  1. 確認目的地願意接收訊息

    若要確認主題規則目的地願意接收 IoT 訊息,請在確認請求enableUrl中呼叫 ,或執行 ConfirmTopicRuleDestinationAPI操作並從confirmationToken確認請求傳遞 。

  2. 將主題規則狀態設定為已啟用

    確認目的地可以接收訊息後,您必須執行 UpdateTopicRuleDestinationAPI操作,將主題規則的狀態設定為 ENABLED

如果您使用的是 AWS IoT 主控台,請複製 confirmationToken 並將其貼到 AWS IoT 主控台的目的地確認對話方塊中。然後,您可以啟用 主題規則。

傳送新的確認請求

若要啟動目的地的新確認訊息,請呼叫 UpdateTopicRuleDestination,並將主題規則目的地的狀態設為 IN_PROGRESS

在傳送新的確認請求之後重複確認程序。

停用和刪除主題規則目的地

若要停用目的地,請呼叫 UpdateTopicRuleDestination,並將主題規則目的地的狀態設為 DISABLED。可以再次啟用 DISABLED 狀態的主題規則,而無需傳送新的確認請求。

若要刪除主題規則目的地,請呼叫 DeleteTopicRuleDestination