مشاركة عبر

أحداث Microsoft Entra

  • مقالة

توفر هذه المقالة خصائص ومخطط أحداث Microsoft Entra التي تنشرها واجهة برمجة تطبيقات Microsoft Graph. للحصول على مقدمة حول مخططات الأحداث، راجع مخطط CloudEvents.

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

يتم تشغيل هذه الأحداث عند إنشاء مستخدم أو مجموعة أو تحديثها أو حذفها في معرف Microsoft Entra أو عن طريق العمل على تلك الموارد باستخدام Microsoft Graph API.

إشعار

حاليا، UserUpdated يتم إنشاء أو GroupUpdated حدث عند إنشاء مستخدم أو مجموعة. إنها مشكلة معروفة وسيتم إصلاحها في الإصدار المستقبلي.

اسم الحدث ‏‏الوصف
Microsoft.Graph.UserUpdated يتم تشغيله عند إنشاء مستخدم في معرف Microsoft Entra أو تحديثه.
Microsoft.Graph.UserDeleted يتم تشغيله عند حذف مستخدم في معرف Microsoft Entra نهائيا.
Microsoft.Graph.GroupUpdated يتم تشغيله عند إنشاء مجموعة في معرف Microsoft Entra أو تحديثها.
Microsoft.Graph.GroupDeleted يتم تشغيله عند حذف مجموعة في معرف Microsoft Entra نهائيا.

إشعار

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

مثال حدث

عند تشغيل حدث ما، ترسل خدمة Event Grid بيانات عن هذا الحدث إلى وجهات الاشتراك. يحتوي هذا القسم على مثال لما ستبدو عليه هذه البيانات لكل حدث من أحداث Microsoft Entra.

حدث Microsoft.Graph.UserUpdated

{
  "id": "00d8a100-2e92-4bfa-86e1-0056dacd0fce",
  "type": "Microsoft.Graph.UserUpdated",
  "source": "/tenants/<tenant-id>/applications/<application-id>",
  "subject": "Users/<user-id>",
  "time": "2022-05-24T22:24:31.3062901Z",
  "datacontenttype": "application/json",
  "specversion": "1.0",
  "data": {
    "changeType": "updated",
    "clientState": "<guid>",
    "resource": "Users/<user-id>",
    "resourceData": {
      "@odata.type": "#Microsoft.Graph.User",
      "@odata.id": "Users/<user-id>",
      "id": "<user-id>",
      "organizationId": "<tenant-id>",
      "eventTime": "2022-05-24T22:24:31.3062901Z",
      "sequenceNumber": <sequence-number>
    },
    "subscriptionExpirationDateTime": "2022-05-24T23:21:19.3554403+00:00",
    "subscriptionId": "<microsoft-graph-subscription-id>",
    "tenantId": "<tenant-id>
  }
}

حدث Microsoft.Graph.UserDeleted

{
  "id": "00d8a100-2e92-4bfa-86e1-0056dacd0fce",
  "type": "Microsoft.Graph.UserDeleted",
  "source": "/tenants/<tenant-id>/applications/<application-id>",
  "subject": "Users/<user-id>",
  "time": "2022-05-24T22:24:31.3062901Z",
  "datacontenttype": "application/json",
  "specversion": "1.0",
  "data": {
    "changeType": "deleted",
    "clientState": "<guid>",
    "resource": "Users/<user-id>",
    "resourceData": {
      "@odata.type": "#Microsoft.Graph.User",
      "@odata.id": "Users/<user-id>",
      "id": "<user-id>",
      "organizationId": "<tenant-id>",
      "eventTime": "2022-05-24T22:24:31.3062901Z",
      "sequenceNumber": <sequence-number>
    },
    "subscriptionExpirationDateTime": "2022-05-24T23:21:19.3554403+00:00",
    "subscriptionId": "<microsoft-graph-subscription-id>",
    "tenantId": "<tenant-id>
  }
}

حدث Microsoft.Graph.GroupUpdated

{
  "id": "00d8a100-2e92-4bfa-86e1-0056dacd0fce",
  "type": "Microsoft.Graph.GroupUpdated",
  "source": "/tenants/<tenant-id>/applications/<application-id>",
  "subject": "Groups/<group-id>",
  "time": "2022-05-24T22:24:31.3062901Z",
  "datacontenttype": "application/json",
  "specversion": "1.0",
  "data": {
    "changeType": "updated",
    "clientState": "<guid>",
    "resource": "Groups/<group-id>",
    "resourceData": {
      "@odata.type": "#Microsoft.Graph.Group",
      "@odata.id": "Groups/<group-id>",
      "id": "<group-id>",
      "organizationId": "<tenant-id>",
      "eventTime": "2022-05-24T22:24:31.3062901Z",
      "sequenceNumber": <sequence-number>
    },
    "subscriptionExpirationDateTime": "2022-05-24T23:21:19.3554403+00:00",
    "subscriptionId": "<microsoft-graph-subscription-id>",
    "tenantId": "<tenant-id>
  }
}

حدث Microsoft.Graph.GroupDeleted

{
  "id": "00d8a100-2e92-4bfa-86e1-0056dacd0fce",
  "type": "Microsoft.Graph.GroupDeleted",
  "source": "/tenants/<tenant-id>/applications/<application-id>",
  "subject": "Groups/<group-id>",
  "time": "2022-05-24T22:24:31.3062901Z",
  "datacontenttype": "application/json",
  "specversion": "1.0",
  "data": {
    "changeType": "deleted",
    "clientState": "<guid>",
    "resource": "Groups/<group-id>",
    "resourceData": {
      "@odata.type": "#Microsoft.Graph.Group",
      "@odata.id": "Groups/<group-id>",
      "id": "<group-id>",
      "organizationId": "<tenant-id>",
      "eventTime": "2022-05-24T22:24:31.3062901Z",
      "sequenceNumber": <sequence-number>
    },
    "subscriptionExpirationDateTime": "2022-05-24T23:21:19.3554403+00:00",
    "subscriptionId": "<microsoft-graph-subscription-id>",
    "tenantId": "<tenant-id>
  }
}

خصائص الحدث

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

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

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

الخاصية نوع الوصف
changeType سلسلة نوع حالة الموارد تتغير.
resource سلسلة محدد الموارد الذي أثير من أجله الحدث.
tenantId سلسلة معرّف المؤسسة حيث الاحتفاظ بالمستخدم أو المجموعة.
clientState سلسلة بيانات سرية قدمها المستخدم في وقت إنشاء اشتراك Microsoft Azure Active Directory Graph API.
@odata.type سلسلة نوع تغيير واجهة برمجة التطبيقات Microsoft Azure Active Directory Graph.
@odata.id سلسلة محدد موارد Microsoft Azure Active Directory Graph API الذي أثير الحدث من أجله.
id سلسلة محدد الموارد الذي أثير من أجله الحدث.
organizationId سلسلة معرف مستأجر Microsoft Entra.
eventTime سلسلة الوقت الذي تغيرت فيه حالة المورد.
sequenceNumber سلسلة رقم التسلسل.
subscriptionExpirationDateTime سلسلة الوقت في تنسيق طلب التعليقات (RFC) 3339 الذي تنتهي فيه صلاحية اشتراك واجهة برمجة تطبيقات Graph.
subscriptionId سلسلة معرف اشتراكMicrosoft Azure Active Directory Graph API.
tenantId سلسلة معرف مستأجر Microsoft Entra.

المحتوى ذو الصلة