مشاركة عبر

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

  • مقالة

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

مراكز IoT المرتبطة ونهج التخصيص

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

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

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

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

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

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

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

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

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

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

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

القيود

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

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

في مدخل 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 Hub المحدد الذي يحتوي على كل من RegistryWrite وService الاتصال الأذونات المعرفة. الافتراضي هو نهج iothubowner . حدد النهج الذي تريد استخدامه.

  5. حدد حفظ.

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

إشعار

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

استخدم الأمر 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 لتحديث مركز IoT مرتبط

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

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

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

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

    Screenshot that shows the linked IoT hub details page. .

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

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

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

إشعار

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

استخدام Azure CLI لتحديث مركز IoT مرتبط

باستخدام 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 مرتبط

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

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

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

استخدام Azure CLI لحذف مركز IoT مرتبط

استخدم الأمر 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 الخاص بك مع سلسلة الاتصالات الجديدة استنادا إلى هذا المفتاح. لهذا السبب، نوصي باستخدام Azuer CLI لتحديث المفاتيح الخاصة بك لأنه يمكنك تحديث سلسلة connnection على المركز المرتبط بشكل رهيب. باستخدام مدخل 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"

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

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