المرجع - نقاط نهاية IoT Hub
ملاحظة
تتوفر بعض الميزات المذكورة في هذه المقالة، مثل المراسلة من السحابة إلى الجهاز، وتوائم الأجهزة، وإدارة الأجهزة، فقط في المستوى القياسي من IoT Hub. لمزيد من المعلومات حول مستويات مركز IoT الأساسية والمعيارية، راجع كيفية اختيار مستوى مركز IoT الصحيح.
أسماء مراكز إنترنت الأشياء
يمكنك العثور على اسم مضيف مركز إنترنت الأشياء الذي يستضيف نقاط النهاية في البوابة الإلكترونية في صفحة نظرة عامة على مركز الوصل. بشكل افتراضي، يبدو اسم DNS لمركز إنترنت الأشياء كما يلي: {your iot hub name}.azure-devices.net.
قائمة بنقاط نهاية IoT Hub المضمنة
Azure IoT Hub هي خدمة متعددة المستأجرين تعرض وظائفها لمختلف الجهات الفاعلة. يوضح الرسم البياني التالي نقاط النهاية المختلفة التي يعرضها IoT Hub.
تصف القائمة التالية نقاط النهاية:
Resource provider. يعرض موفر موارد IoT Hub واجهة Azure Resource Manager. تمكّن هذه الواجهة مالكي اشتراك Azure من إنشاء وحذف لوحات IoT hubs، وتحديث خصائص IoT hubs. تحكم خصائص IoT Hub سياسات الأمان على مستوى الموزع، بدلا من التحكم في الوصول على مستوى الجهاز، والخيارات الوظيفية للمراسلة من السحابة إلى الجهاز ومن جهاز إلى سحابة. يمكنك موفر موارد IoT Hub أيضا من تصدير هويات الأجهزة.
إدارة هوية الجهاز. يعرض كل IoT hub مجموعة من نقاط نهاية HTTPS REST لإدارة هويات الجهاز (الإنشاء والاسترداد والتحديث والحذف). يتم استخدام هويات الأجهزة لمصادقة الجهاز والتحكم في الوصول.
إدارة الجهاز التوأم. يعرض كل مركز إنترنت الأشياء مجموعة من نقاط نهاية HTTPS REST التي تواجه الخدمة للاستعلام عن توائم الجهاز وتحديثها (تحديث العلامات والخصائص).
إدارة الوظائف. يعرض كل مركز إنترنت الأشياء مجموعة من نقاط نهاية HTTPS REST التي تواجه الخدمة للاستعلام عن الوظائف وإدارتها.
نقاط نهاية الجهاز. لكل جهاز في سجل الهوية، يعرض IoT Hub مجموعة من نقاط النهاية. باستثناء ما تمت الإشارة إليه ، يتم عرض نقاط النهاية هذه باستخدام بروتوكولات MQTT v3.1.1 و HTTPS 1.1 و AMQP 1.0. تتوفر AMQP و MQTT أيضا عبر WebSockets على المنفذ 443.
إرسال رسائل من الجهاز إلى السحابة. يستخدم الجهاز نقطة النهاية هذه لإرسال رسائل من الجهاز إلى السحابة.
تلقي رسائل من السحابة إلى الجهاز. يستخدم الجهاز نقطة النهاية هذه لتلقي رسائل موجهة من السحابة إلى الجهاز.
بدء تحميل الملفات. يستخدم الجهاز نقطة النهاية هذه لتلقي Azure Storage SAS URI من IoT Hub لتحميل ملف.
استرداد وتحديث خصائص الجهاز التوأم. يستخدم الجهاز نقطة النهاية هذه للوصول إلى خصائص توأم الجهاز. HTTPS غير مدعوم.
تلقي طلبات الطريقة المباشرة. يستخدم الجهاز نقطة النهاية هذه للاستماع إلى طلبات الطريقة المباشرة. HTTPS غير مدعوم.
هام
لا تتوفر الوظائف التالية للأجهزة التي تستخدم مصادقة المرجع المصدق X.509 (CA) بشكل عام بعد، ويجب تمكين وضع المعاينة:
- HTTPS و MQTT عبر WebSockets و AMQP عبر بروتوكولات WebSockets.
- تحميل الملفات (جميع البروتوكولات).
وهي متوفرة بشكل عام على الأجهزة التي تستخدم مصادقة بصمة الإبهام X.509. لمعرفة المزيد حول مصادقة X.509 باستخدام IoT Hub، راجع شهادات X.509 المدعومة.
نقاط نهاية الخدمة يعرض كل IoT hub مجموعة من نقاط النهاية للجهة الخلفية للحل الخاص بك للتواصل مع أجهزتك. باستثناء واحد، يتم عرض نقاط النهاية هذه فقط باستخدام AMQP وAMQP عبر بروتوكولات WebSockets. يتم الكشف عن نقطة نهاية استدعاء الطريقة المباشرة عبر بروتوكول HTTPS.
تلقي الرسائل من الجهاز إلى السحابة. تتوافق نقطة النهاية هذه مع مراكز أحداث Azure. يمكن للخدمة الخلفية استخدامه لقراءة الرسائل من الجهاز إلى السحابة التي ترسلها أجهزتك. يمكنك إنشاء نقاط نهاية مخصصة على IoT hub الخاص بك بالإضافة إلى نقطة النهاية المدمجة هذه.
إرسال رسائل سحابية إلى جهاز وتلقي إقرارات التسليم. تمكن نقاط النهاية هذه الواجهة الخلفية للحل الخاص بك من إرسال رسائل موثوقة من السحابة إلى الجهاز ، وتلقي إقرارات التسليم أو انتهاء الصلاحية المقابلة.
تلقي إشعارات الملفات. تتيح لك نقطة نهاية المراسلة هذه تلقي إشعارات عندما تقوم أجهزتك بتحميل ملف بنجاح.
استدعاء الطريقة المباشرة. تسمح نقطة النهاية هذه لخدمة الواجهة الخلفية باستدعاء طريقة مباشرة على الجهاز.
توضح مقالة Azure IoT SDKs الطرق المختلفة للوصول إلى نقاط النهاية هذه.
تستخدم جميع نقاط نهاية IoT Hub بروتوكول TLS ، ولا يتم عرض أي نقطة نهاية على الإطلاق على القنوات غير المشفرة/غير الآمنة.
نقاط النهاية المخصصة
يمكنك ربط خدمات Azure الحالية في اشتراكات Azure بمركز إنترنت الأشياء الخاص بك لتكون بمثابة نقاط نهاية لتوجيه الرسائل. تعمل نقاط النهاية كنقاط نهاية خدمة وتستخدم كمتلقي لمسارات الرسائل. لا يمكن للأجهزة الكتابة مباشرة إلى نقاط النهاية الإضافية. مزيد من المعلومات حول توجيه الرسائل.
يدعم IoT Hub حاليا خدمات Azure التالية كنقاط نهاية إضافية:
- حاويات Azure Storage
- مراكز الأحداث
- قوائم انتظار Service Bus
- مواضيع Service Bus
للاطلاع على القيود المفروضة على عدد نقاط النهاية التي يمكنك إضافتها، راجع الحصص النسبية والاختناق.
صحة نقطة النهاية
يمكنك استخدام واجهة برمجة تطبيقات REST Get Endpoint Health للحصول على الحالة الصحية لنقاط النهاية. نوصي باستخدام مقاييس توجيه IoT Hub المتعلقة بزمن انتقال رسالة التوجيه لتحديد الأخطاء وتصحيحها عندما تكون صحة نقطة النهاية ميتة أو غير صحية، حيث نتوقع أن يكون زمن الوصول أعلى عندما تكون نقطة النهاية في إحدى تلك الحالات. لمعرفة المزيد حول استخدام مقاييس IoT Hub، راجع مراقبة IoT Hub.
| الحالة الصحية | الوصف |
|---|---|
| صحي | نقطة النهاية هي قبول الرسائل كما هو متوقع. |
| صحيه | نقطة النهاية لا تقبل الرسائل ويعيد IoT Hub محاولة إرسال رسائل إلى نقطة النهاية هذه. |
| غير معروف | لم يحاول IoT Hub توصيل الرسائل إلى نقطة النهاية هذه. |
| المتدهوره | نقطة النهاية هي قبول الرسائل بشكل أبطأ من المتوقع أو تتعافى من حالة غير صحية. |
| ميت | لم يعد IoT Hub يقدم رسائل إلى نقطة النهاية هذه. فشلت عمليات إعادة محاولة إرسال رسائل إلى نقطة النهاية هذه. |
بوابات الحقل
في حل إنترنت الأشياء، توجد بوابة ميدانية بين أجهزتك ونقاط نهاية IoT Hub. عادة ما يكون موجودا بالقرب من أجهزتك. تتصل أجهزتك مباشرة ببوابة الحقل باستخدام بروتوكول تدعمه الأجهزة. تتصل بوابة الحقل بنقطة نهاية IoT Hub باستخدام بروتوكول يدعمه IoT Hub. قد تكون البوابة الميدانية عبارة عن جهاز مخصص أو كمبيوتر منخفض الطاقة يقوم بتشغيل برنامج بوابة مخصص.
يمكنك استخدام Azure IoT Edge لتنفيذ بوابة حقل. يوفر IoT Edge وظائف مثل اتصالات الإرسال المتعدد من أجهزة متعددة إلى نفس اتصال IoT Hub.
الخطوات التالية
تتضمن الموضوعات المرجعية الأخرى في دليل مطوري IoT Hub هذا ما يلي: