Freigeben über


Azure App Service als Ereignisrasterquelle

Dieser Artikel enthält die Eigenschaften und das Schema für Azure App Service-Ereignisse. Eine Einführung in Ereignisschemas finden Sie unter Azure Event Grid-Ereignisschema. Außerdem erhalten Sie eine Liste mit Schnellstarts und Lernprogrammen, um Azure App Service als Ereignisquelle zu verwenden.

Verfügbare Ereignistypen

Azure App Service gibt die folgenden Ereignistypen aus.

Ereignistyp Beschreibung
Microsoft.Web/Sites. BackupOperationStarted Ausgelöst, wenn eine Sicherung gestartet wurde
Microsoft.Web/Sites. BackupOperationCompleted Ausgelöst, wenn eine Sicherung abgeschlossen wurde
Microsoft.Web/Sites. BackupOperationFailed Ausgelöst, wenn eine Sicherung fehlgeschlagen ist
Microsoft.Web/Sites. RestoreOperationStarted Ausgelöst, wenn eine Wiederherstellung aus einer Sicherung gestartet wurde
Microsoft.Web/Sites. RestoreOperationCompleted Ausgelöst, wenn eine Wiederherstellung aus einer Sicherung abgeschlossen ist
Microsoft.Web/Sites. RestoreOperationFailed Ausgelöst, wenn eine Wiederherstellung aus einer Sicherung fehlgeschlagen ist
Microsoft.Web/Sites. SlotSwapStarted Ausgelöst, wenn ein Slot-Swap gestartet wurde
Microsoft.Web/Sites. SlotSwapCompleted Ausgelöst, wenn ein Slot-Swap abgeschlossen wurde
Microsoft.Web/Sites. SlotSwapFailed Ausgelöst, wenn ein Slot-Swap fehlgeschlagen ist
Microsoft.Web/Sites. SlotSwapWithPreviewStarted Wird ausgelöst, wenn ein Slottausch mit der Vorschau gestartet wurde
Microsoft.Web/Sites. SlotSwapWithPreviewCancelled Wird ausgelöst, wenn ein Slottausch mit der Vorschau abgebrochen wurde
Microsoft.Web/Sites. AppUpdated.Restarted Ausgelöst, wenn eine Website neu gestartet wurde
Microsoft.Web/Sites. AppUpdated.Stopped Ausgelöst, wenn eine Website beendet wurde
Microsoft.Web/Sites. AppUpdated.ChangedAppSettings Wird ausgelöst, wenn sich die App-Einstellungen einer Website geändert haben
Microsoft.Web/serverfarms. AppServicePlanUpdated Ausgelöst, wenn ein App Service Plan aktualisiert wird

Eigenschaften, die allen Ereignissen gemeinsam sind

Wenn ein Ereignis ausgelöst wird, sendet der Event Grid-Dienst Daten zum Ereignis an den Endpunkt, der über ein entsprechendes Abonnement verfügt. In diesem Abschnitt wird anhand eines Beispiels gezeigt, wie diese Daten für jedes Ereignis aussehen. Jedes Ereignis weist die folgenden Daten auf oberster Ebene auf:

Eigentum Typ Beschreibung
source Schnur Vollständiger Ressourcenpfad zur Ereignisquelle. Dieses Feld ist nicht beschreibbar. Dieser Wert wird von Event Grid bereitgestellt.
subject Schnur Publisher-definierter Pfad zum Ereignisbetreff.
type Schnur Einer der registrierten Ereignistypen für diese Ereignisquelle.
time Schnur Die Zeit, zu der das Ereignis basierend auf der UTC-Zeit des Anbieters erzeugt wird.
id Schnur Eindeutiger Bezeichner für das Ereignis.
data Objekt Ereignisdaten für Blob Storage.
specversion Schnur CloudEvents-Schemaspezifikationsversion.

Beispielereignisse

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"
}

Das Datenobjekt enthält die folgenden Eigenschaften:

Eigentum Typ Beschreibung
appEventTypeDetail Objekt Detail der Aktion in der App
action Schnur Art der Aktion des Vorgangs
name Schnur Name der Website, die dieses Ereignis hatte
clientRequestId Schnur Die vom App-Dienst generierte Clientanforderungs-ID für den Website-API-Vorgang, der dieses Ereignis ausgelöst hat
correlationRequestId Schnur Die Korrelationsanforderungs-ID, die vom App-Dienst für den Website-API-Vorgang generiert wurde, der dieses Ereignis ausgelöst hat
requestId Schnur Die vom App-Dienst generierte Anforderungs-ID für den Website-API-Vorgang, der dieses Ereignis ausgelöst hat
address Schnur HTTP-Anforderungs-URL dieses Vorgangs
verb Schnur HTTP-Verb dieses Vorgangs

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"
}

Das Datenobjekt enthält die folgenden Eigenschaften:

Eigentum Typ Beschreibung
appEventTypeDetail Objekt Detail der Aktion in der App
action Schnur Art der Aktion des Vorgangs
name Schnur Name der Website, die dieses Ereignis hatte
clientRequestId Schnur Die vom App-Dienst generierte Clientanforderungs-ID für den Website-API-Vorgang, der dieses Ereignis ausgelöst hat
correlationRequestId Schnur Die Korrelationsanforderungs-ID, die vom App-Dienst für den Website-API-Vorgang generiert wurde, der dieses Ereignis ausgelöst hat
requestId Schnur Die vom App-Dienst generierte Anforderungs-ID für den Website-API-Vorgang, der dieses Ereignis ausgelöst hat
address Schnur HTTP-Anforderungs-URL dieses Vorgangs
verb Schnur HTTP-Verb dieses Vorgangs

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"
}

Das Datenobjekt enthält die folgenden Eigenschaften:

Eigentum Typ Beschreibung
appEventTypeDetail Objekt Detail der Aktion in der App
action Schnur Art der Aktion des Vorgangs
name Schnur Name der Website, die dieses Ereignis hatte
clientRequestId Schnur Die vom App-Dienst generierte Clientanforderungs-ID für den Website-API-Vorgang, der dieses Ereignis ausgelöst hat
correlationRequestId Schnur Die Korrelationsanforderungs-ID, die vom App-Dienst für den Website-API-Vorgang generiert wurde, der dieses Ereignis ausgelöst hat
requestId Schnur Die vom App-Dienst generierte Anforderungs-ID für den Website-API-Vorgang, der dieses Ereignis ausgelöst hat
address Schnur HTTP-Anforderungs-URL dieses Vorgangs
verb Schnur HTTP-Verb dieses Vorgangs
sourceSlot Schnur Der Quellplatz des Tauschs

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"
}

Das Datenobjekt enthält die folgenden Eigenschaften:

Eigentum Typ Beschreibung
appEventTypeDetail Objekt Detail der Aktion in der App
action Schnur Art der Aktion des Vorgangs
name Schnur Name der Website, die dieses Ereignis hatte
clientRequestId Schnur Die vom App-Dienst generierte Clientanforderungs-ID für den Website-API-Vorgang, der dieses Ereignis ausgelöst hat
correlationRequestId Schnur Die Korrelationsanforderungs-ID, die vom App-Dienst für den Website-API-Vorgang generiert wurde, der dieses Ereignis ausgelöst hat
requestId Schnur Die vom App-Dienst generierte Anforderungs-ID für den Website-API-Vorgang, der dieses Ereignis ausgelöst hat
address Schnur HTTP-Anforderungs-URL dieses Vorgangs
verb Schnur HTTP-Verb dieses Vorgangs

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"
}

Das Datenobjekt weist die folgenden Eigenschaften auf:

Eigentum Typ Beschreibung
appEventTypeDetail Objekt Detail der Aktion in der App
action Schnur Art der Aktion des Vorgangs
name Schnur Name der Website, die dieses Ereignis hatte
clientRequestId Schnur Die vom App-Dienst generierte Clientanforderungs-ID für den Website-API-Vorgang, der dieses Ereignis ausgelöst hat
correlationRequestId Schnur Die Korrelationsanforderungs-ID, die vom App-Dienst für den Website-API-Vorgang generiert wurde, der dieses Ereignis ausgelöst hat
requestId Schnur Die vom App-Dienst generierte Anforderungs-ID für den Website-API-Vorgang, der dieses Ereignis ausgelöst hat
address Schnur HTTP-Anforderungs-URL dieses Vorgangs
verb Schnur HTTP-Verb dieses Vorgangs

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"
}

Das Datenobjekt weist die folgenden Eigenschaften auf:

Eigentum Typ Beschreibung
appServicePlanEventTypeDetail Objekt Details zur Aktion im App-Dienstplan
stampKind Schnur Art der Umgebung, in der app-Serviceplan
action Schnur Art der Aktion im App-Dienstplan
status Schnur Status des Vorgangs im App-Serviceplan
sku Objekt Sku des App-Serviceplans
name Schnur Name des App-Serviceplans
Tier Schnur Ebene des App-Dienstplans
Size Schnur Größe des App-Serviceplans
Family Schnur Familie des App-Serviceplans
Capacity Schnur Kapazität des App-Serviceplans
action Schnur Art der Aktion des Vorgangs
name Schnur Name der Website, die dieses Ereignis hatte
clientRequestId Schnur Die vom App-Dienst generierte Clientanforderungs-ID für den Website-API-Vorgang, der dieses Ereignis ausgelöst hat
correlationRequestId Schnur Die Korrelationsanforderungs-ID, die vom App-Dienst für den Website-API-Vorgang generiert wurde, der dieses Ereignis ausgelöst hat
requestId Schnur Die vom App-Dienst generierte Anforderungs-ID für den Website-API-Vorgang, der dieses Ereignis ausgelöst hat
address Schnur HTTP-Anforderungs-URL dieses Vorgangs
verb Schnur HTTP-Verb dieses Vorgangs

Nächste Schritte