为 Sidewalk 设备创建目标 - AWS IoT Wireless

为 Sidewalk 设备创建目标

您可以使用目标中心或使用 CreateDestination 针对适用于 Amazon Sidewalk 的 AWS IoT Core 将目标添加到您的账户。创建目标时,请指定:

  • 要用于 Sidewalk 终端设备的目标的唯一名称。

    注意

    如果您已经使用目标名称添加设备,则在创建目标时必须使用该名称。有关更多信息,请参阅步骤 2:添加 Sidewalk 设备

  • 将用于处理设备数据的 AWS IoT 规则的名称以及要向其发布消息的主题。

  • IAM 角色,向设备的数据授予访问规则的权限。

以下各节介绍如何为目标创建 AWS IoT 规则和 IAM 角色。

创建目标(控制台)

要使用 AWS IoT 控制台创建目标,请转到目标中心并选择添加目标

要处理设备的数据,请在创建目标时指定以下字段,然后选择添加目标

  • 目标详细信息

    输入 Destination name(目标名称)以及您的目标描述(可选)。

  • Rule name(规则名称)

    被配置为评估设备发送的消息并处理设备数据的 AWS IoT 规则。规则名称将映射到您的目标。目标要求规则来处理收到的消息。您可以通过调用 AWS IoT 规则或通过发布到 AWS IoT 消息代理。

    • 如果选择 Enter a rule name(输入规则名称),请输入名称,然后选择 Copy(复制)以复制创建 AWS IoT 规则时要输入的规则名称。您可以选择 Create rule(创建规则)以立即创建规则,或导航到 AWS IoT 控制台的 Rule(规则)中心并使用该名称创建规则。

      您也可以输入规则并使用高级设置以指定主题名称。主题名称是在规则调用期间提供的,可通过使用 topic 规则中的表达式访问。有关 AWS IoT 规则的更多信息,请参阅 AWS IoT 规则

    • 如果选择 Publish to AWS IoT message broker(发布到消息代理),输入主题名称。然后,您可以复制 MQTT 主题名称,多个订阅者可以订阅此主题以接收发布到该主题的消息。有关更多信息,请参阅 MQTT 主题

    有关目标的 AWS IoT 规则的更多信息,请参阅创建规则以处理 LoRaWAN 设备消息

  • 角色名称

    IAM 角色,该角色授予设备数据权限以访问在 Rule name(规则名称)中命名的规则。在控制台中,您可以创建新的服务角色或选择现有的服务角色。如果要创建新的服务角色,可以输入角色名称(例如,SidewalkDestinationRole),或将其留白 适用于 LoRaWAN 的 AWS IoT Core 以生成新的角色名称。然后 适用于 LoRaWAN 的 AWS IoT Core 将代表您自动创建具有适当权限的 IAM 角色。

创建目标(CLI)

要创建目标,请使用 CreateDestination API 操作或 create-destination CLI 命令。例如,以下命令为您的 Sidewalk 终端设备创建目标:

aws iotwireless create-destination --name SidewalkDestination \ --expression-type RuleName --expression SidewalkRule \ --role-arn arn:aws:iam::123456789012:role/SidewalkRole

运行此命令会返回目标详细信息,其中包括 Amazon 资源名称(ARN)和目标名称。

{ "Arn": "arn:aws:iotwireless:us-east-1:123456789012:Destination/SidewalkDestination", "Name": "SidewalkDestination" }

有关创建目标的更多信息,请参阅创建规则以处理 LoRaWAN 设备消息