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