Microsoft.Devices IotHubs 2017-07-01
- أحدث
- 2023-06-30
- معاينة 2023-06-30
- معاينة 2022-11-15
- 2022-04-30-معاينة
- 2021-07-02
- معاينة 2021-07-02
- 2021-07-01
- معاينة 2021-07-01
- 2021-03-31
- 2021-03-03-preview
- 2021-02-01-معاينة
- 2020-08-31
- 2020-08-31-معاينة
- 2020-08-01
- معاينة 2020-07-10
- 2020-06-15
- 2020-04-01
- 2020-03-01
- 2019-11-04
- 2019-07-01-معاينة
- 2019-03-22
- معاينة 2019-03-22
- معاينة 2018-12-01
- 2018-04-01
- 2018-01-22
- 2017-07-01
- 2017-01-19
- 2016-02-03
تعريف مورد Bicep
يمكن نشر نوع مورد IotHubs مع العمليات التي تستهدف:
للحصول على قائمة بالخصائص التي تم تغييرها في كل إصدار من إصدارات واجهة برمجة التطبيقات، راجع سجل التغيير .
تنسيق المورد
لإنشاء مورد Microsoft.Devices/IotHubs، أضف Bicep التالي إلى القالب الخاص بك.
resource symbolicname 'Microsoft.Devices/IotHubs@2017-07-01' = {
etag: 'string'
location: 'string'
name: 'string'
properties: {
authorizationPolicies: [
{
keyName: 'string'
primaryKey: 'string'
rights: 'string'
secondaryKey: 'string'
}
]
cloudToDevice: {
defaultTtlAsIso8601: 'string'
feedback: {
lockDurationAsIso8601: 'string'
maxDeliveryCount: int
ttlAsIso8601: 'string'
}
maxDeliveryCount: int
}
comments: 'string'
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'
}
}
operationsMonitoringProperties: {
events: {
{customized property}: 'string'
}
}
routing: {
endpoints: {
eventHubs: [
{
connectionString: 'string'
name: 'string'
resourceGroup: 'string'
subscriptionId: 'string'
}
]
serviceBusQueues: [
{
connectionString: 'string'
name: 'string'
resourceGroup: 'string'
subscriptionId: 'string'
}
]
serviceBusTopics: [
{
connectionString: 'string'
name: 'string'
resourceGroup: 'string'
subscriptionId: 'string'
}
]
storageContainers: [
{
batchFrequencyInSeconds: int
connectionString: 'string'
containerName: 'string'
encoding: 'string'
fileNameFormat: 'string'
maxChunkSizeInBytes: int
name: 'string'
resourceGroup: 'string'
subscriptionId: 'string'
}
]
}
fallbackRoute: {
condition: 'string'
endpointNames: [
'string'
]
isEnabled: bool
source: 'string'
}
routes: [
{
condition: 'string'
endpointNames: [
'string'
]
isEnabled: bool
name: 'string'
source: 'string'
}
]
}
storageEndpoints: {
{customized property}: {
connectionString: 'string'
containerName: 'string'
sasTtlAsIso8601: 'string'
}
}
}
resourcegroup: 'string'
sku: {
capacity: int
name: 'string'
}
subscriptionid: 'string'
tags: {
{customized property}: 'string'
}
}
قيم الخصائص
خصائص جهاز السحابة
خصائص EventHub
اسم | وصف | قيمة |
---|---|---|
عدد الأقسام | عدد الأقسام لتلقي رسائل من جهاز إلى سحابة في نقطة النهاية المتوافقة مع Event Hub. راجع: /azure/iot-hub/iot-hub-devguide-messaging#device-to-cloud-messages. | الباحث |
retentionTimeInDays | وقت الاستبقاء للرسائل من جهاز إلى سحابة بالأيام. راجع: /azure/iot-hub/iot-hub-devguide-messaging#device-to-cloud-messages | الباحث |
الخصائص الاحتياطية للRoute
اسم | وصف | قيمة |
---|---|---|
شرط | الشرط الذي يتم تقييمه من أجل تطبيق المسار الاحتياطي. إذا لم يتم توفير الشرط، تقييمه إلى صحيح بشكل افتراضي. للتدقيق النحوي، راجع: /azure/iot-hub/iot-hub-devguide-query-language | خيط |
أسماء نقاط النهاية | قائمة نقاط النهاية التي يتم توجيه الرسائل التي تفي بالشرط إليها. يسمح حاليا بنقطة نهاية واحدة فقط. | string[] (مطلوبة) |
isEnabled | يستخدم لتحديد ما إذا كان المسار الاحتياطي ممكنا أم لا. | bool (مطلوب) |
مصدر | المصدر الذي سيتم تطبيق قاعدة التوجيه عليه. على سبيل المثال، DeviceMessages | "أحداث دورة حياة الجهاز" "أحداث دورة حياة الجهاز" "رسائل الجهاز" 'TwinChangeEvents' (مطلوب) |
خصائص الملاحظات
اسم | وصف | قيمة |
---|---|---|
lockDurationAsIso8601 | مدة تأمين قائمة انتظار الملاحظات. راجع: /azure/iot-hub/iot-hub-devguide-messaging#cloud-to-device-messages. | خيط |
maxDeliveryCount | عدد المرات التي يحاول فيها مركز IoT تسليم رسالة في قائمة انتظار الملاحظات. راجع: /azure/iot-hub/iot-hub-devguide-messaging#cloud-to-device-messages. | الباحث القيود: قيمة الحد الأدنى = 1 القيمة القصوى = 100 |
ttlAsIso8601 | الفترة الزمنية التي تتوفر فيها الرسالة للاستهلاك قبل انتهاء صلاحيتها بواسطة مركز IoT. راجع: /azure/iot-hub/iot-hub-devguide-messaging#cloud-to-device-messages. | خيط |
خصائص IotHub
اسم | وصف | قيمة |
---|---|---|
نهج التخويل | نهج الوصول المشتركة التي يمكنك استخدامها لتأمين اتصال بمركز IoT. | SharedAccessSignatureAuthorizationRule[] |
cloudToDevice | خصائص المراسلة من سحابة إلى جهاز لمركز IoT. | CloudToDeviceProperties |
التعليقات | تعليقات مركز IoT. | خيط |
enableFileUploadNotifications | إذا كانت True، يتم تمكين إعلامات تحميل الملفات. | قيمة منطقية |
نقاط نهاية eventHub | خصائص نقطة النهاية المتوافقة مع Event Hub. المفاتيح المحتملة لهذا القاموس هي الأحداث والعملياتMonitoringEvents. يجب أن يكون كلا المفتاحين موجودين في القاموس أثناء إجراء استدعاءات إنشاء أو تحديث لمركز IoT. | IotHubPropertiesEventHubEndpoints |
ملامح | الإمكانات والميزات الممكنة لمركز IoT. | "إدارة الجهاز" "بلا" |
ipFilterRules | قواعد عامل تصفية IP. | IpFilterRule[] |
نقاط نهاية المراسلة | خصائص نقطة نهاية المراسلة لقائمة انتظار إعلام تحميل الملف. | IotHubPropertiesMessagingEndpoints |
operationsMonitoringProperties | خصائص مراقبة العمليات لمركز IoT. المفاتيح المحتملة للقاموس هي الاتصالات، DeviceTelemetry، C2DCommands، DeviceIdentityOperations، FileUploadOperations، Routes، D2CTwinOperations، C2DTwinOperations، TwinQueries، JobsOperations، DirectMethods. | OperationsMonitoringProperties |
التوجيه | الخصائص ذات الصلة للتوجيه لمركز IoT. راجع: /azure/iot-hub/iot-hub-devguide-messaging | RoutingProperties |
نقاط نهاية التخزين | قائمة نقاط نهاية Azure Storage حيث يمكنك تحميل الملفات. يمكنك حاليا تكوين حساب Azure Storage واحد فقط ويجب أن يكون مفتاحه $default. يؤدي تحديد أكثر من حساب تخزين واحد إلى طرح خطأ. يؤدي عدم تحديد قيمة لهذه الخاصية عند تعيين الخاصية enableFileUploadNotifications إلى True إلى ظهور خطأ. | IotHubPropertiesStorageEndpoints |
نقاط نهاية IotHubPropertiesEventHub
اسم | وصف | قيمة |
---|
IotHubPropertiesMessagingEndpoints
اسم | وصف | قيمة |
---|
IotHubPropertiesStorageEndpoints
اسم | وصف | قيمة |
---|
معلومات IotHubSku
اسم | وصف | قيمة |
---|---|---|
سعة | عدد وحدات IoT Hub المتوفرة. راجع: /azure/azure-subscription-service-limits#iot-hub-limits. | int (مطلوب) |
اسم | اسم SKU. | 'F1' 'S1' 'S2' 'S3' (مطلوب) |
IpFilterRule
اسم | وصف | قيمة |
---|---|---|
فعل | الإجراء المطلوب للطلبات التي تم التقاطها بواسطة هذه القاعدة. | "قبول" "رفض" (مطلوب) |
اسم عامل التصفية | اسم قاعدة عامل تصفية IP. | سلسلة (مطلوب) |
ipMask | سلسلة تحتوي على نطاق عنوان IP في رمز CIDR للقاعدة. | سلسلة (مطلوب) |
خصائص نقطة نهاية المراسلة
اسم | وصف | قيمة |
---|---|---|
lockDurationAsIso8601 | مدة التأمين. راجع: /azure/iot-hub/iot-hub-devguide-file-upload. | خيط |
maxDeliveryCount | عدد المرات التي يحاول فيها مركز IoT تسليم رسالة. راجع: /azure/iot-hub/iot-hub-devguide-file-upload. | الباحث القيود: قيمة الحد الأدنى = 1 القيمة القصوى = 100 |
ttlAsIso8601 | الفترة الزمنية التي تتوفر فيها الرسالة للاستهلاك قبل انتهاء صلاحيتها بواسطة مركز IoT. راجع: /azure/iot-hub/iot-hub-devguide-file-upload. | خيط |
Microsoft.Devices/IotHubs
اسم | وصف | قيمة |
---|---|---|
etag | حقل Etag غير مطلوب . إذا تم توفيره في نص الاستجابة، يجب أيضا توفيره كعنوان وفقا لاصطلاح ETag العادي. | خيط |
مكان | موقع المورد. | سلسلة (مطلوب) |
اسم | اسم المورد | سلسلة (مطلوب) |
خصائص | خصائص مركز IoT. | IotHubProperties |
مجموعة الموارد | اسم مجموعة الموارد التي تحتوي على مركز IoT. يعرف اسم مجموعة الموارد مجموعة الموارد بشكل فريد داخل الاشتراك. | سلسلة (مطلوب) |
سكو | معلومات حول SKU لمركز IoT. | IotHubSkuInfo (مطلوب) |
معرف الاشتراك | معرف الاشتراك. | سلسلة (مطلوب) |
العلامات | علامات الموارد | قاموس أسماء العلامات والقيم. راجع العلامات في القوالب |
OperationsMonitoringProperties
اسم | وصف | قيمة |
---|---|---|
احداث | قاموس <OperationMonitoringLevel> | OperationsMonitoringPropertiesEvents |
الأحداث الخاصة ب OperationsMonitoringProperties
اسم | وصف | قيمة |
---|
علامات تعريف الموارد
اسم | وصف | قيمة |
---|
خصائص المسار
اسم | وصف | قيمة |
---|---|---|
شرط | الشرط الذي يتم تقييمه لتطبيق قاعدة التحويل. إذا لم يتم توفير أي شرط، يتم تقييمه إلى صحيح بشكل افتراضي. للتدقيق النحوي، راجع: /azure/iot-hub/iot-hub-devguide-query-language | خيط |
أسماء نقاط النهاية | قائمة نقاط النهاية التي يتم توجيه الرسائل التي تفي بالشرط. يسمح حاليا بنقطة نهاية واحدة فقط. | string[] (مطلوبة) |
isEnabled | يستخدم لتحديد ما إذا كان المسار ممكنا أم لا. | bool (مطلوب) |
اسم | اسم المسار. يمكن أن يتضمن الاسم فقط الأحرف الأبجدية الرقمية والنقاط والتسطير السفلي والواصلات، بحد أقصى 64 حرفا، ويجب أن يكون فريدا. | خيط القيود: النمط = ^[A-Za-z0-9-._]{1,64}$ (مطلوب) |
مصدر | المصدر الذي سيتم تطبيق قاعدة التوجيه عليه، مثل DeviceMessages. | "أحداث دورة حياة الجهاز" "أحداث دورة حياة الجهاز" "رسائل الجهاز" 'TwinChangeEvents' (مطلوب) |
نقاط نهاية التوجيه
اسم | وصف | قيمة |
---|---|---|
eventHubs | قائمة نقاط نهاية مراكز الأحداث التي يوجه مركز IoT الرسائل إليها، استنادا إلى قواعد التوجيه. لا تتضمن هذه القائمة نقطة نهاية مراكز الأحداث المضمنة. | RoutingEventHubProperties [] |
serviceBusQueues | قائمة نقاط نهاية قائمة انتظار ناقل خدمة Microsoft Azure التي يوجه مركز IoT الرسائل إليها، استنادا إلى قواعد التوجيه. | RoutingServiceBusQueueEndpointProperties[] |
serviceBusTopics | قائمة نقاط نهاية موضوع ناقل خدمة Microsoft Azure التي يوجه مركز IoT الرسائل إليها، استنادا إلى قواعد التوجيه. | RoutingServiceBusTopicEndpointProperties[] |
مكونات التخزين | قائمة نقاط نهاية حاوية التخزين التي يوجه مركز IoT الرسائل إليها، استنادا إلى قواعد التوجيه. | RoutingStorageContainerProperties[] |
RoutingEventHubProperties
اسم | وصف | قيمة |
---|---|---|
سلسلة الاتصال | سلسلة الاتصال لنقطة نهاية مركز الحدث. | سلسلة (مطلوب) |
اسم | الاسم الذي يعرف نقطة النهاية هذه. يمكن أن يتضمن الاسم الأحرف الأبجدية الرقمية والنقاط والتسطير السفلي والواصلات بحد أقصى 64 حرفا. الأسماء التالية محجوزة: الأحداث، operationsMonitoringEvents، fileNotifications، $default. يجب أن تكون أسماء نقاط النهاية فريدة عبر أنواع نقاط النهاية. | خيط القيود: النمط = ^[A-Za-z0-9-._]{1,64}$ (مطلوب) |
مجموعة الموارد | اسم مجموعة الموارد لنقطة نهاية مركز الحدث. | خيط |
معرف الاشتراك | معرف الاشتراك لنقطة نهاية مركز الحدث. | خيط |
خصائص التوجيه
RoutingServiceBusQueueEndpointProperties
اسم | وصف | قيمة |
---|---|---|
سلسلة الاتصال | سلسلة الاتصال لنقطة نهاية قائمة انتظار ناقل الخدمة. | سلسلة (مطلوب) |
اسم | الاسم الذي يعرف نقطة النهاية هذه. يمكن أن يتضمن الاسم الأحرف الأبجدية الرقمية والنقاط والتسطير السفلي والواصلات بحد أقصى 64 حرفا. الأسماء التالية محجوزة: الأحداث، operationsMonitoringEvents، fileNotifications، $default. يجب أن تكون أسماء نقاط النهاية فريدة عبر أنواع نقاط النهاية. لا يجب أن يكون الاسم هو نفس اسم قائمة الانتظار الفعلي. | خيط القيود: النمط = ^[A-Za-z0-9-._]{1,64}$ (مطلوب) |
مجموعة الموارد | اسم مجموعة الموارد لنقطة نهاية قائمة انتظار ناقل الخدمة. | خيط |
معرف الاشتراك | معرف الاشتراك لنقطة نهاية قائمة انتظار ناقل الخدمة. | خيط |
RoutingServiceBusTopicEndpointProperties
اسم | وصف | قيمة |
---|---|---|
سلسلة الاتصال | سلسلة الاتصال لنقطة نهاية موضوع ناقل الخدمة. | سلسلة (مطلوب) |
اسم | الاسم الذي يعرف نقطة النهاية هذه. يمكن أن يتضمن الاسم الأحرف الأبجدية الرقمية والنقاط والتسطير السفلي والواصلات بحد أقصى 64 حرفا. الأسماء التالية محجوزة: الأحداث، operationsMonitoringEvents، fileNotifications، $default. يجب أن تكون أسماء نقاط النهاية فريدة عبر أنواع نقاط النهاية. لا يجب أن يكون الاسم هو نفس اسم الموضوع الفعلي. | خيط القيود: النمط = ^[A-Za-z0-9-._]{1,64}$ (مطلوب) |
مجموعة الموارد | اسم مجموعة الموارد لنقطة نهاية موضوع ناقل الخدمة. | خيط |
معرف الاشتراك | معرف الاشتراك لنقطة نهاية موضوع ناقل الخدمة. | خيط |
RoutingStorageContainerProperties
اسم | وصف | قيمة |
---|---|---|
batchFrequencyInSeconds | الفاصل الزمني الذي تتم فيه كتابة الكائنات الثنائية كبيرة الحجم إلى التخزين. يجب أن تتراوح القيمة بين 60 و720 ثانية. القيمة الافتراضية هي 300 ثانية. | الباحث القيود: قيمة الحد الأدنى = 60 القيمة القصوى = 720 |
سلسلة الاتصال | سلسلة الاتصال لحساب التخزين. | سلسلة (مطلوب) |
اسم الحاوية | اسم حاوية التخزين في حساب التخزين. | سلسلة (مطلوب) |
ترميز | الترميز المستخدم لتسلسل الرسائل إلى الكائنات الثنائية كبيرة الحجم. القيم المدعومة هي "avro" و"avroDeflate". القيمة الافتراضية هي "avro". | خيط |
تنسيق اسم الملف | تنسيق اسم الملف للكائن الثنائي كبير الحجم. التنسيق الافتراضي هو {iothub}/{partition}/{YYYY}/{MM}/{DD}/{HH}/{mm}. جميع المعلمات إلزامية ولكن يمكن إعادة ترتيبها. | خيط |
maxChunkSizeInBytes | الحد الأقصى لعدد وحدات البايت لكل كائن ثنائي كبير الحجم مكتوب إلى التخزين. يجب أن تكون القيمة بين 10485760 (10 ميغابايت) 524288000(500 ميغابايت). القيمة الافتراضية هي 314572800 (300 ميغابايت). | الباحث القيود: قيمة الحد الأدنى = 10485760 القيمة القصوى = 524288000 |
اسم | الاسم الذي يعرف نقطة النهاية هذه. يمكن أن يتضمن الاسم الأحرف الأبجدية الرقمية والنقاط والتسطير السفلي والواصلات بحد أقصى 64 حرفا. الأسماء التالية محجوزة: الأحداث، operationsMonitoringEvents، fileNotifications، $default. يجب أن تكون أسماء نقاط النهاية فريدة عبر أنواع نقاط النهاية. | خيط القيود: النمط = ^[A-Za-z0-9-._]{1,64}$ (مطلوب) |
مجموعة الموارد | اسم مجموعة الموارد لحساب التخزين. | خيط |
معرف الاشتراك | معرف الاشتراك لحساب التخزين. | خيط |
SharedAccessSignatureAuthorizationRule
اسم | وصف | قيمة |
---|---|---|
اسم المفتاح | اسم نهج الوصول المشترك. | سلسلة (مطلوب) |
مفتاح أساسي | المفتاح الأساسي. | خيط |
حقوق | الأذونات المعينة لنهج الوصول المشترك. | 'اتصال الجهاز' "قراءة السجل" "RegistryRead, DeviceConnect" "RegistryRead, RegistryWrite" 'RegistryRead, RegistryWrite, DeviceConnect' 'RegistryRead, RegistryWrite, ServiceConnect' 'RegistryRead, RegistryWrite, ServiceConnect, DeviceConnect' "RegistryRead, ServiceConnect" 'RegistryRead, ServiceConnect, DeviceConnect' "RegistryWrite" "RegistryWrite, DeviceConnect" "RegistryWrite, ServiceConnect" 'RegistryWrite, ServiceConnect, DeviceConnect' "اتصال الخدمة" "ServiceConnect, DeviceConnect" (مطلوب) |
مفتاح ثانوي | المفتاح الثانوي. | خيط |
خصائص StorageEndpoint
اسم | وصف | قيمة |
---|---|---|
سلسلة الاتصال | سلسلة الاتصال لحساب Azure Storage الذي يتم تحميل الملفات إليه. | سلسلة (مطلوب) |
اسم الحاوية | اسم حاوية الجذر حيث تقوم بتحميل الملفات. الحاوية غير موجودة ولكن يجب أن تكون قابلة لل creatable باستخدام connectionString المحدد. | سلسلة (مطلوب) |
sasTtlAsIso8601 | الفترة الزمنية التي يكون فيها SAS URI الذي تم إنشاؤه بواسطة IoT Hub لتحميل الملف صالحا. راجع: /azure/iot-hub/iot-hub-devguide-file-upload#file-upload-notification-configuration-options. | خيط |
أمثلة الاستخدام
نماذج Azure Quickstart
تحتوي قوالب Azure Quickstart التالية على نماذج Bicep لنشر نوع المورد هذا.
ملف Bicep | وصف |
---|---|
إنشاء مركز IoT وجهاز إلى مجموعة المستهلكين السحابية | يمكنك هذا القالب من نشر مثيل IoT Hub مع جهاز على السحابة والسحابة إلى تكوينات مراسلة الجهاز وجهاز إلى مجموعة مستهلكي السحابة. |
إنشاء خدمة توفير جهاز IoT Hub | يمكنك هذا القالب من إنشاء مركز IoT وخدمة توفير جهاز IoT Hub، وربط الخدمتين معا. |
إنشاء تحديث الجهاز لحساب IoT Hub، المثيل، IoT Hub | ينشئ هذا القالب حسابا ومثيلا ومركزا لربط المثيل به. يقوم بتكوين المركز مع نهج الوصول الضرورية والمسارات ومجموعة المستهلكين. |
نشر خدمة MedTech بما في ذلك Azure IoT Hub | خدمة MedTech هي واحدة من Azure Health Data Services المصممة لاستيعاب بيانات الجهاز من أجهزة متعددة، وتحويل بيانات الجهاز إلى ملاحظات FHIR، والتي تستمر بعد ذلك في خدمة Azure Health Data Services FHIR. |
استخدام قالب ARM لإنشاء IoT Hub وتوجيه الرسائل وعرضها | استخدم هذا القالب لنشر IoT Hub وحساب تخزين. قم بتشغيل تطبيق لإرسال رسائل إلى المركز التي يتم توجيهها إلى التخزين، ثم عرض النتائج. |
تعريف مورد قالب ARM
يمكن نشر نوع مورد IotHubs مع العمليات التي تستهدف:
للحصول على قائمة بالخصائص التي تم تغييرها في كل إصدار من إصدارات واجهة برمجة التطبيقات، راجع سجل التغيير .
تنسيق المورد
لإنشاء مورد Microsoft.Devices/IotHubs، أضف JSON التالي إلى القالب الخاص بك.
{
"type": "Microsoft.Devices/IotHubs",
"apiVersion": "2017-07-01",
"name": "string",
"etag": "string",
"location": "string",
"properties": {
"authorizationPolicies": [
{
"keyName": "string",
"primaryKey": "string",
"rights": "string",
"secondaryKey": "string"
}
],
"cloudToDevice": {
"defaultTtlAsIso8601": "string",
"feedback": {
"lockDurationAsIso8601": "string",
"maxDeliveryCount": "int",
"ttlAsIso8601": "string"
},
"maxDeliveryCount": "int"
},
"comments": "string",
"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"
}
},
"operationsMonitoringProperties": {
"events": {
"{customized property}": "string"
}
},
"routing": {
"endpoints": {
"eventHubs": [
{
"connectionString": "string",
"name": "string",
"resourceGroup": "string",
"subscriptionId": "string"
}
],
"serviceBusQueues": [
{
"connectionString": "string",
"name": "string",
"resourceGroup": "string",
"subscriptionId": "string"
}
],
"serviceBusTopics": [
{
"connectionString": "string",
"name": "string",
"resourceGroup": "string",
"subscriptionId": "string"
}
],
"storageContainers": [
{
"batchFrequencyInSeconds": "int",
"connectionString": "string",
"containerName": "string",
"encoding": "string",
"fileNameFormat": "string",
"maxChunkSizeInBytes": "int",
"name": "string",
"resourceGroup": "string",
"subscriptionId": "string"
}
]
},
"fallbackRoute": {
"condition": "string",
"endpointNames": [ "string" ],
"isEnabled": "bool",
"source": "string"
},
"routes": [
{
"condition": "string",
"endpointNames": [ "string" ],
"isEnabled": "bool",
"name": "string",
"source": "string"
}
]
},
"storageEndpoints": {
"{customized property}": {
"connectionString": "string",
"containerName": "string",
"sasTtlAsIso8601": "string"
}
}
},
"resourcegroup": "string",
"sku": {
"capacity": "int",
"name": "string"
},
"subscriptionid": "string",
"tags": {
"{customized property}": "string"
}
}
قيم الخصائص
خصائص جهاز السحابة
خصائص EventHub
اسم | وصف | قيمة |
---|---|---|
عدد الأقسام | عدد الأقسام لتلقي رسائل من جهاز إلى سحابة في نقطة النهاية المتوافقة مع Event Hub. راجع: /azure/iot-hub/iot-hub-devguide-messaging#device-to-cloud-messages. | الباحث |
retentionTimeInDays | وقت الاستبقاء للرسائل من جهاز إلى سحابة بالأيام. راجع: /azure/iot-hub/iot-hub-devguide-messaging#device-to-cloud-messages | الباحث |
الخصائص الاحتياطية للRoute
اسم | وصف | قيمة |
---|---|---|
شرط | الشرط الذي يتم تقييمه من أجل تطبيق المسار الاحتياطي. إذا لم يتم توفير الشرط، تقييمه إلى صحيح بشكل افتراضي. للتدقيق النحوي، راجع: /azure/iot-hub/iot-hub-devguide-query-language | خيط |
أسماء نقاط النهاية | قائمة نقاط النهاية التي يتم توجيه الرسائل التي تفي بالشرط إليها. يسمح حاليا بنقطة نهاية واحدة فقط. | string[] (مطلوبة) |
isEnabled | يستخدم لتحديد ما إذا كان المسار الاحتياطي ممكنا أم لا. | bool (مطلوب) |
مصدر | المصدر الذي سيتم تطبيق قاعدة التوجيه عليه. على سبيل المثال، DeviceMessages | "أحداث دورة حياة الجهاز" "أحداث دورة حياة الجهاز" "رسائل الجهاز" 'TwinChangeEvents' (مطلوب) |
خصائص الملاحظات
اسم | وصف | قيمة |
---|---|---|
lockDurationAsIso8601 | مدة تأمين قائمة انتظار الملاحظات. راجع: /azure/iot-hub/iot-hub-devguide-messaging#cloud-to-device-messages. | خيط |
maxDeliveryCount | عدد المرات التي يحاول فيها مركز IoT تسليم رسالة في قائمة انتظار الملاحظات. راجع: /azure/iot-hub/iot-hub-devguide-messaging#cloud-to-device-messages. | الباحث القيود: قيمة الحد الأدنى = 1 القيمة القصوى = 100 |
ttlAsIso8601 | الفترة الزمنية التي تتوفر فيها الرسالة للاستهلاك قبل انتهاء صلاحيتها بواسطة مركز IoT. راجع: /azure/iot-hub/iot-hub-devguide-messaging#cloud-to-device-messages. | خيط |
خصائص IotHub
اسم | وصف | قيمة |
---|---|---|
نهج التخويل | نهج الوصول المشتركة التي يمكنك استخدامها لتأمين اتصال بمركز IoT. | SharedAccessSignatureAuthorizationRule[] |
cloudToDevice | خصائص المراسلة من سحابة إلى جهاز لمركز IoT. | CloudToDeviceProperties |
التعليقات | تعليقات مركز IoT. | خيط |
enableFileUploadNotifications | إذا كانت True، يتم تمكين إعلامات تحميل الملفات. | قيمة منطقية |
نقاط نهاية eventHub | خصائص نقطة النهاية المتوافقة مع Event Hub. المفاتيح المحتملة لهذا القاموس هي الأحداث والعملياتMonitoringEvents. يجب أن يكون كلا المفتاحين موجودين في القاموس أثناء إجراء استدعاءات إنشاء أو تحديث لمركز IoT. | IotHubPropertiesEventHubEndpoints |
ملامح | الإمكانات والميزات الممكنة لمركز IoT. | "إدارة الجهاز" "بلا" |
ipFilterRules | قواعد عامل تصفية IP. | IpFilterRule[] |
نقاط نهاية المراسلة | خصائص نقطة نهاية المراسلة لقائمة انتظار إعلام تحميل الملف. | IotHubPropertiesMessagingEndpoints |
operationsMonitoringProperties | خصائص مراقبة العمليات لمركز IoT. المفاتيح المحتملة للقاموس هي الاتصالات، DeviceTelemetry، C2DCommands، DeviceIdentityOperations، FileUploadOperations، Routes، D2CTwinOperations، C2DTwinOperations، TwinQueries، JobsOperations، DirectMethods. | OperationsMonitoringProperties |
التوجيه | الخصائص ذات الصلة للتوجيه لمركز IoT. راجع: /azure/iot-hub/iot-hub-devguide-messaging | RoutingProperties |
نقاط نهاية التخزين | قائمة نقاط نهاية Azure Storage حيث يمكنك تحميل الملفات. يمكنك حاليا تكوين حساب Azure Storage واحد فقط ويجب أن يكون مفتاحه $default. يؤدي تحديد أكثر من حساب تخزين واحد إلى طرح خطأ. يؤدي عدم تحديد قيمة لهذه الخاصية عند تعيين الخاصية enableFileUploadNotifications إلى True إلى ظهور خطأ. | IotHubPropertiesStorageEndpoints |
نقاط نهاية IotHubPropertiesEventHub
اسم | وصف | قيمة |
---|
IotHubPropertiesMessagingEndpoints
اسم | وصف | قيمة |
---|
IotHubPropertiesStorageEndpoints
اسم | وصف | قيمة |
---|
معلومات IotHubSku
اسم | وصف | قيمة |
---|---|---|
سعة | عدد وحدات IoT Hub المتوفرة. راجع: /azure/azure-subscription-service-limits#iot-hub-limits. | int (مطلوب) |
اسم | اسم SKU. | 'F1' 'S1' 'S2' 'S3' (مطلوب) |
IpFilterRule
اسم | وصف | قيمة |
---|---|---|
فعل | الإجراء المطلوب للطلبات التي تم التقاطها بواسطة هذه القاعدة. | "قبول" "رفض" (مطلوب) |
اسم عامل التصفية | اسم قاعدة عامل تصفية IP. | سلسلة (مطلوب) |
ipMask | سلسلة تحتوي على نطاق عنوان IP في رمز CIDR للقاعدة. | سلسلة (مطلوب) |
خصائص نقطة نهاية المراسلة
اسم | وصف | قيمة |
---|---|---|
lockDurationAsIso8601 | مدة التأمين. راجع: /azure/iot-hub/iot-hub-devguide-file-upload. | خيط |
maxDeliveryCount | عدد المرات التي يحاول فيها مركز IoT تسليم رسالة. راجع: /azure/iot-hub/iot-hub-devguide-file-upload. | الباحث القيود: قيمة الحد الأدنى = 1 القيمة القصوى = 100 |
ttlAsIso8601 | الفترة الزمنية التي تتوفر فيها الرسالة للاستهلاك قبل انتهاء صلاحيتها بواسطة مركز IoT. راجع: /azure/iot-hub/iot-hub-devguide-file-upload. | خيط |
Microsoft.Devices/IotHubs
اسم | وصف | قيمة |
---|---|---|
apiVersion | إصدار واجهة برمجة التطبيقات | '2017-07-01' |
etag | حقل Etag غير مطلوب . إذا تم توفيره في نص الاستجابة، يجب أيضا توفيره كعنوان وفقا لاصطلاح ETag العادي. | خيط |
مكان | موقع المورد. | سلسلة (مطلوب) |
اسم | اسم المورد | سلسلة (مطلوب) |
خصائص | خصائص مركز IoT. | IotHubProperties |
مجموعة الموارد | اسم مجموعة الموارد التي تحتوي على مركز IoT. يعرف اسم مجموعة الموارد مجموعة الموارد بشكل فريد داخل الاشتراك. | سلسلة (مطلوب) |
سكو | معلومات حول SKU لمركز IoT. | IotHubSkuInfo (مطلوب) |
معرف الاشتراك | معرف الاشتراك. | سلسلة (مطلوب) |
العلامات | علامات الموارد | قاموس أسماء العلامات والقيم. راجع العلامات في القوالب |
نوع | نوع المورد | 'Microsoft.Devices/IotHubs' |
OperationsMonitoringProperties
اسم | وصف | قيمة |
---|---|---|
احداث | قاموس <OperationMonitoringLevel> | OperationsMonitoringPropertiesEvents |
الأحداث الخاصة ب OperationsMonitoringProperties
اسم | وصف | قيمة |
---|
علامات تعريف الموارد
اسم | وصف | قيمة |
---|
خصائص المسار
اسم | وصف | قيمة |
---|---|---|
شرط | الشرط الذي يتم تقييمه لتطبيق قاعدة التحويل. إذا لم يتم توفير أي شرط، يتم تقييمه إلى صحيح بشكل افتراضي. للتدقيق النحوي، راجع: /azure/iot-hub/iot-hub-devguide-query-language | خيط |
أسماء نقاط النهاية | قائمة نقاط النهاية التي يتم توجيه الرسائل التي تفي بالشرط. يسمح حاليا بنقطة نهاية واحدة فقط. | string[] (مطلوبة) |
isEnabled | يستخدم لتحديد ما إذا كان المسار ممكنا أم لا. | bool (مطلوب) |
اسم | اسم المسار. يمكن أن يتضمن الاسم فقط الأحرف الأبجدية الرقمية والنقاط والتسطير السفلي والواصلات، بحد أقصى 64 حرفا، ويجب أن يكون فريدا. | خيط القيود: النمط = ^[A-Za-z0-9-._]{1,64}$ (مطلوب) |
مصدر | المصدر الذي سيتم تطبيق قاعدة التوجيه عليه، مثل DeviceMessages. | "أحداث دورة حياة الجهاز" "أحداث دورة حياة الجهاز" "رسائل الجهاز" 'TwinChangeEvents' (مطلوب) |
نقاط نهاية التوجيه
اسم | وصف | قيمة |
---|---|---|
eventHubs | قائمة نقاط نهاية مراكز الأحداث التي يوجه مركز IoT الرسائل إليها، استنادا إلى قواعد التوجيه. لا تتضمن هذه القائمة نقطة نهاية مراكز الأحداث المضمنة. | RoutingEventHubProperties [] |
serviceBusQueues | قائمة نقاط نهاية قائمة انتظار ناقل خدمة Microsoft Azure التي يوجه مركز IoT الرسائل إليها، استنادا إلى قواعد التوجيه. | RoutingServiceBusQueueEndpointProperties[] |
serviceBusTopics | قائمة نقاط نهاية موضوع ناقل خدمة Microsoft Azure التي يوجه مركز IoT الرسائل إليها، استنادا إلى قواعد التوجيه. | RoutingServiceBusTopicEndpointProperties[] |
مكونات التخزين | قائمة نقاط نهاية حاوية التخزين التي يوجه مركز IoT الرسائل إليها، استنادا إلى قواعد التوجيه. | RoutingStorageContainerProperties[] |
RoutingEventHubProperties
اسم | وصف | قيمة |
---|---|---|
سلسلة الاتصال | سلسلة الاتصال لنقطة نهاية مركز الحدث. | سلسلة (مطلوب) |
اسم | الاسم الذي يعرف نقطة النهاية هذه. يمكن أن يتضمن الاسم الأحرف الأبجدية الرقمية والنقاط والتسطير السفلي والواصلات بحد أقصى 64 حرفا. الأسماء التالية محجوزة: الأحداث، operationsMonitoringEvents، fileNotifications، $default. يجب أن تكون أسماء نقاط النهاية فريدة عبر أنواع نقاط النهاية. | خيط القيود: النمط = ^[A-Za-z0-9-._]{1,64}$ (مطلوب) |
مجموعة الموارد | اسم مجموعة الموارد لنقطة نهاية مركز الحدث. | خيط |
معرف الاشتراك | معرف الاشتراك لنقطة نهاية مركز الحدث. | خيط |
خصائص التوجيه
RoutingServiceBusQueueEndpointProperties
اسم | وصف | قيمة |
---|---|---|
سلسلة الاتصال | سلسلة الاتصال لنقطة نهاية قائمة انتظار ناقل الخدمة. | سلسلة (مطلوب) |
اسم | الاسم الذي يعرف نقطة النهاية هذه. يمكن أن يتضمن الاسم الأحرف الأبجدية الرقمية والنقاط والتسطير السفلي والواصلات بحد أقصى 64 حرفا. الأسماء التالية محجوزة: الأحداث، operationsMonitoringEvents، fileNotifications، $default. يجب أن تكون أسماء نقاط النهاية فريدة عبر أنواع نقاط النهاية. لا يجب أن يكون الاسم هو نفس اسم قائمة الانتظار الفعلي. | خيط القيود: النمط = ^[A-Za-z0-9-._]{1,64}$ (مطلوب) |
مجموعة الموارد | اسم مجموعة الموارد لنقطة نهاية قائمة انتظار ناقل الخدمة. | خيط |
معرف الاشتراك | معرف الاشتراك لنقطة نهاية قائمة انتظار ناقل الخدمة. | خيط |
RoutingServiceBusTopicEndpointProperties
اسم | وصف | قيمة |
---|---|---|
سلسلة الاتصال | سلسلة الاتصال لنقطة نهاية موضوع ناقل الخدمة. | سلسلة (مطلوب) |
اسم | الاسم الذي يعرف نقطة النهاية هذه. يمكن أن يتضمن الاسم الأحرف الأبجدية الرقمية والنقاط والتسطير السفلي والواصلات بحد أقصى 64 حرفا. الأسماء التالية محجوزة: الأحداث، operationsMonitoringEvents، fileNotifications، $default. يجب أن تكون أسماء نقاط النهاية فريدة عبر أنواع نقاط النهاية. لا يجب أن يكون الاسم هو نفس اسم الموضوع الفعلي. | خيط القيود: النمط = ^[A-Za-z0-9-._]{1,64}$ (مطلوب) |
مجموعة الموارد | اسم مجموعة الموارد لنقطة نهاية موضوع ناقل الخدمة. | خيط |
معرف الاشتراك | معرف الاشتراك لنقطة نهاية موضوع ناقل الخدمة. | خيط |
RoutingStorageContainerProperties
اسم | وصف | قيمة |
---|---|---|
batchFrequencyInSeconds | الفاصل الزمني الذي تتم فيه كتابة الكائنات الثنائية كبيرة الحجم إلى التخزين. يجب أن تتراوح القيمة بين 60 و720 ثانية. القيمة الافتراضية هي 300 ثانية. | الباحث القيود: قيمة الحد الأدنى = 60 القيمة القصوى = 720 |
سلسلة الاتصال | سلسلة الاتصال لحساب التخزين. | سلسلة (مطلوب) |
اسم الحاوية | اسم حاوية التخزين في حساب التخزين. | سلسلة (مطلوب) |
ترميز | الترميز المستخدم لتسلسل الرسائل إلى الكائنات الثنائية كبيرة الحجم. القيم المدعومة هي "avro" و"avroDeflate". القيمة الافتراضية هي "avro". | خيط |
تنسيق اسم الملف | تنسيق اسم الملف للكائن الثنائي كبير الحجم. التنسيق الافتراضي هو {iothub}/{partition}/{YYYY}/{MM}/{DD}/{HH}/{mm}. جميع المعلمات إلزامية ولكن يمكن إعادة ترتيبها. | خيط |
maxChunkSizeInBytes | الحد الأقصى لعدد وحدات البايت لكل كائن ثنائي كبير الحجم مكتوب إلى التخزين. يجب أن تكون القيمة بين 10485760 (10 ميغابايت) 524288000(500 ميغابايت). القيمة الافتراضية هي 314572800 (300 ميغابايت). | الباحث القيود: قيمة الحد الأدنى = 10485760 القيمة القصوى = 524288000 |
اسم | الاسم الذي يعرف نقطة النهاية هذه. يمكن أن يتضمن الاسم الأحرف الأبجدية الرقمية والنقاط والتسطير السفلي والواصلات بحد أقصى 64 حرفا. الأسماء التالية محجوزة: الأحداث، operationsMonitoringEvents، fileNotifications، $default. يجب أن تكون أسماء نقاط النهاية فريدة عبر أنواع نقاط النهاية. | خيط القيود: النمط = ^[A-Za-z0-9-._]{1,64}$ (مطلوب) |
مجموعة الموارد | اسم مجموعة الموارد لحساب التخزين. | خيط |
معرف الاشتراك | معرف الاشتراك لحساب التخزين. | خيط |
SharedAccessSignatureAuthorizationRule
اسم | وصف | قيمة |
---|---|---|
اسم المفتاح | اسم نهج الوصول المشترك. | سلسلة (مطلوب) |
مفتاح أساسي | المفتاح الأساسي. | خيط |
حقوق | الأذونات المعينة لنهج الوصول المشترك. | 'اتصال الجهاز' "قراءة السجل" "RegistryRead, DeviceConnect" "RegistryRead, RegistryWrite" 'RegistryRead, RegistryWrite, DeviceConnect' 'RegistryRead, RegistryWrite, ServiceConnect' 'RegistryRead, RegistryWrite, ServiceConnect, DeviceConnect' "RegistryRead, ServiceConnect" 'RegistryRead, ServiceConnect, DeviceConnect' "RegistryWrite" "RegistryWrite, DeviceConnect" "RegistryWrite, ServiceConnect" 'RegistryWrite, ServiceConnect, DeviceConnect' "اتصال الخدمة" "ServiceConnect, DeviceConnect" (مطلوب) |
مفتاح ثانوي | المفتاح الثانوي. | خيط |
خصائص StorageEndpoint
اسم | وصف | قيمة |
---|---|---|
سلسلة الاتصال | سلسلة الاتصال لحساب Azure Storage الذي يتم تحميل الملفات إليه. | سلسلة (مطلوب) |
اسم الحاوية | اسم حاوية الجذر حيث تقوم بتحميل الملفات. الحاوية غير موجودة ولكن يجب أن تكون قابلة لل creatable باستخدام connectionString المحدد. | سلسلة (مطلوب) |
sasTtlAsIso8601 | الفترة الزمنية التي يكون فيها SAS URI الذي تم إنشاؤه بواسطة IoT Hub لتحميل الملف صالحا. راجع: /azure/iot-hub/iot-hub-devguide-file-upload#file-upload-notification-configuration-options. | خيط |
أمثلة الاستخدام
قوالب Azure Quickstart
قوالب Azure Quickstart التالية توزيع نوع المورد هذا.
قالب | وصف |
---|---|
إنشاء بيئة الدفع حسب الاستخدام (PAYG) باستخدام مركز IoT |
يمكنك هذا القالب من نشر بيئة Pay As You Go (PAYG) Time Series Insights التي تم تكوينها لاستهلاك الأحداث من IoT Hub. |
إنشاء مركز IoT وجهاز إلى مجموعة المستهلكين السحابية |
يمكنك هذا القالب من نشر مثيل IoT Hub مع جهاز على السحابة والسحابة إلى تكوينات مراسلة الجهاز وجهاز إلى مجموعة مستهلكي السحابة. |
إنشاء محاكي IOT Hub وUbuntu edge |
ينشئ هذا القالب محاكي حافة IOT Hub وVirtual Machine Ubuntu. |
إنشاء خدمة توفير جهاز IoT Hub |
يمكنك هذا القالب من إنشاء مركز IoT وخدمة توفير جهاز IoT Hub، وربط الخدمتين معا. |
إنشاء تحديث الجهاز لحساب IoT Hub، المثيل، IoT Hub |
ينشئ هذا القالب حسابا ومثيلا ومركزا لربط المثيل به. يقوم بتكوين المركز مع نهج الوصول الضرورية والمسارات ومجموعة المستهلكين. |
نشر خدمة MedTech بما في ذلك Azure IoT Hub |
خدمة MedTech هي واحدة من Azure Health Data Services المصممة لاستيعاب بيانات الجهاز من أجهزة متعددة، وتحويل بيانات الجهاز إلى ملاحظات FHIR، والتي تستمر بعد ذلك في خدمة Azure Health Data Services FHIR. |
استخدام قالب ARM لإنشاء IoT Hub وتوجيه الرسائل وعرضها |
استخدم هذا القالب لنشر IoT Hub وحساب تخزين. قم بتشغيل تطبيق لإرسال رسائل إلى المركز التي يتم توجيهها إلى التخزين، ثم عرض النتائج. |
تعريف مورد Terraform (موفر AzAPI)
يمكن نشر نوع مورد IotHubs مع العمليات التي تستهدف:
- مجموعات الموارد
للحصول على قائمة بالخصائص التي تم تغييرها في كل إصدار من إصدارات واجهة برمجة التطبيقات، راجع سجل التغيير .
تنسيق المورد
لإنشاء مورد Microsoft.Devices/IotHubs، أضف Terraform التالي إلى القالب الخاص بك.
resource "azapi_resource" "symbolicname" {
type = "Microsoft.Devices/IotHubs@2017-07-01"
name = "string"
location = "string"
tags = {
{customized property} = "string"
}
body = {
etag = "string"
properties = {
authorizationPolicies = [
{
keyName = "string"
primaryKey = "string"
rights = "string"
secondaryKey = "string"
}
]
cloudToDevice = {
defaultTtlAsIso8601 = "string"
feedback = {
lockDurationAsIso8601 = "string"
maxDeliveryCount = int
ttlAsIso8601 = "string"
}
maxDeliveryCount = int
}
comments = "string"
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"
}
}
operationsMonitoringProperties = {
events = {
{customized property} = "string"
}
}
routing = {
endpoints = {
eventHubs = [
{
connectionString = "string"
name = "string"
resourceGroup = "string"
subscriptionId = "string"
}
]
serviceBusQueues = [
{
connectionString = "string"
name = "string"
resourceGroup = "string"
subscriptionId = "string"
}
]
serviceBusTopics = [
{
connectionString = "string"
name = "string"
resourceGroup = "string"
subscriptionId = "string"
}
]
storageContainers = [
{
batchFrequencyInSeconds = int
connectionString = "string"
containerName = "string"
encoding = "string"
fileNameFormat = "string"
maxChunkSizeInBytes = int
name = "string"
resourceGroup = "string"
subscriptionId = "string"
}
]
}
fallbackRoute = {
condition = "string"
endpointNames = [
"string"
]
isEnabled = bool
source = "string"
}
routes = [
{
condition = "string"
endpointNames = [
"string"
]
isEnabled = bool
name = "string"
source = "string"
}
]
}
storageEndpoints = {
{customized property} = {
connectionString = "string"
containerName = "string"
sasTtlAsIso8601 = "string"
}
}
}
resourcegroup = "string"
sku = {
capacity = int
name = "string"
}
subscriptionid = "string"
}
}
قيم الخصائص
خصائص جهاز السحابة
خصائص EventHub
اسم | وصف | قيمة |
---|---|---|
عدد الأقسام | عدد الأقسام لتلقي رسائل من جهاز إلى سحابة في نقطة النهاية المتوافقة مع Event Hub. راجع: /azure/iot-hub/iot-hub-devguide-messaging#device-to-cloud-messages. | الباحث |
retentionTimeInDays | وقت الاستبقاء للرسائل من جهاز إلى سحابة بالأيام. راجع: /azure/iot-hub/iot-hub-devguide-messaging#device-to-cloud-messages | الباحث |
الخصائص الاحتياطية للRoute
اسم | وصف | قيمة |
---|---|---|
شرط | الشرط الذي يتم تقييمه من أجل تطبيق المسار الاحتياطي. إذا لم يتم توفير الشرط، تقييمه إلى صحيح بشكل افتراضي. للتدقيق النحوي، راجع: /azure/iot-hub/iot-hub-devguide-query-language | خيط |
أسماء نقاط النهاية | قائمة نقاط النهاية التي يتم توجيه الرسائل التي تفي بالشرط إليها. يسمح حاليا بنقطة نهاية واحدة فقط. | string[] (مطلوبة) |
isEnabled | يستخدم لتحديد ما إذا كان المسار الاحتياطي ممكنا أم لا. | bool (مطلوب) |
مصدر | المصدر الذي سيتم تطبيق قاعدة التوجيه عليه. على سبيل المثال، DeviceMessages | "أحداث دورة حياة الجهاز" "أحداث دورة حياة الجهاز" "رسائل الجهاز" 'TwinChangeEvents' (مطلوب) |
خصائص الملاحظات
اسم | وصف | قيمة |
---|---|---|
lockDurationAsIso8601 | مدة تأمين قائمة انتظار الملاحظات. راجع: /azure/iot-hub/iot-hub-devguide-messaging#cloud-to-device-messages. | خيط |
maxDeliveryCount | عدد المرات التي يحاول فيها مركز IoT تسليم رسالة في قائمة انتظار الملاحظات. راجع: /azure/iot-hub/iot-hub-devguide-messaging#cloud-to-device-messages. | الباحث القيود: قيمة الحد الأدنى = 1 القيمة القصوى = 100 |
ttlAsIso8601 | الفترة الزمنية التي تتوفر فيها الرسالة للاستهلاك قبل انتهاء صلاحيتها بواسطة مركز IoT. راجع: /azure/iot-hub/iot-hub-devguide-messaging#cloud-to-device-messages. | خيط |
خصائص IotHub
اسم | وصف | قيمة |
---|---|---|
نهج التخويل | نهج الوصول المشتركة التي يمكنك استخدامها لتأمين اتصال بمركز IoT. | SharedAccessSignatureAuthorizationRule[] |
cloudToDevice | خصائص المراسلة من سحابة إلى جهاز لمركز IoT. | CloudToDeviceProperties |
التعليقات | تعليقات مركز IoT. | خيط |
enableFileUploadNotifications | إذا كانت True، يتم تمكين إعلامات تحميل الملفات. | قيمة منطقية |
نقاط نهاية eventHub | خصائص نقطة النهاية المتوافقة مع Event Hub. المفاتيح المحتملة لهذا القاموس هي الأحداث والعملياتMonitoringEvents. يجب أن يكون كلا المفتاحين موجودين في القاموس أثناء إجراء استدعاءات إنشاء أو تحديث لمركز IoT. | IotHubPropertiesEventHubEndpoints |
ملامح | الإمكانات والميزات الممكنة لمركز IoT. | "إدارة الجهاز" "بلا" |
ipFilterRules | قواعد عامل تصفية IP. | IpFilterRule[] |
نقاط نهاية المراسلة | خصائص نقطة نهاية المراسلة لقائمة انتظار إعلام تحميل الملف. | IotHubPropertiesMessagingEndpoints |
operationsMonitoringProperties | خصائص مراقبة العمليات لمركز IoT. المفاتيح المحتملة للقاموس هي الاتصالات، DeviceTelemetry، C2DCommands، DeviceIdentityOperations، FileUploadOperations، Routes، D2CTwinOperations، C2DTwinOperations، TwinQueries، JobsOperations، DirectMethods. | OperationsMonitoringProperties |
التوجيه | الخصائص ذات الصلة للتوجيه لمركز IoT. راجع: /azure/iot-hub/iot-hub-devguide-messaging | RoutingProperties |
نقاط نهاية التخزين | قائمة نقاط نهاية Azure Storage حيث يمكنك تحميل الملفات. يمكنك حاليا تكوين حساب Azure Storage واحد فقط ويجب أن يكون مفتاحه $default. يؤدي تحديد أكثر من حساب تخزين واحد إلى طرح خطأ. يؤدي عدم تحديد قيمة لهذه الخاصية عند تعيين الخاصية enableFileUploadNotifications إلى True إلى ظهور خطأ. | IotHubPropertiesStorageEndpoints |
نقاط نهاية IotHubPropertiesEventHub
اسم | وصف | قيمة |
---|
IotHubPropertiesMessagingEndpoints
اسم | وصف | قيمة |
---|
IotHubPropertiesStorageEndpoints
اسم | وصف | قيمة |
---|
معلومات IotHubSku
اسم | وصف | قيمة |
---|---|---|
سعة | عدد وحدات IoT Hub المتوفرة. راجع: /azure/azure-subscription-service-limits#iot-hub-limits. | int (مطلوب) |
اسم | اسم SKU. | 'F1' 'S1' 'S2' 'S3' (مطلوب) |
IpFilterRule
اسم | وصف | قيمة |
---|---|---|
فعل | الإجراء المطلوب للطلبات التي تم التقاطها بواسطة هذه القاعدة. | "قبول" "رفض" (مطلوب) |
اسم عامل التصفية | اسم قاعدة عامل تصفية IP. | سلسلة (مطلوب) |
ipMask | سلسلة تحتوي على نطاق عنوان IP في رمز CIDR للقاعدة. | سلسلة (مطلوب) |
خصائص نقطة نهاية المراسلة
اسم | وصف | قيمة |
---|---|---|
lockDurationAsIso8601 | مدة التأمين. راجع: /azure/iot-hub/iot-hub-devguide-file-upload. | خيط |
maxDeliveryCount | عدد المرات التي يحاول فيها مركز IoT تسليم رسالة. راجع: /azure/iot-hub/iot-hub-devguide-file-upload. | الباحث القيود: قيمة الحد الأدنى = 1 القيمة القصوى = 100 |
ttlAsIso8601 | الفترة الزمنية التي تتوفر فيها الرسالة للاستهلاك قبل انتهاء صلاحيتها بواسطة مركز IoT. راجع: /azure/iot-hub/iot-hub-devguide-file-upload. | خيط |
Microsoft.Devices/IotHubs
اسم | وصف | قيمة |
---|---|---|
etag | حقل Etag غير مطلوب . إذا تم توفيره في نص الاستجابة، يجب أيضا توفيره كعنوان وفقا لاصطلاح ETag العادي. | خيط |
مكان | موقع المورد. | سلسلة (مطلوب) |
اسم | اسم المورد | سلسلة (مطلوب) |
خصائص | خصائص مركز IoT. | IotHubProperties |
مجموعة الموارد | اسم مجموعة الموارد التي تحتوي على مركز IoT. يعرف اسم مجموعة الموارد مجموعة الموارد بشكل فريد داخل الاشتراك. | سلسلة (مطلوب) |
سكو | معلومات حول SKU لمركز IoT. | IotHubSkuInfo (مطلوب) |
معرف الاشتراك | معرف الاشتراك. | سلسلة (مطلوب) |
العلامات | علامات الموارد | قاموس أسماء العلامات والقيم. |
نوع | نوع المورد | "Microsoft.Devices/IotHubs@2017-07-01" |
OperationsMonitoringProperties
اسم | وصف | قيمة |
---|---|---|
احداث | قاموس <OperationMonitoringLevel> | OperationsMonitoringPropertiesEvents |
الأحداث الخاصة ب OperationsMonitoringProperties
اسم | وصف | قيمة |
---|
علامات تعريف الموارد
اسم | وصف | قيمة |
---|
خصائص المسار
اسم | وصف | قيمة |
---|---|---|
شرط | الشرط الذي يتم تقييمه لتطبيق قاعدة التحويل. إذا لم يتم توفير أي شرط، يتم تقييمه إلى صحيح بشكل افتراضي. للتدقيق النحوي، راجع: /azure/iot-hub/iot-hub-devguide-query-language | خيط |
أسماء نقاط النهاية | قائمة نقاط النهاية التي يتم توجيه الرسائل التي تفي بالشرط. يسمح حاليا بنقطة نهاية واحدة فقط. | string[] (مطلوبة) |
isEnabled | يستخدم لتحديد ما إذا كان المسار ممكنا أم لا. | bool (مطلوب) |
اسم | اسم المسار. يمكن أن يتضمن الاسم فقط الأحرف الأبجدية الرقمية والنقاط والتسطير السفلي والواصلات، بحد أقصى 64 حرفا، ويجب أن يكون فريدا. | خيط القيود: النمط = ^[A-Za-z0-9-._]{1,64}$ (مطلوب) |
مصدر | المصدر الذي سيتم تطبيق قاعدة التوجيه عليه، مثل DeviceMessages. | "أحداث دورة حياة الجهاز" "أحداث دورة حياة الجهاز" "رسائل الجهاز" 'TwinChangeEvents' (مطلوب) |
نقاط نهاية التوجيه
اسم | وصف | قيمة |
---|---|---|
eventHubs | قائمة نقاط نهاية مراكز الأحداث التي يوجه مركز IoT الرسائل إليها، استنادا إلى قواعد التوجيه. لا تتضمن هذه القائمة نقطة نهاية مراكز الأحداث المضمنة. | RoutingEventHubProperties [] |
serviceBusQueues | قائمة نقاط نهاية قائمة انتظار ناقل خدمة Microsoft Azure التي يوجه مركز IoT الرسائل إليها، استنادا إلى قواعد التوجيه. | RoutingServiceBusQueueEndpointProperties[] |
serviceBusTopics | قائمة نقاط نهاية موضوع ناقل خدمة Microsoft Azure التي يوجه مركز IoT الرسائل إليها، استنادا إلى قواعد التوجيه. | RoutingServiceBusTopicEndpointProperties[] |
مكونات التخزين | قائمة نقاط نهاية حاوية التخزين التي يوجه مركز IoT الرسائل إليها، استنادا إلى قواعد التوجيه. | RoutingStorageContainerProperties[] |
RoutingEventHubProperties
اسم | وصف | قيمة |
---|---|---|
سلسلة الاتصال | سلسلة الاتصال لنقطة نهاية مركز الحدث. | سلسلة (مطلوب) |
اسم | الاسم الذي يعرف نقطة النهاية هذه. يمكن أن يتضمن الاسم الأحرف الأبجدية الرقمية والنقاط والتسطير السفلي والواصلات بحد أقصى 64 حرفا. الأسماء التالية محجوزة: الأحداث، operationsMonitoringEvents، fileNotifications، $default. يجب أن تكون أسماء نقاط النهاية فريدة عبر أنواع نقاط النهاية. | خيط القيود: النمط = ^[A-Za-z0-9-._]{1,64}$ (مطلوب) |
مجموعة الموارد | اسم مجموعة الموارد لنقطة نهاية مركز الحدث. | خيط |
معرف الاشتراك | معرف الاشتراك لنقطة نهاية مركز الحدث. | خيط |
خصائص التوجيه
RoutingServiceBusQueueEndpointProperties
اسم | وصف | قيمة |
---|---|---|
سلسلة الاتصال | سلسلة الاتصال لنقطة نهاية قائمة انتظار ناقل الخدمة. | سلسلة (مطلوب) |
اسم | الاسم الذي يعرف نقطة النهاية هذه. يمكن أن يتضمن الاسم الأحرف الأبجدية الرقمية والنقاط والتسطير السفلي والواصلات بحد أقصى 64 حرفا. الأسماء التالية محجوزة: الأحداث، operationsMonitoringEvents، fileNotifications، $default. يجب أن تكون أسماء نقاط النهاية فريدة عبر أنواع نقاط النهاية. لا يجب أن يكون الاسم هو نفس اسم قائمة الانتظار الفعلي. | خيط القيود: النمط = ^[A-Za-z0-9-._]{1,64}$ (مطلوب) |
مجموعة الموارد | اسم مجموعة الموارد لنقطة نهاية قائمة انتظار ناقل الخدمة. | خيط |
معرف الاشتراك | معرف الاشتراك لنقطة نهاية قائمة انتظار ناقل الخدمة. | خيط |
RoutingServiceBusTopicEndpointProperties
اسم | وصف | قيمة |
---|---|---|
سلسلة الاتصال | سلسلة الاتصال لنقطة نهاية موضوع ناقل الخدمة. | سلسلة (مطلوب) |
اسم | الاسم الذي يعرف نقطة النهاية هذه. يمكن أن يتضمن الاسم الأحرف الأبجدية الرقمية والنقاط والتسطير السفلي والواصلات بحد أقصى 64 حرفا. الأسماء التالية محجوزة: الأحداث، operationsMonitoringEvents، fileNotifications، $default. يجب أن تكون أسماء نقاط النهاية فريدة عبر أنواع نقاط النهاية. لا يجب أن يكون الاسم هو نفس اسم الموضوع الفعلي. | خيط القيود: النمط = ^[A-Za-z0-9-._]{1,64}$ (مطلوب) |
مجموعة الموارد | اسم مجموعة الموارد لنقطة نهاية موضوع ناقل الخدمة. | خيط |
معرف الاشتراك | معرف الاشتراك لنقطة نهاية موضوع ناقل الخدمة. | خيط |
RoutingStorageContainerProperties
اسم | وصف | قيمة |
---|---|---|
batchFrequencyInSeconds | الفاصل الزمني الذي تتم فيه كتابة الكائنات الثنائية كبيرة الحجم إلى التخزين. يجب أن تتراوح القيمة بين 60 و720 ثانية. القيمة الافتراضية هي 300 ثانية. | الباحث القيود: قيمة الحد الأدنى = 60 القيمة القصوى = 720 |
سلسلة الاتصال | سلسلة الاتصال لحساب التخزين. | سلسلة (مطلوب) |
اسم الحاوية | اسم حاوية التخزين في حساب التخزين. | سلسلة (مطلوب) |
ترميز | الترميز المستخدم لتسلسل الرسائل إلى الكائنات الثنائية كبيرة الحجم. القيم المدعومة هي "avro" و"avroDeflate". القيمة الافتراضية هي "avro". | خيط |
تنسيق اسم الملف | تنسيق اسم الملف للكائن الثنائي كبير الحجم. التنسيق الافتراضي هو {iothub}/{partition}/{YYYY}/{MM}/{DD}/{HH}/{mm}. جميع المعلمات إلزامية ولكن يمكن إعادة ترتيبها. | خيط |
maxChunkSizeInBytes | الحد الأقصى لعدد وحدات البايت لكل كائن ثنائي كبير الحجم مكتوب إلى التخزين. يجب أن تكون القيمة بين 10485760 (10 ميغابايت) 524288000(500 ميغابايت). القيمة الافتراضية هي 314572800 (300 ميغابايت). | الباحث القيود: قيمة الحد الأدنى = 10485760 القيمة القصوى = 524288000 |
اسم | الاسم الذي يعرف نقطة النهاية هذه. يمكن أن يتضمن الاسم الأحرف الأبجدية الرقمية والنقاط والتسطير السفلي والواصلات بحد أقصى 64 حرفا. الأسماء التالية محجوزة: الأحداث، operationsMonitoringEvents، fileNotifications، $default. يجب أن تكون أسماء نقاط النهاية فريدة عبر أنواع نقاط النهاية. | خيط القيود: النمط = ^[A-Za-z0-9-._]{1,64}$ (مطلوب) |
مجموعة الموارد | اسم مجموعة الموارد لحساب التخزين. | خيط |
معرف الاشتراك | معرف الاشتراك لحساب التخزين. | خيط |
SharedAccessSignatureAuthorizationRule
اسم | وصف | قيمة |
---|---|---|
اسم المفتاح | اسم نهج الوصول المشترك. | سلسلة (مطلوب) |
مفتاح أساسي | المفتاح الأساسي. | خيط |
حقوق | الأذونات المعينة لنهج الوصول المشترك. | 'اتصال الجهاز' "قراءة السجل" "RegistryRead, DeviceConnect" "RegistryRead, RegistryWrite" 'RegistryRead, RegistryWrite, DeviceConnect' 'RegistryRead, RegistryWrite, ServiceConnect' 'RegistryRead, RegistryWrite, ServiceConnect, DeviceConnect' "RegistryRead, ServiceConnect" 'RegistryRead, ServiceConnect, DeviceConnect' "RegistryWrite" "RegistryWrite, DeviceConnect" "RegistryWrite, ServiceConnect" 'RegistryWrite, ServiceConnect, DeviceConnect' "اتصال الخدمة" "ServiceConnect, DeviceConnect" (مطلوب) |
مفتاح ثانوي | المفتاح الثانوي. | خيط |
خصائص StorageEndpoint
اسم | وصف | قيمة |
---|---|---|
سلسلة الاتصال | سلسلة الاتصال لحساب Azure Storage الذي يتم تحميل الملفات إليه. | سلسلة (مطلوب) |
اسم الحاوية | اسم حاوية الجذر حيث تقوم بتحميل الملفات. الحاوية غير موجودة ولكن يجب أن تكون قابلة لل creatable باستخدام connectionString المحدد. | سلسلة (مطلوب) |
sasTtlAsIso8601 | الفترة الزمنية التي يكون فيها SAS URI الذي تم إنشاؤه بواسطة IoT Hub لتحميل الملف صالحا. راجع: /azure/iot-hub/iot-hub-devguide-file-upload#file-upload-notification-configuration-options. | خيط |