协议资源类型

命名空间:microsoft.graph

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

方法

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

属性

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

关系

关系 类型 说明
承兑 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)"
}