-
Notifications
You must be signed in to change notification settings - Fork 321
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
Merge pull request #22790 from microsoftgraph/main
Merge to publish.
- Loading branch information
Showing
423 changed files
with
9,974 additions
and
730 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,159 @@ | ||
| --- | ||
| title: "approval: filterByCurrentUser" | ||
| description: "Get the approval resources." | ||
| author: "markwahl-msft" | ||
| ms.localizationpriority: medium | ||
| ms.prod: "governance" | ||
| doc_type: apiPageType | ||
| --- | ||
|
|
||
| # approval: filterByCurrentUser | ||
| Namespace: microsoft.graph | ||
|
|
||
| [!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)] | ||
|
|
||
| In [Azure AD entitlement management](../resources/entitlementmanagement-overview.md), return a collection of [access package assignment approvals](../resources/approval.md). The objects returned are those that are in scope for approval by the calling user. | ||
|
|
||
| In [PIM for groups](../resources/privilegedidentitymanagement-for-groups-api-overview.md), return a collection of [assignment approvals](../resources/approval.md). The objects returned are those that are in scope for approval by the calling user. | ||
|
|
||
|
|
||
| ## Permissions | ||
| One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference). | ||
|
|
||
| ### For entitlement management | ||
|
|
||
| | Permission type | Permissions (from least to most privileged) | | ||
| |:---------------------------------------|:--------------------------------------------| | ||
| | Delegated (work or school account) | EntitlementManagement.ReadWrite.All | | ||
| | Delegated (personal Microsoft account) | Not supported. | | ||
| | Application | Not supported. | | ||
|
|
||
| ### For PIM for groups | ||
|
|
||
| | Permission type | Permissions (from least to most privileged) | | ||
| |:---------------------------------------|:--------------------------------------------| | ||
| | Delegated (work or school account) | PrivilegedAssignmentSchedule.Read.AzureADGroup, PrivilegedAssignmentSchedule.ReadWrite.AzureADGroup | | ||
| | Delegated (personal Microsoft account) | Not supported. | | ||
| | Application | Not supported. | | ||
|
|
||
| ## HTTP request | ||
|
|
||
| To retrieve the approval resources in entitlement management: | ||
| <!-- { | ||
| "blockType": "ignored" | ||
| } | ||
| --> | ||
| ``` http | ||
| GET /identityGovernance/entitlementManagement/accessPackageAssignmentApprovals/filterByCurrentUser(on='approver') | ||
| ``` | ||
|
|
||
| To retrieve the approval resources in PIM for groups: | ||
| <!-- { | ||
| "blockType": "ignored" | ||
| } | ||
| --> | ||
| ``` http | ||
| GET /identityGovernance/privilegedAccess/group/assignmentApprovals/filterByCurrentUser(on='approver') | ||
| ``` | ||
|
|
||
| ## Function parameters | ||
| This method supports the OData query parameters for paging through a large result set. For general information, see [OData query parameters](/graph/query-parameters). | ||
|
|
||
| |Parameter|Type|Description| | ||
| |:---|:---|:---| | ||
| |on|approvalFilterByCurrentUserOptions| The allowed value is `approver`. Required.| | ||
|
|
||
| ## Request headers | ||
| |Name|Description| | ||
| |:---|:---| | ||
| |Authorization|Bearer {token}. Required.| | ||
|
|
||
| ## Request body | ||
| Do not supply a request body for this method. | ||
|
|
||
| ## Response | ||
|
|
||
| If successful, this method returns a `200 OK` response code and a collection of [approval](../resources/approval.md) objects in the response body. | ||
|
|
||
| ## Examples | ||
|
|
||
| ### Example 1: Retrieve the approval resources in entitlement management | ||
|
|
||
| #### Request | ||
| <!-- { | ||
| "blockType": "request", | ||
| "name": "approvalthis-filterbycurrentuser" | ||
| } | ||
| --> | ||
| ``` http | ||
| GET https://graph.microsoft.com/beta/identityGovernance/entitlementManagement/accessPackageAssignmentApprovals/filterByCurrentUser(on='approver') | ||
| ``` | ||
|
|
||
| #### Response | ||
| >**Note:** The response object shown here might be shortened for readability. | ||
| <!-- { | ||
| "blockType": "response", | ||
| "truncated": true, | ||
| "@odata.type": "Collection(microsoft.graph.approval)" | ||
| } | ||
| --> | ||
| ``` http | ||
| HTTP/1.1 200 OK | ||
| Content-Type: application/json | ||
| { | ||
| "value": [ | ||
| { | ||
| "@odata.type": "#microsoft.graph.approval", | ||
| "id": "368f6786-6786-368f-8667-8f3686678f36" | ||
| } | ||
| ] | ||
| } | ||
| ``` | ||
|
|
||
| ### Example 2: Retrieve the approval resources in PIM for groups | ||
|
|
||
| #### Request | ||
|
|
||
| <!-- { | ||
| "blockType": "request", | ||
| "name": "approvalthis-filterbycurrentuser_azureADGroup" | ||
| } | ||
| --> | ||
| ``` http | ||
| GET https://graph.microsoft.com/beta/identityGovernance/privilegedAccess/group/assignmentApprovals/filterByCurrentUser(on='approver') | ||
| ``` | ||
|
|
||
| #### Response | ||
| >**Note:** The response object shown here might be shortened for readability. | ||
| <!-- { | ||
| "blockType": "response", | ||
| "truncated": true, | ||
| "@odata.type": "Collection(microsoft.graph.approval)" | ||
| } | ||
| --> | ||
| ``` http | ||
| HTTP/1.1 200 OK | ||
| Content-Type: application/json | ||
| { | ||
| "value": [ | ||
| { | ||
| "@odata.type": "#microsoft.graph.approval", | ||
| "id": "46bc634a-0696-43c5-bc99-d568bc3c27f5", | ||
| "stages": [ | ||
| { | ||
| "id": "46bc634a-0696-43c5-bc99-d568bc3c27f5", | ||
| "displayName": null, | ||
| "reviewedDateTime": null, | ||
| "reviewResult": "NotReviewed", | ||
| "status": "Completed", | ||
| "assignedToMe": true, | ||
| "justification": "", | ||
| "reviewedBy": null | ||
| } | ||
| ] | ||
| } | ||
| ] | ||
| } | ||
| ``` |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Oops, something went wrong.