مشاركة عبر

Egress ونقاط النهاية في Azure Digital Twins

  • مقالة

هام

تم إصدار إصدار جديد من خدمة Azure Digital Twins. في ضوء القدرات الموسعة للخدمة الجديدة، تم إيقاف خدمة Azure Digital Twins الأصلية (الموضحة في مجموعة الوثائق هذه).

لعرض وثائق الخدمة الجديدة، قم بزيارة وثائق Azure Digital Twins النشطة.

تمثل نقاط نهاية Azure Digital Twins وسيط رسالة أو حدث ضمن اشتراك Azure الخاص بالمستخدم. يمكن إرسال الأحداث والرسائل إلى مراكز أحداث Azure وشبكة أحداث Azure ومواضيع ناقل خدمة Azure.

يتم توجيه الأحداث إلى نقاط النهاية وفقا لتفضيلات التوجيه المحددة مسبقا. يحدد المستخدمون أنواع الأحداث التي قد تتلقاها كل نقطة نهاية.

لمعرفة المزيد حول الأحداث والتوجيه وأنواع الأحداث، راجع توجيه الأحداث والرسائل في Azure Digital Twins.

الأحداث

يتم إرسال الأحداث بواسطة كائنات إنترنت الأشياء (مثل الأجهزة وأجهزة الاستشعار) لمعالجتها بواسطة وسطاء الرسائل والأحداث في Azure. يتم تعريف الأحداث بواسطة مرجع مخطط أحداث Azure Event Grid التالي.

{
  "id": "00000000-0000-0000-0000-000000000000",
  "subject": "ExtendedPropertyKey",
  "data": {
    "SpacesToNotify": [
      "3a16d146-ca39-49ee-b803-17a18a12ba36"
    ],
    "Id": "00000000-0000-0000-0000-000000000000",
      "Type": "ExtendedPropertyKey",
    "AccessType": "Create"
  },
  "eventType": "TopologyOperation",
  "eventTime": "2018-04-17T17:41:54.9400177Z",
  "dataVersion": "1",
  "metadataVersion": "1",
  "topic": "/subscriptions/YOUR_TOPIC_NAME"
}
السمة النوع الوصف
المعرف سلسلة معرّف فريد للحدث.
الموضوع سلسلة مسار معرف من قبل الناشر إلى موضوع الحدث.
البيانات كائن بيانات الأحداث الخاصة بموفر المورد.
⁧⁩نوع الحدث⁧⁩ سلسلة أحد أنواع الأحداث المسجلة لمصدر الحدث.
⁧⁩توقيت الحدث⁧⁩ سلسلة وقت إنشاء الحدث بناءً على توقيت UTC الخاص بالموفر.
⁧⁧⁩⁩إصدار البيانات⁧⁧⁩⁩ سلسلة إصدار مخطط عنصر البيانات. يعرّف الناشر إصدار المخطط.
⁧⁧⁩⁩إصدار بيانات التعريف⁧⁧⁩⁩ سلسلة إصدار المخطط لبيانات تعريف الحدث. تحدد «شبكة الأحداث» مخطط خصائص المستوى الأعلى. توفر «شبكة الأحداث» هذه القيمة.
الموضوع سلسلة مسار المورد الكامل إلى مصدر الحدث. هذا الحقل غير قابل للكتابة. توفر «شبكة الأحداث» هذه القيمة.

لمزيد من المعلومات حول مخطط أحداث شبكة الأحداث:

أنواع الحدث

تصنف أنواع الأحداث طبيعة الحدث ويتم تعيينها في الحقل eventType . يتم إعطاء أنواع الأحداث المتاحة من خلال القائمة التالية:

  • طوبولوجياالعملية
  • UdfCustom
  • تغيير المستشعرات
  • تغيير المساحة
  • الجهازالرسالة

يتم وصف تنسيقات الأحداث لكل نوع حدث بشكل أكبر في الأقسام الفرعية التالية.

طوبولوجياالعملية

طوبولوجياالعملية تنطبق على تغييرات الرسم البياني. تحدد خاصية الموضوع نوع الكائن المتأثر. قد تؤدي الأنواع التالية من الكائنات إلى تشغيل هذا الحدث:

  • الجهاز
  • DeviceBlobMetadata
  • الجهازالممتدةالملكية
  • ExtendedPropertyKey
  • ExtendedType
  • كي ستور
  • التقرير
  • تعريف الدور
  • المستشعر
  • SensorBlobMetadata
  • المستشعرالموسعة الخاصية
  • المساحة
  • SpaceBlobMetadata
  • الفضاءالموسعةالملكية
  • موارد الفضاء
  • SpaceRoleAssignment
  • النظام
  • المستخدم
  • UserBlobMetadata
  • UserExtendedProperty

مثال

{
  "id": "00000000-0000-0000-0000-000000000000",
  "subject": "ExtendedPropertyKey",
  "data": {
    "SpacesToNotify": [
      "3a16d146-ca39-49ee-b803-17a18a12ba36"
    ],
    "Id": "00000000-0000-0000-0000-000000000000",
      "Type": "ExtendedPropertyKey",
    "AccessType": "Create"
  },
  "eventType": "TopologyOperation",
  "eventTime": "2018-04-17T17:41:54.9400177Z",
  "dataVersion": "1",
  "metadataVersion": "1",
  "topic": "/subscriptions/YOUR_TOPIC_NAME"
}
القيمة استبدال بـ
YOUR_TOPIC_NAME اسم موضوعك المخصص

UdfCustom

UdfCustom هو حدث يتم إرساله بواسطة وظيفة معرفة من قبل المستخدم (UDF).

هام

يجب إرسال هذا الحدث صراحة من UDF نفسها.

مثال

{
  "id": "568fd394-380b-46fa-925a-ebb96f658cce",
  "subject": "UdfCustom",
  "data": {
    "TopologyObjectId": "7c799bfc-1bff-4b9e-b15a-669933969d20",
    "ResourceType": "Space",
    "Payload": "\"Room is not available or air quality is poor\"",
    "CorrelationId": "568fd394-380b-46fa-925a-ebb96f658cce"
  },
  "eventType": "UdfCustom",
  "eventTime": "2018-10-02T06:50:15.198Z",
  "dataVersion": "1.0",
  "metadataVersion": "1",
  "topic": "/subscriptions/YOUR_TOPIC_NAME"
}
القيمة استبدال بـ
YOUR_TOPIC_NAME اسم موضوعك المخصص

تغيير المستشعرات

SensorChange هو تحديث لحالة المستشعر استنادا إلى تغييرات القياس عن بعد.

مثال

{
  "id": "60bf5336-2929-45b4-bb4c-b45699dfe95f",
  "subject": "SensorChange",
  "data": {
    "Type": "Classic",
    "DataType": "Motion",
    "Id": "60bf5336-2929-45b4-bb4c-b45699dfe95f",
    "Value": "False",
    "PreviousValue": "True",
    "EventTimestamp": "2018-04-17T17:46:15.4964262Z",
    "MessageType": "sensor",
    "Properties": {
      "ms-client-request-id": "c9e576b7-5eea-4f61-8617-92a57add5179",
      "ms-activity-id": "ct22YwXEGJ5u.605.0"
    }
  },
  "eventType": "SensorChange",
  "eventTime": "2018-04-17T17:46:18.5452993Z",
  "dataVersion": "1",
  "metadataVersion": "1",
  "topic": "/subscriptions/YOUR_TOPIC_NAME"
}
القيمة استبدال بـ
YOUR_TOPIC_NAME اسم موضوعك المخصص

تغيير المساحة

SpaceChange هو تحديث لحالة الفضاء استنادا إلى تغييرات القياس عن بعد.

مثال

{
  "id": "42522e10-b1aa-42ff-a5e7-7181788ffc4b",
  "subject": "SpaceChange",
  "data": {
    "Type": null,
    "DataType": "AvailableAndFresh",
    "Id": "7c799bfc-1bff-4b9e-b15a-669933969d20",
    "Value": "Room is not available or air quality is poor",
    "PreviousValue": null,
    "RawData": null,
    "transactionId": null,
    "EventTimestamp": null,
    "MessageType": null,
    "Properties": null,
    "CorrelationId": "42522e10-b1aa-42ff-a5e7-7181788ffc4b"
  },
  "eventType": "SpaceChange",
  "eventTime": "2018-10-02T06:50:20.128Z",
  "dataVersion": "1.0",
  "metadataVersion": "1",
  "topic": "/subscriptions/YOUR_TOPIC_NAME"
}
القيمة استبدال بـ
YOUR_TOPIC_NAME اسم موضوعك المخصص

الجهازالرسالة

باستخدام DeviceMessage، يمكنك تحديد اتصال EventHub الذي يمكن توجيه أحداث القياس عن بعد الخام إليه أيضا من Azure Digital Twins.

ملاحظة

  • يمكن دمج DeviceMessage فقط مع EventHub. لا يمكنك دمج DeviceMessage مع أي من أنواع الأحداث الأخرى.
  • يمكنك تحديد نقطة نهاية واحدة فقط من مجموعة النوع EventHub أو DeviceMessage.

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

تتم ممارسة إدارة نقاط النهاية من خلال واجهة برمجة تطبيقات نقاط النهاية.

في الأمثلة أدناه ، YOUR_MANAGEMENT_API_URL يشير إلى عنوان URI لواجهات برمجة تطبيقات Digital Twins:

https://YOUR_INSTANCE_NAME.YOUR_LOCATION.azuresmartspaces.net/management/api/v1.0
الاسم استبدال بـ
YOUR_INSTANCE_NAME اسم مثيل Azure Digital Twins الخاص بك
YOUR_LOCATION المنطقة التي تتم استضافة المثيل عليها

توضح الأمثلة التالية كيفية تكوين نقاط النهاية المدعومة.

هام

انتبه بعناية إلى السمة eventTypes . يحدد أنواع الأحداث التي يتم التعامل معها بواسطة نقطة النهاية وبالتالي تحديد مسارها.

طلب HTTP POST مصادق عليه ضد:

YOUR_MANAGEMENT_API_URL/endpoints

  • الطريق إلى الخدمة أنواع أحداث الناقل SensorChange و SpaceChange و TopologyOperation:

    {
  "type": "ServiceBus",
  "eventTypes": [
    "SensorChange",
    "SpaceChange",
    "TopologyOperation"
  ],
  "connectionString": "Endpoint=sb://YOUR_NAMESPACE.servicebus.windows.net/;SharedAccessKeyName=RootManageSharedAccessKey;SharedAccessKey=YOUR_PRIMARY_KEY",
  "secondaryConnectionString": "Endpoint=sb://YOUR_NAMESPACE.servicebus.windows.net/;SharedAccessKeyName=RootManageSharedAccessKey;SharedAccessKey=YOUR_SECONDARY_KEY",
  "path": "YOUR_TOPIC_NAME"
}
    القيمة استبدال بـ
    YOUR_NAMESPACE مساحة اسم نقطة النهاية
    YOUR_PRIMARY_KEY سلسلة الاتصال الأساسية المستخدمة للمصادقة
    YOUR_SECONDARY_KEY سلسلة الاتصال الثانوية المستخدمة للمصادقة
    YOUR_TOPIC_NAME اسم موضوعك المخصص

  • الطريق إلى أنواع أحداث شبكة الأحداث SensorChange و SpaceChange و TopologyOperation:

    {
  "type": "EventGrid",
  "eventTypes": [
    "SensorChange",
    "SpaceChange",
    "TopologyOperation"
  ],
  "connectionString": "YOUR_PRIMARY_KEY",
  "secondaryConnectionString": "YOUR_SECONDARY_KEY",
  "path": "YOUR_TOPIC_NAME.westus-1.eventgrid.azure.net"
}
    القيمة استبدال بـ
    YOUR_PRIMARY_KEY سلسلة الاتصال الأساسية المستخدمة للمصادقة
    YOUR_SECONDARY_KEY سلسلة الاتصال الثانوية المستخدمة للمصادقة
    YOUR_TOPIC_NAME اسم موضوعك المخصص

  • التوجيه إلى مراكز الأحداث أنواع الأحداث SensorChange و SpaceChange و TopologyOperation:

    {
  "type": "EventHub",
  "eventTypes": [
    "SensorChange",
    "SpaceChange",
    "TopologyOperation"
  ],
  "connectionString": "Endpoint=sb://YOUR_NAMESPACE.servicebus.windows.net/;SharedAccessKeyName=RootManageSharedAccessKey;SharedAccessKey=YOUR_PRIMARY_KEY",
  "secondaryConnectionString": "Endpoint=sb://YOUR_NAMESPACE.servicebus.windows.net/;SharedAccessKeyName=RootManageSharedAccessKey;SharedAccessKey=YOUR_SECONDARY_KEY",
  "path": "YOUR_EVENT_HUB_NAME"
}
    القيمة استبدال بـ
    YOUR_NAMESPACE مساحة اسم نقطة النهاية
    YOUR_PRIMARY_KEY سلسلة الاتصال الأساسية المستخدمة للمصادقة
    YOUR_SECONDARY_KEY سلسلة الاتصال الثانوية المستخدمة للمصادقة
    YOUR_EVENT_HUB_NAME اسم مركز الأحداث

  • التوجيه إلى مراكز الأحداث نوع الحدث DeviceMessage. إدراج EntityPath في connectionString إلزامي:

    {
  "type": "EventHub",
  "eventTypes": [
    "DeviceMessage"
  ],
  "connectionString": "Endpoint=sb://YOUR_NAMESPACE.servicebus.windows.net/;SharedAccessKeyName=RootManageSharedAccessKey;SharedAccessKey=YOUR_PRIMARY_KEY;EntityPath=YOUR_EVENT_HUB_NAME",
  "secondaryConnectionString": "Endpoint=sb://YOUR_NAMESPACE.servicebus.windows.net/;SharedAccessKeyName=RootManageSharedAccessKey;SharedAccessKey=YOUR_SECONDARY_KEY;EntityPath=YOUR_EVENT_HUB_NAME",
  "path": "YOUR_EVENT_HUB_NAME"
}
    القيمة استبدال بـ
    YOUR_NAMESPACE مساحة اسم نقطة النهاية
    YOUR_PRIMARY_KEY سلسلة الاتصال الأساسية المستخدمة للمصادقة
    YOUR_SECONDARY_KEY سلسلة الاتصال الثانوية المستخدمة للمصادقة
    YOUR_EVENT_HUB_NAME اسم مركز الأحداث

ملاحظة

عند إنشاء نقطة نهاية جديدة، قد يستغرق الأمر ما يصل إلى 5 إلى 10 دقائق لبدء تلقي الأحداث عند نقطة النهاية.

مفاتيح الاتصال الأساسية والثانوية

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

إذا كان كل من مفتاحي الاتصال الأساسي والثانوي غير مصرح بهما، يدخل النظام وقت انتظار احتياطي أسي يصل إلى 30 دقيقة. يتم إسقاط الأحداث على كل وقت انتظار يتم تشغيله.

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

نقاط النهاية التي يتعذر الوصول إليها

عندما تصبح نقطة النهاية غير قابلة للوصول ، يدخل النظام وقت انتظار أسي احتياطي يصل إلى 30 دقيقة. يتم إسقاط الأحداث على كل وقت انتظار يتم تشغيله.

الخطوات التالية