Microsoft.Devices IotHubs 2023-06-30-preview

تعريف مورد Bicep

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

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

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

تنسيق المورد

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

resource symbolicname 'Microsoft.Devices/IotHubs@2023-06-30-preview' = {
  etag: 'string'
  identity: {
    type: 'string'
    userAssignedIdentities: {
      {customized property}: {}
    }
  }
  location: 'string'
  name: 'string'
  properties: {
    allowedFqdnList: [
      'string'
    ]
    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'
      ]
    }
    disableDeviceSAS: bool
    disableLocalAuth: bool
    disableModuleSAS: bool
    enableDataResidency: bool
    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'
      }
    ]
    ipVersion: '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'
    restrictOutboundNetworkAccess: bool
    rootCertificate: {
      enableRootCertificateV2: bool
    }
    routing: {
      endpoints: {
        cosmosDBSqlContainers: [
          {
            authenticationType: 'string'
            containerName: 'string'
            databaseName: 'string'
            endpointUri: 'string'
            id: 'string'
            identity: {
              userAssignedIdentity: 'string'
            }
            name: 'string'
            partitionKeyName: 'string'
            partitionKeyTemplate: 'string'
            primaryKey: 'string'
            resourceGroup: 'string'
            secondaryKey: 'string'
            subscriptionId: 'string'
          }
        ]
        eventHubs: [
          {
            authenticationType: 'string'
            connectionString: 'string'
            endpointUri: 'string'
            entityPath: 'string'
            id: 'string'
            identity: {
              userAssignedIdentity: 'string'
            }
            name: 'string'
            resourceGroup: 'string'
            subscriptionId: 'string'
          }
        ]
        serviceBusQueues: [
          {
            authenticationType: 'string'
            connectionString: 'string'
            endpointUri: 'string'
            entityPath: 'string'
            id: 'string'
            identity: {
              userAssignedIdentity: 'string'
            }
            name: 'string'
            resourceGroup: 'string'
            subscriptionId: 'string'
          }
        ]
        serviceBusTopics: [
          {
            authenticationType: 'string'
            connectionString: 'string'
            endpointUri: 'string'
            entityPath: 'string'
            id: 'string'
            identity: {
              userAssignedIdentity: 'string'
            }
            name: 'string'
            resourceGroup: 'string'
            subscriptionId: 'string'
          }
        ]
        storageContainers: [
          {
            authenticationType: 'string'
            batchFrequencyInSeconds: int
            connectionString: 'string'
            containerName: 'string'
            encoding: 'string'
            endpointUri: 'string'
            fileNameFormat: 'string'
            id: 'string'
            identity: {
              userAssignedIdentity: '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'
        identity: {
          userAssignedIdentity: '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'
"غير صالح"
'MqttBrokerMessages'
'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

اسم وصف قيمة
allowedFqdnList قائمة FQDNs المسموح بها (اسم المجال المؤهل بالكامل) للخروج من Iot Hub. سلسلة[]
نهج التخويل نهج الوصول المشتركة التي يمكنك استخدامها لتأمين اتصال بمركز IoT. SharedAccessSignatureAuthorizationRule[]
cloudToDevice خصائص المراسلة من سحابة إلى جهاز لمركز IoT. CloudToDeviceProperties
التعليقات تعليقات مركز IoT. خيط
deviceStreams يقوم الجهاز ببث خصائص iothub. IotHubPropertiesDeviceStreams
disableDeviceSAS إذا كان صحيحا، لا يمكن استخدام جميع مفاتيح SAS المحددة في نطاق الجهاز (بما في ذلك أجهزة Edge ولكن باستثناء الوحدات النمطية) للمصادقة. قيمة منطقية
تعطيلLocalAuth إذا كان صحيحا، لا يمكن استخدام رموز SAS المميزة مع مفاتيح SAS ذات نطاق مركز Iot للمصادقة. قيمة منطقية
تعطيلModuleSAS إذا كان صحيحا، لا يمكن استخدام جميع مفاتيح SAS التي تم تحديد نطاقها للوحدة النمطية للمصادقة. قيمة منطقية
enableDataResidency هذه الخاصية عند تعيينها إلى true، ستمكن موقع البيانات، وبالتالي، تعطيل التعافي من الكوارث. قيمة منطقية
enableFileUploadNotifications إذا كانت True، يتم تمكين إعلامات تحميل الملفات. قيمة منطقية
التشفير خصائص التشفير لمركز IoT. تشفير PropertiesDescription
نقاط نهاية eventHub خصائص نقطة النهاية المتوافقة مع Event Hub. المفاتيح الوحيدة الممكنة لهذا القاموس هي الأحداث. يجب أن يكون هذا المفتاح موجودا في القاموس أثناء إجراء مكالمات إنشاء أو تحديث لمركز IoT. IotHubPropertiesEventHubEndpoints
ملامح الإمكانات والميزات الممكنة لمركز IoT. "إدارة الجهاز"
"بلا"
ipFilterRules قواعد عامل تصفية IP. IpFilterRule[]
ipVersion تحدد هذه الخاصية إصدار IP الذي يستخدمه المركز حاليا. 'ipv4'
'ipv4ipv6'
'ipv6'
نقاط نهاية المراسلة خصائص نقطة نهاية المراسلة لقائمة انتظار إعلام تحميل الملف. IotHubPropertiesMessagingEndpoints
minTlsVersion يحدد الحد الأدنى لإصدار TLS لدعم هذا المركز. يمكن تعيين إلى "1.2" ليتم رفض العملاء الذين يستخدمون إصدار TLS أقل من 1.2. خيط
networkRuleSets خصائص مجموعة قواعد الشبكة ل IotHub NetworkRuleSetProperties
اتصالات نقطة النهاية الخاصة اتصالات نقطة النهاية الخاصة التي تم إنشاؤها على IotHub هذا PrivateEndpointConnection []
publicNetworkAccess ما إذا كان مسموحا بالطلبات الواردة من الشبكة العامة "معطل"
"ممكن"
تقييدOutboundNetworkAccess إذا كان صحيحا، تقييد الخروج من IotHub إلى FQDNs المسموح بها فقط التي تم تكوينها عبر allowedFqdnList. قيمة منطقية
rootCertificate تخزن هذه الخاصية المعلومات المتعلقة بشهادة الجذر RootCertificateProperties
التوجيه الخصائص ذات الصلة للتوجيه لمركز 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 للقاعدة. سلسلة (مطلوب)

خصائص KeyVaultKey

اسم وصف قيمة
الهوية خصائص الهوية المدارة ل KeyVault Key. ManagedIdentity
معرف المفتاح معرف المفتاح. خيط

معرف مدار

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

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

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

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

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

اسم وصف قيمة

RootCertificateProperties

اسم وصف قيمة
enableRootCertificateV2 عند تعيين هذه الخاصية إلى true، سيستخدم المركز شهادة G2؛ بينما يتم تعيينه على false، يستخدم hub شهادة بالتيمور. قيمة منطقية

خصائص المسار

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

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

RoutingCosmosDBSqlApiProperties

اسم وصف قيمة
نوع المصادقة الأسلوب المستخدم للمصادقة مقابل نقطة نهاية حاوية cosmos DB sql "identityBased"
"keyBased"
اسم الحاوية اسم حاوية cosmos DB sql في قاعدة بيانات cosmos DB. سلسلة (مطلوب)
اسم قاعدة البيانات اسم قاعدة بيانات cosmos DB في حساب cosmos DB. سلسلة (مطلوب)
endpointUri عنوان URL لحساب cosmos DB. يجب أن يتضمن https:// البروتوكول سلسلة (مطلوب)
معرف معرف نقطة نهاية حاوية cosmos DB sql خيط
الهوية خصائص الهوية المدارة لتوجيه نقطة نهاية حاوية cosmos DB. ManagedIdentity
اسم الاسم الذي يعرف نقطة النهاية هذه. يمكن أن يتضمن الاسم الأحرف الأبجدية الرقمية والنقاط والتسطير السفلي والواصلات بحد أقصى 64 حرفا. الأسماء التالية محجوزة: الأحداث، fileNotifications، $default. يجب أن تكون أسماء نقاط النهاية فريدة عبر أنواع نقاط النهاية. خيط

القيود:
النمط = ^[A-Za-z0-9-._]{1,64}$ (مطلوب)
partitionKeyName اسم مفتاح القسم المقترن بحاوية cosmos DB sql هذه إذا كان موجودا. هذه معلمة اختيارية. خيط
partitionKeyTemplate القالب لإنشاء قيمة مفتاح قسم اصطناعي للاستخدام مع حاوية cosmos DB sql هذه. يجب أن يتضمن القالب واحدا على الأقل من العناصر النائبة التالية: {iothub}، و{deviceid}، و{DD}، و{MM}، و{YYYY}. يمكن تحديد أي عنصر نائب واحد مرة واحدة على الأكثر، ولكن مكونات الترتيب وغير العنصر النائب عشوائية. هذه المعلمة مطلوبة فقط إذا تم تحديد PartitionKeyName. خيط
مفتاح أساسي المفتاح الأساسي لحساب cosmos DB. خيط

القيود:
قيمة حساسة. تمرير كمعلمة آمنة.
مجموعة الموارد اسم مجموعة الموارد لحساب cosmos DB. خيط
مفتاح ثانوي المفتاح الثانوي لحساب cosmos DB. خيط

القيود:
قيمة حساسة. تمرير كمعلمة آمنة.
معرف الاشتراك معرف الاشتراك لحساب cosmos DB. خيط

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

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

RoutingEventHubProperties

اسم وصف قيمة
نوع المصادقة الأسلوب المستخدم للمصادقة مقابل نقطة نهاية مركز الحدث "identityBased"
"keyBased"
سلسلة الاتصال سلسلة الاتصال لنقطة نهاية مركز الحدث. خيط

القيود:
قيمة حساسة. تمرير كمعلمة آمنة.
endpointUri عنوان URL لنقطة نهاية مركز الحدث. يجب أن يتضمن sb:// البروتوكول خيط
مسار الكيان اسم مركز الحدث على مساحة اسم مركز الحدث خيط
معرف معرف نقطة نهاية مركز الحدث خيط
الهوية خصائص الهوية المدارة لتوجيه نقطة نهاية مركز الحدث. ManagedIdentity
اسم الاسم الذي يعرف نقطة النهاية هذه. يمكن أن يتضمن الاسم الأحرف الأبجدية الرقمية والنقاط والتسطير السفلي والواصلات بحد أقصى 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:// البروتوكول خيط
مسار الكيان اسم قائمة الانتظار على مساحة اسم ناقل الخدمة خيط
معرف معرف نقطة نهاية قائمة انتظار ناقل الخدمة خيط
الهوية خصائص الهوية المدارة لتوجيه نقطة نهاية قائمة انتظار ناقل خدمة Microsoft Azure. ManagedIdentity
اسم الاسم الذي يعرف نقطة النهاية هذه. يمكن أن يتضمن الاسم الأحرف الأبجدية الرقمية والنقاط والتسطير السفلي والواصلات بحد أقصى 64 حرفا. الأسماء التالية محجوزة: الأحداث، fileNotifications، $default. يجب أن تكون أسماء نقاط النهاية فريدة عبر أنواع نقاط النهاية. لا يجب أن يكون الاسم هو نفس اسم قائمة الانتظار الفعلي. خيط

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

RoutingServiceBusTopicEndpointProperties

اسم وصف قيمة
نوع المصادقة الأسلوب المستخدم للمصادقة مقابل نقطة نهاية موضوع ناقل الخدمة "identityBased"
"keyBased"
سلسلة الاتصال سلسلة الاتصال لنقطة نهاية موضوع ناقل الخدمة. خيط

القيود:
قيمة حساسة. تمرير كمعلمة آمنة.
endpointUri عنوان URL لنقطة نهاية موضوع ناقل الخدمة. يجب أن يتضمن sb:// البروتوكول خيط
مسار الكيان اسم قائمة الانتظار في موضوع ناقل الخدمة خيط
معرف معرف نقطة نهاية موضوع ناقل الخدمة خيط
الهوية خصائص الهوية المدارة لتوجيه نقطة نهاية موضوع ناقل خدمة Microsoft Azure. ManagedIdentity
اسم الاسم الذي يعرف نقطة النهاية هذه. يمكن أن يتضمن الاسم الأحرف الأبجدية الرقمية والنقاط والتسطير السفلي والواصلات بحد أقصى 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}. جميع المعلمات إلزامية ولكن يمكن إعادة ترتيبها. خيط
معرف معرف نقطة نهاية حاوية التخزين خيط
الهوية خصائص الهوية المدارة لتوجيه نقطة نهاية التخزين. ManagedIdentity
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 المحدد. سلسلة (مطلوب)
الهوية خصائص الهوية المدارة لنقطة نهاية التخزين لتحميل الملف. ManagedIdentity
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": "2023-06-30-preview",
  "name": "string",
  "etag": "string",
  "identity": {
    "type": "string",
    "userAssignedIdentities": {
      "{customized property}": {
      }
    }
  },
  "location": "string",
  "properties": {
    "allowedFqdnList": [ "string" ],
    "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" ]
    },
    "disableDeviceSAS": "bool",
    "disableLocalAuth": "bool",
    "disableModuleSAS": "bool",
    "enableDataResidency": "bool",
    "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"
      }
    ],
    "ipVersion": "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",
    "restrictOutboundNetworkAccess": "bool",
    "rootCertificate": {
      "enableRootCertificateV2": "bool"
    },
    "routing": {
      "endpoints": {
        "cosmosDBSqlContainers": [
          {
            "authenticationType": "string",
            "containerName": "string",
            "databaseName": "string",
            "endpointUri": "string",
            "id": "string",
            "identity": {
              "userAssignedIdentity": "string"
            },
            "name": "string",
            "partitionKeyName": "string",
            "partitionKeyTemplate": "string",
            "primaryKey": "string",
            "resourceGroup": "string",
            "secondaryKey": "string",
            "subscriptionId": "string"
          }
        ],
        "eventHubs": [
          {
            "authenticationType": "string",
            "connectionString": "string",
            "endpointUri": "string",
            "entityPath": "string",
            "id": "string",
            "identity": {
              "userAssignedIdentity": "string"
            },
            "name": "string",
            "resourceGroup": "string",
            "subscriptionId": "string"
          }
        ],
        "serviceBusQueues": [
          {
            "authenticationType": "string",
            "connectionString": "string",
            "endpointUri": "string",
            "entityPath": "string",
            "id": "string",
            "identity": {
              "userAssignedIdentity": "string"
            },
            "name": "string",
            "resourceGroup": "string",
            "subscriptionId": "string"
          }
        ],
        "serviceBusTopics": [
          {
            "authenticationType": "string",
            "connectionString": "string",
            "endpointUri": "string",
            "entityPath": "string",
            "id": "string",
            "identity": {
              "userAssignedIdentity": "string"
            },
            "name": "string",
            "resourceGroup": "string",
            "subscriptionId": "string"
          }
        ],
        "storageContainers": [
          {
            "authenticationType": "string",
            "batchFrequencyInSeconds": "int",
            "connectionString": "string",
            "containerName": "string",
            "encoding": "string",
            "endpointUri": "string",
            "fileNameFormat": "string",
            "id": "string",
            "identity": {
              "userAssignedIdentity": "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",
        "identity": {
          "userAssignedIdentity": "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'
"غير صالح"
'MqttBrokerMessages'
'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

اسم وصف قيمة
allowedFqdnList قائمة FQDNs المسموح بها (اسم المجال المؤهل بالكامل) للخروج من Iot Hub. سلسلة[]
نهج التخويل نهج الوصول المشتركة التي يمكنك استخدامها لتأمين اتصال بمركز IoT. SharedAccessSignatureAuthorizationRule[]
cloudToDevice خصائص المراسلة من سحابة إلى جهاز لمركز IoT. CloudToDeviceProperties
التعليقات تعليقات مركز IoT. خيط
deviceStreams يقوم الجهاز ببث خصائص iothub. IotHubPropertiesDeviceStreams
disableDeviceSAS إذا كان صحيحا، لا يمكن استخدام جميع مفاتيح SAS المحددة في نطاق الجهاز (بما في ذلك أجهزة Edge ولكن باستثناء الوحدات النمطية) للمصادقة. قيمة منطقية
تعطيلLocalAuth إذا كان صحيحا، لا يمكن استخدام رموز SAS المميزة مع مفاتيح SAS ذات نطاق مركز Iot للمصادقة. قيمة منطقية
تعطيلModuleSAS إذا كان صحيحا، لا يمكن استخدام جميع مفاتيح SAS التي تم تحديد نطاقها للوحدة النمطية للمصادقة. قيمة منطقية
enableDataResidency هذه الخاصية عند تعيينها إلى true، ستمكن موقع البيانات، وبالتالي، تعطيل التعافي من الكوارث. قيمة منطقية
enableFileUploadNotifications إذا كانت True، يتم تمكين إعلامات تحميل الملفات. قيمة منطقية
التشفير خصائص التشفير لمركز IoT. تشفير PropertiesDescription
نقاط نهاية eventHub خصائص نقطة النهاية المتوافقة مع Event Hub. المفاتيح الوحيدة الممكنة لهذا القاموس هي الأحداث. يجب أن يكون هذا المفتاح موجودا في القاموس أثناء إجراء مكالمات إنشاء أو تحديث لمركز IoT. IotHubPropertiesEventHubEndpoints
ملامح الإمكانات والميزات الممكنة لمركز IoT. "إدارة الجهاز"
"بلا"
ipFilterRules قواعد عامل تصفية IP. IpFilterRule[]
ipVersion تحدد هذه الخاصية إصدار IP الذي يستخدمه المركز حاليا. 'ipv4'
'ipv4ipv6'
'ipv6'
نقاط نهاية المراسلة خصائص نقطة نهاية المراسلة لقائمة انتظار إعلام تحميل الملف. IotHubPropertiesMessagingEndpoints
minTlsVersion يحدد الحد الأدنى لإصدار TLS لدعم هذا المركز. يمكن تعيين إلى "1.2" ليتم رفض العملاء الذين يستخدمون إصدار TLS أقل من 1.2. خيط
networkRuleSets خصائص مجموعة قواعد الشبكة ل IotHub NetworkRuleSetProperties
اتصالات نقطة النهاية الخاصة اتصالات نقطة النهاية الخاصة التي تم إنشاؤها على IotHub هذا PrivateEndpointConnection []
publicNetworkAccess ما إذا كان مسموحا بالطلبات الواردة من الشبكة العامة "معطل"
"ممكن"
تقييدOutboundNetworkAccess إذا كان صحيحا، تقييد الخروج من IotHub إلى FQDNs المسموح بها فقط التي تم تكوينها عبر allowedFqdnList. قيمة منطقية
rootCertificate تخزن هذه الخاصية المعلومات المتعلقة بشهادة الجذر RootCertificateProperties
التوجيه الخصائص ذات الصلة للتوجيه لمركز 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 للقاعدة. سلسلة (مطلوب)

خصائص KeyVaultKey

اسم وصف قيمة
الهوية خصائص الهوية المدارة ل KeyVault Key. ManagedIdentity
معرف المفتاح معرف المفتاح. خيط

معرف مدار

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

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

اسم وصف قيمة
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 إصدار واجهة برمجة التطبيقات 'معاينة 2023-06-30'
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

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

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

اسم وصف قيمة

RootCertificateProperties

اسم وصف قيمة
enableRootCertificateV2 عند تعيين هذه الخاصية إلى true، سيستخدم المركز شهادة G2؛ بينما يتم تعيينه على false، يستخدم hub شهادة بالتيمور. قيمة منطقية

خصائص المسار

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

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

RoutingCosmosDBSqlApiProperties

اسم وصف قيمة
نوع المصادقة الأسلوب المستخدم للمصادقة مقابل نقطة نهاية حاوية cosmos DB sql "identityBased"
"keyBased"
اسم الحاوية اسم حاوية cosmos DB sql في قاعدة بيانات cosmos DB. سلسلة (مطلوب)
اسم قاعدة البيانات اسم قاعدة بيانات cosmos DB في حساب cosmos DB. سلسلة (مطلوب)
endpointUri عنوان URL لحساب cosmos DB. يجب أن يتضمن https:// البروتوكول سلسلة (مطلوب)
معرف معرف نقطة نهاية حاوية cosmos DB sql خيط
الهوية خصائص الهوية المدارة لتوجيه نقطة نهاية حاوية cosmos DB. ManagedIdentity
اسم الاسم الذي يعرف نقطة النهاية هذه. يمكن أن يتضمن الاسم الأحرف الأبجدية الرقمية والنقاط والتسطير السفلي والواصلات بحد أقصى 64 حرفا. الأسماء التالية محجوزة: الأحداث، fileNotifications، $default. يجب أن تكون أسماء نقاط النهاية فريدة عبر أنواع نقاط النهاية. خيط

القيود:
النمط = ^[A-Za-z0-9-._]{1,64}$ (مطلوب)
partitionKeyName اسم مفتاح القسم المقترن بحاوية cosmos DB sql هذه إذا كان موجودا. هذه معلمة اختيارية. خيط
partitionKeyTemplate القالب لإنشاء قيمة مفتاح قسم اصطناعي للاستخدام مع حاوية cosmos DB sql هذه. يجب أن يتضمن القالب واحدا على الأقل من العناصر النائبة التالية: {iothub}، و{deviceid}، و{DD}، و{MM}، و{YYYY}. يمكن تحديد أي عنصر نائب واحد مرة واحدة على الأكثر، ولكن مكونات الترتيب وغير العنصر النائب عشوائية. هذه المعلمة مطلوبة فقط إذا تم تحديد PartitionKeyName. خيط
مفتاح أساسي المفتاح الأساسي لحساب cosmos DB. خيط

القيود:
قيمة حساسة. تمرير كمعلمة آمنة.
مجموعة الموارد اسم مجموعة الموارد لحساب cosmos DB. خيط
مفتاح ثانوي المفتاح الثانوي لحساب cosmos DB. خيط

القيود:
قيمة حساسة. تمرير كمعلمة آمنة.
معرف الاشتراك معرف الاشتراك لحساب cosmos DB. خيط

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

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

RoutingEventHubProperties

اسم وصف قيمة
نوع المصادقة الأسلوب المستخدم للمصادقة مقابل نقطة نهاية مركز الحدث "identityBased"
"keyBased"
سلسلة الاتصال سلسلة الاتصال لنقطة نهاية مركز الحدث. خيط

القيود:
قيمة حساسة. تمرير كمعلمة آمنة.
endpointUri عنوان URL لنقطة نهاية مركز الحدث. يجب أن يتضمن sb:// البروتوكول خيط
مسار الكيان اسم مركز الحدث على مساحة اسم مركز الحدث خيط
معرف معرف نقطة نهاية مركز الحدث خيط
الهوية خصائص الهوية المدارة لتوجيه نقطة نهاية مركز الحدث. ManagedIdentity
اسم الاسم الذي يعرف نقطة النهاية هذه. يمكن أن يتضمن الاسم الأحرف الأبجدية الرقمية والنقاط والتسطير السفلي والواصلات بحد أقصى 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:// البروتوكول خيط
مسار الكيان اسم قائمة الانتظار على مساحة اسم ناقل الخدمة خيط
معرف معرف نقطة نهاية قائمة انتظار ناقل الخدمة خيط
الهوية خصائص الهوية المدارة لتوجيه نقطة نهاية قائمة انتظار ناقل خدمة Microsoft Azure. ManagedIdentity
اسم الاسم الذي يعرف نقطة النهاية هذه. يمكن أن يتضمن الاسم الأحرف الأبجدية الرقمية والنقاط والتسطير السفلي والواصلات بحد أقصى 64 حرفا. الأسماء التالية محجوزة: الأحداث، fileNotifications، $default. يجب أن تكون أسماء نقاط النهاية فريدة عبر أنواع نقاط النهاية. لا يجب أن يكون الاسم هو نفس اسم قائمة الانتظار الفعلي. خيط

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

RoutingServiceBusTopicEndpointProperties

اسم وصف قيمة
نوع المصادقة الأسلوب المستخدم للمصادقة مقابل نقطة نهاية موضوع ناقل الخدمة "identityBased"
"keyBased"
سلسلة الاتصال سلسلة الاتصال لنقطة نهاية موضوع ناقل الخدمة. خيط

القيود:
قيمة حساسة. تمرير كمعلمة آمنة.
endpointUri عنوان URL لنقطة نهاية موضوع ناقل الخدمة. يجب أن يتضمن sb:// البروتوكول خيط
مسار الكيان اسم قائمة الانتظار في موضوع ناقل الخدمة خيط
معرف معرف نقطة نهاية موضوع ناقل الخدمة خيط
الهوية خصائص الهوية المدارة لتوجيه نقطة نهاية موضوع ناقل خدمة Microsoft Azure. ManagedIdentity
اسم الاسم الذي يعرف نقطة النهاية هذه. يمكن أن يتضمن الاسم الأحرف الأبجدية الرقمية والنقاط والتسطير السفلي والواصلات بحد أقصى 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}. جميع المعلمات إلزامية ولكن يمكن إعادة ترتيبها. خيط
معرف معرف نقطة نهاية حاوية التخزين خيط
الهوية خصائص الهوية المدارة لتوجيه نقطة نهاية التخزين. ManagedIdentity
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 المحدد. سلسلة (مطلوب)
الهوية خصائص الهوية المدارة لنقطة نهاية التخزين لتحميل الملف. ManagedIdentity
sasTtlAsIso8601 الفترة الزمنية التي يكون فيها SAS URI الذي تم إنشاؤه بواسطة IoT Hub لتحميل الملف صالحا. راجع: /azure/iot-hub/iot-hub-devguide-file-upload#file-upload-notification-configuration-options. خيط

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

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

قالب وصف
إنشاء بيئة الدفع حسب الاستخدام (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@2023-06-30-preview"
  name = "string"
  etag = "string"
  identity = {
    type = "string"
    userAssignedIdentities = {
      {customized property} = {
      }
    }
  }
  location = "string"
  body = jsonencode({
    properties = {
      allowedFqdnList = [
        "string"
      ]
      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"
        ]
      }
      disableDeviceSAS = bool
      disableLocalAuth = bool
      disableModuleSAS = bool
      enableDataResidency = bool
      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"
        }
      ]
      ipVersion = "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"
      restrictOutboundNetworkAccess = bool
      rootCertificate = {
        enableRootCertificateV2 = bool
      }
      routing = {
        endpoints = {
          cosmosDBSqlContainers = [
            {
              authenticationType = "string"
              containerName = "string"
              databaseName = "string"
              endpointUri = "string"
              id = "string"
              identity = {
                userAssignedIdentity = "string"
              }
              name = "string"
              partitionKeyName = "string"
              partitionKeyTemplate = "string"
              primaryKey = "string"
              resourceGroup = "string"
              secondaryKey = "string"
              subscriptionId = "string"
            }
          ]
          eventHubs = [
            {
              authenticationType = "string"
              connectionString = "string"
              endpointUri = "string"
              entityPath = "string"
              id = "string"
              identity = {
                userAssignedIdentity = "string"
              }
              name = "string"
              resourceGroup = "string"
              subscriptionId = "string"
            }
          ]
          serviceBusQueues = [
            {
              authenticationType = "string"
              connectionString = "string"
              endpointUri = "string"
              entityPath = "string"
              id = "string"
              identity = {
                userAssignedIdentity = "string"
              }
              name = "string"
              resourceGroup = "string"
              subscriptionId = "string"
            }
          ]
          serviceBusTopics = [
            {
              authenticationType = "string"
              connectionString = "string"
              endpointUri = "string"
              entityPath = "string"
              id = "string"
              identity = {
                userAssignedIdentity = "string"
              }
              name = "string"
              resourceGroup = "string"
              subscriptionId = "string"
            }
          ]
          storageContainers = [
            {
              authenticationType = "string"
              batchFrequencyInSeconds = int
              connectionString = "string"
              containerName = "string"
              encoding = "string"
              endpointUri = "string"
              fileNameFormat = "string"
              id = "string"
              identity = {
                userAssignedIdentity = "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"
          identity = {
            userAssignedIdentity = "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'
"غير صالح"
'MqttBrokerMessages'
'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

اسم وصف قيمة
allowedFqdnList قائمة FQDNs المسموح بها (اسم المجال المؤهل بالكامل) للخروج من Iot Hub. سلسلة[]
نهج التخويل نهج الوصول المشتركة التي يمكنك استخدامها لتأمين اتصال بمركز IoT. SharedAccessSignatureAuthorizationRule[]
cloudToDevice خصائص المراسلة من سحابة إلى جهاز لمركز IoT. CloudToDeviceProperties
التعليقات تعليقات مركز IoT. خيط
deviceStreams يقوم الجهاز ببث خصائص iothub. IotHubPropertiesDeviceStreams
disableDeviceSAS إذا كان صحيحا، لا يمكن استخدام جميع مفاتيح SAS المحددة في نطاق الجهاز (بما في ذلك أجهزة Edge ولكن باستثناء الوحدات النمطية) للمصادقة. قيمة منطقية
تعطيلLocalAuth إذا كان صحيحا، لا يمكن استخدام رموز SAS المميزة مع مفاتيح SAS ذات نطاق مركز Iot للمصادقة. قيمة منطقية
تعطيلModuleSAS إذا كان صحيحا، لا يمكن استخدام جميع مفاتيح SAS التي تم تحديد نطاقها للوحدة النمطية للمصادقة. قيمة منطقية
enableDataResidency هذه الخاصية عند تعيينها إلى true، ستمكن موقع البيانات، وبالتالي، تعطيل التعافي من الكوارث. قيمة منطقية
enableFileUploadNotifications إذا كانت True، يتم تمكين إعلامات تحميل الملفات. قيمة منطقية
التشفير خصائص التشفير لمركز IoT. تشفير PropertiesDescription
نقاط نهاية eventHub خصائص نقطة النهاية المتوافقة مع Event Hub. المفاتيح الوحيدة الممكنة لهذا القاموس هي الأحداث. يجب أن يكون هذا المفتاح موجودا في القاموس أثناء إجراء مكالمات إنشاء أو تحديث لمركز IoT. IotHubPropertiesEventHubEndpoints
ملامح الإمكانات والميزات الممكنة لمركز IoT. "إدارة الجهاز"
"بلا"
ipFilterRules قواعد عامل تصفية IP. IpFilterRule[]
ipVersion تحدد هذه الخاصية إصدار IP الذي يستخدمه المركز حاليا. 'ipv4'
'ipv4ipv6'
'ipv6'
نقاط نهاية المراسلة خصائص نقطة نهاية المراسلة لقائمة انتظار إعلام تحميل الملف. IotHubPropertiesMessagingEndpoints
minTlsVersion يحدد الحد الأدنى لإصدار TLS لدعم هذا المركز. يمكن تعيين إلى "1.2" ليتم رفض العملاء الذين يستخدمون إصدار TLS أقل من 1.2. خيط
networkRuleSets خصائص مجموعة قواعد الشبكة ل IotHub NetworkRuleSetProperties
اتصالات نقطة النهاية الخاصة اتصالات نقطة النهاية الخاصة التي تم إنشاؤها على IotHub هذا PrivateEndpointConnection []
publicNetworkAccess ما إذا كان مسموحا بالطلبات الواردة من الشبكة العامة "معطل"
"ممكن"
تقييدOutboundNetworkAccess إذا كان صحيحا، تقييد الخروج من IotHub إلى FQDNs المسموح بها فقط التي تم تكوينها عبر allowedFqdnList. قيمة منطقية
rootCertificate تخزن هذه الخاصية المعلومات المتعلقة بشهادة الجذر RootCertificateProperties
التوجيه الخصائص ذات الصلة للتوجيه لمركز 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 للقاعدة. سلسلة (مطلوب)

خصائص KeyVaultKey

اسم وصف قيمة
الهوية خصائص الهوية المدارة ل KeyVault Key. ManagedIdentity
معرف المفتاح معرف المفتاح. خيط

معرف مدار

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

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

اسم وصف قيمة
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@2023-06-30-preview"

NetworkRuleSetIpRule

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

خصائص NetworkRuleSet

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

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

اسم وصف قيمة

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

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

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

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

PrivateLinkServiceConnectionState

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

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

اسم وصف قيمة

RootCertificateProperties

اسم وصف قيمة
enableRootCertificateV2 عند تعيين هذه الخاصية إلى true، سيستخدم المركز شهادة G2؛ بينما يتم تعيينه على false، يستخدم hub شهادة بالتيمور. قيمة منطقية

خصائص المسار

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

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

RoutingCosmosDBSqlApiProperties

اسم وصف قيمة
نوع المصادقة الأسلوب المستخدم للمصادقة مقابل نقطة نهاية حاوية cosmos DB sql "identityBased"
"keyBased"
اسم الحاوية اسم حاوية cosmos DB sql في قاعدة بيانات cosmos DB. سلسلة (مطلوب)
اسم قاعدة البيانات اسم قاعدة بيانات cosmos DB في حساب cosmos DB. سلسلة (مطلوب)
endpointUri عنوان URL لحساب cosmos DB. يجب أن يتضمن https:// البروتوكول سلسلة (مطلوب)
معرف معرف نقطة نهاية حاوية cosmos DB sql خيط
الهوية خصائص الهوية المدارة لتوجيه نقطة نهاية حاوية cosmos DB. ManagedIdentity
اسم الاسم الذي يعرف نقطة النهاية هذه. يمكن أن يتضمن الاسم الأحرف الأبجدية الرقمية والنقاط والتسطير السفلي والواصلات بحد أقصى 64 حرفا. الأسماء التالية محجوزة: الأحداث، fileNotifications، $default. يجب أن تكون أسماء نقاط النهاية فريدة عبر أنواع نقاط النهاية. خيط

القيود:
النمط = ^[A-Za-z0-9-._]{1,64}$ (مطلوب)
partitionKeyName اسم مفتاح القسم المقترن بحاوية cosmos DB sql هذه إذا كان موجودا. هذه معلمة اختيارية. خيط
partitionKeyTemplate القالب لإنشاء قيمة مفتاح قسم اصطناعي للاستخدام مع حاوية cosmos DB sql هذه. يجب أن يتضمن القالب واحدا على الأقل من العناصر النائبة التالية: {iothub}، و{deviceid}، و{DD}، و{MM}، و{YYYY}. يمكن تحديد أي عنصر نائب واحد مرة واحدة على الأكثر، ولكن مكونات الترتيب وغير العنصر النائب عشوائية. هذه المعلمة مطلوبة فقط إذا تم تحديد PartitionKeyName. خيط
مفتاح أساسي المفتاح الأساسي لحساب cosmos DB. خيط

القيود:
قيمة حساسة. تمرير كمعلمة آمنة.
مجموعة الموارد اسم مجموعة الموارد لحساب cosmos DB. خيط
مفتاح ثانوي المفتاح الثانوي لحساب cosmos DB. خيط

القيود:
قيمة حساسة. تمرير كمعلمة آمنة.
معرف الاشتراك معرف الاشتراك لحساب cosmos DB. خيط

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

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

RoutingEventHubProperties

اسم وصف قيمة
نوع المصادقة الأسلوب المستخدم للمصادقة مقابل نقطة نهاية مركز الحدث "identityBased"
"keyBased"
سلسلة الاتصال سلسلة الاتصال لنقطة نهاية مركز الحدث. خيط

القيود:
قيمة حساسة. تمرير كمعلمة آمنة.
endpointUri عنوان URL لنقطة نهاية مركز الحدث. يجب أن يتضمن sb:// البروتوكول خيط
مسار الكيان اسم مركز الحدث على مساحة اسم مركز الحدث خيط
معرف معرف نقطة نهاية مركز الحدث خيط
الهوية خصائص الهوية المدارة لتوجيه نقطة نهاية مركز الحدث. ManagedIdentity
اسم الاسم الذي يعرف نقطة النهاية هذه. يمكن أن يتضمن الاسم الأحرف الأبجدية الرقمية والنقاط والتسطير السفلي والواصلات بحد أقصى 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:// البروتوكول خيط
مسار الكيان اسم قائمة الانتظار على مساحة اسم ناقل الخدمة خيط
معرف معرف نقطة نهاية قائمة انتظار ناقل الخدمة خيط
الهوية خصائص الهوية المدارة لتوجيه نقطة نهاية قائمة انتظار ناقل خدمة Microsoft Azure. ManagedIdentity
اسم الاسم الذي يعرف نقطة النهاية هذه. يمكن أن يتضمن الاسم الأحرف الأبجدية الرقمية والنقاط والتسطير السفلي والواصلات بحد أقصى 64 حرفا. الأسماء التالية محجوزة: الأحداث، fileNotifications، $default. يجب أن تكون أسماء نقاط النهاية فريدة عبر أنواع نقاط النهاية. لا يجب أن يكون الاسم هو نفس اسم قائمة الانتظار الفعلي. خيط

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

RoutingServiceBusTopicEndpointProperties

اسم وصف قيمة
نوع المصادقة الأسلوب المستخدم للمصادقة مقابل نقطة نهاية موضوع ناقل الخدمة "identityBased"
"keyBased"
سلسلة الاتصال سلسلة الاتصال لنقطة نهاية موضوع ناقل الخدمة. خيط

القيود:
قيمة حساسة. تمرير كمعلمة آمنة.
endpointUri عنوان URL لنقطة نهاية موضوع ناقل الخدمة. يجب أن يتضمن sb:// البروتوكول خيط
مسار الكيان اسم قائمة الانتظار في موضوع ناقل الخدمة خيط
معرف معرف نقطة نهاية موضوع ناقل الخدمة خيط
الهوية خصائص الهوية المدارة لتوجيه نقطة نهاية موضوع ناقل خدمة Microsoft Azure. ManagedIdentity
اسم الاسم الذي يعرف نقطة النهاية هذه. يمكن أن يتضمن الاسم الأحرف الأبجدية الرقمية والنقاط والتسطير السفلي والواصلات بحد أقصى 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}. جميع المعلمات إلزامية ولكن يمكن إعادة ترتيبها. خيط
معرف معرف نقطة نهاية حاوية التخزين خيط
الهوية خصائص الهوية المدارة لتوجيه نقطة نهاية التخزين. ManagedIdentity
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 المحدد. سلسلة (مطلوب)
الهوية خصائص الهوية المدارة لنقطة نهاية التخزين لتحميل الملف. ManagedIdentity
sasTtlAsIso8601 الفترة الزمنية التي يكون فيها SAS URI الذي تم إنشاؤه بواسطة IoT Hub لتحميل الملف صالحا. راجع: /azure/iot-hub/iot-hub-devguide-file-upload#file-upload-notification-configuration-options. خيط