مشاركة عبر


Microsoft.Devices IotHubs 2019-11-04

تعريف مورد Bicep

يمكن نشر نوع مورد IotHubs مع العمليات التي تستهدف:

  • مجموعات الموارد - راجع أوامر نشر مجموعة الموارد

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

تنسيق المورد

لإنشاء مورد Microsoft.Devices/IotHubs، أضف Bicep التالي إلى القالب الخاص بك.

resource symbolicname 'Microsoft.Devices/IotHubs@2019-11-04' = {
  etag: 'string'
  location: 'string'
  name: 'string'
  properties: {
    authorizationPolicies: [
      {
        keyName: 'string'
        primaryKey: 'string'
        rights: 'string'
        secondaryKey: 'string'
      }
    ]
    cloudToDevice: {
      defaultTtlAsIso8601: 'string'
      feedback: {
        lockDurationAsIso8601: 'string'
        maxDeliveryCount: int
        ttlAsIso8601: 'string'
      }
      maxDeliveryCount: int
    }
    comments: 'string'
    enableFileUploadNotifications: bool
    eventHubEndpoints: {
      {customized property}: {
        partitionCount: int
        retentionTimeInDays: int
      }
    }
    features: 'string'
    ipFilterRules: [
      {
        action: 'string'
        filterName: 'string'
        ipMask: 'string'
      }
    ]
    messagingEndpoints: {
      {customized property}: {
        lockDurationAsIso8601: 'string'
        maxDeliveryCount: int
        ttlAsIso8601: 'string'
      }
    }
    routing: {
      endpoints: {
        eventHubs: [
          {
            connectionString: 'string'
            name: 'string'
            resourceGroup: 'string'
            subscriptionId: 'string'
          }
        ]
        serviceBusQueues: [
          {
            connectionString: 'string'
            name: 'string'
            resourceGroup: 'string'
            subscriptionId: 'string'
          }
        ]
        serviceBusTopics: [
          {
            connectionString: 'string'
            name: 'string'
            resourceGroup: 'string'
            subscriptionId: 'string'
          }
        ]
        storageContainers: [
          {
            batchFrequencyInSeconds: int
            connectionString: 'string'
            containerName: 'string'
            encoding: 'string'
            fileNameFormat: 'string'
            maxChunkSizeInBytes: int
            name: 'string'
            resourceGroup: 'string'
            subscriptionId: 'string'
          }
        ]
      }
      enrichments: [
        {
          endpointNames: [
            'string'
          ]
          key: 'string'
          value: 'string'
        }
      ]
      fallbackRoute: {
        condition: 'string'
        endpointNames: [
          'string'
        ]
        isEnabled: bool
        name: 'string'
        source: 'string'
      }
      routes: [
        {
          condition: 'string'
          endpointNames: [
            'string'
          ]
          isEnabled: bool
          name: 'string'
          source: 'string'
        }
      ]
    }
    storageEndpoints: {
      {customized property}: {
        connectionString: 'string'
        containerName: 'string'
        sasTtlAsIso8601: 'string'
      }
    }
  }
  sku: {
    capacity: int
    name: 'string'
  }
  tags: {
    {customized property}: 'string'
  }
}

قيم الخصائص

خصائص جهاز السحابة

اسم وصف قيمة
defaultTtlAsIso8601 الوقت الافتراضي للعيش للرسائل من السحابة إلى الجهاز في قائمة انتظار الجهاز. راجع: /azure/iot-hub/iot-hub-devguide-messaging#cloud-to-device-messages. خيط
ردود الفعل خصائص قائمة انتظار الملاحظات للرسائل من السحابة إلى الجهاز. FeedbackProperties
maxDeliveryCount الحد الأقصى لعدد التسليم للرسائل من السحابة إلى الجهاز في قائمة انتظار الجهاز. راجع: /azure/iot-hub/iot-hub-devguide-messaging#cloud-to-device-messages. الباحث

القيود:
قيمة الحد الأدنى = 1
القيمة القصوى = 100

خصائص الإثراء

اسم وصف قيمة
أسماء نقاط النهاية قائمة نقاط النهاية التي يتم تطبيق الإثراء عليها على الرسالة. string[] (مطلوبة)
مفتاح مفتاح أو اسم خاصية الإثراء. سلسلة (مطلوب)
قيمة قيمة خاصية الإثراء. سلسلة (مطلوب)

خصائص EventHub

اسم وصف قيمة
عدد الأقسام عدد الأقسام لتلقي رسائل من جهاز إلى سحابة في نقطة النهاية المتوافقة مع Event Hub. راجع: /azure/iot-hub/iot-hub-devguide-messaging#device-to-cloud-messages. الباحث
retentionTimeInDays وقت الاستبقاء للرسائل من جهاز إلى سحابة بالأيام. راجع: /azure/iot-hub/iot-hub-devguide-messaging#device-to-cloud-messages الباحث

الخصائص الاحتياطية للRoute

اسم وصف قيمة
شرط الشرط الذي يتم تقييمه من أجل تطبيق المسار الاحتياطي. إذا لم يتم توفير الشرط، تقييمه إلى صحيح بشكل افتراضي. للتدقيق النحوي، راجع: /azure/iot-hub/iot-hub-devguide-query-language خيط
أسماء نقاط النهاية قائمة نقاط النهاية التي يتم توجيه الرسائل التي تفي بالشرط إليها. يسمح حاليا بنقطة نهاية واحدة فقط. string[] (مطلوبة)
isEnabled يستخدم لتحديد ما إذا كان المسار الاحتياطي ممكنا أم لا. bool (مطلوب)
اسم اسم المسار. يمكن أن يتضمن الاسم فقط الأحرف الأبجدية الرقمية والنقاط والتسطير السفلي والواصلات، بحد أقصى 64 حرفا، ويجب أن يكون فريدا. خيط
مصدر المصدر الذي سيتم تطبيق قاعدة التوجيه عليه. على سبيل المثال، DeviceMessages "أحداث دورة حياة الجهاز"
"أحداث دورة حياة الجهاز"
"رسائل الجهاز"
"غير صالح"
'TwinChangeEvents' (مطلوب)

خصائص الملاحظات

اسم وصف قيمة
lockDurationAsIso8601 مدة تأمين قائمة انتظار الملاحظات. راجع: /azure/iot-hub/iot-hub-devguide-messaging#cloud-to-device-messages. خيط
maxDeliveryCount عدد المرات التي يحاول فيها مركز IoT تسليم رسالة في قائمة انتظار الملاحظات. راجع: /azure/iot-hub/iot-hub-devguide-messaging#cloud-to-device-messages. الباحث

القيود:
قيمة الحد الأدنى = 1
القيمة القصوى = 100
ttlAsIso8601 الفترة الزمنية التي تتوفر فيها الرسالة للاستهلاك قبل انتهاء صلاحيتها بواسطة مركز IoT. راجع: /azure/iot-hub/iot-hub-devguide-messaging#cloud-to-device-messages. خيط

خصائص IotHub

اسم وصف قيمة
نهج التخويل نهج الوصول المشتركة التي يمكنك استخدامها لتأمين اتصال بمركز IoT. SharedAccessSignatureAuthorizationRule[]
cloudToDevice خصائص المراسلة من سحابة إلى جهاز لمركز IoT. CloudToDeviceProperties
التعليقات تعليقات مركز IoT. خيط
enableFileUploadNotifications إذا كانت True، يتم تمكين إعلامات تحميل الملفات. قيمة منطقية
نقاط نهاية eventHub خصائص نقطة النهاية المتوافقة مع Event Hub. المفاتيح الوحيدة الممكنة لهذا القاموس هي الأحداث. يجب أن يكون هذا المفتاح موجودا في القاموس أثناء إجراء مكالمات إنشاء أو تحديث لمركز IoT. IotHubPropertiesEventHubEndpoints
ملامح الإمكانات والميزات الممكنة لمركز IoT. "إدارة الجهاز"
"بلا"
ipFilterRules قواعد عامل تصفية IP. IpFilterRule[]
نقاط نهاية المراسلة خصائص نقطة نهاية المراسلة لقائمة انتظار إعلام تحميل الملف. IotHubPropertiesMessagingEndpoints
التوجيه الخصائص ذات الصلة للتوجيه لمركز IoT. راجع: /azure/iot-hub/iot-hub-devguide-messaging RoutingProperties
نقاط نهاية التخزين قائمة نقاط نهاية Azure Storage حيث يمكنك تحميل الملفات. يمكنك حاليا تكوين حساب Azure Storage واحد فقط ويجب أن يكون مفتاحه $default. يؤدي تحديد أكثر من حساب تخزين واحد إلى طرح خطأ. يؤدي عدم تحديد قيمة لهذه الخاصية عند تعيين الخاصية enableFileUploadNotifications إلى True إلى ظهور خطأ. IotHubPropertiesStorageEndpoints

نقاط نهاية IotHubPropertiesEventHub

اسم وصف قيمة

IotHubPropertiesMessagingEndpoints

اسم وصف قيمة

IotHubPropertiesStorageEndpoints

اسم وصف قيمة

معلومات IotHubSku

اسم وصف قيمة
سعة عدد وحدات IoT Hub المتوفرة. راجع: /azure/azure-subscription-service-limits#iot-hub-limits. الباحث
اسم اسم SKU. 'B1'
'B2'
'B3'
'F1'
'S1'
'S2'
'S3' (مطلوب)

IpFilterRule

اسم وصف قيمة
فعل الإجراء المطلوب للطلبات التي تم التقاطها بواسطة هذه القاعدة. "قبول"
"رفض" (مطلوب)
اسم عامل التصفية اسم قاعدة عامل تصفية IP. سلسلة (مطلوب)
ipMask سلسلة تحتوي على نطاق عنوان IP في رمز CIDR للقاعدة. سلسلة (مطلوب)

خصائص نقطة نهاية المراسلة

اسم وصف قيمة
lockDurationAsIso8601 مدة التأمين. راجع: /azure/iot-hub/iot-hub-devguide-file-upload. خيط
maxDeliveryCount عدد المرات التي يحاول فيها مركز IoT تسليم رسالة. راجع: /azure/iot-hub/iot-hub-devguide-file-upload. الباحث

القيود:
قيمة الحد الأدنى = 1
القيمة القصوى = 100
ttlAsIso8601 الفترة الزمنية التي تتوفر فيها الرسالة للاستهلاك قبل انتهاء صلاحيتها بواسطة مركز IoT. راجع: /azure/iot-hub/iot-hub-devguide-file-upload. خيط

Microsoft.Devices/IotHubs

اسم وصف قيمة
etag حقل Etag غير مطلوب . إذا تم توفيره في نص الاستجابة، يجب أيضا توفيره كعنوان وفقا لاصطلاح ETag العادي. خيط
مكان موقع المورد. سلسلة (مطلوب)
اسم اسم المورد سلسلة (مطلوب)
خصائص خصائص IotHub IotHubProperties
سكو معلومات IotHub SKU IotHubSkuInfo (مطلوب)
العلامات علامات الموارد قاموس أسماء العلامات والقيم. راجع العلامات في القوالب

علامات تعريف الموارد

اسم وصف قيمة

خصائص المسار

اسم وصف قيمة
شرط الشرط الذي يتم تقييمه لتطبيق قاعدة التحويل. إذا لم يتم توفير أي شرط، يتم تقييمه إلى صحيح بشكل افتراضي. للتدقيق النحوي، راجع: /azure/iot-hub/iot-hub-devguide-query-language خيط
أسماء نقاط النهاية قائمة نقاط النهاية التي يتم توجيه الرسائل التي تفي بالشرط. يسمح حاليا بنقطة نهاية واحدة فقط. string[] (مطلوبة)
isEnabled يستخدم لتحديد ما إذا كان المسار ممكنا أم لا. bool (مطلوب)
اسم اسم المسار. يمكن أن يتضمن الاسم فقط الأحرف الأبجدية الرقمية والنقاط والتسطير السفلي والواصلات، بحد أقصى 64 حرفا، ويجب أن يكون فريدا. خيط

القيود:
النمط = ^[A-Za-z0-9-._]{1,64}$ (مطلوب)
مصدر المصدر الذي سيتم تطبيق قاعدة التوجيه عليه، مثل DeviceMessages. "أحداث دورة حياة الجهاز"
"أحداث دورة حياة الجهاز"
"رسائل الجهاز"
"غير صالح"
'TwinChangeEvents' (مطلوب)

نقاط نهاية التوجيه

اسم وصف قيمة
eventHubs قائمة نقاط نهاية مراكز الأحداث التي يوجه مركز IoT الرسائل إليها، استنادا إلى قواعد التوجيه. لا تتضمن هذه القائمة نقطة نهاية مراكز الأحداث المضمنة. RoutingEventHubProperties []
serviceBusQueues قائمة نقاط نهاية قائمة انتظار ناقل خدمة Microsoft Azure التي يوجه مركز IoT الرسائل إليها، استنادا إلى قواعد التوجيه. RoutingServiceBusQueueEndpointProperties[]
serviceBusTopics قائمة نقاط نهاية موضوع ناقل خدمة Microsoft Azure التي يوجه مركز IoT الرسائل إليها، استنادا إلى قواعد التوجيه. RoutingServiceBusTopicEndpointProperties[]
مكونات التخزين قائمة نقاط نهاية حاوية التخزين التي يوجه مركز IoT الرسائل إليها، استنادا إلى قواعد التوجيه. RoutingStorageContainerProperties[]

RoutingEventHubProperties

اسم وصف قيمة
سلسلة الاتصال سلسلة الاتصال لنقطة نهاية مركز الحدث. سلسلة (مطلوب)
اسم الاسم الذي يعرف نقطة النهاية هذه. يمكن أن يتضمن الاسم الأحرف الأبجدية الرقمية والنقاط والتسطير السفلي والواصلات بحد أقصى 64 حرفا. الأسماء التالية محجوزة: الأحداث، fileNotifications، $default. يجب أن تكون أسماء نقاط النهاية فريدة عبر أنواع نقاط النهاية. خيط

القيود:
النمط = ^[A-Za-z0-9-._]{1,64}$ (مطلوب)
مجموعة الموارد اسم مجموعة الموارد لنقطة نهاية مركز الحدث. خيط
معرف الاشتراك معرف الاشتراك لنقطة نهاية مركز الحدث. خيط

خصائص التوجيه

اسم وصف قيمة
النهايه الخصائص المتعلقة بنقاط النهاية المخصصة التي يوجه إليها مركز IoT الرسائل استنادا إلى قواعد التوجيه. يسمح بحد أقصى 10 نقاط نهاية مخصصة عبر جميع أنواع نقاط النهاية للموزعات المدفوعة ويسمح بنقطة نهاية مخصصة واحدة فقط عبر جميع أنواع نقاط النهاية للمراكز المجانية. RoutingEndpoints
عمليات الإثراء قائمة عمليات الإثراء التي يوفرها المستخدم والتي ينطبق عليها مركز IoT على الرسائل التي سيتم تسليمها إلى نقاط النهاية المضمنة والمخصصة. راجع: https://aka.ms/telemetryoneventgrid خصائص الإثراء []
مسار احتياطي خصائص المسار المستخدم كمسار احتياطي عند عدم استيفاء أي من الشروط المحددة في قسم "المسارات". هذه معلمة اختيارية. عند عدم تعيين هذه الخاصية، يتم توجيه الرسائل التي لا تفي بأي من الشروط المحددة في قسم "المسارات" إلى نقطة النهاية eventhub المضمنة. FallbackRouteProperties
طرق قائمة قواعد التوجيه التي يوفرها المستخدم والتي يستخدمها مركز IoT لتوجيه الرسائل إلى نقاط النهاية المضمنة والمخصصة. يسمح بحد أقصى 100 قاعدة توجيه لمراكز الدفع ويسمح بحد أقصى 5 قواعد للتوجيه للمراكز المجانية. RouteProperties []

RoutingServiceBusQueueEndpointProperties

اسم وصف قيمة
سلسلة الاتصال سلسلة الاتصال لنقطة نهاية قائمة انتظار ناقل الخدمة. سلسلة (مطلوب)
اسم الاسم الذي يعرف نقطة النهاية هذه. يمكن أن يتضمن الاسم الأحرف الأبجدية الرقمية والنقاط والتسطير السفلي والواصلات بحد أقصى 64 حرفا. الأسماء التالية محجوزة: الأحداث، fileNotifications، $default. يجب أن تكون أسماء نقاط النهاية فريدة عبر أنواع نقاط النهاية. لا يجب أن يكون الاسم هو نفس اسم قائمة الانتظار الفعلي. خيط

القيود:
النمط = ^[A-Za-z0-9-._]{1,64}$ (مطلوب)
مجموعة الموارد اسم مجموعة الموارد لنقطة نهاية قائمة انتظار ناقل الخدمة. خيط
معرف الاشتراك معرف الاشتراك لنقطة نهاية قائمة انتظار ناقل الخدمة. خيط

RoutingServiceBusTopicEndpointProperties

اسم وصف قيمة
سلسلة الاتصال سلسلة الاتصال لنقطة نهاية موضوع ناقل الخدمة. سلسلة (مطلوب)
اسم الاسم الذي يعرف نقطة النهاية هذه. يمكن أن يتضمن الاسم الأحرف الأبجدية الرقمية والنقاط والتسطير السفلي والواصلات بحد أقصى 64 حرفا. الأسماء التالية محجوزة: الأحداث، fileNotifications، $default. يجب أن تكون أسماء نقاط النهاية فريدة عبر أنواع نقاط النهاية. لا يجب أن يكون الاسم هو نفس اسم الموضوع الفعلي. خيط

القيود:
النمط = ^[A-Za-z0-9-._]{1,64}$ (مطلوب)
مجموعة الموارد اسم مجموعة الموارد لنقطة نهاية موضوع ناقل الخدمة. خيط
معرف الاشتراك معرف الاشتراك لنقطة نهاية موضوع ناقل الخدمة. خيط

RoutingStorageContainerProperties

اسم وصف قيمة
batchFrequencyInSeconds الفاصل الزمني الذي تتم فيه كتابة الكائنات الثنائية كبيرة الحجم إلى التخزين. يجب أن تتراوح القيمة بين 60 و720 ثانية. القيمة الافتراضية هي 300 ثانية. الباحث

القيود:
قيمة الحد الأدنى = 60
القيمة القصوى = 720
سلسلة الاتصال سلسلة الاتصال لحساب التخزين. سلسلة (مطلوب)
اسم الحاوية اسم حاوية التخزين في حساب التخزين. سلسلة (مطلوب)
ترميز الترميز المستخدم لتسلسل الرسائل إلى الكائنات الثنائية كبيرة الحجم. القيم المدعومة هي "avro" و"avrodeflate" و"JSON". القيمة الافتراضية هي "avro". 'Avro'
'AvroDeflate'
'JSON'
تنسيق اسم الملف تنسيق اسم الملف للكائن الثنائي كبير الحجم. التنسيق الافتراضي هو {iothub}/{partition}/{YYYY}/{MM}/{DD}/{HH}/{mm}. جميع المعلمات إلزامية ولكن يمكن إعادة ترتيبها. خيط
maxChunkSizeInBytes الحد الأقصى لعدد وحدات البايت لكل كائن ثنائي كبير الحجم مكتوب إلى التخزين. يجب أن تكون القيمة بين 10485760 (10 ميغابايت) 524288000(500 ميغابايت). القيمة الافتراضية هي 314572800 (300 ميغابايت). الباحث

القيود:
قيمة الحد الأدنى = 10485760
القيمة القصوى = 524288000
اسم الاسم الذي يعرف نقطة النهاية هذه. يمكن أن يتضمن الاسم الأحرف الأبجدية الرقمية والنقاط والتسطير السفلي والواصلات بحد أقصى 64 حرفا. الأسماء التالية محجوزة: الأحداث، fileNotifications، $default. يجب أن تكون أسماء نقاط النهاية فريدة عبر أنواع نقاط النهاية. خيط

القيود:
النمط = ^[A-Za-z0-9-._]{1,64}$ (مطلوب)
مجموعة الموارد اسم مجموعة الموارد لحساب التخزين. خيط
معرف الاشتراك معرف الاشتراك لحساب التخزين. خيط

SharedAccessSignatureAuthorizationRule

اسم وصف قيمة
اسم المفتاح اسم نهج الوصول المشترك. سلسلة (مطلوب)
مفتاح أساسي المفتاح الأساسي. خيط
حقوق الأذونات المعينة لنهج الوصول المشترك. 'اتصال الجهاز'
"قراءة السجل"
"RegistryRead, DeviceConnect"
"RegistryRead, RegistryWrite"
'RegistryRead, RegistryWrite, DeviceConnect'
'RegistryRead, RegistryWrite, ServiceConnect'
'RegistryRead, RegistryWrite, ServiceConnect, DeviceConnect'
"RegistryRead, ServiceConnect"
'RegistryRead, ServiceConnect, DeviceConnect'
"RegistryWrite"
"RegistryWrite, DeviceConnect"
"RegistryWrite, ServiceConnect"
'RegistryWrite, ServiceConnect, DeviceConnect'
"اتصال الخدمة"
"ServiceConnect, DeviceConnect" (مطلوب)
مفتاح ثانوي المفتاح الثانوي. خيط

خصائص StorageEndpoint

اسم وصف قيمة
سلسلة الاتصال سلسلة الاتصال لحساب Azure Storage الذي يتم تحميل الملفات إليه. سلسلة (مطلوب)
اسم الحاوية اسم حاوية الجذر حيث تقوم بتحميل الملفات. الحاوية غير موجودة ولكن يجب أن تكون قابلة لل creatable باستخدام connectionString المحدد. سلسلة (مطلوب)
sasTtlAsIso8601 الفترة الزمنية التي يكون فيها SAS URI الذي تم إنشاؤه بواسطة IoT Hub لتحميل الملف صالحا. راجع: /azure/iot-hub/iot-hub-devguide-file-upload#file-upload-notification-configuration-options. خيط

أمثلة الاستخدام

نماذج Azure Quickstart

تحتوي قوالب Azure Quickstart التالية على نماذج Bicep لنشر نوع المورد هذا.

ملف Bicep وصف
إنشاء مركز IoT وجهاز إلى مجموعة المستهلكين السحابية يمكنك هذا القالب من نشر مثيل IoT Hub مع جهاز على السحابة والسحابة إلى تكوينات مراسلة الجهاز وجهاز إلى مجموعة مستهلكي السحابة.
إنشاء خدمة توفير جهاز IoT Hub يمكنك هذا القالب من إنشاء مركز IoT وخدمة توفير جهاز IoT Hub، وربط الخدمتين معا.
إنشاء تحديث الجهاز لحساب IoT Hub، المثيل، IoT Hub ينشئ هذا القالب حسابا ومثيلا ومركزا لربط المثيل به. يقوم بتكوين المركز مع نهج الوصول الضرورية والمسارات ومجموعة المستهلكين.
نشر خدمة MedTech بما في ذلك Azure IoT Hub خدمة MedTech هي واحدة من Azure Health Data Services المصممة لاستيعاب بيانات الجهاز من أجهزة متعددة، وتحويل بيانات الجهاز إلى ملاحظات FHIR، والتي تستمر بعد ذلك في خدمة Azure Health Data Services FHIR.
استخدام قالب ARM لإنشاء IoT Hub وتوجيه الرسائل وعرضها استخدم هذا القالب لنشر IoT Hub وحساب تخزين. قم بتشغيل تطبيق لإرسال رسائل إلى المركز التي يتم توجيهها إلى التخزين، ثم عرض النتائج.

تعريف مورد قالب ARM

يمكن نشر نوع مورد IotHubs مع العمليات التي تستهدف:

  • مجموعات الموارد - راجع أوامر نشر مجموعة الموارد

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

تنسيق المورد

لإنشاء مورد Microsoft.Devices/IotHubs، أضف JSON التالي إلى القالب الخاص بك.

{
  "type": "Microsoft.Devices/IotHubs",
  "apiVersion": "2019-11-04",
  "name": "string",
  "etag": "string",
  "location": "string",
  "properties": {
    "authorizationPolicies": [
      {
        "keyName": "string",
        "primaryKey": "string",
        "rights": "string",
        "secondaryKey": "string"
      }
    ],
    "cloudToDevice": {
      "defaultTtlAsIso8601": "string",
      "feedback": {
        "lockDurationAsIso8601": "string",
        "maxDeliveryCount": "int",
        "ttlAsIso8601": "string"
      },
      "maxDeliveryCount": "int"
    },
    "comments": "string",
    "enableFileUploadNotifications": "bool",
    "eventHubEndpoints": {
      "{customized property}": {
        "partitionCount": "int",
        "retentionTimeInDays": "int"
      }
    },
    "features": "string",
    "ipFilterRules": [
      {
        "action": "string",
        "filterName": "string",
        "ipMask": "string"
      }
    ],
    "messagingEndpoints": {
      "{customized property}": {
        "lockDurationAsIso8601": "string",
        "maxDeliveryCount": "int",
        "ttlAsIso8601": "string"
      }
    },
    "routing": {
      "endpoints": {
        "eventHubs": [
          {
            "connectionString": "string",
            "name": "string",
            "resourceGroup": "string",
            "subscriptionId": "string"
          }
        ],
        "serviceBusQueues": [
          {
            "connectionString": "string",
            "name": "string",
            "resourceGroup": "string",
            "subscriptionId": "string"
          }
        ],
        "serviceBusTopics": [
          {
            "connectionString": "string",
            "name": "string",
            "resourceGroup": "string",
            "subscriptionId": "string"
          }
        ],
        "storageContainers": [
          {
            "batchFrequencyInSeconds": "int",
            "connectionString": "string",
            "containerName": "string",
            "encoding": "string",
            "fileNameFormat": "string",
            "maxChunkSizeInBytes": "int",
            "name": "string",
            "resourceGroup": "string",
            "subscriptionId": "string"
          }
        ]
      },
      "enrichments": [
        {
          "endpointNames": [ "string" ],
          "key": "string",
          "value": "string"
        }
      ],
      "fallbackRoute": {
        "condition": "string",
        "endpointNames": [ "string" ],
        "isEnabled": "bool",
        "name": "string",
        "source": "string"
      },
      "routes": [
        {
          "condition": "string",
          "endpointNames": [ "string" ],
          "isEnabled": "bool",
          "name": "string",
          "source": "string"
        }
      ]
    },
    "storageEndpoints": {
      "{customized property}": {
        "connectionString": "string",
        "containerName": "string",
        "sasTtlAsIso8601": "string"
      }
    }
  },
  "sku": {
    "capacity": "int",
    "name": "string"
  },
  "tags": {
    "{customized property}": "string"
  }
}

قيم الخصائص

خصائص جهاز السحابة

اسم وصف قيمة
defaultTtlAsIso8601 الوقت الافتراضي للعيش للرسائل من السحابة إلى الجهاز في قائمة انتظار الجهاز. راجع: /azure/iot-hub/iot-hub-devguide-messaging#cloud-to-device-messages. خيط
ردود الفعل خصائص قائمة انتظار الملاحظات للرسائل من السحابة إلى الجهاز. FeedbackProperties
maxDeliveryCount الحد الأقصى لعدد التسليم للرسائل من السحابة إلى الجهاز في قائمة انتظار الجهاز. راجع: /azure/iot-hub/iot-hub-devguide-messaging#cloud-to-device-messages. الباحث

القيود:
قيمة الحد الأدنى = 1
القيمة القصوى = 100

خصائص الإثراء

اسم وصف قيمة
أسماء نقاط النهاية قائمة نقاط النهاية التي يتم تطبيق الإثراء عليها على الرسالة. string[] (مطلوبة)
مفتاح مفتاح أو اسم خاصية الإثراء. سلسلة (مطلوب)
قيمة قيمة خاصية الإثراء. سلسلة (مطلوب)

خصائص EventHub

اسم وصف قيمة
عدد الأقسام عدد الأقسام لتلقي رسائل من جهاز إلى سحابة في نقطة النهاية المتوافقة مع Event Hub. راجع: /azure/iot-hub/iot-hub-devguide-messaging#device-to-cloud-messages. الباحث
retentionTimeInDays وقت الاستبقاء للرسائل من جهاز إلى سحابة بالأيام. راجع: /azure/iot-hub/iot-hub-devguide-messaging#device-to-cloud-messages الباحث

الخصائص الاحتياطية للRoute

اسم وصف قيمة
شرط الشرط الذي يتم تقييمه من أجل تطبيق المسار الاحتياطي. إذا لم يتم توفير الشرط، تقييمه إلى صحيح بشكل افتراضي. للتدقيق النحوي، راجع: /azure/iot-hub/iot-hub-devguide-query-language خيط
أسماء نقاط النهاية قائمة نقاط النهاية التي يتم توجيه الرسائل التي تفي بالشرط إليها. يسمح حاليا بنقطة نهاية واحدة فقط. string[] (مطلوبة)
isEnabled يستخدم لتحديد ما إذا كان المسار الاحتياطي ممكنا أم لا. bool (مطلوب)
اسم اسم المسار. يمكن أن يتضمن الاسم فقط الأحرف الأبجدية الرقمية والنقاط والتسطير السفلي والواصلات، بحد أقصى 64 حرفا، ويجب أن يكون فريدا. خيط
مصدر المصدر الذي سيتم تطبيق قاعدة التوجيه عليه. على سبيل المثال، DeviceMessages "أحداث دورة حياة الجهاز"
"أحداث دورة حياة الجهاز"
"رسائل الجهاز"
"غير صالح"
'TwinChangeEvents' (مطلوب)

خصائص الملاحظات

اسم وصف قيمة
lockDurationAsIso8601 مدة تأمين قائمة انتظار الملاحظات. راجع: /azure/iot-hub/iot-hub-devguide-messaging#cloud-to-device-messages. خيط
maxDeliveryCount عدد المرات التي يحاول فيها مركز IoT تسليم رسالة في قائمة انتظار الملاحظات. راجع: /azure/iot-hub/iot-hub-devguide-messaging#cloud-to-device-messages. الباحث

القيود:
قيمة الحد الأدنى = 1
القيمة القصوى = 100
ttlAsIso8601 الفترة الزمنية التي تتوفر فيها الرسالة للاستهلاك قبل انتهاء صلاحيتها بواسطة مركز IoT. راجع: /azure/iot-hub/iot-hub-devguide-messaging#cloud-to-device-messages. خيط

خصائص IotHub

اسم وصف قيمة
نهج التخويل نهج الوصول المشتركة التي يمكنك استخدامها لتأمين اتصال بمركز IoT. SharedAccessSignatureAuthorizationRule[]
cloudToDevice خصائص المراسلة من سحابة إلى جهاز لمركز IoT. CloudToDeviceProperties
التعليقات تعليقات مركز IoT. خيط
enableFileUploadNotifications إذا كانت True، يتم تمكين إعلامات تحميل الملفات. قيمة منطقية
نقاط نهاية eventHub خصائص نقطة النهاية المتوافقة مع Event Hub. المفاتيح الوحيدة الممكنة لهذا القاموس هي الأحداث. يجب أن يكون هذا المفتاح موجودا في القاموس أثناء إجراء مكالمات إنشاء أو تحديث لمركز IoT. IotHubPropertiesEventHubEndpoints
ملامح الإمكانات والميزات الممكنة لمركز IoT. "إدارة الجهاز"
"بلا"
ipFilterRules قواعد عامل تصفية IP. IpFilterRule[]
نقاط نهاية المراسلة خصائص نقطة نهاية المراسلة لقائمة انتظار إعلام تحميل الملف. IotHubPropertiesMessagingEndpoints
التوجيه الخصائص ذات الصلة للتوجيه لمركز IoT. راجع: /azure/iot-hub/iot-hub-devguide-messaging RoutingProperties
نقاط نهاية التخزين قائمة نقاط نهاية Azure Storage حيث يمكنك تحميل الملفات. يمكنك حاليا تكوين حساب Azure Storage واحد فقط ويجب أن يكون مفتاحه $default. يؤدي تحديد أكثر من حساب تخزين واحد إلى طرح خطأ. يؤدي عدم تحديد قيمة لهذه الخاصية عند تعيين الخاصية enableFileUploadNotifications إلى True إلى ظهور خطأ. IotHubPropertiesStorageEndpoints

نقاط نهاية IotHubPropertiesEventHub

اسم وصف قيمة

IotHubPropertiesMessagingEndpoints

اسم وصف قيمة

IotHubPropertiesStorageEndpoints

اسم وصف قيمة

معلومات IotHubSku

اسم وصف قيمة
سعة عدد وحدات IoT Hub المتوفرة. راجع: /azure/azure-subscription-service-limits#iot-hub-limits. الباحث
اسم اسم SKU. 'B1'
'B2'
'B3'
'F1'
'S1'
'S2'
'S3' (مطلوب)

IpFilterRule

اسم وصف قيمة
فعل الإجراء المطلوب للطلبات التي تم التقاطها بواسطة هذه القاعدة. "قبول"
"رفض" (مطلوب)
اسم عامل التصفية اسم قاعدة عامل تصفية IP. سلسلة (مطلوب)
ipMask سلسلة تحتوي على نطاق عنوان IP في رمز CIDR للقاعدة. سلسلة (مطلوب)

خصائص نقطة نهاية المراسلة

اسم وصف قيمة
lockDurationAsIso8601 مدة التأمين. راجع: /azure/iot-hub/iot-hub-devguide-file-upload. خيط
maxDeliveryCount عدد المرات التي يحاول فيها مركز IoT تسليم رسالة. راجع: /azure/iot-hub/iot-hub-devguide-file-upload. الباحث

القيود:
قيمة الحد الأدنى = 1
القيمة القصوى = 100
ttlAsIso8601 الفترة الزمنية التي تتوفر فيها الرسالة للاستهلاك قبل انتهاء صلاحيتها بواسطة مركز IoT. راجع: /azure/iot-hub/iot-hub-devguide-file-upload. خيط

Microsoft.Devices/IotHubs

اسم وصف قيمة
apiVersion إصدار واجهة برمجة التطبيقات '2019-11-04'
etag حقل Etag غير مطلوب . إذا تم توفيره في نص الاستجابة، يجب أيضا توفيره كعنوان وفقا لاصطلاح ETag العادي. خيط
مكان موقع المورد. سلسلة (مطلوب)
اسم اسم المورد سلسلة (مطلوب)
خصائص خصائص IotHub IotHubProperties
سكو معلومات IotHub SKU IotHubSkuInfo (مطلوب)
العلامات علامات الموارد قاموس أسماء العلامات والقيم. راجع العلامات في القوالب
نوع نوع المورد 'Microsoft.Devices/IotHubs'

علامات تعريف الموارد

اسم وصف قيمة

خصائص المسار

اسم وصف قيمة
شرط الشرط الذي يتم تقييمه لتطبيق قاعدة التحويل. إذا لم يتم توفير أي شرط، يتم تقييمه إلى صحيح بشكل افتراضي. للتدقيق النحوي، راجع: /azure/iot-hub/iot-hub-devguide-query-language خيط
أسماء نقاط النهاية قائمة نقاط النهاية التي يتم توجيه الرسائل التي تفي بالشرط. يسمح حاليا بنقطة نهاية واحدة فقط. string[] (مطلوبة)
isEnabled يستخدم لتحديد ما إذا كان المسار ممكنا أم لا. bool (مطلوب)
اسم اسم المسار. يمكن أن يتضمن الاسم فقط الأحرف الأبجدية الرقمية والنقاط والتسطير السفلي والواصلات، بحد أقصى 64 حرفا، ويجب أن يكون فريدا. خيط

القيود:
النمط = ^[A-Za-z0-9-._]{1,64}$ (مطلوب)
مصدر المصدر الذي سيتم تطبيق قاعدة التوجيه عليه، مثل DeviceMessages. "أحداث دورة حياة الجهاز"
"أحداث دورة حياة الجهاز"
"رسائل الجهاز"
"غير صالح"
'TwinChangeEvents' (مطلوب)

نقاط نهاية التوجيه

اسم وصف قيمة
eventHubs قائمة نقاط نهاية مراكز الأحداث التي يوجه مركز IoT الرسائل إليها، استنادا إلى قواعد التوجيه. لا تتضمن هذه القائمة نقطة نهاية مراكز الأحداث المضمنة. RoutingEventHubProperties []
serviceBusQueues قائمة نقاط نهاية قائمة انتظار ناقل خدمة Microsoft Azure التي يوجه مركز IoT الرسائل إليها، استنادا إلى قواعد التوجيه. RoutingServiceBusQueueEndpointProperties[]
serviceBusTopics قائمة نقاط نهاية موضوع ناقل خدمة Microsoft Azure التي يوجه مركز IoT الرسائل إليها، استنادا إلى قواعد التوجيه. RoutingServiceBusTopicEndpointProperties[]
مكونات التخزين قائمة نقاط نهاية حاوية التخزين التي يوجه مركز IoT الرسائل إليها، استنادا إلى قواعد التوجيه. RoutingStorageContainerProperties[]

RoutingEventHubProperties

اسم وصف قيمة
سلسلة الاتصال سلسلة الاتصال لنقطة نهاية مركز الحدث. سلسلة (مطلوب)
اسم الاسم الذي يعرف نقطة النهاية هذه. يمكن أن يتضمن الاسم الأحرف الأبجدية الرقمية والنقاط والتسطير السفلي والواصلات بحد أقصى 64 حرفا. الأسماء التالية محجوزة: الأحداث، fileNotifications، $default. يجب أن تكون أسماء نقاط النهاية فريدة عبر أنواع نقاط النهاية. خيط

القيود:
النمط = ^[A-Za-z0-9-._]{1,64}$ (مطلوب)
مجموعة الموارد اسم مجموعة الموارد لنقطة نهاية مركز الحدث. خيط
معرف الاشتراك معرف الاشتراك لنقطة نهاية مركز الحدث. خيط

خصائص التوجيه

اسم وصف قيمة
النهايه الخصائص المتعلقة بنقاط النهاية المخصصة التي يوجه إليها مركز IoT الرسائل استنادا إلى قواعد التوجيه. يسمح بحد أقصى 10 نقاط نهاية مخصصة عبر جميع أنواع نقاط النهاية للموزعات المدفوعة ويسمح بنقطة نهاية مخصصة واحدة فقط عبر جميع أنواع نقاط النهاية للمراكز المجانية. RoutingEndpoints
عمليات الإثراء قائمة عمليات الإثراء التي يوفرها المستخدم والتي ينطبق عليها مركز IoT على الرسائل التي سيتم تسليمها إلى نقاط النهاية المضمنة والمخصصة. راجع: https://aka.ms/telemetryoneventgrid خصائص الإثراء []
مسار احتياطي خصائص المسار المستخدم كمسار احتياطي عند عدم استيفاء أي من الشروط المحددة في قسم "المسارات". هذه معلمة اختيارية. عند عدم تعيين هذه الخاصية، يتم توجيه الرسائل التي لا تفي بأي من الشروط المحددة في قسم "المسارات" إلى نقطة النهاية eventhub المضمنة. FallbackRouteProperties
طرق قائمة قواعد التوجيه التي يوفرها المستخدم والتي يستخدمها مركز IoT لتوجيه الرسائل إلى نقاط النهاية المضمنة والمخصصة. يسمح بحد أقصى 100 قاعدة توجيه لمراكز الدفع ويسمح بحد أقصى 5 قواعد للتوجيه للمراكز المجانية. RouteProperties []

RoutingServiceBusQueueEndpointProperties

اسم وصف قيمة
سلسلة الاتصال سلسلة الاتصال لنقطة نهاية قائمة انتظار ناقل الخدمة. سلسلة (مطلوب)
اسم الاسم الذي يعرف نقطة النهاية هذه. يمكن أن يتضمن الاسم الأحرف الأبجدية الرقمية والنقاط والتسطير السفلي والواصلات بحد أقصى 64 حرفا. الأسماء التالية محجوزة: الأحداث، fileNotifications، $default. يجب أن تكون أسماء نقاط النهاية فريدة عبر أنواع نقاط النهاية. لا يجب أن يكون الاسم هو نفس اسم قائمة الانتظار الفعلي. خيط

القيود:
النمط = ^[A-Za-z0-9-._]{1,64}$ (مطلوب)
مجموعة الموارد اسم مجموعة الموارد لنقطة نهاية قائمة انتظار ناقل الخدمة. خيط
معرف الاشتراك معرف الاشتراك لنقطة نهاية قائمة انتظار ناقل الخدمة. خيط

RoutingServiceBusTopicEndpointProperties

اسم وصف قيمة
سلسلة الاتصال سلسلة الاتصال لنقطة نهاية موضوع ناقل الخدمة. سلسلة (مطلوب)
اسم الاسم الذي يعرف نقطة النهاية هذه. يمكن أن يتضمن الاسم الأحرف الأبجدية الرقمية والنقاط والتسطير السفلي والواصلات بحد أقصى 64 حرفا. الأسماء التالية محجوزة: الأحداث، fileNotifications، $default. يجب أن تكون أسماء نقاط النهاية فريدة عبر أنواع نقاط النهاية. لا يجب أن يكون الاسم هو نفس اسم الموضوع الفعلي. خيط

القيود:
النمط = ^[A-Za-z0-9-._]{1,64}$ (مطلوب)
مجموعة الموارد اسم مجموعة الموارد لنقطة نهاية موضوع ناقل الخدمة. خيط
معرف الاشتراك معرف الاشتراك لنقطة نهاية موضوع ناقل الخدمة. خيط

RoutingStorageContainerProperties

اسم وصف قيمة
batchFrequencyInSeconds الفاصل الزمني الذي تتم فيه كتابة الكائنات الثنائية كبيرة الحجم إلى التخزين. يجب أن تتراوح القيمة بين 60 و720 ثانية. القيمة الافتراضية هي 300 ثانية. الباحث

القيود:
قيمة الحد الأدنى = 60
القيمة القصوى = 720
سلسلة الاتصال سلسلة الاتصال لحساب التخزين. سلسلة (مطلوب)
اسم الحاوية اسم حاوية التخزين في حساب التخزين. سلسلة (مطلوب)
ترميز الترميز المستخدم لتسلسل الرسائل إلى الكائنات الثنائية كبيرة الحجم. القيم المدعومة هي "avro" و"avrodeflate" و"JSON". القيمة الافتراضية هي "avro". 'Avro'
'AvroDeflate'
'JSON'
تنسيق اسم الملف تنسيق اسم الملف للكائن الثنائي كبير الحجم. التنسيق الافتراضي هو {iothub}/{partition}/{YYYY}/{MM}/{DD}/{HH}/{mm}. جميع المعلمات إلزامية ولكن يمكن إعادة ترتيبها. خيط
maxChunkSizeInBytes الحد الأقصى لعدد وحدات البايت لكل كائن ثنائي كبير الحجم مكتوب إلى التخزين. يجب أن تكون القيمة بين 10485760 (10 ميغابايت) 524288000(500 ميغابايت). القيمة الافتراضية هي 314572800 (300 ميغابايت). الباحث

القيود:
قيمة الحد الأدنى = 10485760
القيمة القصوى = 524288000
اسم الاسم الذي يعرف نقطة النهاية هذه. يمكن أن يتضمن الاسم الأحرف الأبجدية الرقمية والنقاط والتسطير السفلي والواصلات بحد أقصى 64 حرفا. الأسماء التالية محجوزة: الأحداث، fileNotifications، $default. يجب أن تكون أسماء نقاط النهاية فريدة عبر أنواع نقاط النهاية. خيط

القيود:
النمط = ^[A-Za-z0-9-._]{1,64}$ (مطلوب)
مجموعة الموارد اسم مجموعة الموارد لحساب التخزين. خيط
معرف الاشتراك معرف الاشتراك لحساب التخزين. خيط

SharedAccessSignatureAuthorizationRule

اسم وصف قيمة
اسم المفتاح اسم نهج الوصول المشترك. سلسلة (مطلوب)
مفتاح أساسي المفتاح الأساسي. خيط
حقوق الأذونات المعينة لنهج الوصول المشترك. 'اتصال الجهاز'
"قراءة السجل"
"RegistryRead, DeviceConnect"
"RegistryRead, RegistryWrite"
'RegistryRead, RegistryWrite, DeviceConnect'
'RegistryRead, RegistryWrite, ServiceConnect'
'RegistryRead, RegistryWrite, ServiceConnect, DeviceConnect'
"RegistryRead, ServiceConnect"
'RegistryRead, ServiceConnect, DeviceConnect'
"RegistryWrite"
"RegistryWrite, DeviceConnect"
"RegistryWrite, ServiceConnect"
'RegistryWrite, ServiceConnect, DeviceConnect'
"اتصال الخدمة"
"ServiceConnect, DeviceConnect" (مطلوب)
مفتاح ثانوي المفتاح الثانوي. خيط

خصائص StorageEndpoint

اسم وصف قيمة
سلسلة الاتصال سلسلة الاتصال لحساب Azure Storage الذي يتم تحميل الملفات إليه. سلسلة (مطلوب)
اسم الحاوية اسم حاوية الجذر حيث تقوم بتحميل الملفات. الحاوية غير موجودة ولكن يجب أن تكون قابلة لل creatable باستخدام connectionString المحدد. سلسلة (مطلوب)
sasTtlAsIso8601 الفترة الزمنية التي يكون فيها SAS URI الذي تم إنشاؤه بواسطة IoT Hub لتحميل الملف صالحا. راجع: /azure/iot-hub/iot-hub-devguide-file-upload#file-upload-notification-configuration-options. خيط

أمثلة الاستخدام

قوالب Azure Quickstart

قوالب Azure Quickstart التالية توزيع نوع المورد هذا.

قالب وصف
إنشاء بيئة الدفع حسب الاستخدام (PAYG) باستخدام مركز IoT

Deploy to Azure
يمكنك هذا القالب من نشر بيئة Pay As You Go (PAYG) Time Series Insights التي تم تكوينها لاستهلاك الأحداث من IoT Hub.
إنشاء مركز IoT وجهاز إلى مجموعة المستهلكين السحابية

Deploy to Azure
يمكنك هذا القالب من نشر مثيل IoT Hub مع جهاز على السحابة والسحابة إلى تكوينات مراسلة الجهاز وجهاز إلى مجموعة مستهلكي السحابة.
إنشاء محاكي IOT Hub وUbuntu edge

Deploy to Azure
ينشئ هذا القالب محاكي حافة IOT Hub وVirtual Machine Ubuntu.
إنشاء خدمة توفير جهاز IoT Hub

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

Deploy to Azure
ينشئ هذا القالب حسابا ومثيلا ومركزا لربط المثيل به. يقوم بتكوين المركز مع نهج الوصول الضرورية والمسارات ومجموعة المستهلكين.
نشر خدمة MedTech بما في ذلك Azure IoT Hub

Deploy to Azure
خدمة MedTech هي واحدة من Azure Health Data Services المصممة لاستيعاب بيانات الجهاز من أجهزة متعددة، وتحويل بيانات الجهاز إلى ملاحظات FHIR، والتي تستمر بعد ذلك في خدمة Azure Health Data Services FHIR.
استخدام قالب ARM لإنشاء IoT Hub وتوجيه الرسائل وعرضها

Deploy to Azure
استخدم هذا القالب لنشر IoT Hub وحساب تخزين. قم بتشغيل تطبيق لإرسال رسائل إلى المركز التي يتم توجيهها إلى التخزين، ثم عرض النتائج.

تعريف مورد Terraform (موفر AzAPI)

يمكن نشر نوع مورد IotHubs مع العمليات التي تستهدف:

  • مجموعات الموارد

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

تنسيق المورد

لإنشاء مورد Microsoft.Devices/IotHubs، أضف Terraform التالي إلى القالب الخاص بك.

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.Devices/IotHubs@2019-11-04"
  name = "string"
  location = "string"
  tags = {
    {customized property} = "string"
  }
  body = {
    etag = "string"
    properties = {
      authorizationPolicies = [
        {
          keyName = "string"
          primaryKey = "string"
          rights = "string"
          secondaryKey = "string"
        }
      ]
      cloudToDevice = {
        defaultTtlAsIso8601 = "string"
        feedback = {
          lockDurationAsIso8601 = "string"
          maxDeliveryCount = int
          ttlAsIso8601 = "string"
        }
        maxDeliveryCount = int
      }
      comments = "string"
      enableFileUploadNotifications = bool
      eventHubEndpoints = {
        {customized property} = {
          partitionCount = int
          retentionTimeInDays = int
        }
      }
      features = "string"
      ipFilterRules = [
        {
          action = "string"
          filterName = "string"
          ipMask = "string"
        }
      ]
      messagingEndpoints = {
        {customized property} = {
          lockDurationAsIso8601 = "string"
          maxDeliveryCount = int
          ttlAsIso8601 = "string"
        }
      }
      routing = {
        endpoints = {
          eventHubs = [
            {
              connectionString = "string"
              name = "string"
              resourceGroup = "string"
              subscriptionId = "string"
            }
          ]
          serviceBusQueues = [
            {
              connectionString = "string"
              name = "string"
              resourceGroup = "string"
              subscriptionId = "string"
            }
          ]
          serviceBusTopics = [
            {
              connectionString = "string"
              name = "string"
              resourceGroup = "string"
              subscriptionId = "string"
            }
          ]
          storageContainers = [
            {
              batchFrequencyInSeconds = int
              connectionString = "string"
              containerName = "string"
              encoding = "string"
              fileNameFormat = "string"
              maxChunkSizeInBytes = int
              name = "string"
              resourceGroup = "string"
              subscriptionId = "string"
            }
          ]
        }
        enrichments = [
          {
            endpointNames = [
              "string"
            ]
            key = "string"
            value = "string"
          }
        ]
        fallbackRoute = {
          condition = "string"
          endpointNames = [
            "string"
          ]
          isEnabled = bool
          name = "string"
          source = "string"
        }
        routes = [
          {
            condition = "string"
            endpointNames = [
              "string"
            ]
            isEnabled = bool
            name = "string"
            source = "string"
          }
        ]
      }
      storageEndpoints = {
        {customized property} = {
          connectionString = "string"
          containerName = "string"
          sasTtlAsIso8601 = "string"
        }
      }
    }
    sku = {
      capacity = int
      name = "string"
    }
  }
}

قيم الخصائص

خصائص جهاز السحابة

اسم وصف قيمة
defaultTtlAsIso8601 الوقت الافتراضي للعيش للرسائل من السحابة إلى الجهاز في قائمة انتظار الجهاز. راجع: /azure/iot-hub/iot-hub-devguide-messaging#cloud-to-device-messages. خيط
ردود الفعل خصائص قائمة انتظار الملاحظات للرسائل من السحابة إلى الجهاز. FeedbackProperties
maxDeliveryCount الحد الأقصى لعدد التسليم للرسائل من السحابة إلى الجهاز في قائمة انتظار الجهاز. راجع: /azure/iot-hub/iot-hub-devguide-messaging#cloud-to-device-messages. الباحث

القيود:
قيمة الحد الأدنى = 1
القيمة القصوى = 100

خصائص الإثراء

اسم وصف قيمة
أسماء نقاط النهاية قائمة نقاط النهاية التي يتم تطبيق الإثراء عليها على الرسالة. string[] (مطلوبة)
مفتاح مفتاح أو اسم خاصية الإثراء. سلسلة (مطلوب)
قيمة قيمة خاصية الإثراء. سلسلة (مطلوب)

خصائص EventHub

اسم وصف قيمة
عدد الأقسام عدد الأقسام لتلقي رسائل من جهاز إلى سحابة في نقطة النهاية المتوافقة مع Event Hub. راجع: /azure/iot-hub/iot-hub-devguide-messaging#device-to-cloud-messages. الباحث
retentionTimeInDays وقت الاستبقاء للرسائل من جهاز إلى سحابة بالأيام. راجع: /azure/iot-hub/iot-hub-devguide-messaging#device-to-cloud-messages الباحث

الخصائص الاحتياطية للRoute

اسم وصف قيمة
شرط الشرط الذي يتم تقييمه من أجل تطبيق المسار الاحتياطي. إذا لم يتم توفير الشرط، تقييمه إلى صحيح بشكل افتراضي. للتدقيق النحوي، راجع: /azure/iot-hub/iot-hub-devguide-query-language خيط
أسماء نقاط النهاية قائمة نقاط النهاية التي يتم توجيه الرسائل التي تفي بالشرط إليها. يسمح حاليا بنقطة نهاية واحدة فقط. string[] (مطلوبة)
isEnabled يستخدم لتحديد ما إذا كان المسار الاحتياطي ممكنا أم لا. bool (مطلوب)
اسم اسم المسار. يمكن أن يتضمن الاسم فقط الأحرف الأبجدية الرقمية والنقاط والتسطير السفلي والواصلات، بحد أقصى 64 حرفا، ويجب أن يكون فريدا. خيط
مصدر المصدر الذي سيتم تطبيق قاعدة التوجيه عليه. على سبيل المثال، DeviceMessages "أحداث دورة حياة الجهاز"
"أحداث دورة حياة الجهاز"
"رسائل الجهاز"
"غير صالح"
'TwinChangeEvents' (مطلوب)

خصائص الملاحظات

اسم وصف قيمة
lockDurationAsIso8601 مدة تأمين قائمة انتظار الملاحظات. راجع: /azure/iot-hub/iot-hub-devguide-messaging#cloud-to-device-messages. خيط
maxDeliveryCount عدد المرات التي يحاول فيها مركز IoT تسليم رسالة في قائمة انتظار الملاحظات. راجع: /azure/iot-hub/iot-hub-devguide-messaging#cloud-to-device-messages. الباحث

القيود:
قيمة الحد الأدنى = 1
القيمة القصوى = 100
ttlAsIso8601 الفترة الزمنية التي تتوفر فيها الرسالة للاستهلاك قبل انتهاء صلاحيتها بواسطة مركز IoT. راجع: /azure/iot-hub/iot-hub-devguide-messaging#cloud-to-device-messages. خيط

خصائص IotHub

اسم وصف قيمة
نهج التخويل نهج الوصول المشتركة التي يمكنك استخدامها لتأمين اتصال بمركز IoT. SharedAccessSignatureAuthorizationRule[]
cloudToDevice خصائص المراسلة من سحابة إلى جهاز لمركز IoT. CloudToDeviceProperties
التعليقات تعليقات مركز IoT. خيط
enableFileUploadNotifications إذا كانت True، يتم تمكين إعلامات تحميل الملفات. قيمة منطقية
نقاط نهاية eventHub خصائص نقطة النهاية المتوافقة مع Event Hub. المفاتيح الوحيدة الممكنة لهذا القاموس هي الأحداث. يجب أن يكون هذا المفتاح موجودا في القاموس أثناء إجراء مكالمات إنشاء أو تحديث لمركز IoT. IotHubPropertiesEventHubEndpoints
ملامح الإمكانات والميزات الممكنة لمركز IoT. "إدارة الجهاز"
"بلا"
ipFilterRules قواعد عامل تصفية IP. IpFilterRule[]
نقاط نهاية المراسلة خصائص نقطة نهاية المراسلة لقائمة انتظار إعلام تحميل الملف. IotHubPropertiesMessagingEndpoints
التوجيه الخصائص ذات الصلة للتوجيه لمركز IoT. راجع: /azure/iot-hub/iot-hub-devguide-messaging RoutingProperties
نقاط نهاية التخزين قائمة نقاط نهاية Azure Storage حيث يمكنك تحميل الملفات. يمكنك حاليا تكوين حساب Azure Storage واحد فقط ويجب أن يكون مفتاحه $default. يؤدي تحديد أكثر من حساب تخزين واحد إلى طرح خطأ. يؤدي عدم تحديد قيمة لهذه الخاصية عند تعيين الخاصية enableFileUploadNotifications إلى True إلى ظهور خطأ. IotHubPropertiesStorageEndpoints

نقاط نهاية IotHubPropertiesEventHub

اسم وصف قيمة

IotHubPropertiesMessagingEndpoints

اسم وصف قيمة

IotHubPropertiesStorageEndpoints

اسم وصف قيمة

معلومات IotHubSku

اسم وصف قيمة
سعة عدد وحدات IoT Hub المتوفرة. راجع: /azure/azure-subscription-service-limits#iot-hub-limits. الباحث
اسم اسم SKU. 'B1'
'B2'
'B3'
'F1'
'S1'
'S2'
'S3' (مطلوب)

IpFilterRule

اسم وصف قيمة
فعل الإجراء المطلوب للطلبات التي تم التقاطها بواسطة هذه القاعدة. "قبول"
"رفض" (مطلوب)
اسم عامل التصفية اسم قاعدة عامل تصفية IP. سلسلة (مطلوب)
ipMask سلسلة تحتوي على نطاق عنوان IP في رمز CIDR للقاعدة. سلسلة (مطلوب)

خصائص نقطة نهاية المراسلة

اسم وصف قيمة
lockDurationAsIso8601 مدة التأمين. راجع: /azure/iot-hub/iot-hub-devguide-file-upload. خيط
maxDeliveryCount عدد المرات التي يحاول فيها مركز IoT تسليم رسالة. راجع: /azure/iot-hub/iot-hub-devguide-file-upload. الباحث

القيود:
قيمة الحد الأدنى = 1
القيمة القصوى = 100
ttlAsIso8601 الفترة الزمنية التي تتوفر فيها الرسالة للاستهلاك قبل انتهاء صلاحيتها بواسطة مركز IoT. راجع: /azure/iot-hub/iot-hub-devguide-file-upload. خيط

Microsoft.Devices/IotHubs

اسم وصف قيمة
etag حقل Etag غير مطلوب . إذا تم توفيره في نص الاستجابة، يجب أيضا توفيره كعنوان وفقا لاصطلاح ETag العادي. خيط
مكان موقع المورد. سلسلة (مطلوب)
اسم اسم المورد سلسلة (مطلوب)
خصائص خصائص IotHub IotHubProperties
سكو معلومات IotHub SKU IotHubSkuInfo (مطلوب)
العلامات علامات الموارد قاموس أسماء العلامات والقيم.
نوع نوع المورد "Microsoft.Devices/IotHubs@2019-11-04"

علامات تعريف الموارد

اسم وصف قيمة

خصائص المسار

اسم وصف قيمة
شرط الشرط الذي يتم تقييمه لتطبيق قاعدة التحويل. إذا لم يتم توفير أي شرط، يتم تقييمه إلى صحيح بشكل افتراضي. للتدقيق النحوي، راجع: /azure/iot-hub/iot-hub-devguide-query-language خيط
أسماء نقاط النهاية قائمة نقاط النهاية التي يتم توجيه الرسائل التي تفي بالشرط. يسمح حاليا بنقطة نهاية واحدة فقط. string[] (مطلوبة)
isEnabled يستخدم لتحديد ما إذا كان المسار ممكنا أم لا. bool (مطلوب)
اسم اسم المسار. يمكن أن يتضمن الاسم فقط الأحرف الأبجدية الرقمية والنقاط والتسطير السفلي والواصلات، بحد أقصى 64 حرفا، ويجب أن يكون فريدا. خيط

القيود:
النمط = ^[A-Za-z0-9-._]{1,64}$ (مطلوب)
مصدر المصدر الذي سيتم تطبيق قاعدة التوجيه عليه، مثل DeviceMessages. "أحداث دورة حياة الجهاز"
"أحداث دورة حياة الجهاز"
"رسائل الجهاز"
"غير صالح"
'TwinChangeEvents' (مطلوب)

نقاط نهاية التوجيه

اسم وصف قيمة
eventHubs قائمة نقاط نهاية مراكز الأحداث التي يوجه مركز IoT الرسائل إليها، استنادا إلى قواعد التوجيه. لا تتضمن هذه القائمة نقطة نهاية مراكز الأحداث المضمنة. RoutingEventHubProperties []
serviceBusQueues قائمة نقاط نهاية قائمة انتظار ناقل خدمة Microsoft Azure التي يوجه مركز IoT الرسائل إليها، استنادا إلى قواعد التوجيه. RoutingServiceBusQueueEndpointProperties[]
serviceBusTopics قائمة نقاط نهاية موضوع ناقل خدمة Microsoft Azure التي يوجه مركز IoT الرسائل إليها، استنادا إلى قواعد التوجيه. RoutingServiceBusTopicEndpointProperties[]
مكونات التخزين قائمة نقاط نهاية حاوية التخزين التي يوجه مركز IoT الرسائل إليها، استنادا إلى قواعد التوجيه. RoutingStorageContainerProperties[]

RoutingEventHubProperties

اسم وصف قيمة
سلسلة الاتصال سلسلة الاتصال لنقطة نهاية مركز الحدث. سلسلة (مطلوب)
اسم الاسم الذي يعرف نقطة النهاية هذه. يمكن أن يتضمن الاسم الأحرف الأبجدية الرقمية والنقاط والتسطير السفلي والواصلات بحد أقصى 64 حرفا. الأسماء التالية محجوزة: الأحداث، fileNotifications، $default. يجب أن تكون أسماء نقاط النهاية فريدة عبر أنواع نقاط النهاية. خيط

القيود:
النمط = ^[A-Za-z0-9-._]{1,64}$ (مطلوب)
مجموعة الموارد اسم مجموعة الموارد لنقطة نهاية مركز الحدث. خيط
معرف الاشتراك معرف الاشتراك لنقطة نهاية مركز الحدث. خيط

خصائص التوجيه

اسم وصف قيمة
النهايه الخصائص المتعلقة بنقاط النهاية المخصصة التي يوجه إليها مركز IoT الرسائل استنادا إلى قواعد التوجيه. يسمح بحد أقصى 10 نقاط نهاية مخصصة عبر جميع أنواع نقاط النهاية للموزعات المدفوعة ويسمح بنقطة نهاية مخصصة واحدة فقط عبر جميع أنواع نقاط النهاية للمراكز المجانية. RoutingEndpoints
عمليات الإثراء قائمة عمليات الإثراء التي يوفرها المستخدم والتي ينطبق عليها مركز IoT على الرسائل التي سيتم تسليمها إلى نقاط النهاية المضمنة والمخصصة. راجع: https://aka.ms/telemetryoneventgrid خصائص الإثراء []
مسار احتياطي خصائص المسار المستخدم كمسار احتياطي عند عدم استيفاء أي من الشروط المحددة في قسم "المسارات". هذه معلمة اختيارية. عند عدم تعيين هذه الخاصية، يتم توجيه الرسائل التي لا تفي بأي من الشروط المحددة في قسم "المسارات" إلى نقطة النهاية eventhub المضمنة. FallbackRouteProperties
طرق قائمة قواعد التوجيه التي يوفرها المستخدم والتي يستخدمها مركز IoT لتوجيه الرسائل إلى نقاط النهاية المضمنة والمخصصة. يسمح بحد أقصى 100 قاعدة توجيه لمراكز الدفع ويسمح بحد أقصى 5 قواعد للتوجيه للمراكز المجانية. RouteProperties []

RoutingServiceBusQueueEndpointProperties

اسم وصف قيمة
سلسلة الاتصال سلسلة الاتصال لنقطة نهاية قائمة انتظار ناقل الخدمة. سلسلة (مطلوب)
اسم الاسم الذي يعرف نقطة النهاية هذه. يمكن أن يتضمن الاسم الأحرف الأبجدية الرقمية والنقاط والتسطير السفلي والواصلات بحد أقصى 64 حرفا. الأسماء التالية محجوزة: الأحداث، fileNotifications، $default. يجب أن تكون أسماء نقاط النهاية فريدة عبر أنواع نقاط النهاية. لا يجب أن يكون الاسم هو نفس اسم قائمة الانتظار الفعلي. خيط

القيود:
النمط = ^[A-Za-z0-9-._]{1,64}$ (مطلوب)
مجموعة الموارد اسم مجموعة الموارد لنقطة نهاية قائمة انتظار ناقل الخدمة. خيط
معرف الاشتراك معرف الاشتراك لنقطة نهاية قائمة انتظار ناقل الخدمة. خيط

RoutingServiceBusTopicEndpointProperties

اسم وصف قيمة
سلسلة الاتصال سلسلة الاتصال لنقطة نهاية موضوع ناقل الخدمة. سلسلة (مطلوب)
اسم الاسم الذي يعرف نقطة النهاية هذه. يمكن أن يتضمن الاسم الأحرف الأبجدية الرقمية والنقاط والتسطير السفلي والواصلات بحد أقصى 64 حرفا. الأسماء التالية محجوزة: الأحداث، fileNotifications، $default. يجب أن تكون أسماء نقاط النهاية فريدة عبر أنواع نقاط النهاية. لا يجب أن يكون الاسم هو نفس اسم الموضوع الفعلي. خيط

القيود:
النمط = ^[A-Za-z0-9-._]{1,64}$ (مطلوب)
مجموعة الموارد اسم مجموعة الموارد لنقطة نهاية موضوع ناقل الخدمة. خيط
معرف الاشتراك معرف الاشتراك لنقطة نهاية موضوع ناقل الخدمة. خيط

RoutingStorageContainerProperties

اسم وصف قيمة
batchFrequencyInSeconds الفاصل الزمني الذي تتم فيه كتابة الكائنات الثنائية كبيرة الحجم إلى التخزين. يجب أن تتراوح القيمة بين 60 و720 ثانية. القيمة الافتراضية هي 300 ثانية. الباحث

القيود:
قيمة الحد الأدنى = 60
القيمة القصوى = 720
سلسلة الاتصال سلسلة الاتصال لحساب التخزين. سلسلة (مطلوب)
اسم الحاوية اسم حاوية التخزين في حساب التخزين. سلسلة (مطلوب)
ترميز الترميز المستخدم لتسلسل الرسائل إلى الكائنات الثنائية كبيرة الحجم. القيم المدعومة هي "avro" و"avrodeflate" و"JSON". القيمة الافتراضية هي "avro". 'Avro'
'AvroDeflate'
'JSON'
تنسيق اسم الملف تنسيق اسم الملف للكائن الثنائي كبير الحجم. التنسيق الافتراضي هو {iothub}/{partition}/{YYYY}/{MM}/{DD}/{HH}/{mm}. جميع المعلمات إلزامية ولكن يمكن إعادة ترتيبها. خيط
maxChunkSizeInBytes الحد الأقصى لعدد وحدات البايت لكل كائن ثنائي كبير الحجم مكتوب إلى التخزين. يجب أن تكون القيمة بين 10485760 (10 ميغابايت) 524288000(500 ميغابايت). القيمة الافتراضية هي 314572800 (300 ميغابايت). الباحث

القيود:
قيمة الحد الأدنى = 10485760
القيمة القصوى = 524288000
اسم الاسم الذي يعرف نقطة النهاية هذه. يمكن أن يتضمن الاسم الأحرف الأبجدية الرقمية والنقاط والتسطير السفلي والواصلات بحد أقصى 64 حرفا. الأسماء التالية محجوزة: الأحداث، fileNotifications، $default. يجب أن تكون أسماء نقاط النهاية فريدة عبر أنواع نقاط النهاية. خيط

القيود:
النمط = ^[A-Za-z0-9-._]{1,64}$ (مطلوب)
مجموعة الموارد اسم مجموعة الموارد لحساب التخزين. خيط
معرف الاشتراك معرف الاشتراك لحساب التخزين. خيط

SharedAccessSignatureAuthorizationRule

اسم وصف قيمة
اسم المفتاح اسم نهج الوصول المشترك. سلسلة (مطلوب)
مفتاح أساسي المفتاح الأساسي. خيط
حقوق الأذونات المعينة لنهج الوصول المشترك. 'اتصال الجهاز'
"قراءة السجل"
"RegistryRead, DeviceConnect"
"RegistryRead, RegistryWrite"
'RegistryRead, RegistryWrite, DeviceConnect'
'RegistryRead, RegistryWrite, ServiceConnect'
'RegistryRead, RegistryWrite, ServiceConnect, DeviceConnect'
"RegistryRead, ServiceConnect"
'RegistryRead, ServiceConnect, DeviceConnect'
"RegistryWrite"
"RegistryWrite, DeviceConnect"
"RegistryWrite, ServiceConnect"
'RegistryWrite, ServiceConnect, DeviceConnect'
"اتصال الخدمة"
"ServiceConnect, DeviceConnect" (مطلوب)
مفتاح ثانوي المفتاح الثانوي. خيط

خصائص StorageEndpoint

اسم وصف قيمة
سلسلة الاتصال سلسلة الاتصال لحساب Azure Storage الذي يتم تحميل الملفات إليه. سلسلة (مطلوب)
اسم الحاوية اسم حاوية الجذر حيث تقوم بتحميل الملفات. الحاوية غير موجودة ولكن يجب أن تكون قابلة لل creatable باستخدام connectionString المحدد. سلسلة (مطلوب)
sasTtlAsIso8601 الفترة الزمنية التي يكون فيها SAS URI الذي تم إنشاؤه بواسطة IoT Hub لتحميل الملف صالحا. راجع: /azure/iot-hub/iot-hub-devguide-file-upload#file-upload-notification-configuration-options. خيط