本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。
管理 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 收到确认请求后执行以下步骤。
-
确认目标愿意接收消息
要确认主题规则目标愿意接收 IoT 消息,请在确认请求中调用
enableUrl
,或者执行ConfirmTopicRuleDestination
API 操作并从确认请求中传递confirmationToken
。 -
将主题规则状态设置为已启用
确认目标可以接收消息后,必须执行
UpdateTopicRuleDestination
API 操作才能将主题规则的状态设置为ENABLED
。
如果您使用的是 Amazon IoT 控制台,请将其复制confirmationToken
并粘贴到控制 Amazon IoT 台中目标的确认对话框中。然后,您就可以启用主题规则。
发送新确认请求
要为目标激活新的确认消息,请调用 UpdateTopicRuleDestination
并将主题规则目标的状态设置为 IN_PROGRESS
。
发送新的确认请求后,重复确认过程。
禁用并删除主题规则目标
要禁用目标,请调用 UpdateTopicRuleDestination
并将主题规则目标的状态设置为 DISABLED
。可以再次启用处于 DISABLED 状态的主题规则,而无需发送新的确认请求。
要删除主题规则目标,请调用 DeleteTopicRuleDestination
。