Azure App Service como origen de Event Grid

  • Artículo

En este artículo se proporcionan las propiedades y los esquemas de los eventos de Azure App Service. Para una introducción a los esquemas de eventos, consulte Esquema de eventos de Azure Event Grid. También proporciona una lista de inicios rápidos y tutoriales para usar Azure App Service como origen de eventos.

Tipos de eventos disponibles

Azure App Service emite los siguientes tipos de eventos:

Tipo de evento Descripción
Microsoft.Web/sites.BackupOperationStarted Se desencadena cuando se inicia una copia de seguridad.
Microsoft.Web/sites.BackupOperationCompleted Se desencadena cuando se completa una copia de seguridad.
Microsoft.Web/sites.BackupOperationFailed Se desencadena cuando una copia de seguridad devuelve un error.
Microsoft.Web/sites.RestoreOperationStarted Se desencadena cuando se inicia una restauración a partir de una copia de seguridad.
Microsoft.Web/sites.RestoreOperationCompleted Se desencadena cuando se completa una restauración a partir de una copia de seguridad.
Microsoft.Web/sites.RestoreOperationFailed Se desencadena cuando una restauración a partir de una copia de seguridad devuelve un error.
Microsoft.Web/sites.SlotSwapStarted Se desencadena cuando se inicia un cambio de espacio.
Microsoft.Web/sites.SlotSwapCompleted Se desencadena cuando se completa un cambio de espacio.
Microsoft.Web/sites.SlotSwapFailed Se desencadena cuando un cambio de espacio devuelve un error.
Microsoft.Web/sites.SlotSwapWithPreviewStarted Se desencadena cuando se inicia un cambio de espacio con una vista previa.
Microsoft.Web/sites.SlotSwapWithPreviewCancelled Se desencadena cuando se cancela un cambio de espacio con una vista previa.
Microsoft.Web/sites.AppUpdated.Restarted Se desencadena cuando se reinicia un sitio.
Microsoft.Web/sites.AppUpdated.Stopped Se desencadena cuando se detiene un sitio.
Microsoft.Web/sites.AppUpdated.ChangedAppSettings Se desencadena cuando cambia la configuración de la aplicación de un sitio
Microsoft.Web/serverfarms.AppServicePlanUpdated Se desencadena cuando se actualiza un plan de App Service

Propiedades comunes para todos los eventos

Cuando se desencadena un evento, el servicio Event Grid envía datos sobre ese evento al punto de conexión correspondiente. Esta sección contiene un ejemplo del aspecto que deben tener los datos para cada evento. Cada evento tiene los siguientes datos de nivel superior:

Propiedad Tipo Description
source string Ruta de acceso completa a los recursos del origen del evento. En este campo no se puede escribir. Event Grid proporciona este valor.
subject string Ruta al asunto del evento definida por el anunciante.
type string Uno de los tipos de eventos registrados para este origen de eventos.
time string La hora de generación del evento en función de la hora UTC del proveedor.
id string Identificador único para el evento
data object Datos de eventos de Blob Storage.
specversion string Versión de especificación del esquema CloudEvents.

Eventos de ejemplo

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

El objeto de datos contiene las siguientes propiedades:

Propiedad Tipo Description
appEventTypeDetail object Detalles de la acción en la aplicación
action string Tipo de acción de la operación
name string Nombre del sitio web que tenía este evento
clientRequestId string Identificador de solicitud de cliente que generó App Service para la operación de API de sitio que desencadenó este evento.
correlationRequestId string Identificador de solicitud de correlación que generó App Service para la operación de API de sitio que desencadenó este evento.
requestId string Identificador de solicitud que generó App Service para la operación de API de sitio que desencadenó este evento.
address string Dirección URL de la solicitud HTTP de esta operación
verb string Verbo URL de esta operación

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

El objeto de datos contiene las siguientes propiedades:

Propiedad Tipo Description
appEventTypeDetail object Detalles de la acción en la aplicación
action string Tipo de acción de la operación
name string Nombre del sitio web que tenía este evento
clientRequestId string Identificador de solicitud de cliente que generó App Service para la operación de API de sitio que desencadenó este evento.
correlationRequestId string Identificador de solicitud de correlación que generó App Service para la operación de API de sitio que desencadenó este evento.
requestId string Identificador de solicitud que generó App Service para la operación de API de sitio que desencadenó este evento.
address string Dirección URL de la solicitud HTTP de esta operación
verb string Verbo URL de esta operación

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

El objeto de datos contiene las siguientes propiedades:

Propiedad Tipo Description
appEventTypeDetail object Detalles de la acción en la aplicación
action string Tipo de acción de la operación
name string Nombre del sitio web que tenía este evento
clientRequestId string Identificador de solicitud de cliente que generó App Service para la operación de API de sitio que desencadenó este evento.
correlationRequestId string Identificador de solicitud de correlación que generó App Service para la operación de API de sitio que desencadenó este evento.
requestId string Identificador de solicitud que generó App Service para la operación de API de sitio que desencadenó este evento.
address string Dirección URL de la solicitud HTTP de esta operación
verb string Verbo URL de esta operación
sourceSlot string Espacio de origen del cambio

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

El objeto de datos contiene las siguientes propiedades:

Propiedad Tipo Description
appEventTypeDetail object Detalles de la acción en la aplicación
action string Tipo de acción de la operación
name string Nombre del sitio web que tenía este evento
clientRequestId string Identificador de solicitud de cliente que generó App Service para la operación de API de sitio que desencadenó este evento.
correlationRequestId string Identificador de solicitud de correlación que generó App Service para la operación de API de sitio que desencadenó este evento.
requestId string Identificador de solicitud que generó App Service para la operación de API de sitio que desencadenó este evento.
address string Dirección URL de la solicitud HTTP de esta operación
verb string Verbo URL de esta operación

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

El objeto data tiene las siguientes propiedades:

Propiedad Tipo Description
appEventTypeDetail object Detalles de la acción en la aplicación
action string Tipo de acción de la operación
name string Nombre del sitio web que tenía este evento
clientRequestId string Identificador de solicitud de cliente que generó App Service para la operación de API de sitio que desencadenó este evento.
correlationRequestId string Identificador de solicitud de correlación que generó App Service para la operación de API de sitio que desencadenó este evento.
requestId string Identificador de solicitud que generó App Service para la operación de API de sitio que desencadenó este evento.
address string Dirección URL de la solicitud HTTP de esta operación
verb string Verbo URL de esta operación

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

El objeto data tiene las siguientes propiedades:

Propiedad Tipo Description
appServicePlanEventTypeDetail object Detalles de la acción del plan de App Service
stampKind string Tipo de entorno en que se encuentra el plan de App Service
action string Tipo de acción del plan de App Service
status string Estado de la operación del plan de App Service
sku object SKU del plan de App Service.
name string Nombre del plan de App Service
Tier string Nivel del plan de App Service
Size string Tamaño del plan de App Service
Family string Familia del plan de App Service
Capacity string Capacidad del plan de App Service
action string Tipo de acción de la operación
name string Nombre del sitio web que tenía este evento
clientRequestId string Identificador de solicitud de cliente que generó App Service para la operación de API de sitio que desencadenó este evento.
correlationRequestId string Identificador de solicitud de correlación que generó App Service para la operación de API de sitio que desencadenó este evento.
requestId string Identificador de solicitud que generó App Service para la operación de API de sitio que desencadenó este evento.
address string Dirección URL de la solicitud HTTP de esta operación
verb string Verbo URL de esta operación

Pasos siguientes