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	合法保留的状态。 可能的值是：Pending、Error、Success、UnknownFutureValue。

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