استخدام واجهة برمجة تطبيقات REST لإنشاء تطبيقات IoT Central وإدارتها

  • مقالة
  • قراءة خلال 2 دقائق

يمكنك استخدام واجهة برمجة تطبيقات REST لمستوى التحكم لإنشاء تطبيقات IoT Central وإدارتها. يمكنك أيضا استخدام واجهة برمجة تطبيقات REST لإضافة هوية مدارة إلى تطبيقك.

لاستخدام واجهة برمجة التطبيقات هذه ، تحتاج إلى رمز مميز لحامله للمورد management.azure.com . للحصول على رمز مميز لحامله، يمكنك استخدام Azure CLI:

az account get-access-token --resource https://management.azure.com

سرد التطبيقات الخاصة بك

للحصول على قائمة بتطبيقات IoT Central في اشتراك:

GET https://management.azure.com/subscriptions/{subscriptionId}/providers/Microsoft.IoTCentral/iotApps?api-version=2021-06-01

للحصول على قائمة بتطبيقات IoT Central في مجموعة موارد:

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.IoTCentral/iotApps?api-version=2021-06-01

يمكنك استرداد تفاصيل تطبيق فردي:

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.IoTCentral/iotApps/{applicationName}?api-version=2021-06-01

إنشاء تطبيق IoT Central

لإنشاء تطبيق IoT Central مع نظام تعيين هوية مدارة:

PUT https://management.azure.com/subscriptions/<your subscription id>/resourceGroups/<your resource group name>/providers/Microsoft.IoTCentral/iotApps/<your application name>?api-version=2021-06-01

تعرض الحمولة التالية تكوين التطبيق الجديد، بما في ذلك الهوية المدارة:

{
  "location": "eastus",
  "sku": {
    "name": "ST2"
  },
  "properties": {
    "displayName": "Contoso IoT Central App",
    "subdomain": "my-iot-central-app",
    "template": "iotc-pnp-preview@1.0.0"
  },
  "identity": {
    "type": "SystemAssigned"
  }
}

تعديل تطبيق IoT Central

يمكنك تعديل تطبيق IoT Central موجود. يوضح المثال التالي كيفية تغيير اسم العرض وتمكين الهوية المدارة المعينة من قبل النظام:

PATCH https://management.azure.com/subscriptions/<your subscription id>/resourceGroups/<your resource group name>/providers/Microsoft.IoTCentral/iotApps/<your application name>?api-version=2021-06-01

استخدم الحمولة التالية لتغيير اسم العرض وتمكين الهوية المدارة المعينة للنظام:

{
  "properties": {
    "displayName": "Contoso IoT Central App"
  },
  "identity": {
    "type": "SystemAssigned"
  }
}

ملاحظة

يمكنك فقط إضافة هوية مدارة إلى تطبيق IoT Central الذي تم إنشاؤه في منطقة. يتم إنشاء جميع التطبيقات الجديدة في منطقة. لمعرفة المزيد، راجع التحديثات.

حذف تطبيق IoT Central

لحذف تطبيق IoT Central، استخدم:

DELETE https://management.azure.com/subscriptions/<your subscription id>/resourceGroups/<your resource group name>/providers/Microsoft.IoTCentral/iotApps/<your application name>?api-version=2021-06-01

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

الآن بعد أن تعلمت كيفية إنشاء تطبيقات Azure IoT Central وإدارتها باستخدام واجهة برمجة تطبيقات REST، إليك الخطوة التالية المقترحة:

كيفية استخدام واجهة برمجة تطبيقات IoT Central REST لإدارة المستخدمين والأدوار