مشاركة عبر

تكوين تطبيقات Azure كمصدر شبكة الأحداث

  • مقالة

توفر هذه المقالة خصائص ومخطط أحداث تكوين تطبيقات Azure. للحصول على مقدمة لمخططات الأحداث، راجع مخطط حدث Azure Event Grid. كما أنه يوفر لك قائمة من البدايات السريعة والبرامج التعليمية لاستخدام تكوين Azure App كمصدر للحدث.

أنواع الأحداث المتاحة

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

نوع الحدث ‏‏الوصف
Microsoft.AppConfiguration.KeyValueModified العرض عند إنشاء قيمة مفتاح أو استبدالها.
Microsoft.AppConfiguration.KeyValueDeleted العرض عند حذف قيمة مفتاح.
Microsoft.AppConfiguration.SnapshotCreated يرفع عند إنشاء لقطة.
Microsoft.AppConfiguration.SnapshotModified يرفع عند تعديل لقطة.

Event schema

ويحتوي الحدث على بيانات المستوى الأعلى التالية:

الخاصية نوع الوصف
source سلسلة مسار المورد الكامل إلى مصدر الحدث. هذا الحقل غير قابل للكتابة. توفر شبكة الأحداث هذه القيمة.
subject سلسلة مسار يحدده الناشر لموضوع الحدث.
type سلسلة أحد أنواع الأحداث المسجلة لمصدر الحدث الماثل.
time سلسلة الوقت الذي يتم إنشاء الحدث استناداً إلى وقت UTC الموفر.
id سلسلة المعرف الفريد للحدث.
data كائن بيانات حدث تكوين التطبيق.
specversion سلسلة إصدار مواصفات مخطط CloudEvents.

كائن البيانات له الخصائص التالية:

حدث قيمة المفتاح

الخاصية نوع الوصف
key سلسلة مفتاح قيمة المفتاح الذي تم تعديله أو حذفه.
label سلسلة التسمية، إن وجدت، لقيمة المفتاح التي تم تعديلها أو حذفها.
etag سلسلة للحصول KeyValueModified على etag قيمة المفتاح الجديد. للحصول KeyValueDeleted على etag قيمة المفتاح التي تم حذفها.
syncToken سلسلة رمز المزامنة الذي يمثل حالة الخادم بعد حدث قيمة المفتاح.

حدث اللقطة

الخاصية نوع الوصف
name سلسلة اسم اللقطة التي تم إنشاؤها أو تعديلها.
etag سلسلة للحصول SnapshotCreated على etag للقطة الجديدة. للحصول SnapshotModified على etag للقطة التي تم تعديلها.
syncToken سلسلة رمز المزامنة الذي يمثل حالة الخادم بعد حدث اللقطة.

مثال حدث

يوضح المثال التالي مخطط حدث تعديل قيمة المفتاح:

[{
  "id": "84e17ea4-66db-4b54-8050-df8f7763f87b",
  "source": "/subscriptions/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/resourceGroups/testrg/providers/microsoft.appconfiguration/configurationstores/contoso",
  "subject": "https://contoso.azconfig.io/kv/Foo?label=FizzBuzz",
  "data": {
    "key": "Foo",
    "label": "FizzBuzz",
    "etag": "FnUExLaj2moIi4tJX9AXn9sakm0"
  },
  "type": "Microsoft.AppConfiguration.KeyValueModified",
  "time": "2019-05-31T20:05:03Z",
  "specversion": "1.0"
}]

يوضح المثال التالي مخطط حدث حذف قيمة المفتاح:

[{
  "id": "84e17ea4-66db-4b54-8050-df8f7763f87b",
  "source": "/subscriptions/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/resourceGroups/testrg/providers/microsoft.appconfiguration/configurationstores/contoso",
  "subject": "https://contoso.azconfig.io/kv/Foo?label=FizzBuzz",
  "data": {
    "key": "Foo",
    "label": "FizzBuzz",
    "etag": "FnUExLaj2moIi4tJX9AXn9sakm0"
  },
  "type": "Microsoft.AppConfiguration.KeyValueDeleted",
  "time": "2019-05-31T20:05:03Z",
  "specversion": "1.0"
}]

يوضح المثال التالي مخطط حدث تم إنشاؤه للقطة:

[{
  "source": "/subscriptions/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/resourceGroups/testrg/providers/microsoft.appconfiguration/configurationstores/contoso",
  "subject": "https://contoso.azconfig.io/kvsnapshots/Foo",
  "type": "Microsoft.AppConfiguration.SnapshotCreated",
  "time": "2023-09-02T20:05:03.0000000Z",
  "id": "84e17ea4-66db-4b54-8050-df8f7763f87b",
  "data": {
    "name": "Foo",
    "etag": "FnUExLaj2moIi4tJX9AXn9sakm0",
    "syncToken": "zAJw6V16=Njo1IzUxNjQ2NzM=;sn=5164673"
  },
  "specversion": "1.0"
}]

يوضح المثال التالي مخطط حدث معدل للقطة:

[{
  "source": "/subscriptions/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/resourceGroups/testrg/providers/microsoft.appconfiguration/configurationstores/contoso",
  "subject": "https://contoso.azconfig.io/snapshots/Foo",
  "type": "Microsoft.AppConfiguration.SnapshotModified",
  "time": "2023-09-03T20:05:03.0000000Z",
  "id": "84e17ea4-66db-4b54-8050-df8f7763f87b",
  "data": {
    "name": "Foo",
    "etag": "FnUExLaj2moIi4tJX9AXn9sakm0",
    "syncToken": "zAJw6V16=Njo1IzUxNjQ2NzM=;sn=5164673"
  },
  "specversion": "1.0"
}]

البرامج التعليمية والدروس المعرفية

المسمى الوظيفي ‏‏الوصف
الاستجابة إلى أحداث تكوين التطبيقات Azure باستخدام شبكة الأحداث نظرة عامة حول دمج تكوين تطبيق Azure مع شبكة الأحداث.
استخدام Event Grid لإشعارات تغيير البيانات تعرف على كيفية استخدام اشتراكات حدث تكوين تطبيقات Azure لإرسال أحداث تعديل قيمة المفتاح إلى نقطة نهاية ويب.

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