إنشاء رسائل IoT Hub وقراءتها

لدعم إمكانية التشغيل التفاعلي عبر البروتوكولات، يحدد IoT Hub مجموعة شائعة من ميزات المراسلة المتوفرة في جميع البروتوكولات التي تواجه الجهاز. يمكن استخدام هذه الميزات في كل من الرسائل من جهاز إلى سحابة والرسائل من السحابة إلى الجهاز.

يقوم IoT Hub بتنفيذ المراسلة من جهاز إلى سحابة باستخدام نمط مراسلة دفق. تشبه رسائل IoT Hub من جهاز إلى سحابة أحداث مراكز الأحداث أكثر من رسائل ناقل خدمة Microsoft Azure من حيث أن هناك عددا كبيرا من الأحداث التي تمر عبر الخدمة التي يمكن للعديد من القراء قراءتها.

تتكون رسالة IoT Hub من:

• مجموعة محددة مسبقا من خصائص النظام كما هو موضح لاحقا في هذه المقالة.

• مجموعة من خصائص التطبيق. قاموس خصائص السلسلة التي يمكن للتطبيق تعريفها والوصول إليها، دون الحاجة إلى إلغاء تسلسل نص الرسالة. لا يعدل IoT Hub هذه الخصائص أبدًا.

• نص الرسالة، والذي يمكن أن يكون أي نوع من البيانات.

ينفذ كل بروتوكول جهاز خصائص الإعداد بطرق مختلفة. لمزيد من المعلومات، راجع دليل بروتوكول MQTT ودليل بروتوكول AMQP دليل المطور للحصول على التفاصيل.

عند إرسال رسائل من جهاز إلى سحابة باستخدام بروتوكول HTTPS أو إرسال رسائل من السحابة إلى الجهاز، يمكن أن تحتوي أسماء الخصائص والقيم على أحرف أبجدية رقمية ASCII فقط، بالإضافة إلى ! # $ % & ' * + - . ^ _ ` | ~ .

تتميز المراسلة من جهاز إلى سحابة باستخدام IoT Hub بالخصائص التالية:

• الرسائل من جهاز إلى شبكة سحابية دائمة ويتم الاحتفاظ بها في نقطة النهاية الافتراضية للرسائل/الأحداث لـ IoT Hub لمدة تصل إلى سبعة أيام.

• يمكن أن تصل الرسائل من الجهاز إلى السحابة إلى 256 كيلوبايت كحد أقصى، ويمكن تجميعها على دفعات لتحسين عمليات إرسال. يمكن أن تكون الدُفعات 256 كيلوبايت بحد أقصى.

• لا يسمح IoT Hub بالتقسيم العشوائي. يتم تقسيم الرسائل من جهاز إلى سحابة استنادًا إلى deviceIdالأصلي.

• كما هو موضح في Control access to IoT Hub، يتيح IoT Hub المصادقة لكل جهاز والتحكم في الوصول.

• يمكنك وضع طابع على الرسائل بمعلومات تنتقل إلى خصائص التطبيق. لمزيد من المعلومات، راجع إغناء الرسائل .

لاستخدام نص الرسالة في استعلام توجيه IoT Hub، قم بتوفير كائن JSON صالح للرسالة وتعيين خاصية نوع المحتوى للرسالة إلى application/json;charset=utf-8.

يوضح المثال التالي نص رسالة صالح وقابل للتوجيه:

{
    "timestamp": "2022-02-08T20:10:46Z",
    "tag_name": "spindle_speed",
    "tag_value": 100
}

خصائص النظام للرسائل من جهاز إلى سحابة

خصائص التطبيق للرسائل من جهاز إلى سحابة

الاستخدام الشائع لخصائص التطبيق هو إرسال طابع زمني من الجهاز باستخدام الخاصية iothub-creation-time-utc لتسجيل وقت إرسال الرسالة بواسطة الجهاز. يجب أن يكون تنسيق هذا الطابع الزمني بالتوقيت العالمي المتفق عليه دون معلومات عن المنطقة الزمنية. على سبيل المثال، 2021-04-21T11:30:16Z صالح، ولكنه 2021-04-21T11:30:16-07:00 غير صالح.

{
  "applicationId":"00001111-aaaa-2222-bbbb-3333cccc4444",
  "messageSource":"telemetry",
  "deviceId":"sample-device-01",
  "schema":"default@v1",
  "templateId":"urn:modelDefinition:mkuyqxzgea:e14m1ukpn",
  "enqueuedTime":"2021-01-29T16:45:39.143Z",
  "telemetry":{
    "temperature":8.341033560421833
  },
  "messageProperties":{
    "iothub-creation-time-utc":"2021-01-29T16:45:39.021Z"
  },
  "enrichments":{}
}

خصائص النظام للرسائل من السحابة إلى الجهاز

أسماء خصائص النظام

تختلف أسماء خصائص النظام بناءً على نقطة النهاية التي يتم توجيه الرسائل إليها.

حجم الرسالة

يقيس IoT Hub حجم الرسالة بطريقة غير محددة البروتوكول، مع الأخذ في الاعتبار البيانات الأساسية الفعلية فقط. يتم حساب الحجم بالبايت كمجموع القيم التالية:

• حجم النص بالبايت.
• الحجم بالبايت لكافة قيم خصائص نظام الرسائل.
• الحجم بالبايت لكافة أسماء خصائص المستخدم وقيمها.

تقتصر أسماء الخصائص وقيمها على أحرف ASCII، بحيث يساوي طول السلاسل الحجم بالبايت.

خصائص مكافحة تزييف الهوية

لتجنب تزييف هوية الجهاز في الرسائل من الجهاز إلى السحابة، يضع IoT Hub طابع على كافة الرسائل بالخصائص التالية:

• iothub-connection-device-id
• iothub-connection-auth-generation-id
• iothub-connection-auth-method

يحتوي النوعان الأولان على deviceId وgenerationId للجهاز الأصلي، وفقاً لخصائص هوية الجهاز.

تحتوي الخاصية iothub-connection-auth-method على كائن متسلسل في JSON، مع الخصائص التالية:

{
  "scope": "{ hub | device | module }",
  "type": "{ symkey | sas | x509 }",
  "issuer": "iothub"
}

الخطوات التالية

• للحصول على معلومات بشأن حدود حجم الرسالة في IoT Hub، راجع حصص IoT Hub والتقييد.
• لمعرفة كيفية إنشاء وقراءة رسائل IoT Hub بلغات برمجة مختلفة، راجع التشغيل السريعs.
• للتعرف على بنية الأحداث غير المتعلقة بالتتبع التي تم إنشاؤها بواسطة مركز IoT، راجع مخططات أحداث مركز IoT غير بيانات تتبع الاستخدام.