retentionEvent 资源类型

命名空间：microsoft.graph.security

重要

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

表示基于事件的保留标签的触发器，其中保留期的开始取决于发生特定类型的事件的时间。 若要详细了解它，请参阅 在事件发生时启动保留期。

方法

方法	返回类型	说明
列出 retentionEvents	microsoft.graph.security.retentionEvent 集合	获取 retentionEvent 对象及其属性的列表。
Create retentionEvent	microsoft.graph.security.retentionEvent	Create新的 retentionEvent 对象。
获取 retentionEvent	microsoft.graph.security.retentionEvent	读取 retentionEvent 对象的属性和关系。
删除 retentionEvent	无	删除 retentionEvent 对象。
列表 retentionEventType	microsoft.graph.security.retentionEventType 集合	从 exapnd eventType 导航属性获取 retentionEventType 资源。
Create retentionEventType	microsoft.graph.security.retentionEventType	通过在创建事件时添加相关的 odata 属性来添加 eventType。

属性

属性	类型	说明
createdBy	microsoft.graph.identitySet	创建 retentionEvent 的用户。
createdDateTime	DateTimeOffset	创建 retentionEvent 的日期时间。
说明	String	有关事件的可选信息。
displayName	String	事件的名称。
eventPropagationResults	microsoft.graph.security.eventPropagationResult 集合	表示已创建事件的成功状态和其他信息。
eventQueries	microsoft.graph.security.eventQuery 集合	表示与保留事件关联的工作负荷 (SharePoint Online、OneDrive for Business、Exchange Online) 和标识信息。
eventStatus	microsoft.graph.security.retentionEventStatus	创建事件后事件传播到作用域内位置的事件的状态。
eventTriggerDateTime	DateTimeOffset	应触发事件的可选时间。
id	String	表示创建 retentionEvent 的用户的唯一 ID。 实体。
lastModifiedBy	microsoft.graph.identitySet	上次修改 retentionEvent 的用户。
lastModifiedDateTime	DateTimeOffset	修改 retentionEvent 的最近日期时间。
lastStatusUpdateDateTime	DateTimeOffset	上次更新事件状态的时间。

关系

关系	类型	说明
retentionEventType	microsoft.graph.security.retentionEventType	指定在创建事件时将启动使用此事件类型的标签的保留期的事件。

JSON 表示形式

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

{
  "@odata.type": "#microsoft.graph.security.retentionEvent",
  "id": "String (identifier)",
  "displayName": "String",
  "description": "String",
  "eventQueries": [
    {
      "@odata.type": "microsoft.graph.security.eventQuery"
    }
  ],
  "eventTriggerDateTime": "String (timestamp)",
  "createdBy": {
    "@odata.type": "microsoft.graph.identitySet"
  },
  "createdDateTime": "String (timestamp)",
  "lastModifiedBy": {
    "@odata.type": "microsoft.graph.identitySet"
  },
  "lastModifiedDateTime": "String (timestamp)",
  "eventPropagationResults": [
    {
      "@odata.type": "microsoft.graph.security.eventPropagationResult"
    }
  ],
  "eventStatus": {
    "@odata.type": "microsoft.graph.security.retentionEventStatus"
  },
  "lastStatusUpdateDateTime": "String (timestamp)"
}