管理 HTTP 主题规则目标 - Amazon IoT Core
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异,请参阅 中国的 Amazon Web Services 服务入门 (PDF)

本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。

管理 HTTP 主题规则目标

您可以使用以下操作来管理 HTTP 主题规则目标。

创建 HTTP 主题规则目标

您可以通过调用 CreateTopicRuleDestination 操作或使用 Amazon IoT 控制台来创建 HTTP 主题规则目标。

创建目标后, Amazon 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

发送的确认令牌 Amazon IoT Core。示例中是已截断的令牌。您的令牌会更长。您需要此令牌用 Amazon IoT Core来确认您的目的地。

enableUrl

您需要浏览以确认主题规则目标的 URL。

messageType

消息类型。

确认 HTTP 主题规则目标

要完成端点确认过程,如果您使用 Amazon CLI,则必须在确认 URL 收到确认请求后执行以下步骤。

  1. 确认目标愿意接收消息

    要确认主题规则目标愿意接收 IoT 消息,请在确认请求中调用 enableUrl,或者执行 ConfirmTopicRuleDestination API 操作并从确认请求中传递 confirmationToken

  2. 将主题规则状态设置为已启用

    确认目标可以接收消息后,必须执行 UpdateTopicRuleDestination API 操作才能将主题规则的状态设置为 ENABLED

如果您使用的是 Amazon IoT 控制台,请将其复制confirmationToken并粘贴到控制 Amazon IoT 台中目标的确认对话框中。然后,您就可以启用主题规则。

发送新确认请求

要为目标激活新的确认消息,请调用 UpdateTopicRuleDestination 并将主题规则目标的状态设置为 IN_PROGRESS

发送新的确认请求后,重复确认过程。

禁用并删除主题规则目标

要禁用目标,请调用 UpdateTopicRuleDestination 并将主题规则目标的状态设置为 DISABLED。可以再次启用处于 DISABLED 状态的主题规则,而无需发送新的确认请求。

要删除主题规则目标,请调用 DeleteTopicRuleDestination