قراءة الرسائل من جهاز إلى سحابة من نقطة النهاية المضمنة
تُوجه الرسائل، بشكل افتراضي، إلى نقطة النهاية المضمنة التي تواجه الخدمة (الرسائل/الأحداث) المتوافقة مع مراكز الأحداث. يكشف IoT Hub نقطة النهاية المضمنة للرسائل/الأحداثلخدماتك الخلفية لقراءة الرسائل من جهاز إلى سحابة التي يتلقاها مركزك. نقطة النهاية هذه متوافقة مع "مركز الأحداث"، والتي تمكنك من استخدام أي من الآليات التي تدعمها خدمة "مراكز الأحداث" لقراءة الرسائل.
إذا كنت تستخدم توجيه الرسائل وتم تمكين المسار الاحتياطي، فستنتقل الرسالة التي لا تتطابق مع استعلام على أي مسار إلى نقطة النهاية المضمنة. إذا قمت بتعطيل هذا المسار الاحتياطي، يتم إسقاط رسالة لا تتطابق مع أي استعلام.
يتم حاليًا عرض نقطة النهاية هذه فقط باستخدام بروتوكول AMQP على المنفذ 5671 وAMQP عبر WebSocketsعلى المنفذ 443. يعرض مركز IoT الخصائص التالية لتمكينك من التحكم في رسائل/أحداث نقطة نهاية المراسلة المتوافقة مع مراكز الأحداث المضمنة.
| الخاصية | الوصف |
|---|---|
| عدد الأقسام | عيّن هذه الخاصية عند الإنشاء لتحديد عدد الأقسام الخاصة باستيعاب الحدث من جهاز إلى سحابة. |
| وقت الاستبقاء | تحدد هذه الخاصية المدة بالأيام التي يحتفظ فيها IoT Hub بالرسائل. الإعداد الافتراضي هو يوم واحد، ولكن يمكن زيادته إلى سبعة أيام. |
يسمح IoT Hub بالاحتفاظ بالبيانات في نقطة النهاية المضمنة لمدة أقصاها سبعة أيام. يمكنك تعيين وقت الاستبقاء أثناء إنشاء مركز IoT الخاص بك. يعتمد وقت استبقاء البيانات في IoT Hub على مستوى IoT hub ونوع الوحدة. من حيث الحجم، يمكن لنقطة النهاية المضمنة الاحتفاظ برسائل من الحد الأقصى لحجم الرسالة حتى 24 ساعة على الأقل من الحصة النسبية. على سبيل المثال، يوفر مركز IoT لوحدة S1 مساحة تخزين كافية للاحتفاظ بما لا يقل عن 400,000 رسالة، بمعدل 4 كيلوبايت لكل رسالة. إذا كانت أجهزتك ترسل رسائل أصغر، فقد يتم الاحتفاظ بها لفترة أطول (حتى سبعة أيام) اعتمادا على مقدار التخزين المستهلك. نضمن الاحتفاظ بالبيانات لوقت الاستبقاء المحدد كحد أدنى. بعد وقت الاستبقاء، تنتهي صلاحية الرسائل وتصبح غير قابلة للوصول. يمكنك تعديل وقت الاستبقاء، إما برمجيا باستخدام واجهات برمجة تطبيقات REST لموفر موارد IoT Hub، أو مع مدخل Microsoft Azure.
يتيح لك IoT Hub أيضا إدارة مجموعات المستهلكين على نقطة النهاية المضمنة. يمكنك الحصول على ما يصل إلى 20 مجموعة مستهلكين لكل مركز IoT.
الاتصال بنقطة النهاية المضمنة
بعض عمليات تكامل المنتج وSDKs "مراكز الأحداث" على دراية بـ IoT Hub وتتيح لك استخدام سلسلة اتصال خدمة IoT hub للاتصال بنقطة النهاية المضمنة.
عند استخدام وحدات SDK لمراكز الأحداث أو عمليات تكامل المنتج التي ليست على دراية بمركز IoT، تحتاج إلى نقطة نهاية متوافقة مع "مراكز الأحداث" واسم متوافق مع "مركز الحدث". يمكن استرداد هذه القيم من المدخل كما يلي:
سجل الدخول إلى مدخل Microsoft Azure والانتقال إلى IoT hub الخاص بك.
حدد نقاط النهاية المضمنة من قائمة الموارد، ضمن إعدادات المركز.
يحتوي جزء عمل نقاط النهاية المضمنة على ثلاثة أقسام:
- يحتوي قسم تفاصيل مركز الأحداث على القيم التالية: الأقسام والاسم المتوافق مع مركز الأحداث والاحتفاظ لمجموعات المستهلكين.
- يحتوي قسم نقطة النهاية المتوافقة مع Event Hub على القيم التالية: نهج الوصول المشترك ونقطة النهاية المتوافقة مع Event Hub.
- يحتوي قسم مراسلة السحابة إلى الجهاز على القيم التالية: TTL الافتراضي ووقت استبقاء الملاحظات والحد الأقصى لعدد التسليم.
في جزء العمل، يحتوي حقل نقطة النهاية المتوافقة مع Event Hub على سلسلة الاتصال Event Hubs كاملة تشبه المثال التالي:
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 |
| مساحة الاسم | abcd1234namespace |
يمكنك بعد ذلك اختيار أي نهج وصول مشترك من القائمة المنسدلة نهج الوصول المشترك، كما هو موضح في لقطة الشاشة السابقة. يعرض فقط النهج التي لديها أذونات ServiceConnect للاتصال بمركز الأحداث المحدد.
عينات SDK
تتضمن SDKs التي يمكنك استخدامها للاتصال بنقطة النهاية المتوافقة مع "مراكز الأحداث" المضمنة التي يكشفها مركز IoT:
الاتصال بالخدمات والمنتجات الأخرى
تتضمن عمليات تكامل المنتج التي يمكنك استخدامها مع نقطة النهاية المتوافقة مع "مراكز الأحداث" المضمنة التي يكشفها مركز IoT:
-
لمزيد من المعلومات، راجع روابط Azure IoT Hub لوظائف Azure.
-
لمزيد من المعلومات، راجع دفق البيانات كإدخل في Stream Analytics.
-
لمزيد من المعلومات، راجع إضافة مصدر حدث مركز IoT إلى بيئة Azure Time Series Insight.
-
لمزيد من المعلومات، راجع دليل مطور Apache Kafka لمراكز أحداث Azure.
الخطوات التالية
للمزيد من المعلومات حول نقاط نهاية IoT Hub، يرجى مراجعةنقاط نهاية IoT Hub.
إن كنت تريد توجيه رسائل الجهاز إلى السحابة إلى نقاط النهاية المخصصة، يرجى مراجعةاستخدام مسارات الرسائل ونقاط النهاية المخصصة للرسائل من جهاز إلى سحابة.