管理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 资源名称 (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