Share via

خدمة تطبيق Azure كمصدر لـ Event Grid

  • مقالة

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

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

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

نوع الحدث ‏‏الوصف
Microsoft.Web/sites.BackupOperationStarted يتم تشغيله عند بدء النسخ الاحتياطي
Microsoft.Web/sites.BackupOperationCompleted يتم تشغيله عند اكتمال النسخ الاحتياطي
Microsoft.Web/sites.BackupOperationFailed يتم تشغيله عند فشل النسخ الاحتياطي
Microsoft.Web/sites.RestoreOperationStarted يتم تشغيله عند بدء الاستعادة من نسخة احتياطية
Microsoft.Web/sites.RestoreOperationCompleted يتم تشغيله عند اكتمال الاستعادة من نسخة احتياطية
Microsoft.Web/sites.RestoreOperationFailed يتم تشغيله عند فشل الاستعادة من نسخة احتياطية
Microsoft.Web/sites.SlotSwapStarted يتم تشغيله عند بدء تبديل الفتحة
Microsoft.Web/sites.SlotSwapCompleted يتم تشغيله عند اكتمال تبديل الفتحة
Microsoft.Web/sites.SlotSwapFailed يتم تشغيله عند فشل تبديل الفتحة
Microsoft.Web/sites.SlotSwapWithPreviewStarted يتم تشغيله عند بدء تبديل الفتحة بالمعاينة
Microsoft.Web/sites.SlotSwapWithPreviewCancelled يتم تشغيله عند إلغاء تبديل الفتحة مع المعاينة
Microsoft.Web/sites.AppUpdated.Restarted يتم تشغيله عند إعادة تشغيل أحد المواقع
Microsoft.Web/sites.AppUpdated.Stopped تم تشغيله عند إيقاف تشغيل موقع
Microsoft.Web/sites.AppUpdated.ChangedAppSettings يتم تشغيله عندما تتغير إعدادات التطبيق الخاصة بالموقع
Microsoft.Web/serverfarms.AppServicePlanUpdated يتم تشغيله عند تحديث خطة خدمة التطبيق

الخصائص المشتركة لجميع الأحداث

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

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

مثال الأحداث

BackupOperationStarted, BackupOperationCompleted, BackupOperationFailed

{
	"id": "7c5d6de5-eb70-4de2-b788-c52a544e68b8",
	"source": "/subscriptions/<id>/resourceGroups/<rg>/providers/Microsoft.Web/sites/<site-name>",
	"subject": "/Microsoft.Web/sites/<site-name>",
	"type": "Microsoft.Web.BackupOperationStarted",
	"time": "2020-01-28T18:26:51.7194887Z",
	"data": {
		"appEventTypeDetail": {
			"action": "Started"
		},
		"name": "<site-name>",
		"clientRequestId": "None",
		"correlationRequestId": "None",
		"requestId": "292f499d-04ee-4066-994d-c2df57b99198",
		"address": "None",
		"verb": "None"
	},
	"specversion": "1.0"
}

يحتوي كائن البيانات على الخصائص التالية:

الخاصية نوع ‏‏الوصف
appEventTypeDetail كائن تفاصيل الإجراء على التطبيق
action سلسلة نوع الإجراء للعملية
name سلسلة اسم موقع الويب الذي يحتوي على هذا الحدث
clientRequestId سلسلة معرّف طلب العميل الذي تم إنشاؤه بواسطة خدمة التطبيق لعملية واجهة برمجة تطبيقات الموقع التي أطلقت هذا الحدث
correlationRequestId سلسلة معرّف طلب الارتباط الذي تم إنشاؤه بواسطة خدمة التطبيق لعملية واجهة برمجة تطبيقات الموقع التي أدت إلى تشغيل هذا الحدث
requestId سلسلة معرّف الطلب الذي تم إنشاؤه بواسطة خدمة التطبيق لعملية واجهة برمجة تطبيقات الموقع التي أدت إلى تشغيل هذا الحدث
address سلسلة عنوان URL لطلب HTTP لهذه العملية
verb سلسلة فعل HTTP لهذه العملية

RestoreOperationStarted, RestoreOperationCompleted, RestoreOperationFailed

{
	"id": "7c5d6de5-eb70-4de2-b788-c52a544e68b8",
	"source": "/subscriptions/<id>/resourceGroups/<rg>/providers/Microsoft.Web/sites/<site-name>",
	"subject": "/Microsoft.Web/sites/<site-name>",
	"type": "Microsoft.Web.RestoreOperationStarted",
	"time": "2020-01-28T18:26:51.7194887Z",
	"data": {
		"appEventTypeDetail": {
			"action": "Started"
		},
		"name": "<site-name>",
		"clientRequestId": "None",
		"correlationRequestId": "None",
		"requestId": "292f499d-04ee-4066-994d-c2df57b99198",
		"address": "None",
		"verb": "POST"
	},
	"specversion": "1.0"
}

يحتوي كائن البيانات على الخصائص التالية:

الخاصية نوع ‏‏الوصف
appEventTypeDetail كائن تفاصيل الإجراء على التطبيق
action سلسلة نوع الإجراء للعملية
name سلسلة اسم موقع الويب الذي يحتوي على هذا الحدث
clientRequestId سلسلة معرّف طلب العميل الذي تم إنشاؤه بواسطة خدمة التطبيق لعملية واجهة برمجة تطبيقات الموقع التي أطلقت هذا الحدث
correlationRequestId سلسلة معرّف طلب الارتباط الذي تم إنشاؤه بواسطة خدمة التطبيق لعملية واجهة برمجة تطبيقات الموقع التي أدت إلى تشغيل هذا الحدث
requestId سلسلة معرّف الطلب الذي تم إنشاؤه بواسطة خدمة التطبيق لعملية واجهة برمجة تطبيقات الموقع التي أدت إلى تشغيل هذا الحدث
address سلسلة عنوان URL لطلب HTTP لهذه العملية
verb سلسلة فعل HTTP لهذه العملية

SlotSwapStarted, SlotSwapCompleted, SlotSwapFailed

{
	"id": "7c5d6de5-eb70-4de2-b788-c52a544e68b8",
	"source": "/subscriptions/<id>/resourceGroups/<rg>/providers/Microsoft.Web/sites/<site-name>",
	"subject": "/Microsoft.Web/sites/<site-name>",
	"type": "Microsoft.Web.SlotSwapStarted",
	"time": "2020-01-28T18:26:51.7194887Z",
	"data": {
		"appEventTypeDetail": null,
		"name": "<site-name>",
		"clientRequestId": "922f4841-20d9-4dd6-8c5b-23f0d85e5592",
		"correlationRequestId": "9ac46505-2b8a-4e06-834c-05ffbe2e8c3a",
		"requestId": "765117aa-eaf8-4bd2-a644-1dbf69c7b0fd",
		"address": "/websystems/WebSites/web/subscriptions/<id>/webspaces/<webspace>/sites/<site-name>/slots?Command=SWAP&targetSlot=production",
		"verb": "POST",
		"sourceSlot": "staging",
		"targetSlot": "production"
	},
    "specversion": "1.0"
}

يحتوي كائن البيانات على الخصائص التالية:

الخاصية نوع ‏‏الوصف
appEventTypeDetail كائن تفاصيل الإجراء على التطبيق
action سلسلة نوع الإجراء للعملية
name سلسلة اسم موقع الويب الذي يحتوي على هذا الحدث
clientRequestId سلسلة معرّف طلب العميل الذي تم إنشاؤه بواسطة خدمة التطبيق لعملية واجهة برمجة تطبيقات الموقع التي أطلقت هذا الحدث
correlationRequestId سلسلة معرّف طلب الارتباط الذي تم إنشاؤه بواسطة خدمة التطبيق لعملية واجهة برمجة تطبيقات الموقع التي أدت إلى تشغيل هذا الحدث
requestId سلسلة معرّف الطلب الذي تم إنشاؤه بواسطة خدمة التطبيق لعملية واجهة برمجة تطبيقات الموقع التي أدت إلى تشغيل هذا الحدث
address سلسلة عنوان URL لطلب HTTP لهذه العملية
verb سلسلة فعل HTTP لهذه العملية
sourceSlot سلسلة فتحة المصدر للمبادلة

SlotSwapWithPreviewStarted, SlotSwapWithPreviewCancelled

{
	"id": "7c5d6de5-eb70-4de2-b788-c52a544e68b8",
	"source": "/subscriptions/<id>/resourceGroups/<rg>/providers/Microsoft.Web/sites/<site-name>",
	"subject": "/Microsoft.Web/sites/<site-name>",
	"type": "Microsoft.Web.SlotSwapWithPreviewStarted",
	"time": "2020-01-28T18:26:51.7194887Z",
	"data": {
		"appEventTypeDetail": null,
		"name": "<site-name>",
		"clientRequestId": "922f4841-20d9-4dd6-8c5b-23f0d85e5592",
		"correlationRequestId": "9ac46505-2b8a-4e06-834c-05ffbe2e8c3a",
		"requestId": "765117aa-eaf8-4bd2-a644-1dbf69c7b0fd",
		"address": "/websystems/WebSites/web/subscriptions/<id>/webspaces/<webspace>/sites/<site-name>/slots?Command=SWAP&targetSlot=production",
		"verb": "POST",
		"sourceSlot": "staging",
		"targetSlot": "production"
	},
    "specversion": "1.0"
}

يحتوي كائن البيانات على الخصائص التالية:

الخاصية نوع ‏‏الوصف
appEventTypeDetail كائن تفاصيل الإجراء على التطبيق
action سلسلة نوع الإجراء للعملية
name سلسلة اسم موقع الويب الذي يحتوي على هذا الحدث
clientRequestId سلسلة معرّف طلب العميل الذي تم إنشاؤه بواسطة خدمة التطبيق لعملية واجهة برمجة تطبيقات الموقع التي أطلقت هذا الحدث
correlationRequestId سلسلة معرّف طلب الارتباط الذي تم إنشاؤه بواسطة خدمة التطبيق لعملية واجهة برمجة تطبيقات الموقع التي أدت إلى تشغيل هذا الحدث
requestId سلسلة معرّف الطلب الذي تم إنشاؤه بواسطة خدمة التطبيق لعملية واجهة برمجة تطبيقات الموقع التي أدت إلى تشغيل هذا الحدث
address سلسلة عنوان URL لطلب HTTP لهذه العملية
verb سلسلة فعل HTTP لهذه العملية

AppUpdated.Restarted, AppUpdated.Stopped, AppUpdated.ChangedAppSettings

{
	"id": "b74ea56b-2a3f-4de5-a5d7-38e60c81cf23",
	"source": "/subscriptions/<id>/resourceGroups/<group>/providers/Microsoft.Web/sites/<site-name>",
	"subject": "/Microsoft.Web/sites/<site-name>",
	"type": "Microsoft.Web.AppUpdated",
	"time": "2020-01-28T18:22:30.2760952Z",
	"data": {
		"appEventTypeDetail": {
			"action": "Stopped"
		},
		"name": "<site-name>",
		"clientRequestId": "64a5e0aa-7cee-4ff1-9093-b9197b820014",
		"correlationRequestId": "25bb36a5-8f6c-4f04-b615-e9a0ee045756",
		"requestId": "f2e8eb3f-b190-42de-b99e-6acefe587374",
		"address": "/websystems/WebSites/web/subscriptions/<id>/webspaces/<webspace>/sites/<site-name>/stop",
		"verb": "POST"
	},
    "specversion": "1.0"
}

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

الخاصية نوع ‏‏الوصف
appEventTypeDetail كائن تفاصيل الإجراء على التطبيق
action سلسلة نوع الإجراء للعملية
name سلسلة اسم موقع الويب الذي يحتوي على هذا الحدث
clientRequestId سلسلة معرّف طلب العميل الذي تم إنشاؤه بواسطة خدمة التطبيق لعملية واجهة برمجة تطبيقات الموقع التي أطلقت هذا الحدث
correlationRequestId سلسلة معرّف طلب الارتباط الذي تم إنشاؤه بواسطة خدمة التطبيق لعملية واجهة برمجة تطبيقات الموقع التي أدت إلى تشغيل هذا الحدث
requestId سلسلة معرّف الطلب الذي تم إنشاؤه بواسطة خدمة التطبيق لعملية واجهة برمجة تطبيقات الموقع التي أدت إلى تشغيل هذا الحدث
address سلسلة عنوان URL لطلب HTTP لهذه العملية
verb سلسلة فعل HTTP لهذه العملية

Serverfarms.AppServicePlanUpdated

{
	"id": "56501672-9150-40e1-893a-18420c7fdbf7",
	"source": "/subscriptions/<id>/resourceGroups/<rg>/providers/Microsoft.Web/serverfarms/<serverfarm-name>",
	"subject": "/Microsoft.Web/serverfarms/<plan-name>",
	"type": "Microsoft.Web.AppServicePlanUpdated",
	"time": "2020-01-28T18:22:23.5516004Z",
	"data": {
		"serverFarmEventTypeDetail": {
			"stampKind": "Public",
			"action": "Updated",
			"status": "Started"
		},
		"serverFarmId": "0",
		"sku": {
			"name": "P1v2",
			"tier": "PremiumV2",
			"size": "P1v2",
			"family": "Pv2",
			"capacity": 1
		},
		"clientRequestId": "8f880321-a991-45c7-b743-6ff63fe4c004",
		"correlationRequestId": "1995c3be-ba7f-4ccf-94af-516df637ec8a",
		"requestId": "b973a8e6-6949-4783-b44c-ac778be831bb",
		"address": "/websystems/WebSites/serverfarms/subscriptions/<id>/webspaces/<webspace-id>/serverfarms/<plan-name>/async",
		"verb": "PUT"
	},
    "specversion": "1.0"
}

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

الخاصية نوع ‏‏الوصف
appServicePlanEventTypeDetail كائن تفاصيل الإجراء على خطة خدمة التطبيق
stampKind سلسلة نوع البيئة التي تكون فيها خطة خدمة التطبيق
action سلسلة نوع الإجراء على خطة خدمة التطبيق
status سلسلة حالة العملية على خطة خدمة التطبيق
sku كائن SKU لخطة خدمة التطبيق
name سلسلة اسم خطة خدمة التطبيق
Tier سلسلة مستوى خطة خدمة التطبيق
Size سلسلة حجم خطة خدمة التطبيق
Family سلسلة عائلة خطة خدمة التطبيق
Capacity سلسلة قدرة خطة خدمة التطبيق
action سلسلة نوع الإجراء للعملية
name سلسلة اسم موقع الويب الذي يحتوي على هذا الحدث
clientRequestId سلسلة معرّف طلب العميل الذي تم إنشاؤه بواسطة خدمة التطبيق لعملية واجهة برمجة تطبيقات الموقع التي أطلقت هذا الحدث
correlationRequestId سلسلة معرّف طلب الارتباط الذي تم إنشاؤه بواسطة خدمة التطبيق لعملية واجهة برمجة تطبيقات الموقع التي أدت إلى تشغيل هذا الحدث
requestId سلسلة معرّف الطلب الذي تم إنشاؤه بواسطة خدمة التطبيق لعملية واجهة برمجة تطبيقات الموقع التي أدت إلى تشغيل هذا الحدث
address سلسلة عنوان URL لطلب HTTP لهذه العملية
verb سلسلة فعل HTTP لهذه العملية

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