أحداث Microsoft ToDo
توفر هذه المقالة خصائص ومخطط أحداث مهمة Microsoft ToDo، والتي يتم نشرها بواسطة Microsoft Graph API. للحصول على مقدمة حول مخططات الأحداث، راجع مخطط CloudEvents.
أنواع الأحداث المتاحة
يتم تشغيل هذه الأحداث عند إنشاء todoTask أو تحديثه أو حذفه عن طريق التشغيل عبر تلك الموارد باستخدام واجهة برمجة تطبيقات Microsoft Graph. لاحظ أنه يمكنك الاشتراك في التغييرات من قائمة مهام معينة فقط.
اسم الحدث | الوصف |
---|---|
Microsoft.Graph.ToDoCreated | يتم تشغيله عند إنشاء todoTask في قائمة مهام Microsoft ToDo. |
Microsoft.Graph.ToDoUpdated | يتم تشغيله عند تحديث todoTask في قائمة مهام Microsoft ToDo. |
Microsoft.Graph.ToDoDeleted | يتم تشغيله عند حذف todoTask في قائمة مهام Microsoft ToDo. |
مثال حدث
عند تشغيل حدث ما، ترسل خدمة Event Grid بيانات عن هذا الحدث إلى وجهات الاشتراك. يحتوي هذا القسم على مثال لما ستبدو عليه هذه البيانات لكل حدث تنبيه أمان Microsoft.
حدث Microsoft.Graph.ToDoCreated
{
"id": "00d8a100-2e92-4bfa-86e1-0056dacd0fce",
"type": "Microsoft.Graph.ToDoCreated",
"source": "/tenants/<tenant-id>/applications/<application-id>",
"subject": "TodoTask/<ToDoTask-id>",
"time": "2022-05-24T22:24:31.3062901Z",
"datacontenttype": "application/json",
"specversion": "1.0",
"data": {
"expirationDateTime": "2023-10-01T06:21:57-07:00",
"changeType": "Created",
"subscriptionId": "<guid>",
"resource": "todob2/graph/v1/users(<user-id>)/tasks",
"clientState": "<user-provided secret>",
"resourceData": {
"id": "<ToDoTask-id>",
"@odata.type": "#microsoft.graph.todoTask"
}
}
}
حدث Microsoft.Graph.ToDoUpdated
{
"id": "00d8a100-2e92-4bfa-86e1-0056dacd0fce",
"type": "Microsoft.Graph.ToDoUpdated",
"source": "/tenants/<tenant-id>/applications/<application-id>",
"subject": "TodoTask/<ToDoTask-id>",
"time": "2022-05-24T22:24:31.3062901Z",
"datacontenttype": "application/json",
"specversion": "1.0",
"data": {
"expirationDateTime": "2023-10-01T06:21:57-07:00",
"changeType": "Updated",
"subscriptionId": "<guid>",
"resource": "todob2/graph/v1/users(<user-id>)/tasks",
"clientState": "<user-provided secret>",
"resourceData": {
"id": "<ToDoTask-id>",
"@odata.type": "#microsoft.graph.todoTask"
}
}
}
حدث Microsoft.Graph.ToDoDeleted
{
"id": "00d8a100-2e92-4bfa-86e1-0056dacd0fce",
"type": "Microsoft.Graph.ToDoDeleted",
"source": "/tenants/<tenant-id>/applications/<application-id>",
"subject": "TodoTask/<ToDoTask-id>",
"time": "2022-05-24T22:24:31.3062901Z",
"datacontenttype": "application/json",
"specversion": "1.0",
"data": {
"expirationDateTime": "2023-10-01T06:21:57-07:00",
"changeType": "Deleted",
"subscriptionId": "<guid>",
"resource": "todob2/graph/v1/users(<user-id>)/tasks",
"clientState": "<user-provided secret>",
"resourceData": {
"id": "<ToDoTask-id>",
"@odata.type": "#microsoft.graph.todoTask"
}
}
}
خصائص الحدث
ويحتوي الحدث على بيانات المستوى الأعلى التالية:
الخاصية | نوع | الوصف |
---|---|---|
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 |
سلسلة | محدد الموارد الذي أثير من أجله الحدث. |
subscriptionExpirationDateTime |
سلسلة | الوقت في RFC 3339 تنسيق الذي ينتهي عنده الاشتراك في Microsoft Azure Active Directory Graph API. |
subscriptionId |
سلسلة | معرف اشتراكMicrosoft Azure Active Directory Graph API. |
tenantId |
سلسلة | معرف مستأجر Microsoft Entra. |
الخطوات التالية
- للحصول على مقدمة عن أحداث شركاء Azure Event Grid's Partner راجع نظرة عامة على Partner Events
- للحصول على معلومات حول كيفية الاشتراك في Microsoft Graph API لتلقي الأحداث، راجع الاشتراك في أحداث واجهة برمجة تطبيقات Microsoft Graph.
- للحصول على مَعلومات حول معالجات أحداث Azure Event Grid، راجع معالجات الأحداث.
- لمزيد من المعلومات حول إنشاء اشتراك Azure Event Grid، راجع قم بإنشاء اشتراك الحدث و مخطط اشتراك Event Grid .
- للحصول على معلومات حول كيفية تكوين اشتراك حدث لتحديد أحداث معينة سيتم تسليمها، راجع تصفية الحدث. قد تحتاج أيضا إلى الرجوع إلى أحداث التصفية.