changeNotification 资源类型

命名空间:microsoft.graph

重要

Microsoft Graph版本下的 /beta API 可能会发生更改。 不支持在生产应用程序中使用这些 API。 若要确定 API 是否在 v1.0 中可用,请使用 版本 选择器。

表示发送给订阅者的通知。 此资源的所有属性都是只读的。

有关详细信息,请参阅 Microsoft Graph API 通过更改通知

方法

无。

属性

属性 类型 说明
changeType changeType 指示将引发更改通知的更改类型。 支持的值是:createdupdateddeleted。 必需项。
clientState 字符串 订阅请求请求中指定的 clientState 属性的值(如果有 () 。 最大长度为 255 个字符。 客户端可以通过比较 clientState 属性的值来检查更改通知是否来自服务。 与订阅一起发送的 clientState 属性的值与每次更改通知时收到的 clientState 属性的值进行比较。 可选。
encryptedContent changeNotificationEncryptedContent (预览) 更改通知附加的加密内容。 仅在订阅 请求期间定义了 encryptionCertificateincludeResourceData 且资源支持它时提供。 可选。
id string 通知的唯一 ID。 可选。
lifecycleEvent lifecycleEventType 如果当前通知是生命周期通知,则生命周期通知的类型。 可选。 支持的值是 、missed``subscriptionRemovedreauthorizationRequired。 可选。
resource string 发出更改通知的资源 https://graph.microsoft.com相对于 的 URI。 必需项。
resourceData resourceData 此属性的内容取决于要订阅资源的类型。 可选。
subscriptionExpirationDateTime DateTimeOffset 订阅的过期时间。 必需项。
subscriptionId Guid 生成通知的订阅的唯一标识符。 必需项。
tenantId Guid 发出更改通知的租户的唯一标识符。 必填。

关系

无。

JSON 表示形式

下面是资源的 JSON 表示形式。

{
  "@odata.type": "#microsoft.graph.changeNotification",
  "id": "String (identifier)",
  "subscriptionId": "Guid",
  "subscriptionExpirationDateTime": "String (timestamp)",
  "clientState": "String",
  "changeType": "String",
  "resource": "String",
  "tenantId": "Guid",
  "encryptedContent": {
    "@odata.type": "microsoft.graph.changeNotificationEncryptedContent"
  },
  "lifecycleEvent": "String",
  "resourceData": {
    "@odata.type": "microsoft.graph.resourceData"
  }
}