Microsoft.Devices IotHubs 2021-07-02-preview
تعريف مورد Bicep
يمكن نشر نوع مورد IotHubs مع العمليات التي تستهدف:
- مجموعات الموارد - راجع أوامر نشر مجموعة الموارد
للحصول على قائمة بالخصائص التي تم تغييرها في كل إصدار من إصدارات واجهة برمجة التطبيقات، راجع سجل التغيير.
تنسيق المورد
لإنشاء مورد Microsoft.Devices/IotHubs، أضف Bicep التالي إلى القالب الخاص بك.
resource symbolicname 'Microsoft.Devices/IotHubs@2021-07-02-preview' = {
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'
deviceStreams: {
streamingEndpoints: [
'string'
]
}
disableDeviceSAS: bool
disableLocalAuth: bool
disableModuleSAS: bool
enableDataResidency: bool
enableFileUploadNotifications: bool
encryption: {
keySource: 'string'
keyVaultProperties: [
{
identity: {
userAssignedIdentity: 'string'
}
keyIdentifier: 'string'
}
]
}
eventHubEndpoints: {
{customized property}: {
partitionCount: int
retentionTimeInDays: int
}
}
features: 'string'
ipFilterRules: [
{
action: 'string'
filterName: 'string'
ipMask: 'string'
}
]
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: {
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. | 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. | سلسلة |
deviceStreams | يقوم الجهاز ببث خصائص iothub. | IotHubPropertiesDeviceStreams |
disableDeviceSAS | إذا كان صحيحا، فلا يمكن استخدام جميع مفاتيح SAS المحددة النطاق للجهاز (بما في ذلك أجهزة Edge ولكن باستثناء الوحدات النمطية) للمصادقة. | Bool |
disableLocalAuth | إذا كان صحيحا، لا يمكن استخدام رموز SAS المميزة مع مفاتيح SAS ذات نطاق مركز Iot للمصادقة. | Bool |
disableModuleSAS | إذا كان صحيحا، لا يمكن استخدام جميع مفاتيح SAS التي تم تحديد نطاقها للوحدة النمطية للمصادقة. | Bool |
enableDataResidency | هذه الخاصية عند تعيينها إلى true، ستمكن موقع البيانات، وبالتالي، تعطيل الإصلاح بعد كارثة. | Bool |
enableFileUploadNotifications | إذا كانت True، يتم تمكين إعلامات تحميل الملفات. | Bool |
التشفير | خصائص التشفير لمركز IoT. | EncryptionPropertiesDescription |
نقاط الانتهاء الخاصة بمركز الحدث | خصائص نقطة النهاية المتوافقة مع 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. | سلسلة |
IotHubPropertiesDeviceStreams
الاسم | الوصف | القيمة |
---|---|---|
نقاط نهاية البث | قائمة نقاط نهاية تدفقات الأجهزة. | سلسلة [] |
EncryptionPropertiesDescription
الاسم | الوصف | القيمة |
---|---|---|
مصدر المفتاح | مصدر المفتاح. | سلسلة |
خصائص keyVault | خصائص مفتاح KeyVault. | KeyVaultKeyProperties[] |
KeyVaultKeyProperties
الاسم | الوصف | القيمة |
---|---|---|
الهوية | خصائص الهوية المدارة ل KeyVault Key. | معرف مدار |
معرف المفتاح | معرف المفتاح. | سلسلة |
MANAGEDIDENTITY
الاسم | الوصف | القيمة |
---|---|---|
userAssignedIdentity | الهوية المعينة من قبل المستخدم. | سلسلة |
نقاط نهاية 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 | إذا كان 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[] |
مسار احتياطي | خصائص المسار المستخدم كمسار احتياطي عند عدم استيفاء أي من الشروط المحددة في قسم "المسارات". فهذه معلمة اختيارية. عند عدم تعيين هذه الخاصية، يتم توجيه الرسائل التي لا تفي بأي من الشروط المحددة في قسم "المسارات" إلى نقطة النهاية eventhub المضمنة. | الاحتياطيةRouteProperties |
المسارات | قائمة قواعد التوجيه التي يوفرها المستخدم والتي يستخدمها مركز IoT لتوجيه الرسائل إلى نقاط النهاية المضمنة والمخصصة. يسمح بحد أقصى 100 قاعدة توجيه للمراكز المدفوعة ويسمح بحد أقصى 5 قواعد توجيه للمراكز المجانية. | RouteProperties[] |
نقاط نهاية التوجيه
الاسم | الوصف | القيمة |
---|---|---|
eventHubs | قائمة نقاط نهاية مراكز الأحداث التي يوجهها مركز IoT إلى الرسائل، استنادا إلى قواعد التوجيه. لا تتضمن هذه القائمة نقطة نهاية مراكز الأحداث المضمنة. | RoutingEventHubProperties[] |
serviceBusQueues | قائمة نقاط نهاية قائمة انتظار ناقل خدمة Microsoft Azure التي يوجه مركز IoT الرسائل إليها، استنادا إلى قواعد التوجيه. | RoutingServiceBusQueueEndpointProperties[] |
serviceBusTopics | قائمة نقاط نهاية موضوع ناقل خدمة Microsoft Azure التي يوجه مركز IoT الرسائل إليها، استنادا إلى قواعد التوجيه. | RoutingServiceBusTopicEndpointProperties[] |
storageContainers | قائمة نقاط نهاية حاوية التخزين التي يوجه مركز IoT الرسائل إليها، استنادا إلى قواعد التوجيه. | RoutingStorageContainerProperties[] |
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. | معرف مدار |
الاسم | الاسم الذي يعرف نقطة النهاية هذه. يمكن أن يتضمن الاسم الأحرف الأبجدية الرقمية والنقاط والتسطير السفلي والواصلات بحد أقصى 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:// |
سلسلة |
تنسيق اسم الملف | تنسيق اسم الملف للكائن الثنائي كبير الحجم. التنسيق الافتراضي هو {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" "DigitalTwinChangeEvents" "غير صالح" 'MqttBrokerMessages' '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' 'DigitalTwinChangeEvents' "غير صالح" 'MqttBrokerMessages' '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. |
تعريف مورد قالب ARM
يمكن توزيع نوع مورد IotHubs مع العمليات التي تستهدف:
- مجموعات الموارد - راجع أوامر نشر مجموعة الموارد
للحصول على قائمة بالخصائص التي تم تغييرها في كل إصدار من إصدارات واجهة برمجة التطبيقات، راجع سجل التغيير.
تنسيق المورد
لإنشاء مورد Microsoft.Devices/IotHubs، أضف JSON التالي إلى القالب الخاص بك.
{
"type": "Microsoft.Devices/IotHubs",
"apiVersion": "2021-07-02-preview",
"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",
"deviceStreams": {
"streamingEndpoints": [ "string" ]
},
"disableDeviceSAS": "bool",
"disableLocalAuth": "bool",
"disableModuleSAS": "bool",
"enableDataResidency": "bool",
"enableFileUploadNotifications": "bool",
"encryption": {
"keySource": "string",
"keyVaultProperties": [
{
"identity": {
"userAssignedIdentity": "string"
},
"keyIdentifier": "string"
}
]
},
"eventHubEndpoints": {
"{customized property}": {
"partitionCount": "int",
"retentionTimeInDays": "int"
}
},
"features": "string",
"ipFilterRules": [
{
"action": "string",
"filterName": "string",
"ipMask": "string"
}
],
"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": {
"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 | إصدار واجهة برمجة تطبيقات المورد | 'معاينة 2021-07-02' |
الاسم | اسم المورد | سلسلة (مطلوبة) حد الحرف: 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. | سلسلة |
deviceStreams | يقوم الجهاز ببث خصائص iothub. | IotHubPropertiesDeviceStreams |
disableDeviceSAS | إذا كان صحيحا، فلا يمكن استخدام جميع مفاتيح SAS المحددة النطاق للجهاز (بما في ذلك أجهزة Edge ولكن باستثناء الوحدات النمطية) للمصادقة. | Bool |
disableLocalAuth | إذا كان صحيحا، لا يمكن استخدام رموز SAS المميزة مع مفاتيح SAS ذات نطاق مركز Iot للمصادقة. | Bool |
disableModuleSAS | إذا كان صحيحا، لا يمكن استخدام جميع مفاتيح SAS التي تم تحديد نطاقها للوحدة النمطية للمصادقة. | Bool |
enableDataResidency | هذه الخاصية عند تعيينها إلى true، ستمكن موقع البيانات، وبالتالي، تعطيل الإصلاح بعد كارثة. | Bool |
enableFileUploadNotifications | إذا كانت True، يتم تمكين إعلامات تحميل الملفات. | Bool |
التشفير | خصائص التشفير لمركز IoT. | EncryptionPropertiesDescription |
نقاط الانتهاء الخاصة بمركز الحدث | خصائص نقطة النهاية المتوافقة مع 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. | سلسلة |
IotHubPropertiesDeviceStreams
الاسم | الوصف | القيمة |
---|---|---|
نقاط نهاية البث | قائمة نقاط نهاية تدفقات الأجهزة. | سلسلة [] |
EncryptionPropertiesDescription
الاسم | الوصف | القيمة |
---|---|---|
مصدر المفتاح | مصدر المفتاح. | سلسلة |
خصائص keyVault | خصائص مفتاح KeyVault. | KeyVaultKeyProperties[] |
KeyVaultKeyProperties
الاسم | الوصف | القيمة |
---|---|---|
الهوية | خصائص الهوية المدارة ل KeyVault Key. | معرف مدار |
معرف المفتاح | معرف المفتاح. | سلسلة |
MANAGEDIDENTITY
الاسم | الوصف | القيمة |
---|---|---|
userAssignedIdentity | الهوية المعينة من قبل المستخدم. | سلسلة |
نقاط نهاية 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 | إذا كان 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[] |
مسار احتياطي | خصائص المسار المستخدم كمسار احتياطي عند عدم استيفاء أي من الشروط المحددة في قسم "المسارات". فهذه معلمة اختيارية. عند عدم تعيين هذه الخاصية، يتم توجيه الرسائل التي لا تفي بأي من الشروط المحددة في قسم "المسارات" إلى نقطة النهاية eventhub المضمنة. | الاحتياطيةRouteProperties |
المسارات | قائمة قواعد التوجيه التي يوفرها المستخدم والتي يستخدمها مركز IoT لتوجيه الرسائل إلى نقاط النهاية المضمنة والمخصصة. يسمح بحد أقصى 100 قاعدة توجيه للمراكز المدفوعة ويسمح بحد أقصى 5 قواعد توجيه للمراكز المجانية. | RouteProperties[] |
نقاط نهاية التوجيه
الاسم | الوصف | القيمة |
---|---|---|
eventHubs | قائمة نقاط نهاية مراكز الأحداث التي يوجهها مركز IoT إلى الرسائل، استنادا إلى قواعد التوجيه. لا تتضمن هذه القائمة نقطة نهاية مراكز الأحداث المضمنة. | RoutingEventHubProperties[] |
serviceBusQueues | قائمة نقاط نهاية قائمة انتظار ناقل خدمة Microsoft Azure التي يوجه مركز IoT الرسائل إليها، استنادا إلى قواعد التوجيه. | RoutingServiceBusQueueEndpointProperties[] |
serviceBusTopics | قائمة نقاط نهاية موضوع ناقل خدمة Microsoft Azure التي يوجه مركز IoT الرسائل إليها، استنادا إلى قواعد التوجيه. | RoutingServiceBusTopicEndpointProperties[] |
storageContainers | قائمة نقاط نهاية حاوية التخزين التي يوجه مركز IoT الرسائل إليها، استنادا إلى قواعد التوجيه. | RoutingStorageContainerProperties[] |
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. | معرف مدار |
الاسم | الاسم الذي يعرف نقطة النهاية هذه. يمكن أن يتضمن الاسم الأحرف الأبجدية الرقمية والنقاط والتسطير السفلي والواصلات بحد أقصى 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:// |
سلسلة |
تنسيق اسم الملف | تنسيق اسم الملف للكائن الثنائي كبير الحجم. التنسيق الافتراضي هو {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' "أحداث دورة حياة الجهاز" "أحداث دورة حياة الجهاز" "DeviceMessages" "DigitalTwinChangeEvents" "غير صالح" 'MqttBrokerMessages' 'TwinChangeEvents' (مطلوب) |
خصائص المسار
الاسم | الوصف | القيمة |
---|---|---|
الشرط | الشرط الذي يتم تقييمه لتطبيق قاعدة التوجيه. إذا لم يتم توفير أي شرط، يتم تقييمه إلى صحيح بشكل افتراضي. للتدقيق النحوي، راجع: /azure/iot-hub/iot-hub-devguide-query-language | سلسلة |
أسماء نقاط النهاية | قائمة نقاط النهاية التي يتم توجيه الرسائل التي تفي بالشرط. يسمح حاليا بنقطة نهاية واحدة فقط. | string[] (مطلوب) القيود: الحد الأدنى للطول = 1 الحد الأقصى للطول = 1 |
isEnabled | يستخدم لتحديد ما إذا كان المسار ممكنا أم لا. | bool (مطلوب) |
الاسم | اسم المسار. يمكن أن يتضمن الاسم فقط الأحرف الأبجدية الرقمية والنقاط والتسطير السفلي والواصلات، ويبلغ الحد الأقصى لطوله 64 حرفا، ويجب أن يكون فريدا. | سلسلة (مطلوب) القيود: النمط = ^[A-Za-z0-9-._]{1,64}$ |
المصدر | المصدر الذي سيتم تطبيق قاعدة التوجيه عليه، مثل DeviceMessages. | 'DeviceConnectionStateEvents' "أحداث دورة حياة الجهاز" "أحداث دورة حياة الجهاز" "DeviceMessages" "DigitalTwinChangeEvents" "غير صالح" 'MqttBrokerMessages' 'TwinChangeEvents' (مطلوب) |
IotHubPropertiesStorageEndpoints
الاسم | الوصف | القيمة |
---|---|---|
{خاصية مخصصة} | StorageEndpointProperties |
StorageEndpointProperties
الاسم | الوصف | القيمة |
---|---|---|
نوع المصادقة | يحدد نوع المصادقة المستخدم للاتصال بحساب التخزين. | '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@2021-07-02-preview"
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"
deviceStreams = {
streamingEndpoints = [
"string"
]
}
disableDeviceSAS = bool
disableLocalAuth = bool
disableModuleSAS = bool
enableDataResidency = bool
enableFileUploadNotifications = bool
encryption = {
keySource = "string"
keyVaultProperties = [
{
identity = {
userAssignedIdentity = "string"
}
keyIdentifier = "string"
}
]
}
eventHubEndpoints = {
{customized property} = {
partitionCount = int
retentionTimeInDays = int
}
}
features = "string"
ipFilterRules = [
{
action = "string"
filterName = "string"
ipMask = "string"
}
]
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 = {
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@2021-07-02-preview" |
الاسم | اسم المورد | سلسلة (مطلوبة) حد الحرف: 3-50 الأحرف الصالحة: الأبجدية الرقمية والواصلات. لا يمكنك أن تنهي بالواصلة. يجب أن يكون اسم المورد فريدا عبر Azure. |
الموقع | موقع المورد. | سلسلة (مطلوبة) |
parent_id | للنشر إلى مجموعة موارد، استخدم معرف مجموعة الموارد هذه. | سلسلة (مطلوبة) |
العلامات | علامات الموارد. | قاموس أسماء العلامات والقيم. |
sku | معلومات IotHub SKU | IotHubSkuInfo (مطلوب) |
etag | حقل Etag غير مطلوب. إذا تم توفيره في نص الاستجابة، فيجب أيضا توفيره كعنوان وفقا لاصطلاح ETag العادي. | سلسلة |
الهوية | الهويات المدارة ل IotHub. | معرفية الذراع |
خصائص | خصائص IotHub | IotHubProperties |
معرفية الذراع
الاسم | الوصف | القيمة |
---|---|---|
النوع | نوع الهوية المستخدمة للمورد. يتضمن النوع "SystemAssigned,UserAssigned" كلا من الهوية التي تم إنشاؤها ضمنيا ومجموعة من الهويات المعينة من قبل المستخدم. سيقوم النوع "بلا" بإزالة أي هويات من الخدمة. | "SystemAssigned" "SystemAssigned، UserAssigned" "UserAssigned" |
identity_ids | قاموس {ArmUserIdentity} | صفيف معرفات هوية المستخدم. |
ArmIdentityUserAssignedIdentities
الاسم | الوصف | القيمة |
---|---|---|
{خاصية مخصصة} | ArmUserIdentity |
ArmUserIdentity
لا يحتوي هذا الكائن على أي خصائص لتعيينها أثناء التوزيع. جميع الخصائص هي ReadOnly.
IotHubProperties
الاسم | الوصف | القيمة |
---|---|---|
allowedFqdnList | قائمة FQDNs المسموح بها (اسم المجال المؤهل بالكامل) للانحراف من Iot Hub. | سلسلة [] |
نهج التخويل | نهج الوصول المشتركة التي يمكنك استخدامها لتأمين اتصال بمركز IoT. | SharedAccessSignatureAuthorizationRule[] |
cloudToDevice | خصائص المراسلة من السحابة إلى الجهاز لمركز IoT. | CloudToDeviceProperties |
تعليقات | تعليقات مركز IoT. | سلسلة |
deviceStreams | يقوم الجهاز ببث خصائص iothub. | IotHubPropertiesDeviceStreams |
disableDeviceSAS | إذا كان صحيحا، فلا يمكن استخدام جميع مفاتيح SAS المحددة النطاق للجهاز (بما في ذلك أجهزة Edge ولكن باستثناء الوحدات النمطية) للمصادقة. | Bool |
disableLocalAuth | إذا كان صحيحا، لا يمكن استخدام رموز SAS المميزة مع مفاتيح SAS ذات نطاق مركز Iot للمصادقة. | Bool |
disableModuleSAS | إذا كان صحيحا، لا يمكن استخدام جميع مفاتيح SAS التي تم تحديد نطاقها للوحدة النمطية للمصادقة. | Bool |
enableDataResidency | هذه الخاصية عند تعيينها إلى true، ستمكن موقع البيانات، وبالتالي، تعطيل الإصلاح بعد كارثة. | Bool |
enableFileUploadNotifications | إذا كان True، يتم تمكين إعلامات تحميل الملفات. | Bool |
التشفير | خصائص التشفير لمركز IoT. | EncryptionPropertiesDescription |
نقاط الانتهاء الخاصة بمركز الحدث | خصائص نقطة النهاية المتوافقة مع 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 | المفتاح الأساسي. | سلسلة |
حقوق | الأذونات المعينة لنهج الوصول المشترك. | "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. | سلسلة |
IotHubPropertiesDeviceStreams
الاسم | الوصف | القيمة |
---|---|---|
نقاط نهاية البث | قائمة نقاط نهاية تدفقات الأجهزة. | سلسلة [] |
EncryptionPropertiesDescription
الاسم | الوصف | القيمة |
---|---|---|
مصدر المفتاح | مصدر المفتاح. | سلسلة |
keyVaultProperties | خصائص مفتاح KeyVault. | KeyVaultKeyProperties[] |
KeyVaultKeyProperties
الاسم | الوصف | القيمة |
---|---|---|
الهوية | خصائص الهوية المدارة ل KeyVault Key. | ManagedIdentity |
keyIdentifier | معرف المفتاح. | سلسلة |
MANAGEDIDENTITY
الاسم | الوصف | القيمة |
---|---|---|
userAssignedIdentity | الهوية المعينة من قبل المستخدم. | سلسلة |
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 (مطلوب) |
خصائص اتصال نقطة النهاية الخاصة
الاسم | الوصف | القيمة |
---|---|---|
نقطة النهاية الخاصة | خاصية نقطة النهاية الخاصة لاتصال نقطة نهاية خاصة | نقطة النهاية الخاصة |
privateLinkServiceConnectionState | الحالة الحالية لاتصال نقطة نهاية خاصة | PrivateLinkServiceConnectionState (مطلوب) |
نقطة النهاية الخاصة
لا يحتوي هذا الكائن على أي خصائص لتعيينها أثناء التوزيع. جميع الخصائص هي ReadOnly.
PrivateLinkServiceConnectionState
الاسم | الوصف | القيمة |
---|---|---|
الإجراءات مطلوبة | الإجراءات المطلوبة لاتصال نقطة نهاية خاصة | سلسلة |
الوصف | وصف الحالة الحالية لاتصال نقطة نهاية خاصة | سلسلة (مطلوبة) |
الحالة | حالة اتصال نقطة نهاية خاصة | "تمت الموافقة" "غير متصل" "معلق" "مرفوض" (مطلوب) |
RoutingProperties
الاسم | الوصف | القيمة |
---|---|---|
نقاط النهاية | الخصائص المتعلقة بنقاط النهاية المخصصة التي يوجه إليها مركز IoT الرسائل استنادا إلى قواعد التوجيه. يسمح بحد أقصى 10 نقاط نهاية مخصصة عبر جميع أنواع نقاط النهاية للمراكز المدفوعة ويسمح بنقطة نهاية مخصصة فقط عبر جميع أنواع نقاط النهاية للمراكز المجانية. | نقاط نهاية التوجيه |
عمليات الإثراء | قائمة عمليات الإثراء التي يوفرها المستخدم والتي ينطبق عليها مركز IoT على الرسائل التي سيتم تسليمها إلى نقاط النهاية المضمنة والمخصصة. انظر: https://aka.ms/telemetryoneventgrid |
خصائص الإثراء[] |
مسار احتياطي | خصائص المسار المستخدم كمسار احتياطي عند عدم استيفاء أي من الشروط المحددة في قسم "المسارات". فهذه معلمة اختيارية. عند عدم تعيين هذه الخاصية، يتم توجيه الرسائل التي لا تفي بأي من الشروط المحددة في قسم "المسارات" إلى نقطة نهاية eventhub المضمنة. | الاحتياطيةRouteProperties |
المسارات | قائمة قواعد التوجيه التي يوفرها المستخدم والتي يستخدمها مركز IoT لتوجيه الرسائل إلى نقاط النهاية المضمنة والمخصصة. يسمح بحد أقصى 100 قاعدة توجيه للمراكز المدفوعة ويسمح بحد أقصى 5 قواعد توجيه للمراكز المجانية. | RouteProperties[] |
نقاط نهاية التوجيه
الاسم | الوصف | القيمة |
---|---|---|
eventHubs | قائمة نقاط نهاية مراكز الأحداث التي يوجه مركز IoT الرسائل إليها، استنادا إلى قواعد التوجيه. لا تتضمن هذه القائمة نقطة نهاية مراكز الأحداث المضمنة. | RoutingEventHubProperties[] |
serviceBusQueues | قائمة نقاط نهاية قائمة انتظار ناقل خدمة Microsoft Azure التي يوجه مركز IoT الرسائل إليها، استنادا إلى قواعد التوجيه. | RoutingServiceBusQueueEndpointProperties[] |
serviceBusTopics | قائمة نقاط نهاية موضوع ناقل خدمة Microsoft Azure التي يوجه مركز IoT الرسائل إليها، استنادا إلى قواعد التوجيه. | RoutingServiceBusTopicEndpointProperties[] |
storageContainers | قائمة نقاط نهاية حاوية التخزين التي يوجه مركز IoT الرسائل إليها، استنادا إلى قواعد التوجيه. | RoutingStorageContainerProperties[] |
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:// |
سلسلة |
تنسيق اسم الملف | تنسيق اسم الملف للكائن الثنائي كبير الحجم. التنسيق الافتراضي هو {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" "أحداث دورة حياة الجهاز" "رسائل الجهاز" "DigitalTwinChangeEvents" "غير صالح" "MqttBrokerMessages" "TwinChangeEvents" (مطلوب) |
خصائص المسار
الاسم | الوصف | القيمة |
---|---|---|
الشرط | الشرط الذي يتم تقييمه لتطبيق قاعدة التحويل. إذا لم يتم توفير أي شرط، يتم تقييمه إلى صحيح بشكل افتراضي. للتدقيق النحوي، راجع: /azure/iot-hub/iot-hub-devguide-query-language | سلسلة |
أسماء نقاط النهاية | قائمة نقاط النهاية التي يتم توجيه الرسائل التي تفي بالشرط. يسمح حاليا بنقطة نهاية واحدة فقط. | string[] (مطلوب) القيود: الحد الأدنى للطول = 1 الحد الأقصى للطول = 1 |
isEnabled | يستخدم لتحديد ما إذا كان المسار ممكنا أم لا. | bool (مطلوب) |
الاسم | اسم المسار. يمكن أن يتضمن الاسم الأحرف الأبجدية الرقمية والنقاط والتسطير السفلي والواصلات بحد أقصى 64 حرفا، ويجب أن يكون فريدا. | سلسلة (مطلوبة) القيود: النمط = ^[A-Za-z0-9-._]{1,64}$ |
المصدر | المصدر الذي سيتم تطبيق قاعدة التحويل عليه، مثل DeviceMessages. | "أحداث حالة اتصال الجهاز" "أحداث دورة حياة DeviceJob" "أحداث دورة حياة الجهاز" "رسائل الجهاز" "DigitalTwinChangeEvents" "غير صالح" "MqttBrokerMessages" "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" (مطلوب) |