userConsentRequest resource type
Namespace: microsoft.graph
Represents the details of the consent request a user creates when they request to access an app or to grant permissions to an app. The details include justification for requesting access, the status of the request, and the approval details.
The user can create a consent request when an app or a permission requires admin authorization and only when the admin consent workflow is enabled.
Methods
Method | Return type | Description |
---|---|---|
List userConsentRequests | userConsentRequest collection | Retrieve a collection of userConsentRequest objects for an appConsentRequest. |
Get userConsentRequest | userConsentRequest | Read the properties and relationships of a userConsentRequest object. |
filterByCurrentUser | userConsentRequest collection | Read the properties of userConsentRequest objects for an appConsentRequest for which the current user is the reviewer. |
Properties
Property | Type | Description |
---|---|---|
approvalId | String | The id of the approval. This value is equal to the value of the id . |
completedDateTime | DateTimeOffset | The date and time when the status of the request was marked as Completed . The date and time information uses ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 is 2014-01-01T00:00:00Z . |
createdBy | identitySet | The user who created the request. |
createdDateTime | DateTimeOffset | The date and time when the request was created. The date and time information uses ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 is 2014-01-01T00:00:00Z . Supports $filter (eq only) and $orderby . |
customData | String | Free text field to define any custom data for the user consent request. Not used. |
id | String | Identifier of the request. |
reason | String | The user's justification for requiring access to the app. Supports $filter (eq only) and $orderby . |
status | String | The status of the user's app consent request. Possible values are: Initializing , InProgress , Expired , and Completed . Supports $filter (eq only) and $orderby . |
Relationships
Relationship | Type | Description |
---|---|---|
approval | approval | Approval decisions associated with a request. |
JSON representation
The following is a JSON representation of the resource.
{
"@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"
}
意見反應
https://aka.ms/ContentUserFeedback。
即將登場:在 2024 年,我們將逐步淘汰 GitHub 問題作為內容的意見反應機制,並將它取代為新的意見反應系統。 如需詳細資訊,請參閱:提交並檢視相關的意見反應