Microsoft.Devices IotHubs

تعريف مورد Bicep

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

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

تنسيق المورد

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

resource symbolicname 'Microsoft.Devices/IotHubs@2023-06-30' = {
  name: 'string'
  location: 'string'
  tags: {
    tagName1: 'tagValue1'
    tagName2: 'tagValue2'
  }
  sku: {
    capacity: int
    name: 'string'
  }
  etag: 'string'
  identity: {
    type: 'string'
    userAssignedIdentities: {
      {customized property}: {}
    }
  }
  properties: {
    allowedFqdnList: [
      'string'
    ]
    authorizationPolicies: [
      {
        keyName: 'string'
        primaryKey: 'string'
        rights: 'string'
        secondaryKey: 'string'
        keyName: 'string'
        primaryKey: 'string'
        rights: 'string'
        secondaryKey: 'string'
      }
    ]
    cloudToDevice: {
      defaultTtlAsIso8601: 'string'
      feedback: {
        lockDurationAsIso8601: 'string'
        maxDeliveryCount: int
        ttlAsIso8601: 'string'
      }
      maxDeliveryCount: int
    }
    comments: 'string'
    disableDeviceSAS: bool
    disableLocalAuth: bool
    disableModuleSAS: bool
    enableDataResidency: bool
    enableFileUploadNotifications: bool
    eventHubEndpoints: {
      {customized property}: {
        partitionCount: int
        retentionTimeInDays: int
      }
    }
    features: 'string'
    ipFilterRules: [
      {
        action: 'string'
        filterName: 'string'
        ipMask: 'string'
      }
    ]
    messagingEndpoints: {
      {customized property}: {
        lockDurationAsIso8601: 'string'
        maxDeliveryCount: int
        ttlAsIso8601: 'string'
      }
    }
    minTlsVersion: 'string'
    networkRuleSets: {
      applyToBuiltInEventHubEndpoint: bool
      defaultAction: 'string'
      ipRules: [
        {
          action: 'Allow'
          filterName: 'string'
          ipMask: 'string'
        }
      ]
    }
    privateEndpointConnections: [
      {
        properties: {
          privateEndpoint: {}
          privateLinkServiceConnectionState: {
            actionsRequired: 'string'
            description: 'string'
            status: 'string'
          }
        }
      }
    ]
    publicNetworkAccess: 'string'
    restrictOutboundNetworkAccess: bool
    routing: {
      endpoints: {
        cosmosDBSqlContainers: [
          {
            authenticationType: 'string'
            containerName: 'string'
            databaseName: 'string'
            endpointUri: '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'
      }
    }
  }
}

قيم Property

IotHubs

الاسم الوصف القيمة
الاسم اسم المورد سلسلة (مطلوبة)

حد الحرف: 3-50

الأحرف الصالحة:
الأبجدية الرقمية والواصلات.

لا يمكنك أن تنهي بالواصلة.

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

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

الاسم الوصف القيمة
النوع نوع الهوية المستخدمة للمورد. يشتمل النوع "SystemAssigned، UserAssigned" على كل من هوية تم إنشاؤها ضمنيّاً ومجموعة من الهويات المعينة من قِبل المستخدم. سيقوم النوع "بلا" بإزالة أي هويات من الخدمة. 'بلا'
'SystemAssigned'
'SystemAssigned, UserAssigned'
"تعيين المستخدم"
userAssignedIdentities قاموس {ArmUserIdentity} معرفات ArmIdentityUserAssignedIdentities

معرفات ArmIdentityUserAssignedIdentities

الاسم الوصف القيمة
{خاصية مخصصة} ArmUserIdentity

ArmUserIdentity

لا يحتوي هذا الكائن على أي خصائص لتعيينها أثناء التوزيع. جميع الخصائص هي ReadOnly.

IotHubProperties

الاسم الوصف القيمة
allowedFqdnList قائمة FQDNs المسموح بها (اسم المجال المؤهل بالكامل) للانحدار من Iot Hub. سلسلة []
نهج التخويل نهج الوصول المشتركة التي يمكنك استخدامها لتأمين اتصال بمركز IoT. SharedAccessSignatureAuthorizationRule[]
cloudToDevice خصائص المراسلة من السحابة إلى الجهاز لمركز IoT. CloudToDeviceProperties
تعليقات تعليقات مركز IoT. سلسلة
disableDeviceSAS إذا كان صحيحا، فلا يمكن استخدام جميع مفاتيح SAS المحددة النطاق للجهاز (بما في ذلك أجهزة Edge ولكن باستثناء الوحدات النمطية) للمصادقة. Bool
disableLocalAuth إذا كان صحيحا، لا يمكن استخدام رموز SAS المميزة مع مفاتيح SAS ذات نطاق مركز Iot للمصادقة. Bool
disableModuleSAS إذا كان صحيحا، لا يمكن استخدام جميع مفاتيح SAS التي تم تحديد نطاقها للوحدة النمطية للمصادقة. Bool
enableDataResidency هذه الخاصية عند تعيينها إلى true، ستمكن موقع البيانات، وبالتالي، تعطيل الإصلاح بعد كارثة. Bool
enableFileUploadNotifications إذا كان True، يتم تمكين إعلامات تحميل الملفات. Bool
نقاط الانتهاء الخاصة بمركز الحدث خصائص نقطة النهاية المتوافقة مع Event Hub. المفاتيح الوحيدة الممكنة لهذا القاموس هي الأحداث. يجب أن يكون هذا المفتاح موجودا في القاموس أثناء إجراء استدعاءات إنشاء أو تحديث لمركز IoT. IotHubPropertiesEventHubEndpoints
features الإمكانات والميزات الممكنة لمركز IoT. "إدارة الجهاز"
'بلا'
ipFilterRules قواعد عامل تصفية IP. IpFilterRule[]
نقاط نهاية المراسلة خصائص نقطة نهاية المراسلة لقائمة انتظار إعلام تحميل الملف. IotHubPropertiesMessagingEndpoints
minTlsVersion يحدد الحد الأدنى من إصدار TLS لدعم هذا المركز. يمكن تعيين إلى "1.2" لرفض العملاء الذين يستخدمون إصدار TLS أقل من 1.2. سلسلة
networkRuleSets خصائص مجموعة قواعد الشبكة ل IotHub NetworkRuleSetProperties
اتصالات نقطة النهاية الخاصة اتصالات نقطة النهاية الخاصة التي تم إنشاؤها على IotHub هذا PrivateEndpointConnection[]
publicNetworkAccess ما إذا كان مسموحا بالطلبات الواردة من الشبكة العامة "معطل"
"ممكن"
تقييدOutboundNetworkAccess إذا كان صحيحا، فسيتم تقييد الخروج من IotHub فقط إلى FQDNs المسموح بها التي تم تكوينها عبر allowedFqdnList. Bool
التوجيه الخصائص ذات الصلة بالتوجيه لمركز IoT. راجع: /azure/iot-hub/iot-hub-devguide-messaging RoutingProperties
نقاط نهاية التخزين قائمة نقاط نهاية Azure Storage حيث يمكنك تحميل الملفات. يمكنك حاليا تكوين حساب Azure Storage واحد فقط ويجب أن يكون مفتاحه $default. يؤدي تحديد أكثر من حساب تخزين واحد إلى ظهور خطأ. يؤدي عدم تحديد قيمة لهذه الخاصية عند تعيين الخاصية enableFileUploadNotifications إلى True إلى ظهور خطأ. IotHubPropertiesStorageEndpoints

SharedAccessSignatureAuthorizationRule

الاسم الوصف القيمة
keyName اسم نهج الوصول المشترك. سلسلة (مطلوب)
primaryKey المفتاح الأساسي. سلسلة
حقوق الأذونات المعينة لنهج الوصول المشترك. "اتصال الجهاز"
'RegistryRead'
'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"
'ServiceConnect, DeviceConnect' (مطلوب)
مفتاح ثانوي المفتاح الثانوي. سلسلة
keyName اسم نهج الوصول المشترك. سلسلة (مطلوب)
primaryKey المفتاح الأساسي. سلسلة
حقوق الأذونات المعينة لنهج الوصول المشترك. "اتصال الجهاز"
'RegistryRead'
'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"
'ServiceConnect, DeviceConnect' (مطلوب)
مفتاح ثانوي المفتاح الثانوي. سلسلة

CloudToDeviceProperties

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

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

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

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

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

IotHubPropertiesEventHubEndpoints

الاسم الوصف القيمة
{خاصية مخصصة} EventHubProperties

EventHubProperties

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

IpFilterRule

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

IotHubPropertiesMessagingEndpoints

الاسم الوصف القيمة
{خاصية مخصصة} MessagingEndpointProperties

MessagingEndpointProperties

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

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

NetworkRuleSetProperties

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

NetworkRuleSetIpRule

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

PrivateEndpointConnection

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

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

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

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

لا يحتوي هذا الكائن على أي خصائص لتعيينها أثناء التوزيع. جميع الخصائص هي ReadOnly.

PrivateLinkServiceConnectionState

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

RoutingProperties

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

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

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

RoutingCosmosDBSqlApiProperties

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

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

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

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

MANAGEDIDENTITY

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

RoutingEventHubProperties

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

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

RoutingServiceBusQueueEndpointProperties

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

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

RoutingServiceBusTopicEndpointProperties

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

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

RoutingStorageContainerProperties

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

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

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

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

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

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

القيود:
الحد الأدنى للطول = 1
المفتاح المفتاح أو الاسم الخاص بخاصية الإثراء. سلسلة (مطلوب)
القيمة قيمة خاصية الإثراء. سلسلة (مطلوب)

الاحتياطيةRouteProperties

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

القيود:
الحد الأدنى للطول = 1
الحد الأقصى للطول = 1
isEnabled يستخدم لتحديد ما إذا كان المسار الاحتياطي ممكنا أم لا. bool (مطلوب)
الاسم اسم المسار. يمكن أن يتضمن الاسم فقط الأحرف الأبجدية الرقمية والنقاط والتسطير السفلي والواصلات، ويبلغ الحد الأقصى لطوله 64 حرفا، ويجب أن يكون فريدا. سلسلة
المصدر المصدر الذي سيتم تطبيق قاعدة التوجيه عليه. على سبيل المثال، DeviceMessages 'DeviceConnectionStateEvents'
"أحداث دورة حياة الجهاز"
"أحداث دورة حياة الجهاز"
"DeviceMessages"
"غير صالح"
'TwinChangeEvents' (مطلوب)

خصائص المسار

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

القيود:
الحد الأدنى للطول = 1
الحد الأقصى للطول = 1
isEnabled يستخدم لتحديد ما إذا كان المسار ممكنا أم لا. bool (مطلوب)
الاسم اسم المسار. يمكن أن يتضمن الاسم فقط الأحرف الأبجدية الرقمية والنقاط والتسطير السفلي والواصلات، ويبلغ الحد الأقصى لطوله 64 حرفا، ويجب أن يكون فريدا. سلسلة (مطلوب)

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

IotHubPropertiesStorageEndpoints

الاسم الوصف القيمة
{خاصية مخصصة} StorageEndpointProperties

StorageEndpointProperties

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

IotHubSkuInfo

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

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

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

قالب الوصف
إنشاء محاكي IOT Hub وUbuntu edge

نشر في Azure
ينشئ هذا القالب IOT Hub ومحاكي Ubuntu Edge للجهاز الظاهري.
استخدام قالب ARM لإنشاء IoT Hub وتوجيه الرسائل وعرضها

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

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

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

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

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

نشر في Azure
يمكنك هذا القالب من نشر بيئة Pay As You Go (PAYG) Time Series Insights التي تم تكوينها لاستهلاك الأحداث من IoT Hub.

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

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

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

تنسيق المورد

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

{
  "type": "Microsoft.Devices/IotHubs",
  "apiVersion": "2023-06-30",
  "name": "string",
  "location": "string",
  "tags": {
    "tagName1": "tagValue1",
    "tagName2": "tagValue2"
  },
  "sku": {
    "capacity": "int",
    "name": "string"
  },
  "etag": "string",
  "identity": {
    "type": "string",
    "userAssignedIdentities": {
      "{customized property}": {}
    }
  },
  "properties": {
    "allowedFqdnList": [ "string" ],
    "authorizationPolicies": [
      {
        "keyName": "string",
        "primaryKey": "string",
        "rights": "string",
        "secondaryKey": "string",
        "keyName": "string",
        "primaryKey": "string",
        "rights": "string",
        "secondaryKey": "string"
      }
    ],
    "cloudToDevice": {
      "defaultTtlAsIso8601": "string",
      "feedback": {
        "lockDurationAsIso8601": "string",
        "maxDeliveryCount": "int",
        "ttlAsIso8601": "string"
      },
      "maxDeliveryCount": "int"
    },
    "comments": "string",
    "disableDeviceSAS": "bool",
    "disableLocalAuth": "bool",
    "disableModuleSAS": "bool",
    "enableDataResidency": "bool",
    "enableFileUploadNotifications": "bool",
    "eventHubEndpoints": {
      "{customized property}": {
        "partitionCount": "int",
        "retentionTimeInDays": "int"
      }
    },
    "features": "string",
    "ipFilterRules": [
      {
        "action": "string",
        "filterName": "string",
        "ipMask": "string"
      }
    ],
    "messagingEndpoints": {
      "{customized property}": {
        "lockDurationAsIso8601": "string",
        "maxDeliveryCount": "int",
        "ttlAsIso8601": "string"
      }
    },
    "minTlsVersion": "string",
    "networkRuleSets": {
      "applyToBuiltInEventHubEndpoint": "bool",
      "defaultAction": "string",
      "ipRules": [
        {
          "action": "Allow",
          "filterName": "string",
          "ipMask": "string"
        }
      ]
    },
    "privateEndpointConnections": [
      {
        "properties": {
          "privateEndpoint": {},
          "privateLinkServiceConnectionState": {
            "actionsRequired": "string",
            "description": "string",
            "status": "string"
          }
        }
      }
    ],
    "publicNetworkAccess": "string",
    "restrictOutboundNetworkAccess": "bool",
    "routing": {
      "endpoints": {
        "cosmosDBSqlContainers": [
          {
            "authenticationType": "string",
            "containerName": "string",
            "databaseName": "string",
            "endpointUri": "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"
      }
    }
  }
}

قيم Property

IotHubs

الاسم الوصف القيمة
النوع نوع المورد 'Microsoft.Devices/IotHubs'
apiVersion إصدار واجهة برمجة تطبيقات المورد '2023-06-30'
الاسم اسم المورد سلسلة (مطلوبة)

حد الحرف: 3-50

الأحرف الصالحة:
الأبجدية الرقمية والواصلات.

لا يمكنك أن تنهي بالواصلة.

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

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

الاسم الوصف القيمة
النوع نوع الهوية المستخدمة للمورد. يشتمل النوع "SystemAssigned، UserAssigned" على كل من هوية تم إنشاؤها ضمنيّاً ومجموعة من الهويات المعينة من قِبل المستخدم. سيقوم النوع "بلا" بإزالة أي هويات من الخدمة. 'بلا'
'SystemAssigned'
'SystemAssigned, UserAssigned'
"تعيين المستخدم"
userAssignedIdentities قاموس {ArmUserIdentity} معرفات ArmIdentityUserAssignedIdentities

معرفات ArmIdentityUserAssignedIdentities

الاسم الوصف القيمة
{خاصية مخصصة} ArmUserIdentity

ArmUserIdentity

لا يحتوي هذا الكائن على أي خصائص لتعيينها أثناء التوزيع. جميع الخصائص هي ReadOnly.

IotHubProperties

الاسم الوصف القيمة
allowedFqdnList قائمة FQDNs المسموح بها (اسم المجال المؤهل بالكامل) للانحدار من Iot Hub. سلسلة []
نهج التخويل نهج الوصول المشتركة التي يمكنك استخدامها لتأمين اتصال بمركز IoT. SharedAccessSignatureAuthorizationRule[]
cloudToDevice خصائص المراسلة من السحابة إلى الجهاز لمركز IoT. CloudToDeviceProperties
تعليقات تعليقات مركز IoT. سلسلة
disableDeviceSAS إذا كان صحيحا، فلا يمكن استخدام جميع مفاتيح SAS المحددة النطاق للجهاز (بما في ذلك أجهزة Edge ولكن باستثناء الوحدات النمطية) للمصادقة. Bool
disableLocalAuth إذا كان صحيحا، لا يمكن استخدام رموز SAS المميزة مع مفاتيح SAS ذات نطاق مركز Iot للمصادقة. Bool
disableModuleSAS إذا كان صحيحا، لا يمكن استخدام جميع مفاتيح SAS التي تم تحديد نطاقها للوحدة النمطية للمصادقة. Bool
enableDataResidency هذه الخاصية عند تعيينها إلى true، ستمكن موقع البيانات، وبالتالي، تعطيل الإصلاح بعد كارثة. Bool
enableFileUploadNotifications إذا كانت True، يتم تمكين إعلامات تحميل الملفات. Bool
نقاط الانتهاء الخاصة بمركز الحدث خصائص نقطة النهاية المتوافقة مع Event Hub. المفاتيح الوحيدة الممكنة لهذا القاموس هي الأحداث. يجب أن يكون هذا المفتاح موجودا في القاموس أثناء إجراء استدعاءات إنشاء أو تحديث لمركز IoT. نقاط نهاية IotHubPropertiesEventHub
features الإمكانات والميزات الممكنة لمركز IoT. "إدارة الجهاز"
'بلا'
ipFilterRules قواعد عامل تصفية IP. IpFilterRule[]
نقاط نهاية المراسلة خصائص نقطة نهاية المراسلة لقائمة انتظار إعلام تحميل الملف. IotHubPropertiesMessagingEndpoints
minTlsVersion يحدد الحد الأدنى من إصدار TLS لدعم هذا المركز. يمكن تعيين إلى "1.2" لرفض العملاء الذين يستخدمون إصدار TLS أقل من 1.2. سلسلة
networkRuleSets خصائص مجموعة قواعد الشبكة ل IotHub NetworkRuleSetProperties
اتصالات نقطة النهاية الخاصة اتصالات نقطة النهاية الخاصة التي تم إنشاؤها على IotHub هذا PrivateEndpointConnection[]
publicNetworkAccess ما إذا كان مسموحا بالطلبات الواردة من الشبكة العامة "معطل"
"ممكن"
تقييدOutboundNetworkAccess إذا كان صحيحا، فسيتم تقييد الخروج من IotHub إلى FQDNs المسموح بها فقط التي تم تكوينها عبر allowedFqdnList. Bool
التوجيه الخصائص ذات الصلة بالتوجيه لمركز IoT. راجع: /azure/iot-hub/iot-hub-devguide-messaging RoutingProperties
نقاط نهاية التخزين قائمة نقاط نهاية Azure Storage حيث يمكنك تحميل الملفات. يمكنك حاليا تكوين حساب Azure Storage واحد فقط ويجب أن يكون مفتاحه $default. يؤدي تحديد أكثر من حساب تخزين واحد إلى طرح خطأ. يؤدي عدم تحديد قيمة لهذه الخاصية عند تعيين الخاصية enableFileUploadNotifications إلى True إلى ظهور خطأ. IotHubPropertiesStorageEndpoints

SharedAccessSignatureAuthorizationRule

الاسم الوصف القيمة
keyName اسم نهج الوصول المشترك. سلسلة (مطلوبة)
primaryKey المفتاح الأساسي. سلسلة
حقوق الأذونات المعينة لنهج الوصول المشترك. 'DeviceConnect'
'RegistryRead'
'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"
'ServiceConnect, DeviceConnect' (مطلوب)
مفتاح ثانوي المفتاح الثانوي. سلسلة
keyName اسم نهج الوصول المشترك. سلسلة (مطلوبة)
primaryKey المفتاح الأساسي. سلسلة
حقوق الأذونات المعينة لنهج الوصول المشترك. 'DeviceConnect'
'RegistryRead'
'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"
'ServiceConnect, DeviceConnect' (مطلوب)
مفتاح ثانوي المفتاح الثانوي. سلسلة

CloudToDeviceProperties

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

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

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

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

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

IotHubPropertiesEventHubEndpoints

الاسم الوصف القيمة
{خاصية مخصصة} EventHubProperties

EventHubProperties

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

IpFilterRule

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

IotHubPropertiesMessagingEndpoints

الاسم الوصف القيمة
{خاصية مخصصة} MessagingEndpointProperties

MessagingEndpointProperties

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

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

NetworkRuleSetProperties

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

NetworkRuleSetIpRule

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

PrivateEndpointConnection

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

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

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

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

لا يحتوي هذا الكائن على أي خصائص لتعيينها أثناء التوزيع. جميع الخصائص هي ReadOnly.

PrivateLinkServiceConnectionState

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

RoutingProperties

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

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

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

RoutingCosmosDBSqlApiProperties

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

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

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

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

MANAGEDIDENTITY

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

RoutingEventHubProperties

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

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

RoutingServiceBusQueueEndpointProperties

الاسم الوصف القيمة
نوع المصادقة الأسلوب المستخدم للمصادقة مقابل نقطة نهاية قائمة انتظار ناقل الخدمة 'identityBased'
"keyBased"
سلسلة الاتصال سلسلة الاتصال نقطة نهاية قائمة انتظار ناقل الخدمة. سلسلة
endpointUri عنوان URL لنقطة نهاية قائمة انتظار ناقل الخدمة. يجب أن يتضمن البروتوكول sb:// سلسلة
entityPath اسم قائمة الانتظار على مساحة اسم ناقل الخدمة سلسلة
المعرف معرف نقطة نهاية قائمة انتظار ناقل الخدمة سلسلة
الهوية خصائص الهوية المدارة لتوجيه نقطة نهاية قائمة انتظار ناقل خدمة Microsoft Azure. ManagedIdentity
الاسم الاسم الذي يعرف نقطة النهاية هذه. يمكن أن يتضمن الاسم فقط الأحرف الأبجدية الرقمية والنقاط والتسطير السفلي والواصلات ويبلغ الحد الأقصى لطوله 64 حرفا. الأسماء التالية محجوزة: الأحداث، وملفات التعليقات التوضيحية، $default. يجب أن تكون أسماء نقاط النهاية فريدة عبر أنواع نقاط النهاية. لا يجب أن يكون الاسم هو نفس اسم قائمة الانتظار الفعلي. سلسلة (مطلوب)

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

RoutingServiceBusTopicEndpointProperties

الاسم الوصف القيمة
نوع المصادقة الأسلوب المستخدم للمصادقة مقابل نقطة نهاية موضوع ناقل الخدمة 'identityBased'
"keyBased"
سلسلة الاتصال سلسلة الاتصال نقطة نهاية موضوع ناقل الخدمة. سلسلة
endpointUri عنوان URL لنقطة نهاية موضوع ناقل الخدمة. يجب أن يتضمن البروتوكول sb:// سلسلة
entityPath اسم قائمة الانتظار في موضوع ناقل الخدمة سلسلة
المعرف معرف نقطة نهاية موضوع ناقل الخدمة سلسلة
الهوية خصائص الهوية المدارة لتوجيه نقطة نهاية موضوع ناقل خدمة Microsoft Azure. ManagedIdentity
الاسم الاسم الذي يعرف نقطة النهاية هذه. يمكن أن يتضمن الاسم فقط الأحرف الأبجدية الرقمية والنقاط والتسطير السفلي والواصلات ويبلغ الحد الأقصى لطوله 64 حرفا. الأسماء التالية محجوزة: الأحداث، وملفات التعليقات التوضيحية، $default. يجب أن تكون أسماء نقاط النهاية فريدة عبر أنواع نقاط النهاية. لا يجب أن يكون الاسم هو نفس اسم الموضوع الفعلي. سلسلة (مطلوب)

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

RoutingStorageContainerProperties

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

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

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

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

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

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

القيود:
الحد الأدنى للطول = 1
المفتاح المفتاح أو الاسم الخاص بخاصية الإثراء. سلسلة (مطلوب)
القيمة قيمة خاصية الإثراء. سلسلة (مطلوب)

الاحتياطيةRouteProperties

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

القيود:
الحد الأدنى للطول = 1
الحد الأقصى للطول = 1
isEnabled يستخدم لتحديد ما إذا كان المسار الاحتياطي ممكنا أم لا. bool (مطلوب)
الاسم اسم المسار. يمكن أن يتضمن الاسم فقط الأحرف الأبجدية الرقمية والنقاط والتسطير السفلي والواصلات، ويبلغ الحد الأقصى لطوله 64 حرفا، ويجب أن يكون فريدا. سلسلة
المصدر المصدر الذي سيتم تطبيق قاعدة التوجيه عليه. على سبيل المثال، DeviceMessages 'DeviceConnectionStateEvents'
"أحداث دورة حياة الجهاز"
"أحداث دورة حياة الجهاز"
"DeviceMessages"
"غير صالح"
'TwinChangeEvents' (مطلوب)

خصائص المسار

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

القيود:
الحد الأدنى للطول = 1
الحد الأقصى للطول = 1
isEnabled يستخدم لتحديد ما إذا كان المسار ممكنا أم لا. bool (مطلوب)
الاسم اسم المسار. يمكن أن يتضمن الاسم الأحرف الأبجدية الرقمية والنقاط والتسطير السفلي والواصلات بحد أقصى 64 حرفا، ويجب أن يكون فريدا. سلسلة (مطلوبة)

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

IotHubPropertiesStorageEndpoints

الاسم الوصف القيمة
{خاصية مخصصة} خصائص StorageEndpoint

خصائص StorageEndpoint

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

IotHubSkuInfo

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

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

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

قالب الوصف
إنشاء IOT Hub ومحاكي Ubuntu edge

نشر في Azure
ينشئ هذا القالب IOT Hub ومحاكي Ubuntu Edge للجهاز الظاهري.
استخدام قالب ARM لإنشاء IoT Hub وتوجيه الرسائل وعرضها

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

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

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

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

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

نشر في Azure
يمكنك هذا القالب من نشر بيئة Pay As You Go (PAYG) Time Series Insights التي تم تكوينها لاستهلاك الأحداث من IoT Hub.

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

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

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

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

تنسيق المورد

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

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.Devices/IotHubs@2023-06-30"
  name = "string"
  location = "string"
  parent_id = "string"
  tags = {
    tagName1 = "tagValue1"
    tagName2 = "tagValue2"
  }
  identity {
    type = "string"
    identity_ids = []
  }
  body = jsonencode({
    properties = {
      allowedFqdnList = [
        "string"
      ]
      authorizationPolicies = [
        {
          keyName = "string"
          primaryKey = "string"
          rights = "string"
          secondaryKey = "string"
          keyName = "string"
          primaryKey = "string"
          rights = "string"
          secondaryKey = "string"
        }
      ]
      cloudToDevice = {
        defaultTtlAsIso8601 = "string"
        feedback = {
          lockDurationAsIso8601 = "string"
          maxDeliveryCount = int
          ttlAsIso8601 = "string"
        }
        maxDeliveryCount = int
      }
      comments = "string"
      disableDeviceSAS = bool
      disableLocalAuth = bool
      disableModuleSAS = bool
      enableDataResidency = bool
      enableFileUploadNotifications = bool
      eventHubEndpoints = {
        {customized property} = {
          partitionCount = int
          retentionTimeInDays = int
        }
      }
      features = "string"
      ipFilterRules = [
        {
          action = "string"
          filterName = "string"
          ipMask = "string"
        }
      ]
      messagingEndpoints = {
        {customized property} = {
          lockDurationAsIso8601 = "string"
          maxDeliveryCount = int
          ttlAsIso8601 = "string"
        }
      }
      minTlsVersion = "string"
      networkRuleSets = {
        applyToBuiltInEventHubEndpoint = bool
        defaultAction = "string"
        ipRules = [
          {
            action = "Allow"
            filterName = "string"
            ipMask = "string"
          }
        ]
      }
      privateEndpointConnections = [
        {
          properties = {
            privateEndpoint = {}
            privateLinkServiceConnectionState = {
              actionsRequired = "string"
              description = "string"
              status = "string"
            }
          }
        }
      ]
      publicNetworkAccess = "string"
      restrictOutboundNetworkAccess = bool
      routing = {
        endpoints = {
          cosmosDBSqlContainers = [
            {
              authenticationType = "string"
              containerName = "string"
              databaseName = "string"
              endpointUri = "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"
    }
    etag = "string"
  })
}

قيم Property

IotHubs

الاسم الوصف القيمة
النوع نوع المورد "Microsoft.Devices/IotHubs@2023-06-30"
الاسم اسم المورد سلسلة (مطلوب)

حد الحرف: 3-50

أحرف صالحة:
الأبجدية الرقمية والواصلات.

لا يمكنك أن تنهي بالواصلة.

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

ArmIdentity

الاسم الوصف القيمة
النوع نوع الهوية المستخدمة للمورد. يشتمل النوع "SystemAssigned، UserAssigned" على كل من هوية تم إنشاؤها ضمنيّاً ومجموعة من الهويات المعينة من قِبل المستخدم. سيقوم النوع "بلا" بإزالة أي هويات من الخدمة. "SystemAssigned"
"SystemAssigned، UserAssigned"
"UserAssigned"
identity_ids قاموس {ArmUserIdentity} صفيف معرفات هوية المستخدم.

ArmIdentityUserAssignedIdentities

الاسم الوصف القيمة
{خاصية مخصصة} ArmUserIdentity

ArmUserIdentity

لا يحتوي هذا الكائن على أي خصائص لتعيينها أثناء التوزيع. جميع الخصائص هي ReadOnly.

IotHubProperties

الاسم الوصف القيمة
allowedFqdnList قائمة FQDNs المسموح بها (اسم المجال المؤهل بالكامل) للانحراف من Iot Hub. سلسلة []
نهج التخويل نهج الوصول المشتركة التي يمكنك استخدامها لتأمين اتصال بمركز IoT. SharedAccessSignatureAuthorizationRule[]
cloudToDevice خصائص المراسلة من السحابة إلى الجهاز لمركز IoT. CloudToDeviceProperties
تعليقات تعليقات مركز IoT. سلسلة
disableDeviceSAS إذا كان صحيحا، فلا يمكن استخدام جميع مفاتيح SAS المحددة النطاق للجهاز (بما في ذلك أجهزة Edge ولكن باستثناء الوحدات النمطية) للمصادقة. Bool
disableLocalAuth إذا كان صحيحا، لا يمكن استخدام رموز SAS المميزة مع مفاتيح SAS ذات نطاق مركز Iot للمصادقة. Bool
disableModuleSAS إذا كان صحيحا، لا يمكن استخدام جميع مفاتيح SAS التي تم تحديد نطاقها للوحدة النمطية للمصادقة. Bool
enableDataResidency هذه الخاصية عند تعيينها إلى true، ستمكن موقع البيانات، وبالتالي، تعطيل الإصلاح بعد كارثة. Bool
enableFileUploadNotifications إذا كان True، يتم تمكين إعلامات تحميل الملفات. Bool
نقاط الانتهاء الخاصة بمركز الحدث خصائص نقطة النهاية المتوافقة مع Event Hub. المفاتيح الوحيدة الممكنة لهذا القاموس هي الأحداث. يجب أن يكون هذا المفتاح موجودا في القاموس أثناء إجراء استدعاءات إنشاء أو تحديث لمركز IoT. نقاط نهاية IotHubPropertiesEventHub
features الإمكانات والميزات الممكنة لمركز IoT. "إدارة الجهاز"
"لا أحد"
ipFilterRules قواعد عامل تصفية IP. IpFilterRule[]
نقاط نهاية المراسلة خصائص نقطة نهاية المراسلة لقائمة انتظار إعلام تحميل الملف. IotHubPropertiesMessagingEndpoints
minTlsVersion يحدد الحد الأدنى من إصدار TLS لدعم هذا المركز. يمكن تعيين إلى "1.2" لرفض العملاء الذين يستخدمون إصدار TLS أقل من 1.2. سلسلة
networkRuleSets خصائص مجموعة قواعد الشبكة ل IotHub NetworkRuleSetProperties
اتصالات نقطة النهاية الخاصة اتصالات نقطة النهاية الخاصة التي تم إنشاؤها على IotHub هذا PrivateEndpointConnection[]
publicNetworkAccess ما إذا كان مسموحا بالطلبات الواردة من الشبكة العامة "معطل"
"ممكن"
تقييدOutboundNetworkAccess إذا كان صحيحا، فسيتم تقييد الخروج من IotHub إلى FQDNs المسموح بها فقط التي تم تكوينها عبر allowedFqdnList. Bool
التوجيه الخصائص ذات الصلة بالتوجيه لمركز IoT. راجع: /azure/iot-hub/iot-hub-devguide-messaging RoutingProperties
نقاط نهاية التخزين قائمة نقاط نهاية Azure Storage حيث يمكنك تحميل الملفات. يمكنك حاليا تكوين حساب Azure Storage واحد فقط ويجب أن يكون مفتاحه $default. يؤدي تحديد أكثر من حساب تخزين واحد إلى طرح خطأ. يؤدي عدم تحديد قيمة لهذه الخاصية عند تعيين الخاصية enableFileUploadNotifications إلى True إلى ظهور خطأ. IotHubPropertiesStorageEndpoints

SharedAccessSignatureAuthorizationRule

الاسم الوصف القيمة
keyName اسم نهج الوصول المشترك. سلسلة (مطلوبة)
primaryKey المفتاح الأساسي. سلسلة
حقوق الأذونات المعينة لنهج الوصول المشترك. "DeviceConnect"
"RegistryRead"
"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"
"ServiceConnect, DeviceConnect" (مطلوب)
مفتاح ثانوي المفتاح الثانوي. سلسلة
keyName اسم نهج الوصول المشترك. سلسلة (مطلوبة)
primaryKey المفتاح الأساسي. سلسلة
حقوق الأذونات المعينة لنهج الوصول المشترك. "DeviceConnect"
"RegistryRead"
"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"
"ServiceConnect, DeviceConnect" (مطلوب)
مفتاح ثانوي المفتاح الثانوي. سلسلة

CloudToDeviceProperties

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

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

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

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

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

نقاط نهاية IotHubPropertiesEventHub

الاسم الوصف القيمة
{خاصية مخصصة} خصائص EventHub

خصائص EventHub

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

IpFilterRule

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

IotHubPropertiesMessagingEndpoints

الاسم الوصف القيمة
{خاصية مخصصة} MessagingEndpointProperties

MessagingEndpointProperties

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

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

NetworkRuleSetProperties

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

NetworkRuleSetIpRule

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

PrivateEndpointConnection

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

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

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

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

لا يحتوي هذا الكائن على أي خصائص لتعيينها أثناء التوزيع. جميع الخصائص هي ReadOnly.

PrivateLinkServiceConnectionState

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

RoutingProperties

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

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

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

RoutingCosmosDBSqlApiProperties

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

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

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

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

MANAGEDIDENTITY

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

RoutingEventHubProperties

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

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

RoutingServiceBusQueueEndpointProperties

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

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

RoutingServiceBusTopicEndpointProperties

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

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

RoutingStorageContainerProperties

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

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

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

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

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

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

القيود:
الحد الأدنى للطول = 1
المفتاح مفتاح أو اسم خاصية الإثراء. سلسلة (مطلوبة)
القيمة قيمة خاصية الإثراء. سلسلة (مطلوبة)

الاحتياطيةRouteProperties

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

القيود:
الحد الأدنى للطول = 1
الحد الأقصى للطول = 1
isEnabled يستخدم لتحديد ما إذا كان المسار الاحتياطي ممكنا أم لا. bool (مطلوب)
الاسم اسم المسار. يمكن أن يتضمن الاسم الأحرف الأبجدية الرقمية والنقاط والتسطير السفلي والواصلات بحد أقصى 64 حرفا، ويجب أن يكون فريدا. سلسلة
المصدر المصدر الذي سيتم تطبيق قاعدة التحويل عليه. على سبيل المثال، DeviceMessages "أحداث حالة اتصال الجهاز"
"أحداث دورة حياة DeviceJob"
"أحداث دورة حياة الجهاز"
"رسائل الجهاز"
"غير صالح"
"TwinChangeEvents" (مطلوب)

خصائص المسار

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

القيود:
الحد الأدنى للطول = 1
الحد الأقصى للطول = 1
isEnabled يستخدم لتحديد ما إذا كان المسار ممكنا أم لا. bool (مطلوب)
الاسم اسم المسار. يمكن أن يتضمن الاسم الأحرف الأبجدية الرقمية والنقاط والتسطير السفلي والواصلات بحد أقصى 64 حرفا، ويجب أن يكون فريدا. سلسلة (مطلوبة)

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

IotHubPropertiesStorageEndpoints

الاسم الوصف القيمة
{خاصية مخصصة} خصائص StorageEndpoint

خصائص StorageEndpoint

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

IotHubSkuInfo

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