從內建端點讀取裝置對雲端訊息

根據預設,訊息會路由到與事件中樞相容的內建服務對應端點 (訊息/事件)。 IoT 中樞會公開您後端服務的 messages/events 內建端點,以讀取您的中樞收到的裝置到雲端訊息。 此端點為事件中樞相容,可讓您使用事件中樞服務支援的任何機制讀取訊息。

如果您使用訊息路由並已啟用後援路由,就會將任何路由上未符合查詢的所有訊息移至內建端點。 如果您停用此後援路由,則會卸除不符合任何查詢的訊息。

此端點目前只會使用連接埠 5671 上的 AMQP 通訊協定,以及連接埠 443 上的透過 WebSocket 的 AMQP 公開。 IoT 中樞會公開下列屬性,讓您控制與事件中樞相容的內建訊息端點 messages/events

屬性 說明
分割計數 在建立時設定此屬性,以定義裝置到雲端事件擷取的分割區數目。
保留時間 此屬性可指定 IoT 中樞保留訊息的天數。 預設值是一天,但它可以增加到七天。

IoT 中樞允許資料在內建端點中最多保留 7天。 您可以在建立 IoT 中樞期間設定保留時間。 IoT 中樞的資料保留時間取決於您的 IoT 中樞層和單位類型。 就大小而言,內建端點可以保留的訊息,其訊息大小上限高達至少 24 小時的配額。 例如,一個 S1 單位 IoT 中樞提供足夠的儲存體來保留至少 400,000 則訊息 (每個訊息 4 KB)。 如果您的裝置傳送較小的訊息,則這些訊息會保留較長的時間 (最多 7 天),視耗用的儲存空間而定。 我們保證至少將資料保留指定的保留時間。 在保留時間過後,訊息就會過期且變成無法存取。 您可以使用 IoT 中樞資源提供者 REST API 採取程式設計方式,或透過 Azure 入口網站來修改保留期時間。

IoT 中樞也可讓您管理內建端點上的取用者群組。 每個 IoT 中樞最多可以有 20 個取用者群組。

連線到內建端點

某些產品整合和事件中樞 SDK 會感知 IoT 中樞,並讓您使用 IoT 中樞服務連接字串來連結到內建端點。

當您使用無法感知 IoT 中樞的事件中樞 SDK 或產品整合時,需要事件中樞相容端點和事件中樞相容名稱。 您可以從入口網站擷取這些值,如下所示:

  1. 登入 Azure 入口網站,然後瀏覽至 IoT 中樞。

  2. 從 [中樞設定] 底下的 [資源] 功能表選取 [內建端點]

  3. [內建端點] 工作窗格包含三個區段:

    • [事件中樞詳細資料] 區段包含下列值:分割區事件中樞相容名稱保留時間,以及取用者群組
    • [事件中樞相容端點] 區段包含下列值:共用存取原則事件中樞相容端點
    • [雲端到裝置傳訊] 區段包含下列值:預設 TTL意見反應保留時間,以及最大傳遞計數

    Screen capture showing device-to-cloud settings.

在工作窗格中,[事件中樞相容端點] 欄位包含完整的事件中樞連接字串,如下列範例所示:

Endpoint=sb://abcd1234namespace.servicebus.windows.net/;SharedAccessKeyName=iothubowner;SharedAccessKey=keykeykeykeykeykey=;EntityPath=iothub-ehub-abcd-1234-123456

如果您所使用的 SDK 需要其他值,則其會是:

名稱
端點 sb://abcd1234namespace.servicebus.windows.net/
主機名稱 abcd1234namespace.servicebus.windows.net
Namespace abcd1234namespace

然後,您可以從 [共用存取原則] 下拉式清單中選擇任何共用存取原則,如上一個螢幕擷取畫面所示。 其只會顯示具有 ServiceConnect 權限以連線至指定事件中樞的原則。

SDK 範例

您可以用來連線到內建事件中樞相容端點 (由 IoT 中樞公開) 的 SDK 包括:

語言 SDK 範例
.NET https://www.nuget.org/packages/Azure.Messaging.EventHubs ReadD2cMessages .NET
Java https://mvnrepository.com/artifact/com.azure/azure-messaging-eventhubs
Node.js https://www.npmjs.com/package/@azure/event-hubs read-d2c-messages Node.js
Python https://pypi.org/project/azure-eventhub/ read-dec-messages Python

可與內建事件中樞相容端點 (由 IoT 中樞公開) 搭配使用的產品整合包括:

下一步