协议资源类型

命名空间:microsoft.graph

表示使用Microsoft Entra ID 治理创建和管理的租户的可自定义使用条款协议。 可以根据方案使用以下方法创建和管理Microsoft Entra使用条款功能

方法

方法 返回类型 Description
List 协议 集合 获取协议对象集合。
创建 合同 通过发布到协议集合来创建新协议。
Get 合同 读取协议对象的属性和关系。
更新 更新协议对象。
删除 删除协议对象。

属性

属性 类型 说明
displayName String 协议的显示名称。 显示名称用于对协议进行内部跟踪,但不会向查看协议的最终用户显示。 支持 $filtereq)。
id String 协议的标识符。 此为只读属性。 支持 $filtereq)。
isPerDeviceAcceptanceRequired 布尔值 指示是否要求最终用户在访问协议的每台设备上接受此协议。 最终用户需要在 Microsoft Entra ID 中注册其设备(如果尚未注册)。 支持 $filtereq)。
isViewingBeforeAcceptanceRequired 布尔值 指示用户在接受协议之前是否必须展开协议。 支持 $filtereq)。
termsExpiration termsExpiration 所有用户的到期计划和协议频率。 支持 $filtereq)。
userReacceptRequiredFrequency 持续时间 用户必须重新接受使用条款的持续时间。 该值在持续时间内以 ISO 8601 格式表示。 支持 $filtereq)。

关系

关系 类型 说明
承兑 agreementAcceptance 集合 此为只读属性。 有关接受本协议的信息。
file agreementFile 链接到本协议的默认 PDF。
files agreementFileLocalization 集合 链接到本协议的 PDF。 此属性正在弃用。 请改用 file 属性。 支持 $expand

JSON 表示形式

以下 JSON 表示形式显示了资源类型。

{
  "@odata.type": "#microsoft.graph.agreement",
  "displayName": "String",
  "id": "String (identifier)",
  "isPerDeviceAcceptanceRequired": "Boolean",
  "isViewingBeforeAcceptanceRequired": "Boolean",
  "termsExpiration": {
    "@odata.type": "microsoft.graph.termsExpiration"
  },
  "userReacceptRequiredFrequency": "String (duration)"
}