從內建端點讀取裝置對雲端訊息
根據預設,訊息會路由到與事件中樞相容的內建服務對應端點 (訊息/事件)。 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 或產品整合時,需要事件中樞相容端點和事件中樞相容名稱。 您可以從入口網站擷取這些值,如下所示:
登入 Azure 入口網站,然後瀏覽至 IoT 中樞。
從 [中樞設定] 底下的 [資源] 功能表選取 [內建端點]。
[內建端點] 工作窗格包含三個區段:
- [事件中樞詳細資料] 區段包含下列值:分割區、事件中樞相容名稱、保留時間,以及取用者群組。
- [事件中樞相容端點] 區段包含下列值:共用存取原則和事件中樞相容端點。
- [雲端到裝置傳訊] 區段包含下列值:預設 TTL、意見反應保留時間,以及最大傳遞計數。
在工作窗格中,[事件中樞相容端點] 欄位包含完整的事件中樞連接字串,如下列範例所示:
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 包括:
可與內建事件中樞相容端點 (由 IoT 中樞公開) 搭配使用的產品整合包括:
-
如需詳細資訊,請參閱 Azure Functions 的 Azure IoT 中樞繫結。
-
如需詳細資訊,請參閱串流資料作為串流分析的輸入。
-
如需詳細資訊,請參閱將 IoT 中樞事件來源新增至 Azure 時間序列深入解析環境。
-
如需詳細資訊,請參閱 Azure 事件中樞的 Apache Kafka 開發人員指南。
下一步
如需 IoT 中樞端點的詳細資訊,請參閱 IoT 中樞端點。
如果您想要將裝置到雲端的訊息路由至自訂端點,請參閱針對裝置到雲端訊息使用訊息路由與自訂端點。