مشاركة عبر

أحداث Microsoft OneDrive

  • مقالة

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

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

يتم تشغيل هذه الأحداث عند تحديث driveItem عن طريق التشغيل عبر تلك الموارد باستخدام Microsoft Graph API.

اسم الحدث ‏‏الوصف
Microsoft.Graph.DriveItemUpdated يتم تشغيل هذا الحدث عند تحديث المحتوى في التسلسل الهرمي لمجلد جذر driveItem في OneDrive for Business، أو مجلد جذر أو مجلد فرعي driveItem في OneDrive الشخصي للمستخدم.

مثال حدث

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

حدث Microsoft.Graph.DriveItemUpdated

{
  "id": "00d8a100-2e92-4bfa-86e1-0056dacd0fce",
  "type": "Microsoft.Graph.DriveItemUpdated",
  "source": "/tenants/<tenant-id>/applications/<application-id>",
  "subject": "driveItem/<driveItem-id>",
  "time": "2022-05-24T22:24:31.3062901Z",
  "datacontenttype": "application/json",
  "specversion": "1.0",
  "data": {
    "subscriptionId": "<microsoft-graph-subscription-id>",
    "tenantId": "<tenant-id>",
    "clientState": "<user-provided secret>",
    "expirationDateTime": "2023-10-05T18:11:08.587Z",
    "resource": "<guid>",
    "siteUrl": "<sharepoint relative URL>",
    "webId": "<guid>",
    "resourceData": {
      "@odata.type": "#Microsoft.Graph.driveItem"
    },    
  }
}

خصائص الحدث

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

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

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

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

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