建立您 Sidewalk 裝置的目的地 - AWS IoT Wireless
建立目的地 (主控台)建立目的地 (CLI)

建立您 Sidewalk 裝置的目的地

您可從使用目的地中樞或使用 CreateDestination，將目的地新增至您的適用於 Amazon Sidewalk 的 AWS IoT Core 帳戶。建立目的地時，請指定：

  • 一個用於您 Sidewalk 終端裝置之目的地的唯一名稱。

    注意

    若您已使用目的地名稱新增裝置，則在建立目的地時必須使用該名稱。如需詳細資訊，請參閱步驟 2：新增您的 Sidewalk 裝置。

  • 將要處理裝置資料的 AWS IoT 規則名稱，及訊息將要發佈的主題。

  • 授予裝置資料存取規則權限的 IAM 角色。

下列章節說明如何建立您目的地的 AWS IoT 規則和 IAM 角色。

建立目的地 (主控台)

如要使用 AWS IoT 主控台建立目的地，請移至目的地中樞，並選擇新增目的地。

如要處理裝置的資料，請在建立目的地時指定下列欄位，然後選擇新增目的地。

  • 目的地詳細資訊

    為您的目的地輸入 Destination name (目的地名稱) 和選用描述。

  • 規則名稱

    AWS IoT 規則被設定為評估裝置傳送的訊息並處理裝置的資料。規則名稱會映射至目的地。目的地需要規則來處理接收到的訊息。您可以選擇透過叫用 AWS IoT 規則或發佈至 AWS IoT 訊息代理程式的方式來處理訊息。

    • 如果選擇 Enter a rule name (輸入規則名稱)，請輸入名稱然後選擇 Copy (複製)，來複製您在建立 AWS IoT 規則時將輸入的規則名稱。您可以選擇 Create rule (建立規則) 來立即建立規則，或導覽至 AWS IoT 主控台的規則中樞，並使用該名稱建立規則。

      您也可以輸入規則，再使用 Advanced (進階) 設定來指定主題名稱。主題名稱會在規則叫用期間提供，而且可以使用規則中的 topic 運算式存取。如需有關 AWS IoT 規則的更多資訊，請參閱 AWS IoT 規則。

    • 若您選擇發佈至 AWS IoT 訊息代理程式，請輸入主題名稱。然後您可以複製 MQTT 主題名稱，多位訂閱者可以訂閱此主題，以接收發佈至該主題的訊息。如需更多詳細資訊，請參閱 MQTT 主題。

    如需有關目的地之 AWS IoT 規則的詳細資訊，請參閱建立規則來處理 LoRaWAN 裝置訊息。

  • 角色名稱

    授予裝置資料許可，以存取在 Rule name (規則名稱) 中命名之規則的 IAM 角色。您可以在主控台中建立新的服務角色，或選取現有的服務角色。如果正在建立新的服務角色，您可以輸入角色名稱 (例如 SidewalkDestinationRole)，或為 AWS IoT Core for LoRaWAN 保留為空白以產生新的角色名稱。AWS IoT Core for LoRaWAN 會代表您自動建立具有適當許可的 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 Resource Name (ARN) 和目的地名稱。

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

如需有關建立目的地的詳細資訊，請參閱建立規則來處理 LoRaWAN 裝置訊息。