userConsentRequest 资源类型

命名空间：microsoft.graph

重要

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

表示用户在请求访问应用或向应用授予权限时创建的同意请求的详细信息。 详细信息包括请求访问的理由、请求的状态和审批详细信息。

当应用或权限需要管理员授权并且仅当启用了 管理员同意工作流 时，用户才能创建同意请求。

方法

方法	返回类型	说明
列出 userConsentRequests	userConsentRequest 集合	检索 appConsentRequest 的 userConsentRequest 对象的集合。
获取 userConsentRequest	userConsentRequest	读取 userConsentRequest 对象的属性和关系。
filterByCurrentUser	userConsentRequest 集合	读取当前用户作为审阅者的 appConsentRequest 的 userConsentRequest 对象的属性。

属性

属性	类型	说明
approvalId	String	审批的 ID。 此值等于 的值 id。
completedDateTime	DateTimeOffset	请求 状态 标记为 Completed的日期和时间。 日期和时间信息采用 ISO 8601 格式，并且始终处于 UTC 时间。 例如，2014 年 1 月 1 日午夜 UTC 为 2014-01-01T00:00:00Z。
createdBy	identitySet	创建请求的用户。
createdDateTime	DateTimeOffset	创建请求的日期和时间。 日期和时间信息采用 ISO 8601 格式，并且始终处于 UTC 时间。 例如，2014 年 1 月 1 日午夜 UTC 为 2014-01-01T00:00:00Z。 仅支持 $filter) eq 和 $orderby (。
customData	String	用于定义用户同意请求的任何自定义数据的自由文本字段。 未使用。
id	String	请求的标识符。
reason	String	用户要求访问应用的理由。 仅支持 $filter) eq 和 $orderby (。
status	String	用户的应用同意请求的状态。 可能的值为： Initializing、 InProgress、 Expired和 Completed。 仅支持 $filter) eq 和 $orderby (。

关系

关系	类型	说明
“审批”	“审批”	与请求关联的审批决策。

JSON 表示形式

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

{
  "@odata.type": "#microsoft.graph.userConsentRequest",
  "id": "String (identifier)",
  "status": "String",
  "completedDateTime": "String (timestamp)",
  "createdDateTime": "String (timestamp)",
  "approvalId": "String",
  "customData": "String",
  "createdBy": {
    "@odata.type": "microsoft.graph.identitySet"
  },
  "reason": "String"
}