Nota:
El acceso a esta página requiere autorización. Puede intentar iniciar sesión o cambiar directorios.
El acceso a esta página requiere autorización. Puede intentar cambiar los directorios.
Espacio de nombres: microsoft.graph
Representa la notificación enviada al suscriptor (aplicación) de una suscripción de Microsoft Graph. Todas las propiedades de este recurso son de solo lectura.
Para obtener más información, consulte Usar Microsoft Graph para obtener notificaciones de cambios.
Métodos
Ninguno.
Propiedades
Nota:
La propiedad changeType es necesaria y solo está presente en las notificaciones de cambios. La propiedad lifecycleEvent es necesaria y solo está presente en las notificaciones de ciclo de vida. Estas dos propiedades son mutuamente excluyentes; Una notificación incluirá solo uno de ellos.
| Propiedad | Tipo | Descripción |
|---|---|---|
| changeType | changeType | Indica el tipo de cambio que generará la notificación de cambio. Requerido y solo presente para notificaciones de cambio. Mutuamente excluyente con lifecycleEvent. Los valores posibles son: created, updated, deleted y unknownFutureValue
unknownFutureValue es un centinela de enumeración evolutivo reservado para la extensibilidad futura. Su adición no introduce un nuevo tipo de cambio de notificación ni cambia la entrega de notificación existente. |
| clientState | string | Valor de la propiedad clientState enviada en la solicitud de suscripción (si existe). La longitud máxima es 255 caracteres. El cliente puede comprobar si la notificación de cambio procede del servicio comparando los valores de la propiedad clientState . El valor de la propiedad clientState enviada con la suscripción se compara con el valor de la propiedad clientState recibida con cada notificación de cambio. Opcional. |
| Contenido cifrado | changeNotificationEncryptedContent | (versión preliminar) Contenido cifrado adjunto con la notificación de cambio. Solo se proporciona si encryptionCertificate e includeResourceData se definieron durante la solicitud de suscripción y si el recurso lo admite. Opcional. |
| id | string | Identificador único de la notificación. Opcional. |
| lifecycleEvent | lifecycleEventType | El tipo de notificación del ciclo de vida. Obligatorio y solo presente para notificaciones de ciclo de vida. Mutuamente excluyente con changeType. Valores admitidos: missed, subscriptionRemoved, reauthorizationRequired. |
| resource | Cadena | El URI del recurso que emitió la notificación de cambio relativa a https://graph.microsoft.com. Obligatorio. |
| resourceData | resourceData | El contenido de esta propiedad depende del tipo de recurso al que se suscriba. Opcional. |
| subscriptionExpirationDateTime | DateTimeOffset | Fecha de expiración de la suscripción. Obligatorio. |
| subscriptionId | Guid | El identificador único de la suscripción que generó la notificación. Obligatorio. |
| tenantId | Guid | El identificador único del inquilino desde el que se originó la notificación de cambio. Obligatorio. |
Relaciones
Ninguna.
Representación JSON
La siguiente representación JSON muestra el tipo de recurso.
{
"@odata.type": "#microsoft.graph.changeNotification",
"changeType": "String",
"clientState": "String",
"encryptedContent": {
"@odata.type": "microsoft.graph.changeNotificationEncryptedContent"
},
"id": "String (identifier)",
"lifecycleEvent": "String",
"resource": "String",
"resourceData": {
"@odata.type": "microsoft.graph.resourceData"
},
"subscriptionExpirationDateTime": "String (timestamp)",
"subscriptionId": "Guid",
"tenantId": "Guid"
}