使用 Azure 入口網站 建立和刪除路由和端點
本文說明如何在中樞 Azure IoT 中樞 中建立路由和端點,然後刪除您的路由和端點。 瞭解如何使用 Azure 入口網站 來建立 Azure 事件中樞、Azure 服務匯流排 佇列和主題、Azure 儲存體 和 Azure Cosmos DB 的路由和端點。
若要深入瞭解路由在 IoT 中樞 的運作方式,請參閱使用 IoT 中樞 訊息路由將裝置到雲端訊息傳送至不同的端點。 若要逐步設定路由以將訊息傳送至記憶體,然後在模擬裝置上進行測試,請參閱教學課程:使用 IoT 中樞 訊息路由將裝置數據傳送至 Azure 儲存體。
必要條件
本文所述的程式會使用下列資源:
- Azure 入口網站
- IoT 中樞
- Azure 中的端點服務
Azure 入口網站
本文使用 Azure 入口網站 來處理 IoT 中樞 和其他 Azure 服務。 若要深入瞭解如何使用 Azure 入口網站,請參閱什麼是 Azure 入口網站?。
IoT 中樞
若要建立IoT中樞路由,您需要使用 Azure IoT 中樞 建立的IoT中樞。 裝置訊息和事件源自IoT中樞。
當您建立IoT中樞路由時,請務必使用下列中樞資源:
- Azure 訂用帳戶中的 IoT 中樞。 如果您還沒有中樞,您可以遵循使用 Azure 入口網站 建立IoT中樞的步驟。
端點服務
若要建立IoT中樞路由,您至少需要一個其他 Azure 服務,才能作為路由的端點。 端點會接收裝置訊息和事件。 您可以選擇要用來與 IoT 中樞路由連線的端點的 Azure 服務:事件中樞、服務匯流排 佇列或主題、Azure 儲存體 或 Azure Cosmos DB。
當您建立IoT中樞路由的端點時,請務必使用 下列其中一個 資源:
事件中樞資源(命名空間和實體)。 如果您需要建立新的事件中樞資源,請參閱快速入門:使用 Azure 入口網站 建立事件中樞。
服務匯流排 佇列資源(命名空間和佇列)。 如果您需要建立新的 服務匯流排 佇列,請參閱使用 Azure 入口網站 建立 服務匯流排 命名空間和佇列。
服務匯流排 主題資源(命名空間和主題)。 如果您需要建立新的 服務匯流排 主題,請參閱使用 Azure 入口網站 來建立主題 服務匯流排 主題和訂用帳戶。
Azure 儲存體 資源(帳戶和容器)。 如果您需要在 Azure 中建立新的記憶體帳戶,請參閱 建立記憶體帳戶。 當您建立記憶體帳戶時,有許多選項,但本文只需要帳戶中的新容器。
Azure Cosmos DB 資源(帳戶、資料庫和容器)。 如果您需要建立 Azure Cosmos DB 的新實例,請參閱 建立 Azure Cosmos DB 帳戶。 針對 [API] 選項,選取 [適用於 NoSQL 的 Azure Cosmos DB]。
建立路由和端點
路由傳送訊息或事件記錄至 Azure 服務以進行記憶體或處理。 每個路由都有數據源、訊息或事件記錄的來源,以及訊息或事件記錄檔最終結束的端點。 您可以使用路由查詢來篩選訊息或事件,再移至端點。 端點可以是事件中樞、服務匯流排 佇列或主題、記憶體帳戶或 Azure Cosmos DB 資源。
在 Azure 入口網站 中,移至您的IoT中樞。
在 [中樞設定] 底下的 [資源] 功能表中,選取 [訊息路由],然後選取 [新增]。
在 [ 端點] 索引標籤上,選取現有的端點,或藉由提供下列資訊來建立新的端點:
參數 值 端點類型 選取 [Cosmos DB]。 端點名稱 提供新端點的唯一名稱,或選取 [選取現有] 以選擇現有的 儲存體 端點。 Cosmos DB 帳戶 使用下拉功能表來選取您訂用帳戶中的現有 Cosmos DB 帳戶。 Database 使用下拉功能表來選取 Cosmos DB 帳戶中的現有資料庫。 集合 使用下拉功能表來選取現有的集合(或容器)。 產生訊息的綜合分割區索引鍵 選取 [啟用 ] 以支援適用於大規模案例的數據記憶體。 否則,請選取 [ 停用 ] 如需詳細資訊,請參閱 Azure Cosmos DB 中的數據分割和水準調整和 綜合數據分割索引鍵。 數據分割索引鍵名稱 如果您啟用綜合分割區索引鍵,請提供分割區索引鍵的名稱。 分割區索引鍵屬性名稱是在容器層級定義,一旦設定后就無法變更。 分割區索引鍵範本 提供用來設定綜合分割區索引鍵值的範本。 產生的分割區索引鍵值會自動新增至每個新 Cosmos DB 記錄的數據分割索引鍵屬性。
選取 [建立 +] 以建立端點, 並繼續建立路由。
在 [ 路由] 索引標籤上,提供下列資訊來建立端點的新路由:
參數 值 名稱 提供路由的唯一名稱。 資料來源 使用下拉功能表來選取路由的數據源。 您可以從遙測訊息或 非遙測事件路由傳送數據 路由查詢 或者,新增查詢以在路由之前篩選數據。 如需詳細資訊,請參閱 IoT 中樞 訊息路由查詢語法。 如果您新增路由查詢,請使用 [測試 ] 功能來提供範例訊息,並針對它測試路由。
如果您想要將訊息擴充新增至路由,請選取 [建立 + 新增擴充]。 如需詳細資訊,請參閱 訊息擴充。 如果沒有,請選取 [ 建立 + 略過擴充]。
回到 [ 訊息路由 概觀],確認新的路由出現在 [ 路由 ] 索引標籤上,而您的新端點會出現在 [ 自定義端點] 索引 卷標上。
更新路由
若要更新 Azure 入口網站 中的路由:
在 Azure 入口網站中,移至您的 IoT 中樞。
在 [中樞設定] 底下的 [資源] 功能表中,選取 [訊息路由]。
在 [路由] 索引標籤中,選取您要修改的路由。
您可以變更現有路由的下列參數:
- 端點:您可以建立新的端點,或選取不同的現有端點。
- 資料來源。
- 啟用路由。
- 路由查詢。
選取 [儲存]。
刪除路由
若要刪除 Azure 入口網站 中的路由:
更新自訂端點
若要更新 Azure 入口網站 中的自訂端點:
在 Azure 入口網站中,移至您的 IoT 中樞。
在 [中樞設定] 底下的 [資源] 功能表中,選取 [訊息路由]。
在 [ 自定義端點] 索引 標籤中,選取您要修改的端點。
您可以變更現有端點的下列參數:
- 選取 [儲存]。
刪除自訂端點
若要刪除 Azure 入口網站 中的自訂端點:
在 Azure 入口網站中,移至您的 IoT 中樞。
在 [中樞設定] 底下的 [資源] 功能表中,選取 [訊息路由]。
在 [ 自定義端點] 索引 標籤中,使用複選單塊來選取您要刪除的端點。
選取 [刪除]。
下一步
若要深入瞭解訊息路由,請參閱教學課程:使用 IoT 中樞 訊息路由將裝置數據傳送至 Azure 儲存體。 在本教學課程中,您會建立記憶體路由,並使用IoT中樞中的裝置進行測試。