إنشاء نقاط نهاية في Azure Digital Twins

توضح هذه المقالة كيفية إنشاء نقطة نهاية لأحداث Azure Digital Twin باستخدام مدخل Azure أو Azure CLI. يمكنك أيضا إدارة نقاط النهاية باستخدام واجهات برمجة التطبيقات لمستوى التحكم DigitalTwinsEndpoint.

توجيه إعلامات الأحداث من Azure Digital Twins إلى خدمات انتقال البيانات من الخادم أو موارد الحوسبة المتصلة هي عملية من خطوتين: إنشاء نقاط النهاية، ثم إنشاء مسارات الأحداث لإرسال البيانات إلى نقاط النهاية هذه. تتناول هذه المقالة الخطوة الأولى، إعداد نقاط النهاية التي يمكن أن تتلقى الأحداث. لاحقا، يمكنك إنشاء مسارات الأحداث التي تحدد الأحداث التي تم إنشاؤها بواسطة Azure Digital Twins التي يتم تسليمها إلى نقاط النهاية.

المتطلبات الأساسية

• ستحتاج إلى حساب Azure، والذي يمكن إعداده مجانا

• ستحتاج إلى مثيل Azure Digital Twins في اشتراك Azure. إذا لم يكن لديك مثيل بالفعل، يمكنك إنشاء مثيل باستخدام الخطوات الواردة في إعداد مثيل ومصادقة. استخدم القيم التالية من الإعداد بسهولة لاستخدامها لاحقا في هذه المقالة:

  • اسم مثيل
  • مجموعة الموارد

  يمكنك العثور على هذه التفاصيل في مدخل Microsoft Azure بعد إعداد المثيل الخاص بك.

  

بعد ذلك، اتبع الإرشادات أدناه إذا كنت تنوي استخدام Azure CLI أثناء اتباع هذا الدليل.

إعداد البيئة الخاصة بك لـ Azure CLI

• استخدم بيئة Bash في Azure Cloud Shell. لمزيد من المعلومات، راجع التشغيل السريع ل Bash في Azure Cloud Shell.

  

• إذا كنت تفضل تشغيل أوامر مرجع CLI محلياً قم بتثبيت CLI Azure. إذا كنت تعمل على نظام تشغيل Windows أو macOS، ففكر في تشغيل Azure CLI في حاوية Docker. لمزيد من المعلومات، راجع كيفية تشغيل Azure CLI في حاوية Docker.

  • إذا كنت تستخدم تثبيت محلي، يُرجى تسجيل الدخول إلى Azure CLI مستخدمًا أمر az login. لإنهاء عملية المصادقة، اتبع الخطوات المعروضة في جهازك. للحصول على خيارات أخرى لتسجيل دخول، راجع تسجيل الدخول باستخدام Azure CLI.

  • عندما يُطلب منك، قم بتثبيت ملحق Azure CLI عند الاستخدام لأول مرة. لمزيد من المعلومات بشأن الامتدادات، راجع استخدام امتدادات مع Azure CLI.

  • يُرجى تشغيل إصدار az للوصول إلى الإصدار والمكتبات التابعة التي تم تثبيتها. للتحديث لآخر إصدار، يُرجى تشغيل تحديث az.

إنشاء الموارد المطلوبة

هذه الخدمات هي أنواع نقاط النهاية المدعومة التي يمكنك إنشاؤها للمثيل الخاص بك:

• موضوع Event Grid
  • بالنسبة لنقاط نهاية Event Grid، يتم دعم مواضيع شبكة الأحداث فقط. مجالات شبكة الأحداث غير مدعومة كنقاط نهاية.
• مركز مراكز الأحداث
• موضوع ناقل خدمة Microsoft Azure

لربط نقطة نهاية ب Azure Digital Twins، يجب أن يكون موضوع شبكة الأحداث أو مركز الأحداث أو موضوع ناقل الخدمة الذي تستخدمه لنقطة النهاية موجودا بالفعل.

استخدم المخطط التالي لمعرفة الموارد التي يجب إعدادها قبل إنشاء نقطة النهاية الخاصة بك.

نوع نقطة النهاية	الموارد المطلوبة (مرتبطة بإرشادات الإنشاء)
نقطة نهاية شبكة الحدث	موضوع Event Grid *يجب أن يكون مخطط الحدث مخطط شبكة الأحداث أو مخطط أحداث السحابة v1.0
نقطة نهاية مراكز الأحداث	مساحة اسم مراكز الأحداث مركز الحدث (اختياري) قاعدة التخويل للمصادقة المستندة إلى المفتاح
نقطة نهاية ناقل الخدمة	مساحة اسم ناقل الخدمة موضوع ناقل خدمة Microsoft Azure (اختياري) قاعدة التخويل للمصادقة المستندة إلى المفتاح

أنشئ نقطة النهاية

بمجرد إنشاء موارد نقطة النهاية، يمكنك استخدامها لنقطة نهاية Azure Digital Twins.

المدخل

لإنشاء نقطة نهاية جديدة، انتقل إلى صفحة المثيل في مدخل Microsoft Azure (يمكنك العثور على المثيل عن طريق إدخال اسمه في شريط بحث المدخل).

1. من قائمة المثيل، حدد Endpoints. ثم من صفحة نقاط النهاية التالية، حدد + إنشاء نقطة نهاية. سيؤدي القيام بذلك إلى فتح صفحة إنشاء نقطة نهاية، حيث ستقوم بتعبئة الحقول في الخطوات التالية.

   

2. أدخل اسمالنقطة النهاية واختر نوع نقطة النهاية.

3. أكمل التفاصيل الأخرى المطلوبة لنوع نقطة النهاية، بما في ذلك اشتراكك وموارد نقطة النهاية الموضحة سابقا.

   1. بالنسبة لمراكز الأحداث ونقاط نهاية ناقل خدمة Microsoft Azure فقط، يجب تحديد نوع المصادقة. يمكنك استخدام المصادقة المستندة إلى المفتاح مع قاعدة تخويل تم إنشاؤها مسبقا، أو هوية مدارة معينة من قبل النظام أو معينة من قبل المستخدم. لمزيد من المعلومات حول استخدام خيارات مصادقة الهوية، راجع خيارات نقطة النهاية: المصادقة المستندة إلى الهوية.

   

4. قم بإنهاء إنشاء نقطة النهاية الخاصة بك عن طريق تحديد حفظ.

بعد إنشاء نقطة النهاية الخاصة بك، يمكنك التحقق من أن نقطة النهاية قد تم إنشاؤها بنجاح عن طريق التحقق من أيقونة الإعلام في شريط مدخل Azure العلوي:

إذا فشل إنشاء نقطة النهاية، فلاحظ رسالة الخطأ وأعد المحاولة بعد بضع دقائق.

يمكنك أيضا عرض نقطة النهاية التي تم إنشاؤها مرة أخرى في صفحة نقاط النهاية لمثيل Azure Digital Twins.

الآن يتوفر موضوع Event Grid أو مركز الأحداث أو Service Bus كنقطة نهاية في Azure Digital Twins، تحت الاسم الذي اخترته لنقطة النهاية. ستستخدم عادة هذا الاسم كهدف لمسار حدث، والذي يمكنك إنشاؤه في إنشاء التوجيهات وعوامل التصفية.

المبادره القطريه

توضح الأمثلة التالية كيفية إنشاء نقاط النهاية باستخدام الأمر az dt endpoint create ل Azure Digital Twins CLI. استبدل العناصر النائبة في الأوامر بتفاصيل الموارد الخاصة بك.

لإنشاء نقطة نهاية Event Grid:

az dt endpoint create eventgrid --endpoint-name <Event-Grid-endpoint-name> --eventgrid-resource-group <Event-Grid-resource-group-name> --eventgrid-topic <your-Event-Grid-topic-name> --dt-name <your-Azure-Digital-Twins-instance-name>

لإنشاء نقطة نهاية مراكز الأحداث (المصادقة المستندة إلى المفتاح):

az dt endpoint create eventhub --endpoint-name <Event-Hub-endpoint-name> --eventhub-resource-group <Event-Hub-resource-group> --eventhub-namespace <Event-Hub-namespace> --eventhub <Event-Hub-name> --eventhub-policy <Event-Hub-policy> --dt-name <your-Azure-Digital-Twins-instance-name>

لإنشاء نقطة نهاية موضوع ناقل خدمة Microsoft Azure (المصادقة المستندة إلى المفتاح):

az dt endpoint create servicebus --endpoint-name <Service-Bus-endpoint-name> --servicebus-resource-group <Service-Bus-resource-group-name> --servicebus-namespace <Service-Bus-namespace> --servicebus-topic <Service-Bus-topic-name> --servicebus-policy <Service-Bus-topic-policy> --dt-name <your-Azure-Digital-Twins-instance-name>

بعد تشغيل هذه الأوامر بنجاح، سيكون موضوع Event Grid أو مركز الأحداث أو موضوع ناقل الخدمة متاحا كنقطة نهاية في Azure Digital Twins، تحت الاسم الذي قمت بتوفيره مع الوسيطة --endpoint-name . ستستخدم عادة هذا الاسم كهدف لمسار حدث، والذي يمكنك إنشاؤه في إنشاء التوجيهات وعوامل التصفية.

خيارات نقطة النهاية: المصادقة المستندة إلى الهوية

يصف هذا القسم كيفية استخدام هوية مدارة لمثيل Azure Digital Twins عند إعادة توجيه الأحداث إلى وجهات التوجيه المدعومة. إعداد هوية مدارة غير مطلوب للتوجيه، ولكن يمكن أن يساعد المثيل على الوصول بسهولة إلى موارد Microsoft Entra الأخرى المحمية، مثل مراكز الأحداث ووجهات ناقل الخدمة وحاوية تخزين Azure. يمكن تعيين الهويات المدارة من قبل النظام أو تعيينها من قبل المستخدم.

يستعرض باقي هذا القسم ثلاث خطوات لإعداد نقطة نهاية بهوية مدارة.

1. تمكين الهوية المدارة للمثيل

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

المدخل

أولا، تأكد من تمكين هوية مدارة لمثيل Azure Digital Twins.

تأكد أيضا من أن لديك دور مالك بيانات Azure Digital Twins على المثيل. يمكنك العثور على إرشادات في إعداد أذونات وصول المستخدم.

المبادره القطريه

أولا، تأكد من تمكين هوية مدارة لمثيل Azure Digital Twins.

تأكد أيضا من أن لديك دور مالك بيانات Azure Digital Twins على المثيل. يمكنك العثور على إرشادات في إعداد أذونات وصول المستخدم.

2. تعيين أدوار Azure إلى الهوية

بمجرد إنشاء هوية مدارة لمثيل Azure Digital Twins، ستحتاج إلى تعيين الأدوار المناسبة للمصادقة مع أنواع مختلفة من نقاط النهاية لتوجيه الأحداث إلى الوجهات المدعومة. يصف هذا القسم خيارات الدور وكيفية تعيينها إلى الهوية المدارة.

هام

تأكد من إكمال هذه الخطوة. بدونها، لن تتمكن الهوية من الوصول إلى نقاط النهاية الخاصة بك ولن يتم تسليم الأحداث.

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

الوجهة	دور Azure
مراكز أحداث Azure	مرسل بيانات مراكز أحداث Azure Event Hubs
ناقل خدمة Azure	مرسل بيانات ناقل خدمة Azure
حاوية تخزين Azure	المساهم في بيانات مخزن البيانات الثنائية الكبيرة

استخدم علامات التبويب أدناه لتعيين الدور باستخدام تجربتك المفضلة.

المدخل

لتعيين دور للهوية، ابدأ بفتح مدخل Azure في مستعرض.

1. انتقل إلى مورد نقطة النهاية (مركز الحدث أو موضوع ناقل الخدمة أو حاوية التخزين) عن طريق البحث عن اسمه في شريط بحث المدخل.

2. حدد Access control (IAM).

3. حدد Add>Add role assignment لفتح صفحة إضافة تعيين الدور.

4. قم بتعيين الدور المطلوب للهوية المدارة لمثيل Azure Digital Twins الخاص بك، باستخدام المعلومات أدناه. للحصول على خطوات تفصيلية، راجع تعيين أدوار Azure باستخدام مدخل Azure.

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

   

المبادره القطريه

يمكنك إضافة المعلمة --scopesaz dt create إلى الأمر لتعيين الهوية إلى نطاق واحد أو أكثر بدور محدد. يمكن استخدام الأمر مع هذه المعلمة عند إنشاء المثيل لأول مرة، أو لاحقا عن طريق تمرير اسم مثيل موجود بالفعل.

فيما يلي مثال ينشئ مثيلا بهوية مدارة معينة من قبل النظام، ويعين هذه الهوية دورا مخصصا يسمى MyCustomRole في مركز الأحداث.

az dt create --dt-name <new-instance-name> --resource-group <resource-group> --mi-system-assigned --scopes "/subscriptions/<subscription ID>/resourceGroups/<resource-group>/providers/Microsoft.EventHub/namespaces/<Event-Hubs-namespace>/eventhubs/<event-hub-name>" --role MyCustomRole

لمزيد من الأمثلة على تعيينات الأدوار باستخدام هذا الأمر، راجع الوثائق المرجعية az dt create.

يمكنك أيضا استخدام مجموعة أوامر تعيين الدور az لإنشاء الأدوار وإدارتها. يمكن استخدام هذا الأمر لدعم سيناريوهات أخرى حيث لا تريد تجميع تعيين الدور باستخدام الأمر إنشاء.

3. إنشاء نقطة النهاية باستخدام المصادقة المستندة إلى الهوية

بعد إعداد هوية مدارة لمثيل Azure Digital Twins وتعيين الدور (الأدوار) المناسبة له، يمكنك إنشاء نقاط النهاية التي تستخدم الهوية للمصادقة. يتوفر هذا الخيار فقط لمراكز الأحداث ونقاط النهاية من نوع ناقل الخدمة (غير مدعوم لشبكة الأحداث).

إشعار

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

استخدم علامات التبويب أدناه لإنشاء نقطة النهاية باستخدام تجربتك المفضلة.

المدخل

ابدأ باتباع الإرشادات العامة لإنشاء نقطة نهاية Azure Digital Twins.

عند الوصول إلى خطوة إكمال التفاصيل المطلوبة لنوع نقطة النهاية، حدد إما تعيين النظام أو تعيين المستخدم (معاينة) لنوع المصادقة.

قم بإنهاء إعداد نقطة النهاية الخاصة بك وحدد حفظ.

المبادره القطريه

تتم إضافة الهويات المدارة إلى نقطة نهاية عن طريق إضافة معلمات إلى az dt endpoint create الأمر المستخدم لإنشاء نقطة النهاية. (لمزيد من المعلومات حول هذا الأمر، راجع وثائقه المرجعية أو الإرشادات العامة لإنشاء نقطة نهاية Azure Digital Twins.).

استخدم الأمر CLI أدناه لنوع الهوية المدارة الذي اخترته.

أمر الهوية المعين من قبل النظام

لإنشاء نقطة نهاية تستخدم المصادقة المعينة IdentityBased من قبل النظام، حدد نوع المصادقة مع المعلمة --auth-type . يوضح المثال أدناه هذه الوظيفة لنقطة نهاية مراكز الأحداث.

az dt endpoint create eventhub --endpoint-name <endpoint-name> --eventhub-resource-group <eventhub-resource-group> --eventhub-namespace <eventhub-namespace> --eventhub <eventhub-name> --dt-name <instance-name> --auth-type IdentityBased

أمر الهوية المعينة من قبل المستخدم

لإنشاء نقطة نهاية تستخدم مصادقة الهوية المعينة من قبل المستخدم، حدد معرف مورد الهوية المعين من قبل المستخدم باستخدام المعلمة --user . يوضح المثال أدناه هذه الوظيفة لنقطة نهاية مراكز الأحداث.

az dt endpoint create eventhub --endpoint-name <endpoint-name> --eventhub-resource-group <eventhub-resource-group> --eventhub-namespace <eventhub-namespace> --eventhub <eventhub-name> --dt-name <instance-name> --user <user-assigned-identity-resource-ID>

اعتبارات تعطيل الهويات المدارة

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

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

خيارات نقطة النهاية: الكتابة غير المستخدمة

عندما لا تتمكن نقطة النهاية من تسليم حدث خلال فترة زمنية معينة أو بعد محاولة تسليم الحدث لعدد معين من المرات، يمكنها إرسال الحدث غير المحذوئ إلى حساب تخزين. وتعرف هذه العملية باسم dead-lettering.

يمكنك إعداد موارد التخزين الضرورية باستخدام مدخل Microsoft Azure أو Azure Digital Twins CLI. ومع ذلك، لإنشاء نقطة نهاية مع تمكين الحروف غير المستخدمة، ستحتاج إلى استخدام Azure Digital Twins CLI أو واجهات برمجة تطبيقات مستوى التحكم.

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

إعداد موارد التخزين

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

ستوفر URI لهذه الحاوية عند إنشاء نقطة النهاية لاحقا. سيتم توفير موقع الرسائل غير المستخدمة إلى نقطة النهاية كحاويات URI مع رمز SAS المميز. يحتاج write هذا الرمز المميز إلى إذن لحاوية الوجهة داخل حساب التخزين. سيكون عنوان URI SAS للحرف المهمم الذي تم تشكيله بالكامل بتنسيق: https://<storage-account-name>.blob.core.windows.net/<container-name>?<SAS-token>.

اتبع الخطوات أدناه لإعداد موارد التخزين هذه في حساب Azure الخاص بك، للتحضير لإعداد اتصال نقطة النهاية في القسم التالي.

1. اتبع الخطوات الواردة في إنشاء حساب تخزين لإنشاء حساب تخزين في اشتراك Azure. دون اسم حساب التخزين لاستخدامه لاحقا.
2. اتبع الخطوات الواردة في إنشاء حاوية لإنشاء حاوية داخل حساب التخزين الجديد. دون اسم الحاوية لاستخدامه لاحقا.

إنشاء رمز SAS مميز

بعد ذلك، قم بإنشاء رمز SAS المميز لحساب التخزين الخاص بك الذي يمكن لنقطة النهاية استخدامه للوصول إليه.

المدخل

1. ابدأ بالانتقال إلى حساب التخزين الخاص بك في مدخل Microsoft Azure (يمكنك العثور عليه بالاسم باستخدام شريط بحث المدخل).

2. في صفحة حساب التخزين، اختر ارتباط توقيع الوصول المشترك في شريط التنقل الأيمن لبدء إعداد رمز SAS المميز.

   

3. في صفحة توقيع الوصول المشترك، ضمن الخدماتالمسموح بها وأنواع الموارد المسموح بها، حدد أي إعدادات تريدها. ستحتاج إلى تحديد مربع واحد على الأقل في كل فئة. ضمن الأذونات المسموح بها، اختر كتابة (يمكنك أيضا تحديد أذونات أخرى إذا أردت).

4. قم بتعيين القيم التي تريدها للإعدادات المتبقية.

5. عند الانتهاء، حدد الزر Generate SAS and سلسلة الاتصال لإنشاء رمز SAS المميز.

   

6. سيؤدي القيام بذلك إلى إنشاء العديد من قيم SAS سلسلة الاتصال في أسفل نفس الصفحة، أسفل تحديدات الإعداد. قم بالتمرير لأسفل لعرض القيم، واستخدم أيقونة Copy to clipboard لنسخ قيمة رمز SAS المميز . احفظه لاستخدامه لاحقا.

   

المبادره القطريه

1. استرجع مفاتيح حساب التخزين باستخدام الأمر التالي وانسخ القيمة لأي من المفاتيح:

   az storage account keys list --account-name <storage-account-name>
   

2. حدد تاريخ انتهاء صلاحية وقم بإنشاء رمز SAS المميز لحساب التخزين الخاص بك باستخدام الأمر التالي:

   az storage account generate-sas --account-name <storage-account-name> --account-key <storage-account-key> --expiry <expiration-date> --services bfqt --resource-types o --permissions w
   

   إخراج هذا الأمر هو رمز SAS المميز. انسخ قيمة رمز SAS المميز لاستخدامها لاحقا.

   إشعار

   يتضمن هذا الأمر خدمات "b lob" و"file" و"queue" و"table"؛ ونوع مورد "object"؛ ويسمح بأذونات "write".

   لمزيد من المعلومات حول az storage account generate-sas الأمر ومعلماته، راجع مرجع Azure CLI.

إنشاء نقطة النهاية غير المستخدمة

المدخل

لإنشاء نقطة نهاية مع تمكين الأحرف غير المستخدمة، يجب استخدام أوامر CLI أو واجهات برمجة تطبيقات مستوى التحكم لإنشاء نقطة النهاية الخاصة بك، بدلا من مدخل Microsoft Azure.

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

المبادره القطريه

لإنشاء نقطة نهاية تم تمكين الأحرف غير المستخدمة فيها، أضف المعلمة --deadletter-sas-uriإلى الأمر az dt endpoint create الذي ينشئ نقطة نهاية.

قيمة المعلمة هي URI SAS غير المستخدمة المكونة من اسم حساب التخزين واسم الحاوية ورمز SAS المميز الذي جمعته في القسم السابق. تنشئ هذه المعلمة نقطة النهاية مع المصادقة المستندة إلى المفتاح. إليك ما تبدو عليه المعلمة:

--deadletter-sas-uri https://<storage-account-name>.blob.core.windows.net/<container-name>?<SAS-token>

تلميح

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

يمكنك أيضا إنشاء نقاط نهاية الرسائل المهملة باستخدام واجهات برمجة تطبيقات وحدة التحكم Azure Digital Twins بدلا من CLI. للقيام بذلك، اعرض وثائق DigitalTwinsEndpoint لمعرفة كيفية هيكلة الطلب وإضافة معلمات الأحرف غير المستخدمة.

مخطط تخزين الرسائل

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

<container>/<endpoint-name>/<year>/<month>/<day>/<hour>/<event-ID>.json

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

فيما يلي مثال على رسالة غير مستخدمة لإشعار إنشاء توأم:

{
  "specversion": "1.0",
  "id": "xxxxxxxx-xxxxx-xxxx-xxxx-xxxxxxxxxxxx",
  "type": "Microsoft.DigitalTwins.Twin.Create",
  "source": "<your-instance>.api.<your-region>.da.azuredigitaltwins-test.net",
  "data": {
    "$dtId": "<your-instance>xxxxxxxx-xxxxx-xxxx-xxxx-xxxxxxxxxxxx",
    "$etag": "W/\"xxxxxxxx-xxxxx-xxxx-xxxx-xxxxxxxxxxxx\"",
    "TwinData": "some sample",
    "$metadata": {
      "$model": "dtmi:test:deadlettermodel;1",
      "room": {
        "lastUpdateTime": "2020-10-14T01:11:49.3576659Z"
      }
    }
  },
  "subject": "<your-instance>xxxxxxxx-xxxxx-xxxx-xxxx-xxxxxxxxxxxx",
  "time": "2020-10-14T01:11:49.3667224Z",
  "datacontenttype": "application/json",
  "traceparent": "00-889a9094ba22b9419dd9d8b3bfe1a301-f6564945cb20e94a-01"
}

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

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