كيفية ربط وإدارة مراكز IoT

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

إعدادات مركز IoT المرتبطة

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

بعد ربط مركز IoT ب DPS، يكون مؤهلا للمشاركة في التخصيص. تعتمد مشاركة الجهاز وكيفية مشاركته في التخصيص على الإعدادات في التسجيل الذي يقوم الجهاز بتوفيره والإعدادات على مركز IoT المرتبط نفسه.

تتحكم الإعدادات التالية في كيفية استخدام DPS لمراكز IoT المرتبطة:

• سلسلة الاتصال: تعيين سلسلة الاتصال IoT Hub التي يستخدمها DPS للاتصال بمركز IoT المرتبط. يستند سلسلة الاتصال إلى أحد نهج الوصول المشتركة لمركز IoT. يحتاج DPS إلى الأذونات التالية على مركز IoT: RegistryWrite وServiceConnect. يجب أن يكون سلسلة الاتصال لسياسة وصول مشتركة لها هذه الأذونات. لمعرفة المزيد حول نهج الوصول المشترك ل IoT Hub، راجع التحكم في الوصول إلى مركز IoT والأذونات.

• وزن التخصيص: يحدد احتمالية تحديد مركز IoT عندما يقوم DPS بتجزئة تعيين الجهاز عبر مجموعة من مراكز IoT. يمكن أن تتراوح القيمة بين واحد و1000. الإعداد الافتراضي هو واحد (أو خال). تزيد القيم الأعلى من احتمال تحديد مركز IoT.

• تطبيق نهج التخصيص: يحدد ما إذا كان مركز IoT يشارك في نهج التخصيص. الإعداد الافتراضي هو نعم (صحيح). إذا تم تعيينها إلى لا (خطأ)، فلن يتم تعيين الأجهزة إلى مركز IoT. لا يزال من الممكن تحديد مركز IoT في التسجيل، ولكنه لن يشارك في التخصيص. يمكنك استخدام هذا الإعداد لإزالة مركز IoT مؤقتا أو نهائيا من المشاركة في التخصيص؛ على سبيل المثال، إذا كان يقترب من العدد المسموح به من الأجهزة.

للتعرف على نهج تخصيص DPS وكيفية مشاركة مراكز IoT المرتبطة فيها، راجع إدارة نهج التخصيص.

القيود

• هناك بعض القيود عند العمل مع مراكز IoT المرتبطة ونقاط النهاية الخاصة. لمزيد من المعلومات، راجع قيود نقطة النهاية الخاصة.

• يجب أن يكون لدى IoT Hub المرتبط اتصال باستخدام نهج الوصول المشتركة المعينة إلى السماح.

إضافة مركز IoT مرتبط

يمكنك إضافة مراكز IoT الموجودة داخل اشتراكك أو خارجه. عند ربط مركز IoT، قد يكون متوفرا أو غير متوفر للتخصيصات في التسجيلات الموجودة:

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

• بالنسبة للتسجيلات التي تقوم بتعيين مراكز IoT بشكل صريح لتطبيق نهج التخصيص عليها، ستحتاج إلى إضافة مركز IoT الجديد يدويا أو برمجيا إلى إعدادات التسجيل حتى يشارك في التخصيص.

مدخل Microsoft Azure

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

لربط مركز IoT بمثيل DPS الخاص بك في مدخل Microsoft Azure:

1. في القائمة اليسرى لمثيل DPS، حدد Linked IoT hubs.

2. في أعلى الصفحة، حدد +"Add".

3. في صفحة إضافة ارتباط إلى مركز IoT، حدد الاشتراك الذي يحتوي على مركز IoT ثم اختر اسم مركز IoT من قائمة مركز IoT.

4. بعد تحديد مركز IoT، اختر نهج وصول ستستخدمه DPS للاتصال بمركز IoT. تعرض قائمة نهج الوصول جميع نهج الوصول المشتركة المحددة على مركز IoT المحدد الذي تم تعريف كل من أذونات RegistryWrite وServiceConnect. الافتراضي هو نهج iothubowner . حدد النهج الذي تريد استخدامه.

5. حدد حفظ.

إشعار

في مدخل Microsoft Azure، لا يمكنك تعيين عرض التخصيص وتطبيق إعدادات نهج التخصيص عند إضافة مركز IoT مرتبط. بدلا من ذلك، قم بتحديث هذه الإعدادات بعد ربط مركز IoT.

Azure CLI

استخدم الأمر az iot dps linked-hub create Azure CLI لربط مركز IoT بمثيل DPS الخاص بك.

على سبيل المثال، يربط الأمر التالي مركز IoT المسمى MyExampleHub باستخدام سلسلة الاتصال لنهج الوصول المشترك iothubowner الخاص به. يترك هذا الأمر عرض التخصيص وتطبيق إعدادات نهج التخصيص في الإعدادات الافتراضية الخاصة بها، ولكن يمكنك تحديد قيم لهذه الإعدادات إذا كنت تريد ذلك.

az iot dps linked-hub create --dps-name MyExampleDps --resource-group MyResourceGroup --connection-string "HostName=MyExampleHub.azure-devices.net;SharedAccessKeyName=iothubowner;SharedAccessKey=XNBhoasdfhqRlgGnasdfhivtshcwh4bJwe7c0RIGuWsirW0=" --location westus

يدعم DPS أيضا ربط مراكز IoT باستخدام إنشاء أو تحديث واجهة برمجة تطبيقات REST لمورد DPS وقوالب Resource Manager وDK لإدارة DPS.

تحديث مركز IoT مرتبط

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

مدخل Microsoft Azure

في مدخل Microsoft Azure، يمكنك تحديث تخصيص الوزن وتطبيق إعدادات نهج التخصيص.

لتحديث الإعدادات لمركز IoT مرتبط باستخدام مدخل Microsoft Azure:

1. في القائمة اليسرى لمثيل DPS، حدد Linked IoT hubs، ثم حدد مركز IoT من القائمة.

2. في صفحة تفاصيل مركز IoT المرتبط:

   

   • استخدم شريط التمرير أو مربع النص تخصيص الوزن لاختيار وزن بين واحد و1000. الإعداد الافتراضي هو واحد.

   • قم بتعيين مفتاح تطبيق نهج التخصيص لتحديد ما إذا كان يجب تضمين مركز IoT المرتبط في التخصيص.

3. احفظ إعداداتك.

إشعار

لا يمكنك تحديث سلسلة الاتصال التي يستخدمها DPS للاتصال بمركز IoT من مدخل Microsoft Azure. بدلا من ذلك، استخدم Azure CLI لتحديث سلسلة الاتصال، أو احذف مركز IoT المرتبط من مثيل DPS وأعد ربطه. لمعرفة المزيد، راجع قسم تحديث المفاتيح لمراكز IoT المرتبطة.

Azure CLI

باستخدام Azure CLI، يمكنك تحديث عرض التخصيص وتطبيق نهج التخصيص وإعدادات سلسلة الاتصال.

استخدم الأمر az iot dps linked-hub update لتحديث وزن التخصيص أو تطبيق إعدادات نهج التخصيص. على سبيل المثال، يقوم الأمر التالي بتعيين وزن التخصيص وتطبيق نهج التخصيص لمركز IoT مرتبط:

az iot dps linked-hub update --dps-name MyExampleDps --resource-group MyResourceGroup --linked-hub MyExampleHub --allocation-weight 2 --apply-allocation-policy true

استخدم الأمر az iot dps update لتحديث سلسلة الاتصال لمركز IoT مرتبط. يمكنك استخدام المعلمة --set جنبا إلى جنب مع سلسلة الاتصال لنهج الوصول المشترك لمركز IoT الذي تريد استخدامه. للحصول على التفاصيل، راجع تحديث المفاتيح لمراكز IoT المرتبطة.

يدعم DPS أيضا تحديث مراكز IoT المرتبطة باستخدام إنشاء أو تحديث واجهة برمجة تطبيقات REST لمورد DPS وقوالب Resource Manager وDK لإدارة DPS.

حذف مركز IoT مرتبط

عند حذف مركز IoT مرتبط من مثيل DPS الخاص بك، لن يكون متاحا لتعيينه في التسجيلات المستقبلية. ومع ذلك، قد تتم إزالتها أو لا تتم إزالتها من التخصيصات في التسجيلات الموجودة:

• بالنسبة للتسجيلات التي لم تقم بتعيين مراكز IoT بشكل صريح لتطبيق نهج التخصيص عليها، لم يعد مركز IoT المرتبط المحذوف متاحا للتخصيص.

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

مدخل Microsoft Azure

لحذف مركز IoT مرتبط من مثيل DPS في مدخل Microsoft Azure:

1. في القائمة اليسرى لمثيل DPS، حدد Linked IoT hubs.

2. من قائمة مراكز IoT، حدد خانة الاختيار بجوار مركز IoT أو مراكز IoT التي تريد حذفها. ثم حدد حذف في أعلى الصفحة وتأكد من اختيارك عند مطالبتك بذلك.

Azure CLI

استخدم الأمر az iot dps linked-hub delete لإزالة مركز IoT مرتبط من مثيل DPS. على سبيل المثال، يزيل الأمر التالي مركز IoT المسمى MyExampleHub:

az iot dps linked-hub delete --dps-name MyExampleDps --resource-group MyResourceGroup --linked-hub MyExampleHub

يدعم DPS أيضا حذف IoT Hubs المرتبطة من مثيل DPS باستخدام إنشاء أو تحديث واجهة برمجة تطبيقات REST لمورد DPS وقوالب Resource Manager وDDKs لإدارة DPS.

تحديث المفاتيح لمراكز IoT المرتبطة

قد يصبح من الضروري إما تدوير المفاتيح المتماثلة لمركز IoT المرتبط ب DPS أو تحديثها. في هذه الحالة، ستحتاج أيضا إلى تحديث إعداد سلسلة الاتصال في DPS لمركز IoT المرتبط.

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

مدخل Microsoft Azure

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

لتحديث مفاتيح متماثلة لمركز IoT مرتبط في مدخل Microsoft Azure:

1. في القائمة اليسرى لمثيل DPS في مدخل Microsoft Azure، حدد مركز IoT الذي تريد تحديث مفتاح واحد أو أكثر له.

2. في صفحة تفاصيل مركز IoT المرتبط، لاحظ قيم وزن التخصيص وتطبيق نهج التخصيص. تحتاج إلى هذه القيم عند إعادة ربط مركز IoT إلى مثيل DPS الخاص بك لاحقا. ثم حدد إدارة المورد للانتقال إلى مركز IoT.

3. في القائمة اليمنى من مركز IoT، ضمن Security settings، حدد Shared access policies.

4. في نهج الوصول المشترك، ضمن إدارة نهج الوصول المشترك، حدد النهج الذي يستخدمه مثيل DPS للاتصال بمركز IoT المرتبط.

5. في أعلى الصفحة، حدد إعادة إنشاء المفتاح الأساسي أو إعادة إنشاء المفتاح الثانوي أو مفاتيح التبديل، وأكد اختيارك عند مطالبتك.

6. انتقل مرة أخرى إلى مثيل DPS الخاص بك.

7. اتبع الخطوات الواردة في قسم حذف مركز IoT مرتبط لحذف مركز IoT من مثيل DPS الخاص بك.

8. اتبع الخطوات الواردة في قسم إضافة مركز IoT مرتبط لإعادة ربط مركز IoT بمثيل DPS الخاص بك مع سلسلة الاتصال الجديد للنهج.

9. إذا كنت بحاجة إلى استعادة وزن التخصيص وتطبيق إعدادات نهج التخصيص، فاتبع الخطوات الواردة في قسم تحديث مركز IoT مرتبط باستخدام القيم التي حفظتها في الخطوة 2.

Azure CLI

لتحديث مفاتيح متماثلة لمركز IoT مرتبط باستخدام Azure CLS:

1. استخدم الأمر az iot hub policy renew-key لتبديل المفاتيح المتماثلة أو إعادة إنشائها لنهج الوصول المشترك على مركز IoT. على سبيل المثال، يجدد الأمر التالي المفتاح الأساسي لنهج الوصول المشترك iothubowner على مركز IoT:

   az iot hub policy renew-key --hub-name MyExampleHub --name owner --rk primary
   

2. استخدم الأمر az iot hub connection-string show للحصول على سلسلة الاتصال الجديد لنهج الوصول المشترك. على سبيل المثال، يحصل الأمر التالي على سلسلة الاتصال الأساسي لنهج الوصول المشترك iothubowner الذي تمت إعادة إنشاء المفتاح الأساسي له في الأمر السابق:

   az iot hub connection-string show --hub-name MyExampleHub --policy-name owner --key-type primary
   

3. استخدم الأمر az iot dps linked-hub list للعثور على موضع مركز IoT في مجموعة مراكز IoT المرتبطة لمثيل DPS الخاص بك. على سبيل المثال، يحصل الأمر التالي على سلسلة الاتصال الأساسي لنهج الوصول المشترك للمالك الذي تمت إعادة إنشاء المفتاح الأساسي له في الأمر السابق:

   az iot dps linked-hub list --dos-name MyExampleDps
   

   يظهر الإخراج موضع مركز IoT المرتبط الذي تريد تحديث سلسلة الاتصال له في جدول مراكز IoT المرتبطة التي يحتفظ بها مثيل DPS. في هذه الحالة، إنه أول مركز IoT في القائمة، MyExampleHub.

   [
   {
       "allocationWeight": null,
       "applyAllocationPolicy": null,
       "connectionString": "HostName=MyExampleHub.azure-devices.net;SharedAccessKeyName=iothubowner;SharedAccessKey=****",
       "location": "centralus",
       "name": "MyExampleHub.azure-devices.net"
   },
   {
       "allocationWeight": null,
       "applyAllocationPolicy": null,
       "connectionString": "HostName=MyExampleHub-2.azure-devices.net;SharedAccessKeyName=iothubowner;SharedAccessKey=****",
       "location": "centralus",
       "name": "NyExampleHub-2.azure-devices.net"
   }
   ]
   

4. استخدم الأمر az iot dps update لتحديث سلسلة الاتصال لمركز IoT المرتبط. يمكنك استخدام المعلمة --set وموضع مركز IoT المرتبط في properties.iotHubs[] الجدول لاستهداف مركز IoT. على سبيل المثال، يقوم الأمر التالي بتحديث سلسلة الاتصال ل MyExampleHub الذي تم إرجاعه أولا في الأمر السابق:

   az iot dps update --name MyExampleDps --set properties.iotHubs[0].connectionString="HostName=MyExampleHub-2.azure-devices.net;SharedAccessKeyName=iothubowner;SharedAccessKey=NewTokenValue"
   

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

• لمعرفة المزيد حول نهج التخصيص، راجع إدارة نهج التخصيص.