legalHold 资源类型

命名空间:microsoft.graph.ediscovery

重要

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

表示合法保留。 合法保留与电子数据展示案例关联。 法律保留不应与保留保留混淆,保留保留用于控制内容保留Microsoft 365策略。 电子数据展示法律保留用于无限期保留内容,以用于需要防止删除内容的诉讼、内部调查和其他法律操作。 有关详细信息,请参阅管理Advanced eDiscovery

继承自 实体

方法

方法 返回类型 说明
列出 legalHolds microsoft.graph.ediscovery.legalHold 集合 获取 legalHold 对象 及其属性的列表。
创建 legalHold microsoft.graph.ediscovery.legalHold 创建新的 legalHold 对象。
获取 legalHold microsoft.graph.ediscovery.legalHold 读取 legalHold 对象的属性和 关系。
更新 legalHold microsoft.graph.ediscovery.legalHold 更新 legalHold 对象 的属性。
删除 legalHold 删除 legalHold 对象。
列出 siteSources microsoft.graph.ediscovery.siteSource 集合 获取与合法保留相关联的 siteSource 对象列表。
创建 siteSource microsoft.graph.ediscovery.siteSource 创建新的 siteSource 对象。
列出 userSources microsoft.graph.ediscovery.userSource 集合 获取与 合法保留相关联的 userSource 对象列表。
创建 userSource microsoft.graph.ediscovery.userSource 创建新的 userSource 对象。

属性

属性 类型 说明
contentQuery String 指定要位于指定位置的内容的 KQL 查询。 若要了解更多信息,请参阅内容搜索和电子数据展示的关键字 查询和搜索条件。 若要保留指定位置中所有的内容,请保留 contentQuery 为空。
createdBy identitySet 创建合法保留的用户。
createdDateTime DateTimeOffset 创建合法保留的日期和时间。
说明 String 法定保留说明。
displayName String 合法显示名称的保留项。
错误 字符串集合 列出放置保留时发生的任何错误。
id String 电子数据展示案例的 ID。 只读。 继承自 实体
isEnabled Boolean 指示是否启用保留并主动保留内容。
lastModifiedBy identitySet 上次修改法定保留的用户。
lastModifiedDateTime DateTimeOffset 上次修改法定保留的日期和时间。
状态 microsoft.graph.ediscovery.legalHoldStatus 合法保留的状态。 可能的值是:PendingErrorSuccessUnknownFutureValue

legalHoldStatus 值

成员 说明
Pending 保留分配过程正在进行中。
错误 应用保留时出错。 有关详细信息,请参阅 legalHold 对象的 errors 属性。
成功 成功应用保留并保留指定内容。

关系

关系 类型 说明
siteSources microsoft.graph.ediscovery.siteSource 集合 与合法保留SharePoint网站的数据源实体。
userSources microsoft.graph.ediscovery.userSource 集合 合法保留的数据源实体。 这是邮箱和邮箱网站的OneDrive for Business。

JSON 表示形式

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

{
  "@odata.type": "#microsoft.graph.ediscovery.legalHold",
  "id": "String (identifier)",
  "description": "String",
  "createdBy": {
    "@odata.type": "microsoft.graph.identitySet"
  },
  "lastModifiedBy": {
    "@odata.type": "microsoft.graph.identitySet"
  },
  "lastModifiedDateTime": "String (timestamp)",
  "isEnabled": "Boolean",
  "status": "String",
  "contentQuery": "String",
  "errors": [
    "String"
  ],
  "displayName": "String",
  "createdDateTime": "String (timestamp)"
}