Microsoft.Devices IotHubs 2023-06-30

مقالة
04/08/2024

تعريف مورد 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.	نقاط نهاية 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	إذا كان True، فسيتم تطبيق مجموعة قواعد الشبكة أيضا على BuiltIn EventHub EndPoint من IotHub	bool (مطلوب)
defaultAction	الإجراء الافتراضي لمجموعة قواعد الشبكة	"السماح" "رفض"
ipRules	قائمة قواعد IP	NetworkRuleSetIpRule[] (مطلوب)

NetworkRuleSetIpRule

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

PrivateEndpointConnection

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

PrivateEndpointConnectionProperties

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

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

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

PrivateLinkServiceConnectionState

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

RoutingProperties

الاسم	الوصف	القيمة
نقاط النهاية	الخصائص المتعلقة بنقاط النهاية المخصصة التي يوجه إليها مركز IoT الرسائل استنادا إلى قواعد التوجيه. يسمح بحد أقصى 10 نقاط نهاية مخصصة عبر جميع أنواع نقاط النهاية للمراكز المدفوعة ويسمح بنقطة نهاية مخصصة فقط عبر جميع أنواع نقاط النهاية للمراكز المجانية.	نقاط نهاية التوجيه
عمليات الإثراء	قائمة عمليات الإثراء التي يوفرها المستخدم والتي ينطبق عليها مركز IoT على الرسائل التي سيتم تسليمها إلى نقاط النهاية المضمنة والمخصصة. انظر: `https://aka.ms/telemetryoneventgrid`	EnrichmentProperties[]
مسار احتياطي	خصائص المسار المستخدم كمسار احتياطي عند عدم استيفاء أي من الشروط المحددة في قسم "المسارات". فهذه معلمة اختيارية. عندما لا تكون هذه الخاصية موجودة في القالب، يتم تعطيل المسار الاحتياطي بشكل افتراضي.	الاحتياطية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	'DeviceConnectionStateEvents' 'DeviceJobLifecycleEvents' "أحداث دورة حياة الجهاز" '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	ينشئ هذا القالب IOT Hub ومحاكي Ubuntu Edge للجهاز الظاهري.
استخدام قالب ARM لإنشاء IoT Hub وتوجيه الرسائل وعرضها	استخدم هذا القالب لنشر IoT Hub وحساب تخزين. قم بتشغيل تطبيق لإرسال رسائل إلى المركز التي يتم توجيهها إلى التخزين، ثم عرض النتائج.
إنشاء خدمة توفير جهاز IoT Hub	يمكنك هذا القالب من إنشاء مركز IoT وخدمة توفير جهاز IoT Hub، وربط الخدمتين معا.
إنشاء مركز IoT ومجموعة مستهلكين جهاز إلى السحابة	يمكنك هذا القالب من نشر مثيل IoT Hub مع جهاز إلى السحابة والسحابة إلى تكوينات مراسلة الجهاز وجهاز إلى مجموعة مستهلكي السحابة.
إنشاء تحديث الجهاز لحساب IoT Hub، المثيل، IoT Hub	ينشئ هذا القالب حسابا ومثيلا ومركزا لربط المثيل به. يقوم بتكوين المركز مع نهج الوصول الضرورية والمسارات ومجموعة المستهلكين.
توزيع خدمة MedTech بما في ذلك Azure IoT Hub	خدمة MedTech هي واحدة من Azure Health Data Services المصممة لاستيعاب بيانات الجهاز من أجهزة متعددة، وتحويل بيانات الجهاز إلى ملاحظات FHIR، والتي تستمر بعد ذلك في خدمة Azure Health Data Services FHIR.
إنشاء بيئة الدفع حسب الاستخدام (PAYG) باستخدام IoT Hub	يمكنك هذا القالب من نشر بيئة Time Series Insights للدفع حسب الاستخدام (PAYG) التي تم تكوينها لاستهلاك الأحداث من 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.	ArmIdentity
خصائص	خصائص IotHub	IotHubProperties

ArmIdentity

الاسم	الوصف	القيمة
النوع	نوع الهوية المستخدمة للمورد. يشتمل النوع "SystemAssigned، UserAssigned" على كل من هوية تم إنشاؤها ضمنيّاً ومجموعة من الهويات المعينة من قِبل المستخدم. سيقوم النوع "بلا" بإزالة أي هويات من الخدمة.	'بلا' 'SystemAssigned' 'SystemAssigned, UserAssigned' "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	ينشئ هذا القالب IOT Hub ومحاكي Ubuntu Edge للجهاز الظاهري.
استخدام قالب ARM لإنشاء IoT Hub وتوجيه الرسائل وعرضها	استخدم هذا القالب لتوزيع IoT Hub وحساب تخزين. قم بتشغيل تطبيق لإرسال رسائل إلى المركز التي يتم توجيهها إلى التخزين، ثم عرض النتائج.
إنشاء خدمة توفير جهاز IoT Hub	يمكنك هذا القالب من إنشاء مركز IoT وخدمة توفير جهاز IoT Hub، وربط الخدمتين معا.
إنشاء IoT Hub ومجموعة مستهلكين جهاز إلى السحابة	يمكنك هذا القالب من نشر مثيل IoT Hub مع تكوينات مراسلة الجهاز إلى السحابة والسحابة إلى الجهاز وجهاز إلى مجموعة مستهلكين السحابة.
إنشاء تحديث الجهاز لحساب IoT Hub، المثيل، IoT Hub	ينشئ هذا القالب حسابا ومثيلا ومركزا لربط المثيل به. يقوم بتكوين المركز مع نهج الوصول الضرورية والمسارات ومجموعة المستهلكين.
توزيع خدمة MedTech بما في ذلك Azure IoT Hub	خدمة MedTech هي واحدة من خدمات بيانات Azure Health المصممة لاستيعاب بيانات الجهاز من أجهزة متعددة، وتحويل بيانات الجهاز إلى ملاحظات FHIR، والتي تستمر بعد ذلك في خدمة Azure Health Data Services FHIR.
إنشاء بيئة الدفع حسب الاستخدام (PAYG) باستخدام IoT Hub	يمكنك هذا القالب من نشر بيئة 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.	سلسلة

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	إذا كان True، فسيتم تطبيق مجموعة قواعد الشبكة أيضا على BuiltIn EventHub EndPoint من IotHub	bool (مطلوب)
defaultAction	الإجراء الافتراضي لمجموعة قواعد الشبكة	"السماح" "رفض"
ipRules	قائمة قواعد IP	NetworkRuleSetIpRule[] (مطلوب)

NetworkRuleSetIpRule

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

PrivateEndpointConnection

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

PrivateEndpointConnectionProperties

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

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

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

PrivateLinkServiceConnectionState

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

RoutingProperties

الاسم	الوصف	القيمة
نقاط النهاية	الخصائص المتعلقة بنقاط النهاية المخصصة التي يوجه إليها مركز IoT الرسائل استنادا إلى قواعد التوجيه. يسمح بحد أقصى 10 نقاط نهاية مخصصة عبر جميع أنواع نقاط النهاية للمراكز المدفوعة ويسمح بنقطة نهاية مخصصة فقط عبر جميع أنواع نقاط النهاية للمراكز المجانية.	نقاط نهاية التوجيه
عمليات الإثراء	قائمة عمليات الإثراء التي يوفرها المستخدم والتي ينطبق عليها مركز IoT على الرسائل التي سيتم تسليمها إلى نقاط النهاية المضمنة والمخصصة. انظر: `https://aka.ms/telemetryoneventgrid`	EnrichmentProperties[]
مسار احتياطي	خصائص المسار المستخدم كمسار احتياطي عند عدم استيفاء أي من الشروط المحددة في قسم "المسارات". فهذه معلمة اختيارية. عندما لا تكون هذه الخاصية موجودة في القالب، يتم تعطيل المسار الاحتياطي بشكل افتراضي.	الاحتياطية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.	ManagedIdentity
الاسم	الاسم الذي يعرف نقطة النهاية هذه. يمكن أن يتضمن الاسم فقط الأحرف الأبجدية الرقمية والنقاط والتسطير السفلي والواصلات ويبلغ الحد الأقصى لطوله 64 حرفا. الأسماء التالية محجوزة: الأحداث، وملفات التعليقات التوضيحية، $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	اسم مركز الأحداث على مساحة اسم مركز الحدث	سلسلة
المعرف	معرف نقطة نهاية مركز الحدث	سلسلة
الهوية	خصائص الهوية المدارة لتوجيه نقطة نهاية مركز الأحداث.	ManagedIdentity
الاسم	الاسم الذي يعرف نقطة النهاية هذه. يمكن أن يتضمن الاسم فقط الأحرف الأبجدية الرقمية والنقاط والتسطير السفلي والواصلات ويبلغ الحد الأقصى لطوله 64 حرفا. الأسماء التالية محجوزة: الأحداث، وملفات التعليقات التوضيحية، $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" (مطلوب)

مشاركة عبر

Microsoft.Devices IotHubs 2023-06-30

تعريف مورد Bicep

تنسيق المورد

قيم Property

IotHubs

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

معرفات ArmIdentityUserAssignedIdentities

ArmUserIdentity

IotHubProperties

SharedAccessSignatureAuthorizationRule

CloudToDeviceProperties

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

IotHubPropertiesEventHubEndpoints

EventHubProperties

IpFilterRule

IotHubPropertiesMessagingEndpoints

MessagingEndpointProperties

NetworkRuleSetProperties

NetworkRuleSetIpRule

PrivateEndpointConnection

PrivateEndpointConnectionProperties

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

PrivateLinkServiceConnectionState

RoutingProperties

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

RoutingCosmosDBSqlApiProperties

MANAGEDIDENTITY

RoutingEventHubProperties

RoutingServiceBusQueueEndpointProperties

RoutingServiceBusTopicEndpointProperties

RoutingStorageContainerProperties

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

الاحتياطيةRouteProperties

خصائص المسار

IotHubPropertiesStorageEndpoints

StorageEndpointProperties

IotHubSkuInfo

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

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

تنسيق المورد

قيم Property

IotHubs

ArmIdentity

ArmIdentityUserAssignedIdentities

ArmUserIdentity

IotHubProperties

SharedAccessSignatureAuthorizationRule

CloudToDeviceProperties

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

IotHubPropertiesEventHubEndpoints

EventHubProperties

IpFilterRule

IotHubPropertiesMessagingEndpoints

MessagingEndpointProperties

NetworkRuleSetProperties

NetworkRuleSetIpRule

PrivateEndpointConnection

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

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

PrivateLinkServiceConnectionState

RoutingProperties

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

RoutingCosmosDBSqlApiProperties

MANAGEDIDENTITY

RoutingEventHubProperties

RoutingServiceBusQueueEndpointProperties

RoutingServiceBusTopicEndpointProperties

RoutingStorageContainerProperties

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

الاحتياطيةRouteProperties

خصائص المسار

IotHubPropertiesStorageEndpoints

خصائص StorageEndpoint

IotHubSkuInfo

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

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

تنسيق المورد

قيم Property

IotHubs