Microsoft.Devices IotHubs 2021-02-01-preview

مقالة
10/26/2024

أحدث
2023-06-30
معاينة 2023-06-30
معاينة 2022-11-15
2022-04-30-معاينة
2021-07-02
معاينة 2021-07-02
2021-07-01
معاينة 2021-07-01
2021-03-31
2021-03-03-preview
2021-02-01-معاينة
2020-08-31
2020-08-31-معاينة
2020-08-01
معاينة 2020-07-10
2020-06-15
2020-04-01
2020-03-01
2019-11-04
2019-07-01-معاينة
2019-03-22
معاينة 2019-03-22
معاينة 2018-12-01
2018-04-01
2018-01-22
2017-07-01
2017-01-19
2016-02-03

تعريف مورد Bicep

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

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

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

تنسيق المورد

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

resource symbolicname 'Microsoft.Devices/IotHubs@2021-02-01-preview' = {
  etag: 'string'
  identity: {
    type: 'string'
    userAssignedIdentities: {
      {customized property}: {}
    }
  }
  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'
    deviceStreams: {
      streamingEndpoints: [
        'string'
      ]
    }
    enableFileUploadNotifications: bool
    encryption: {
      keySource: 'string'
      keyVaultProperties: [
        {
          identity: {
            userAssignedIdentity: 'string'
          }
          keyIdentifier: 'string'
        }
      ]
    }
    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'
      }
    }
    minTlsVersion: 'string'
    networkRuleSets: {
      applyToBuiltInEventHubEndpoint: bool
      defaultAction: 'string'
      ipRules: [
        {
          action: 'string'
          filterName: 'string'
          ipMask: 'string'
        }
      ]
    }
    privateEndpointConnections: [
      {
        properties: {
          privateEndpoint: {}
          privateLinkServiceConnectionState: {
            actionsRequired: 'string'
            description: 'string'
            status: 'string'
          }
        }
      }
    ]
    publicNetworkAccess: 'string'
    routing: {
      endpoints: {
        eventHubs: [
          {
            authenticationType: 'string'
            connectionString: 'string'
            endpointUri: 'string'
            entityPath: 'string'
            id: 'string'
            name: 'string'
            resourceGroup: 'string'
            subscriptionId: 'string'
          }
        ]
        serviceBusQueues: [
          {
            authenticationType: 'string'
            connectionString: 'string'
            endpointUri: 'string'
            entityPath: 'string'
            id: 'string'
            name: 'string'
            resourceGroup: 'string'
            subscriptionId: 'string'
          }
        ]
        serviceBusTopics: [
          {
            authenticationType: 'string'
            connectionString: 'string'
            endpointUri: 'string'
            entityPath: 'string'
            id: 'string'
            name: 'string'
            resourceGroup: 'string'
            subscriptionId: 'string'
          }
        ]
        storageContainers: [
          {
            authenticationType: 'string'
            batchFrequencyInSeconds: int
            connectionString: 'string'
            containerName: 'string'
            encoding: 'string'
            endpointUri: 'string'
            fileNameFormat: 'string'
            id: '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}: {
        authenticationType: 'string'
        connectionString: 'string'
        containerName: 'string'
        sasTtlAsIso8601: 'string'
      }
    }
  }
  sku: {
    capacity: int
    name: 'string'
  }
  tags: {
    {customized property}: 'string'
  }
}

قيم الخصائص

معرفية الذراع

اسم	وصف	قيمة
نوع	نوع الهوية المستخدمة للمورد. يتضمن النوع "SystemAssigned,UserAssigned" كلا من الهوية التي تم إنشاؤها ضمنيا ومجموعة من الهويات المعينة من قبل المستخدم. سيقوم النوع "بلا" بإزالة أي هويات من الخدمة.	"بلا" 'SystemAssigned' "SystemAssigned, UserAssigned" "تعيين المستخدم"
معرفات تعيين المستخدم	قاموس <ArmUserIdentity>	ArmIdentityUserAssignedIdentities

معرفات المستخدم ArmIdentityAssignedIdentities

اسم	وصف	قيمة

معرف ArmUser

اسم	وصف	قيمة

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

اسم	وصف	قيمة
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

EncryptionPropertiesDescription

اسم	وصف	قيمة
مصدر المفتاح	مصدر المفتاح.	خيط
خصائص keyVault	خصائص مفتاح KeyVault.	KeyVaultKeyProperties []

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

اسم	وصف	قيمة
أسماء نقاط النهاية	قائمة نقاط النهاية التي يتم تطبيق الإثراء عليها على الرسالة.	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	"أحداث حالة اتصال الجهاز" "أحداث دورة حياة الجهاز" "أحداث دورة حياة الجهاز" "رسائل الجهاز" 'DigitalTwinChangeEvents' "غير صالح" '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.	خيط
deviceStreams	يقوم الجهاز ببث خصائص iothub.	IotHubPropertiesDeviceStreams
enableFileUploadNotifications	إذا كانت True، يتم تمكين إعلامات تحميل الملفات.	قيمة منطقية
التشفير	خصائص التشفير لمركز IoT.	تشفير PropertiesDescription
نقاط نهاية eventHub	خصائص نقطة النهاية المتوافقة مع Event Hub. المفاتيح الوحيدة الممكنة لهذا القاموس هي الأحداث. يجب أن يكون هذا المفتاح موجودا في القاموس أثناء إجراء مكالمات إنشاء أو تحديث لمركز IoT.	IotHubPropertiesEventHubEndpoints
ملامح	الإمكانات والميزات الممكنة لمركز IoT.	"إدارة الجهاز" "بلا"
ipFilterRules	قواعد عامل تصفية IP.	IpFilterRule[]
نقاط نهاية المراسلة	خصائص نقطة نهاية المراسلة لقائمة انتظار إعلام تحميل الملف.	IotHubPropertiesMessagingEndpoints
minTlsVersion	يحدد الحد الأدنى لإصدار TLS لدعم هذا المركز. يمكن تعيين إلى "1.2" ليتم رفض العملاء الذين يستخدمون إصدار TLS أقل من 1.2.	خيط
networkRuleSets	خصائص مجموعة قواعد الشبكة ل IotHub	NetworkRuleSetProperties
اتصالات نقطة النهاية الخاصة	اتصالات نقطة النهاية الخاصة التي تم إنشاؤها على IotHub هذا	PrivateEndpointConnection []
publicNetworkAccess	ما إذا كان مسموحا بالطلبات الواردة من الشبكة العامة	"معطل" "ممكن"
التوجيه	الخصائص ذات الصلة للتوجيه لمركز IoT. راجع: /azure/iot-hub/iot-hub-devguide-messaging	RoutingProperties
نقاط نهاية التخزين	قائمة نقاط نهاية Azure Storage حيث يمكنك تحميل الملفات. يمكنك حاليا تكوين حساب Azure Storage واحد فقط ويجب أن يكون مفتاحه $default. يؤدي تحديد أكثر من حساب تخزين واحد إلى طرح خطأ. يؤدي عدم تحديد قيمة لهذه الخاصية عند تعيين الخاصية enableFileUploadNotifications إلى True إلى ظهور خطأ.	IotHubPropertiesStorageEndpoints

IotHubPropertiesDeviceStreams

اسم	وصف	قيمة
نقاط النهاية المتدفقة	قائمة نقاط نهاية تدفقات الأجهزة.	سلسلة[]

نقاط نهاية 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 للقاعدة.	سلسلة (مطلوب)

KEKIdentity

اسم	وصف	قيمة
معرف تعيين المستخدم	الهوية المعينة للمستخدم.	خيط

خصائص KeyVaultKey

اسم	وصف	قيمة
الهوية	الهوية.	KEKIdentity
معرف المفتاح	معرف المفتاح.	خيط

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

اسم	وصف	قيمة
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.	ArmIdentity
مكان	موقع المورد.	سلسلة (مطلوب)
اسم	اسم المورد	سلسلة (مطلوب)
خصائص	خصائص IotHub	IotHubProperties
سكو	معلومات IotHub SKU	IotHubSkuInfo (مطلوب)
العلامات	علامات الموارد	قاموس أسماء العلامات والقيم. راجع العلامات في القوالب

NetworkRuleSetIpRule

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

خصائص NetworkRuleSet

اسم	وصف	قيمة
applyToBuiltInEventHubEndpoint	إذا كان صحيحا، تطبيق مجموعة قواعد الشبكة أيضا على نقطة نهاية BuiltIn EventHub ل IotHub	bool (مطلوب)
القيمة الافتراضية	الإجراء الافتراضي لمجموعة قواعد الشبكة	"السماح" "رفض"
قواعد ip	قائمة قواعد IP	NetworkRuleSetIpRule[] (مطلوب)

نقطة نهاية خاصة

اسم	وصف	قيمة

اتصال نقطة النهاية الخاصة

اسم	وصف	قيمة
خصائص	خصائص اتصال نقطة النهاية الخاصة	PrivateEndpointConnectionProperties (مطلوب)

خصائص اتصال نقطة النهاية الخاصة

اسم	وصف	قيمة
نقطة نهاية خاصة	خاصية نقطة النهاية الخاصة لاتصال نقطة نهاية خاصة	نقطة النهاية الخاصة
privateLinkServiceConnectionState	الحالة الحالية لاتصال نقطة نهاية خاصة	PrivateLinkServiceConnectionState (مطلوب)

PrivateLinkServiceConnectionState

اسم	وصف	قيمة
الإجراءات المطلوبة	الإجراءات المطلوبة لاتصال نقطة نهاية خاصة	خيط
وصف	وصف الحالة الحالية لاتصال نقطة نهاية خاصة	سلسلة (مطلوب)
حالة	حالة اتصال نقطة نهاية خاصة	"تمت الموافقة" "غير متصل" "معلق" "مرفوض" (مطلوب)

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

اسم	وصف	قيمة

خصائص المسار

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

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

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

RoutingEventHubProperties

اسم	وصف	قيمة
نوع المصادقة	الأسلوب المستخدم للمصادقة مقابل نقطة نهاية مركز الحدث	"identityBased" "keyBased"
سلسلة الاتصال	سلسلة الاتصال لنقطة نهاية مركز الحدث.	خيط
endpointUri	عنوان URL لنقطة نهاية مركز الحدث. يجب أن يتضمن sb:// البروتوكول	خيط
مسار الكيان	اسم مركز الحدث على مساحة اسم مركز الحدث	خيط
معرف	معرف نقطة نهاية مركز الحدث	خيط
اسم	الاسم الذي يعرف نقطة النهاية هذه. يمكن أن يتضمن الاسم الأحرف الأبجدية الرقمية والنقاط والتسطير السفلي والواصلات بحد أقصى 64 حرفا. الأسماء التالية محجوزة: الأحداث، fileNotifications، $default. يجب أن تكون أسماء نقاط النهاية فريدة عبر أنواع نقاط النهاية.	خيط القيود: النمط = `^[A-Za-z0-9-._]{1,64}$` (مطلوب)
مجموعة الموارد	اسم مجموعة الموارد لنقطة نهاية مركز الحدث.	خيط
معرف الاشتراك	معرف الاشتراك لنقطة نهاية مركز الحدث.	خيط

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

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

RoutingServiceBusQueueEndpointProperties

اسم	وصف	قيمة
نوع المصادقة	الأسلوب المستخدم للمصادقة مقابل نقطة نهاية قائمة انتظار ناقل الخدمة	"identityBased" "keyBased"
سلسلة الاتصال	سلسلة الاتصال لنقطة نهاية قائمة انتظار ناقل الخدمة.	خيط
endpointUri	عنوان URL لنقطة نهاية قائمة انتظار ناقل الخدمة. يجب أن يتضمن sb:// البروتوكول	خيط
مسار الكيان	اسم قائمة الانتظار على مساحة اسم ناقل الخدمة	خيط
معرف	معرف نقطة نهاية قائمة انتظار ناقل الخدمة	خيط
اسم	الاسم الذي يعرف نقطة النهاية هذه. يمكن أن يتضمن الاسم الأحرف الأبجدية الرقمية والنقاط والتسطير السفلي والواصلات بحد أقصى 64 حرفا. الأسماء التالية محجوزة: الأحداث، fileNotifications، $default. يجب أن تكون أسماء نقاط النهاية فريدة عبر أنواع نقاط النهاية. لا يجب أن يكون الاسم هو نفس اسم قائمة الانتظار الفعلي.	خيط القيود: النمط = `^[A-Za-z0-9-._]{1,64}$` (مطلوب)
مجموعة الموارد	اسم مجموعة الموارد لنقطة نهاية قائمة انتظار ناقل الخدمة.	خيط
معرف الاشتراك	معرف الاشتراك لنقطة نهاية قائمة انتظار ناقل الخدمة.	خيط

RoutingServiceBusTopicEndpointProperties

اسم	وصف	قيمة
نوع المصادقة	الأسلوب المستخدم للمصادقة مقابل نقطة نهاية موضوع ناقل الخدمة	"identityBased" "keyBased"
سلسلة الاتصال	سلسلة الاتصال لنقطة نهاية موضوع ناقل الخدمة.	خيط
endpointUri	عنوان URL لنقطة نهاية موضوع ناقل الخدمة. يجب أن يتضمن sb:// البروتوكول	خيط
مسار الكيان	اسم قائمة الانتظار في موضوع ناقل الخدمة	خيط
معرف	معرف نقطة نهاية موضوع ناقل الخدمة	خيط
اسم	الاسم الذي يعرف نقطة النهاية هذه. يمكن أن يتضمن الاسم الأحرف الأبجدية الرقمية والنقاط والتسطير السفلي والواصلات بحد أقصى 64 حرفا. الأسماء التالية محجوزة: الأحداث، fileNotifications، $default. يجب أن تكون أسماء نقاط النهاية فريدة عبر أنواع نقاط النهاية. لا يجب أن يكون الاسم هو نفس اسم الموضوع الفعلي.	خيط القيود: النمط = `^[A-Za-z0-9-._]{1,64}$` (مطلوب)
مجموعة الموارد	اسم مجموعة الموارد لنقطة نهاية موضوع ناقل الخدمة.	خيط
معرف الاشتراك	معرف الاشتراك لنقطة نهاية موضوع ناقل الخدمة.	خيط

RoutingStorageContainerProperties

اسم	وصف	قيمة
نوع المصادقة	الأسلوب المستخدم للمصادقة مقابل نقطة نهاية التخزين	"identityBased" "keyBased"
batchFrequencyInSeconds	الفاصل الزمني الذي تتم فيه كتابة الكائنات الثنائية كبيرة الحجم إلى التخزين. يجب أن تتراوح القيمة بين 60 و720 ثانية. القيمة الافتراضية هي 300 ثانية.	الباحث القيود: قيمة الحد الأدنى = 60 القيمة القصوى = 720
سلسلة الاتصال	سلسلة الاتصال لحساب التخزين.	خيط
اسم الحاوية	اسم حاوية التخزين في حساب التخزين.	سلسلة (مطلوب)
ترميز	الترميز المستخدم لتسلسل الرسائل إلى الكائنات الثنائية كبيرة الحجم. القيم المدعومة هي "avro" و"avrodeflate" و"JSON". القيمة الافتراضية هي "avro".	'Avro' 'AvroDeflate' 'JSON'
endpointUri	عنوان URL لنقطة نهاية التخزين. يجب أن يتضمن https:// البروتوكول	خيط
تنسيق اسم الملف	تنسيق اسم الملف للكائن الثنائي كبير الحجم. التنسيق الافتراضي هو {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

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

نماذج التشغيل السريع

تنشر نماذج التشغيل السريع التالية نوع المورد هذا.

ملف 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": "2021-02-01-preview",
  "name": "string",
  "etag": "string",
  "identity": {
    "type": "string",
    "userAssignedIdentities": {
      "{customized property}": {
      }
    }
  },
  "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",
    "deviceStreams": {
      "streamingEndpoints": [ "string" ]
    },
    "enableFileUploadNotifications": "bool",
    "encryption": {
      "keySource": "string",
      "keyVaultProperties": [
        {
          "identity": {
            "userAssignedIdentity": "string"
          },
          "keyIdentifier": "string"
        }
      ]
    },
    "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"
      }
    },
    "minTlsVersion": "string",
    "networkRuleSets": {
      "applyToBuiltInEventHubEndpoint": "bool",
      "defaultAction": "string",
      "ipRules": [
        {
          "action": "string",
          "filterName": "string",
          "ipMask": "string"
        }
      ]
    },
    "privateEndpointConnections": [
      {
        "properties": {
          "privateEndpoint": {
          },
          "privateLinkServiceConnectionState": {
            "actionsRequired": "string",
            "description": "string",
            "status": "string"
          }
        }
      }
    ],
    "publicNetworkAccess": "string",
    "routing": {
      "endpoints": {
        "eventHubs": [
          {
            "authenticationType": "string",
            "connectionString": "string",
            "endpointUri": "string",
            "entityPath": "string",
            "id": "string",
            "name": "string",
            "resourceGroup": "string",
            "subscriptionId": "string"
          }
        ],
        "serviceBusQueues": [
          {
            "authenticationType": "string",
            "connectionString": "string",
            "endpointUri": "string",
            "entityPath": "string",
            "id": "string",
            "name": "string",
            "resourceGroup": "string",
            "subscriptionId": "string"
          }
        ],
        "serviceBusTopics": [
          {
            "authenticationType": "string",
            "connectionString": "string",
            "endpointUri": "string",
            "entityPath": "string",
            "id": "string",
            "name": "string",
            "resourceGroup": "string",
            "subscriptionId": "string"
          }
        ],
        "storageContainers": [
          {
            "authenticationType": "string",
            "batchFrequencyInSeconds": "int",
            "connectionString": "string",
            "containerName": "string",
            "encoding": "string",
            "endpointUri": "string",
            "fileNameFormat": "string",
            "id": "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}": {
        "authenticationType": "string",
        "connectionString": "string",
        "containerName": "string",
        "sasTtlAsIso8601": "string"
      }
    }
  },
  "sku": {
    "capacity": "int",
    "name": "string"
  },
  "tags": {
    "{customized property}": "string"
  }
}

قيم الخصائص

معرفية الذراع

اسم	وصف	قيمة
نوع	نوع الهوية المستخدمة للمورد. يتضمن النوع "SystemAssigned,UserAssigned" كلا من الهوية التي تم إنشاؤها ضمنيا ومجموعة من الهويات المعينة من قبل المستخدم. سيقوم النوع "بلا" بإزالة أي هويات من الخدمة.	"بلا" 'SystemAssigned' "SystemAssigned, UserAssigned" "تعيين المستخدم"
معرفات تعيين المستخدم	قاموس <ArmUserIdentity>	ArmIdentityUserAssignedIdentities

معرفات المستخدم ArmIdentityAssignedIdentities

اسم	وصف	قيمة

معرف ArmUser

اسم	وصف	قيمة

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

اسم	وصف	قيمة
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

EncryptionPropertiesDescription

اسم	وصف	قيمة
مصدر المفتاح	مصدر المفتاح.	خيط
خصائص keyVault	خصائص مفتاح KeyVault.	KeyVaultKeyProperties []

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

اسم	وصف	قيمة
أسماء نقاط النهاية	قائمة نقاط النهاية التي يتم تطبيق الإثراء عليها على الرسالة.	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	"أحداث حالة اتصال الجهاز" "أحداث دورة حياة الجهاز" "أحداث دورة حياة الجهاز" "رسائل الجهاز" 'DigitalTwinChangeEvents' "غير صالح" '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.	خيط
deviceStreams	يقوم الجهاز ببث خصائص iothub.	IotHubPropertiesDeviceStreams
enableFileUploadNotifications	إذا كانت True، يتم تمكين إعلامات تحميل الملفات.	قيمة منطقية
التشفير	خصائص التشفير لمركز IoT.	تشفير PropertiesDescription
نقاط نهاية eventHub	خصائص نقطة النهاية المتوافقة مع Event Hub. المفاتيح الوحيدة الممكنة لهذا القاموس هي الأحداث. يجب أن يكون هذا المفتاح موجودا في القاموس أثناء إجراء مكالمات إنشاء أو تحديث لمركز IoT.	IotHubPropertiesEventHubEndpoints
ملامح	الإمكانات والميزات الممكنة لمركز IoT.	"إدارة الجهاز" "بلا"
ipFilterRules	قواعد عامل تصفية IP.	IpFilterRule[]
نقاط نهاية المراسلة	خصائص نقطة نهاية المراسلة لقائمة انتظار إعلام تحميل الملف.	IotHubPropertiesMessagingEndpoints
minTlsVersion	يحدد الحد الأدنى لإصدار TLS لدعم هذا المركز. يمكن تعيين إلى "1.2" ليتم رفض العملاء الذين يستخدمون إصدار TLS أقل من 1.2.	خيط
networkRuleSets	خصائص مجموعة قواعد الشبكة ل IotHub	NetworkRuleSetProperties
اتصالات نقطة النهاية الخاصة	اتصالات نقطة النهاية الخاصة التي تم إنشاؤها على IotHub هذا	PrivateEndpointConnection []
publicNetworkAccess	ما إذا كان مسموحا بالطلبات الواردة من الشبكة العامة	"معطل" "ممكن"
التوجيه	الخصائص ذات الصلة للتوجيه لمركز IoT. راجع: /azure/iot-hub/iot-hub-devguide-messaging	RoutingProperties
نقاط نهاية التخزين	قائمة نقاط نهاية Azure Storage حيث يمكنك تحميل الملفات. يمكنك حاليا تكوين حساب Azure Storage واحد فقط ويجب أن يكون مفتاحه $default. يؤدي تحديد أكثر من حساب تخزين واحد إلى طرح خطأ. يؤدي عدم تحديد قيمة لهذه الخاصية عند تعيين الخاصية enableFileUploadNotifications إلى True إلى ظهور خطأ.	IotHubPropertiesStorageEndpoints

IotHubPropertiesDeviceStreams

اسم	وصف	قيمة
نقاط النهاية المتدفقة	قائمة نقاط نهاية تدفقات الأجهزة.	سلسلة[]

نقاط نهاية 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 للقاعدة.	سلسلة (مطلوب)

KEKIdentity

اسم	وصف	قيمة
معرف تعيين المستخدم	الهوية المعينة للمستخدم.	خيط

خصائص KeyVaultKey

اسم	وصف	قيمة
الهوية	الهوية.	KEKIdentity
معرف المفتاح	معرف المفتاح.	خيط

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

اسم	وصف	قيمة
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	إصدار واجهة برمجة التطبيقات	'2021-02-01-preview'
etag	حقل Etag غير مطلوب . إذا تم توفيره في نص الاستجابة، يجب أيضا توفيره كعنوان وفقا لاصطلاح ETag العادي.	خيط
الهوية	الهويات المدارة ل IotHub.	ArmIdentity
مكان	موقع المورد.	سلسلة (مطلوب)
اسم	اسم المورد	سلسلة (مطلوب)
خصائص	خصائص IotHub	IotHubProperties
سكو	معلومات IotHub SKU	IotHubSkuInfo (مطلوب)
العلامات	علامات الموارد	قاموس أسماء العلامات والقيم. راجع العلامات في القوالب
نوع	نوع المورد	'Microsoft.Devices/IotHubs'

NetworkRuleSetIpRule

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

خصائص NetworkRuleSet

اسم	وصف	قيمة
applyToBuiltInEventHubEndpoint	إذا كان صحيحا، تطبيق مجموعة قواعد الشبكة أيضا على نقطة نهاية BuiltIn EventHub ل IotHub	bool (مطلوب)
القيمة الافتراضية	الإجراء الافتراضي لمجموعة قواعد الشبكة	"السماح" "رفض"
قواعد ip	قائمة قواعد IP	NetworkRuleSetIpRule[] (مطلوب)

نقطة نهاية خاصة

اسم	وصف	قيمة

اتصال نقطة النهاية الخاصة

اسم	وصف	قيمة
خصائص	خصائص اتصال نقطة النهاية الخاصة	PrivateEndpointConnectionProperties (مطلوب)

خصائص اتصال نقطة النهاية الخاصة

اسم	وصف	قيمة
نقطة نهاية خاصة	خاصية نقطة النهاية الخاصة لاتصال نقطة نهاية خاصة	نقطة النهاية الخاصة
privateLinkServiceConnectionState	الحالة الحالية لاتصال نقطة نهاية خاصة	PrivateLinkServiceConnectionState (مطلوب)

PrivateLinkServiceConnectionState

اسم	وصف	قيمة
الإجراءات المطلوبة	الإجراءات المطلوبة لاتصال نقطة نهاية خاصة	خيط
وصف	وصف الحالة الحالية لاتصال نقطة نهاية خاصة	سلسلة (مطلوب)
حالة	حالة اتصال نقطة نهاية خاصة	"تمت الموافقة" "غير متصل" "معلق" "مرفوض" (مطلوب)

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

اسم	وصف	قيمة

خصائص المسار

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

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

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

RoutingEventHubProperties

اسم	وصف	قيمة
نوع المصادقة	الأسلوب المستخدم للمصادقة مقابل نقطة نهاية مركز الحدث	"identityBased" "keyBased"
سلسلة الاتصال	سلسلة الاتصال لنقطة نهاية مركز الحدث.	خيط
endpointUri	عنوان URL لنقطة نهاية مركز الحدث. يجب أن يتضمن sb:// البروتوكول	خيط
مسار الكيان	اسم مركز الحدث على مساحة اسم مركز الحدث	خيط
معرف	معرف نقطة نهاية مركز الحدث	خيط
اسم	الاسم الذي يعرف نقطة النهاية هذه. يمكن أن يتضمن الاسم الأحرف الأبجدية الرقمية والنقاط والتسطير السفلي والواصلات بحد أقصى 64 حرفا. الأسماء التالية محجوزة: الأحداث، fileNotifications، $default. يجب أن تكون أسماء نقاط النهاية فريدة عبر أنواع نقاط النهاية.	خيط القيود: النمط = `^[A-Za-z0-9-._]{1,64}$` (مطلوب)
مجموعة الموارد	اسم مجموعة الموارد لنقطة نهاية مركز الحدث.	خيط
معرف الاشتراك	معرف الاشتراك لنقطة نهاية مركز الحدث.	خيط

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

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

RoutingServiceBusQueueEndpointProperties

اسم	وصف	قيمة
نوع المصادقة	الأسلوب المستخدم للمصادقة مقابل نقطة نهاية قائمة انتظار ناقل الخدمة	"identityBased" "keyBased"
سلسلة الاتصال	سلسلة الاتصال لنقطة نهاية قائمة انتظار ناقل الخدمة.	خيط
endpointUri	عنوان URL لنقطة نهاية قائمة انتظار ناقل الخدمة. يجب أن يتضمن sb:// البروتوكول	خيط
مسار الكيان	اسم قائمة الانتظار على مساحة اسم ناقل الخدمة	خيط
معرف	معرف نقطة نهاية قائمة انتظار ناقل الخدمة	خيط
اسم	الاسم الذي يعرف نقطة النهاية هذه. يمكن أن يتضمن الاسم الأحرف الأبجدية الرقمية والنقاط والتسطير السفلي والواصلات بحد أقصى 64 حرفا. الأسماء التالية محجوزة: الأحداث، fileNotifications، $default. يجب أن تكون أسماء نقاط النهاية فريدة عبر أنواع نقاط النهاية. لا يجب أن يكون الاسم هو نفس اسم قائمة الانتظار الفعلي.	خيط القيود: النمط = `^[A-Za-z0-9-._]{1,64}$` (مطلوب)
مجموعة الموارد	اسم مجموعة الموارد لنقطة نهاية قائمة انتظار ناقل الخدمة.	خيط
معرف الاشتراك	معرف الاشتراك لنقطة نهاية قائمة انتظار ناقل الخدمة.	خيط

RoutingServiceBusTopicEndpointProperties

اسم	وصف	قيمة
نوع المصادقة	الأسلوب المستخدم للمصادقة مقابل نقطة نهاية موضوع ناقل الخدمة	"identityBased" "keyBased"
سلسلة الاتصال	سلسلة الاتصال لنقطة نهاية موضوع ناقل الخدمة.	خيط
endpointUri	عنوان URL لنقطة نهاية موضوع ناقل الخدمة. يجب أن يتضمن sb:// البروتوكول	خيط
مسار الكيان	اسم قائمة الانتظار في موضوع ناقل الخدمة	خيط
معرف	معرف نقطة نهاية موضوع ناقل الخدمة	خيط
اسم	الاسم الذي يعرف نقطة النهاية هذه. يمكن أن يتضمن الاسم الأحرف الأبجدية الرقمية والنقاط والتسطير السفلي والواصلات بحد أقصى 64 حرفا. الأسماء التالية محجوزة: الأحداث، fileNotifications، $default. يجب أن تكون أسماء نقاط النهاية فريدة عبر أنواع نقاط النهاية. لا يجب أن يكون الاسم هو نفس اسم الموضوع الفعلي.	خيط القيود: النمط = `^[A-Za-z0-9-._]{1,64}$` (مطلوب)
مجموعة الموارد	اسم مجموعة الموارد لنقطة نهاية موضوع ناقل الخدمة.	خيط
معرف الاشتراك	معرف الاشتراك لنقطة نهاية موضوع ناقل الخدمة.	خيط

RoutingStorageContainerProperties

اسم	وصف	قيمة
نوع المصادقة	الأسلوب المستخدم للمصادقة مقابل نقطة نهاية التخزين	"identityBased" "keyBased"
batchFrequencyInSeconds	الفاصل الزمني الذي تتم فيه كتابة الكائنات الثنائية كبيرة الحجم إلى التخزين. يجب أن تتراوح القيمة بين 60 و720 ثانية. القيمة الافتراضية هي 300 ثانية.	الباحث القيود: قيمة الحد الأدنى = 60 القيمة القصوى = 720
سلسلة الاتصال	سلسلة الاتصال لحساب التخزين.	خيط
اسم الحاوية	اسم حاوية التخزين في حساب التخزين.	سلسلة (مطلوب)
ترميز	الترميز المستخدم لتسلسل الرسائل إلى الكائنات الثنائية كبيرة الحجم. القيم المدعومة هي "avro" و"avrodeflate" و"JSON". القيمة الافتراضية هي "avro".	'Avro' 'AvroDeflate' 'JSON'
endpointUri	عنوان URL لنقطة نهاية التخزين. يجب أن يتضمن https:// البروتوكول	خيط
تنسيق اسم الملف	تنسيق اسم الملف للكائن الثنائي كبير الحجم. التنسيق الافتراضي هو {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

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

قوالب التشغيل السريع

تنشر قوالب التشغيل السريع التالية نوع المورد هذا.

قالب	وصف
إنشاء بيئة الدفع حسب الاستخدام (PAYG) باستخدام مركز IoT	يمكنك هذا القالب من نشر بيئة Pay As You Go (PAYG) Time Series Insights التي تم تكوينها لاستهلاك الأحداث من IoT Hub.
إنشاء مركز IoT وجهاز إلى مجموعة المستهلكين السحابية	يمكنك هذا القالب من نشر مثيل IoT Hub مع جهاز على السحابة والسحابة إلى تكوينات مراسلة الجهاز وجهاز إلى مجموعة مستهلكي السحابة.
إنشاء محاكي IOT Hub وUbuntu edge	ينشئ هذا القالب محاكي حافة IOT Hub وVirtual Machine Ubuntu.
إنشاء خدمة توفير جهاز 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 وحساب تخزين. قم بتشغيل تطبيق لإرسال رسائل إلى المركز التي يتم توجيهها إلى التخزين، ثم عرض النتائج.

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

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

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

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

تنسيق المورد

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

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.Devices/IotHubs@2021-02-01-preview"
  name = "string"
  etag = "string"
  identity = {
    type = "string"
    userAssignedIdentities = {
      {customized property} = {
      }
    }
  }
  location = "string"
  body = jsonencode({
    properties = {
      authorizationPolicies = [
        {
          keyName = "string"
          primaryKey = "string"
          rights = "string"
          secondaryKey = "string"
        }
      ]
      cloudToDevice = {
        defaultTtlAsIso8601 = "string"
        feedback = {
          lockDurationAsIso8601 = "string"
          maxDeliveryCount = int
          ttlAsIso8601 = "string"
        }
        maxDeliveryCount = int
      }
      comments = "string"
      deviceStreams = {
        streamingEndpoints = [
          "string"
        ]
      }
      enableFileUploadNotifications = bool
      encryption = {
        keySource = "string"
        keyVaultProperties = [
          {
            identity = {
              userAssignedIdentity = "string"
            }
            keyIdentifier = "string"
          }
        ]
      }
      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"
        }
      }
      minTlsVersion = "string"
      networkRuleSets = {
        applyToBuiltInEventHubEndpoint = bool
        defaultAction = "string"
        ipRules = [
          {
            action = "string"
            filterName = "string"
            ipMask = "string"
          }
        ]
      }
      privateEndpointConnections = [
        {
          properties = {
            privateEndpoint = {
            }
            privateLinkServiceConnectionState = {
              actionsRequired = "string"
              description = "string"
              status = "string"
            }
          }
        }
      ]
      publicNetworkAccess = "string"
      routing = {
        endpoints = {
          eventHubs = [
            {
              authenticationType = "string"
              connectionString = "string"
              endpointUri = "string"
              entityPath = "string"
              id = "string"
              name = "string"
              resourceGroup = "string"
              subscriptionId = "string"
            }
          ]
          serviceBusQueues = [
            {
              authenticationType = "string"
              connectionString = "string"
              endpointUri = "string"
              entityPath = "string"
              id = "string"
              name = "string"
              resourceGroup = "string"
              subscriptionId = "string"
            }
          ]
          serviceBusTopics = [
            {
              authenticationType = "string"
              connectionString = "string"
              endpointUri = "string"
              entityPath = "string"
              id = "string"
              name = "string"
              resourceGroup = "string"
              subscriptionId = "string"
            }
          ]
          storageContainers = [
            {
              authenticationType = "string"
              batchFrequencyInSeconds = int
              connectionString = "string"
              containerName = "string"
              encoding = "string"
              endpointUri = "string"
              fileNameFormat = "string"
              id = "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} = {
          authenticationType = "string"
          connectionString = "string"
          containerName = "string"
          sasTtlAsIso8601 = "string"
        }
      }
    }
  })
  sku = {
    capacity = int
    name = "string"
  }
  tags = {
    {customized property} = "string"
  }
}

قيم الخصائص

معرفية الذراع

اسم	وصف	قيمة
نوع	نوع الهوية المستخدمة للمورد. يتضمن النوع "SystemAssigned,UserAssigned" كلا من الهوية التي تم إنشاؤها ضمنيا ومجموعة من الهويات المعينة من قبل المستخدم. سيقوم النوع "بلا" بإزالة أي هويات من الخدمة.	"بلا" 'SystemAssigned' "SystemAssigned, UserAssigned" "تعيين المستخدم"
معرفات تعيين المستخدم	قاموس <ArmUserIdentity>	ArmIdentityUserAssignedIdentities

معرفات المستخدم ArmIdentityAssignedIdentities

اسم	وصف	قيمة

معرف ArmUser

اسم	وصف	قيمة

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

اسم	وصف	قيمة
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

EncryptionPropertiesDescription

اسم	وصف	قيمة
مصدر المفتاح	مصدر المفتاح.	خيط
خصائص keyVault	خصائص مفتاح KeyVault.	KeyVaultKeyProperties []

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

اسم	وصف	قيمة
أسماء نقاط النهاية	قائمة نقاط النهاية التي يتم تطبيق الإثراء عليها على الرسالة.	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	"أحداث حالة اتصال الجهاز" "أحداث دورة حياة الجهاز" "أحداث دورة حياة الجهاز" "رسائل الجهاز" 'DigitalTwinChangeEvents' "غير صالح" '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.	خيط
deviceStreams	يقوم الجهاز ببث خصائص iothub.	IotHubPropertiesDeviceStreams
enableFileUploadNotifications	إذا كانت True، يتم تمكين إعلامات تحميل الملفات.	قيمة منطقية
التشفير	خصائص التشفير لمركز IoT.	تشفير PropertiesDescription
نقاط نهاية eventHub	خصائص نقطة النهاية المتوافقة مع Event Hub. المفاتيح الوحيدة الممكنة لهذا القاموس هي الأحداث. يجب أن يكون هذا المفتاح موجودا في القاموس أثناء إجراء مكالمات إنشاء أو تحديث لمركز IoT.	IotHubPropertiesEventHubEndpoints
ملامح	الإمكانات والميزات الممكنة لمركز IoT.	"إدارة الجهاز" "بلا"
ipFilterRules	قواعد عامل تصفية IP.	IpFilterRule[]
نقاط نهاية المراسلة	خصائص نقطة نهاية المراسلة لقائمة انتظار إعلام تحميل الملف.	IotHubPropertiesMessagingEndpoints
minTlsVersion	يحدد الحد الأدنى لإصدار TLS لدعم هذا المركز. يمكن تعيين إلى "1.2" ليتم رفض العملاء الذين يستخدمون إصدار TLS أقل من 1.2.	خيط
networkRuleSets	خصائص مجموعة قواعد الشبكة ل IotHub	NetworkRuleSetProperties
اتصالات نقطة النهاية الخاصة	اتصالات نقطة النهاية الخاصة التي تم إنشاؤها على IotHub هذا	PrivateEndpointConnection []
publicNetworkAccess	ما إذا كان مسموحا بالطلبات الواردة من الشبكة العامة	"معطل" "ممكن"
التوجيه	الخصائص ذات الصلة للتوجيه لمركز IoT. راجع: /azure/iot-hub/iot-hub-devguide-messaging	RoutingProperties
نقاط نهاية التخزين	قائمة نقاط نهاية Azure Storage حيث يمكنك تحميل الملفات. يمكنك حاليا تكوين حساب Azure Storage واحد فقط ويجب أن يكون مفتاحه $default. يؤدي تحديد أكثر من حساب تخزين واحد إلى طرح خطأ. يؤدي عدم تحديد قيمة لهذه الخاصية عند تعيين الخاصية enableFileUploadNotifications إلى True إلى ظهور خطأ.	IotHubPropertiesStorageEndpoints

IotHubPropertiesDeviceStreams

اسم	وصف	قيمة
نقاط النهاية المتدفقة	قائمة نقاط نهاية تدفقات الأجهزة.	سلسلة[]

نقاط نهاية 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 للقاعدة.	سلسلة (مطلوب)

KEKIdentity

اسم	وصف	قيمة
معرف تعيين المستخدم	الهوية المعينة للمستخدم.	خيط

خصائص KeyVaultKey

اسم	وصف	قيمة
الهوية	الهوية.	KEKIdentity
معرف المفتاح	معرف المفتاح.	خيط

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

اسم	وصف	قيمة
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.	ArmIdentity
مكان	موقع المورد.	سلسلة (مطلوب)
اسم	اسم المورد	سلسلة (مطلوب)
خصائص	خصائص IotHub	IotHubProperties
سكو	معلومات IotHub SKU	IotHubSkuInfo (مطلوب)
العلامات	علامات الموارد	قاموس أسماء العلامات والقيم.
نوع	نوع المورد	"Microsoft.Devices/IotHubs@2021-02-01-preview"

NetworkRuleSetIpRule

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

خصائص NetworkRuleSet

اسم	وصف	قيمة
applyToBuiltInEventHubEndpoint	إذا كان صحيحا، تطبيق مجموعة قواعد الشبكة أيضا على نقطة نهاية BuiltIn EventHub ل IotHub	bool (مطلوب)
القيمة الافتراضية	الإجراء الافتراضي لمجموعة قواعد الشبكة	"السماح" "رفض"
قواعد ip	قائمة قواعد IP	NetworkRuleSetIpRule[] (مطلوب)

نقطة نهاية خاصة

اسم	وصف	قيمة

اتصال نقطة النهاية الخاصة

اسم	وصف	قيمة
خصائص	خصائص اتصال نقطة النهاية الخاصة	PrivateEndpointConnectionProperties (مطلوب)

خصائص اتصال نقطة النهاية الخاصة

اسم	وصف	قيمة
نقطة نهاية خاصة	خاصية نقطة النهاية الخاصة لاتصال نقطة نهاية خاصة	نقطة النهاية الخاصة
privateLinkServiceConnectionState	الحالة الحالية لاتصال نقطة نهاية خاصة	PrivateLinkServiceConnectionState (مطلوب)

PrivateLinkServiceConnectionState

اسم	وصف	قيمة
الإجراءات المطلوبة	الإجراءات المطلوبة لاتصال نقطة نهاية خاصة	خيط
وصف	وصف الحالة الحالية لاتصال نقطة نهاية خاصة	سلسلة (مطلوب)
حالة	حالة اتصال نقطة نهاية خاصة	"تمت الموافقة" "غير متصل" "معلق" "مرفوض" (مطلوب)

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

اسم	وصف	قيمة

خصائص المسار

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

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

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

RoutingEventHubProperties

اسم	وصف	قيمة
نوع المصادقة	الأسلوب المستخدم للمصادقة مقابل نقطة نهاية مركز الحدث	"identityBased" "keyBased"
سلسلة الاتصال	سلسلة الاتصال لنقطة نهاية مركز الحدث.	خيط
endpointUri	عنوان URL لنقطة نهاية مركز الحدث. يجب أن يتضمن sb:// البروتوكول	خيط
مسار الكيان	اسم مركز الحدث على مساحة اسم مركز الحدث	خيط
معرف	معرف نقطة نهاية مركز الحدث	خيط
اسم	الاسم الذي يعرف نقطة النهاية هذه. يمكن أن يتضمن الاسم الأحرف الأبجدية الرقمية والنقاط والتسطير السفلي والواصلات بحد أقصى 64 حرفا. الأسماء التالية محجوزة: الأحداث، fileNotifications، $default. يجب أن تكون أسماء نقاط النهاية فريدة عبر أنواع نقاط النهاية.	خيط القيود: النمط = `^[A-Za-z0-9-._]{1,64}$` (مطلوب)
مجموعة الموارد	اسم مجموعة الموارد لنقطة نهاية مركز الحدث.	خيط
معرف الاشتراك	معرف الاشتراك لنقطة نهاية مركز الحدث.	خيط

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

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

RoutingServiceBusQueueEndpointProperties

اسم	وصف	قيمة
نوع المصادقة	الأسلوب المستخدم للمصادقة مقابل نقطة نهاية قائمة انتظار ناقل الخدمة	"identityBased" "keyBased"
سلسلة الاتصال	سلسلة الاتصال لنقطة نهاية قائمة انتظار ناقل الخدمة.	خيط
endpointUri	عنوان URL لنقطة نهاية قائمة انتظار ناقل الخدمة. يجب أن يتضمن sb:// البروتوكول	خيط
مسار الكيان	اسم قائمة الانتظار على مساحة اسم ناقل الخدمة	خيط
معرف	معرف نقطة نهاية قائمة انتظار ناقل الخدمة	خيط
اسم	الاسم الذي يعرف نقطة النهاية هذه. يمكن أن يتضمن الاسم الأحرف الأبجدية الرقمية والنقاط والتسطير السفلي والواصلات بحد أقصى 64 حرفا. الأسماء التالية محجوزة: الأحداث، fileNotifications، $default. يجب أن تكون أسماء نقاط النهاية فريدة عبر أنواع نقاط النهاية. لا يجب أن يكون الاسم هو نفس اسم قائمة الانتظار الفعلي.	خيط القيود: النمط = `^[A-Za-z0-9-._]{1,64}$` (مطلوب)
مجموعة الموارد	اسم مجموعة الموارد لنقطة نهاية قائمة انتظار ناقل الخدمة.	خيط
معرف الاشتراك	معرف الاشتراك لنقطة نهاية قائمة انتظار ناقل الخدمة.	خيط

RoutingServiceBusTopicEndpointProperties

اسم	وصف	قيمة
نوع المصادقة	الأسلوب المستخدم للمصادقة مقابل نقطة نهاية موضوع ناقل الخدمة	"identityBased" "keyBased"
سلسلة الاتصال	سلسلة الاتصال لنقطة نهاية موضوع ناقل الخدمة.	خيط
endpointUri	عنوان URL لنقطة نهاية موضوع ناقل الخدمة. يجب أن يتضمن sb:// البروتوكول	خيط
مسار الكيان	اسم قائمة الانتظار في موضوع ناقل الخدمة	خيط
معرف	معرف نقطة نهاية موضوع ناقل الخدمة	خيط
اسم	الاسم الذي يعرف نقطة النهاية هذه. يمكن أن يتضمن الاسم الأحرف الأبجدية الرقمية والنقاط والتسطير السفلي والواصلات بحد أقصى 64 حرفا. الأسماء التالية محجوزة: الأحداث، fileNotifications، $default. يجب أن تكون أسماء نقاط النهاية فريدة عبر أنواع نقاط النهاية. لا يجب أن يكون الاسم هو نفس اسم الموضوع الفعلي.	خيط القيود: النمط = `^[A-Za-z0-9-._]{1,64}$` (مطلوب)
مجموعة الموارد	اسم مجموعة الموارد لنقطة نهاية موضوع ناقل الخدمة.	خيط
معرف الاشتراك	معرف الاشتراك لنقطة نهاية موضوع ناقل الخدمة.	خيط

RoutingStorageContainerProperties

اسم	وصف	قيمة
نوع المصادقة	الأسلوب المستخدم للمصادقة مقابل نقطة نهاية التخزين	"identityBased" "keyBased"
batchFrequencyInSeconds	الفاصل الزمني الذي تتم فيه كتابة الكائنات الثنائية كبيرة الحجم إلى التخزين. يجب أن تتراوح القيمة بين 60 و720 ثانية. القيمة الافتراضية هي 300 ثانية.	الباحث القيود: قيمة الحد الأدنى = 60 القيمة القصوى = 720
سلسلة الاتصال	سلسلة الاتصال لحساب التخزين.	خيط
اسم الحاوية	اسم حاوية التخزين في حساب التخزين.	سلسلة (مطلوب)
ترميز	الترميز المستخدم لتسلسل الرسائل إلى الكائنات الثنائية كبيرة الحجم. القيم المدعومة هي "avro" و"avrodeflate" و"JSON". القيمة الافتراضية هي "avro".	'Avro' 'AvroDeflate' 'JSON'
endpointUri	عنوان URL لنقطة نهاية التخزين. يجب أن يتضمن https:// البروتوكول	خيط
تنسيق اسم الملف	تنسيق اسم الملف للكائن الثنائي كبير الحجم. التنسيق الافتراضي هو {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

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

مشاركة عبر

Microsoft.Devices IotHubs 2021-02-01-preview

تعريف مورد Bicep

تنسيق المورد

قيم الخصائص

معرفية الذراع

معرفات المستخدم ArmIdentityAssignedIdentities

معرف ArmUser

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

EncryptionPropertiesDescription

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

خصائص EventHub

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

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

خصائص IotHub

IotHubPropertiesDeviceStreams

نقاط نهاية IotHubPropertiesEventHub

IotHubPropertiesMessagingEndpoints

IotHubPropertiesStorageEndpoints

معلومات IotHubSku

IpFilterRule

KEKIdentity

خصائص KeyVaultKey

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

Microsoft.Devices/IotHubs

NetworkRuleSetIpRule

خصائص NetworkRuleSet

نقطة نهاية خاصة

اتصال نقطة النهاية الخاصة

خصائص اتصال نقطة النهاية الخاصة

PrivateLinkServiceConnectionState

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

خصائص المسار

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

RoutingEventHubProperties

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

RoutingServiceBusQueueEndpointProperties

RoutingServiceBusTopicEndpointProperties

RoutingStorageContainerProperties

SharedAccessSignatureAuthorizationRule

خصائص StorageEndpoint

نماذج التشغيل السريع

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

تنسيق المورد

قيم الخصائص

معرفية الذراع

معرفات المستخدم ArmIdentityAssignedIdentities

معرف ArmUser

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

EncryptionPropertiesDescription

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

خصائص EventHub

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

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

خصائص IotHub

IotHubPropertiesDeviceStreams

نقاط نهاية IotHubPropertiesEventHub

IotHubPropertiesMessagingEndpoints

IotHubPropertiesStorageEndpoints

معلومات IotHubSku

IpFilterRule

KEKIdentity

خصائص KeyVaultKey

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

Microsoft.Devices/IotHubs

NetworkRuleSetIpRule

خصائص NetworkRuleSet

نقطة نهاية خاصة

اتصال نقطة النهاية الخاصة

خصائص اتصال نقطة النهاية الخاصة

PrivateLinkServiceConnectionState

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

خصائص المسار

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

RoutingEventHubProperties

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

RoutingServiceBusQueueEndpointProperties

RoutingServiceBusTopicEndpointProperties

RoutingStorageContainerProperties

SharedAccessSignatureAuthorizationRule