Skip to content

policyroot-list-permissiongrantpreapprovalpolicies.md

Latest commit

 

History

History
188 lines (157 loc) · 7.56 KB

policyroot-list-permissiongrantpreapprovalpolicies.md

File metadata and controls

188 lines (157 loc) · 7.56 KB
title List permissionGrantPreApprovalPolicies
description Get the permissionGrantPreApprovalPolicy objects in the tenant.
author yuhko-msft
ms.localizationpriority medium
ms.subservice entra-applications
doc_type apiPageType
ms.date 07/22/2024

List permissionGrantPreApprovalPolicies

Namespace: microsoft.graph

[!INCLUDE beta-disclaimer]

Retrieve the list of permissionGrantPreApprovalPolicy objects in the tenant.

[!INCLUDE national-cloud-support]

Permissions

Choose the permission or permissions marked as least privileged for this API. Use a higher privileged permission or permissions only if your app requires it. For details about delegated and application permissions, see Permission types. To learn more about these permissions, see the permissions reference.

[!INCLUDE permissions-table]

[!INCLUDE rbac-permission-grant-preapproval-policy-read]

HTTP request

GET /policies/permissionGrantPreApprovalPolicies

Optional query parameters

This method does not support the OData query parameters to help customize the response. For general information, see OData query parameters.

Request headers

Name Description
Authorization Bearer {token}. Required. Learn more about authentication and authorization.

Request body

Don't supply a request body for this method.

Response

If successful, this method returns a 200 OK response code and a collection of permissionGrantPreApprovalPolicy objects in the response body.

Examples

Request

HTTP

GET https://graph.microsoft.com/beta/policies/permissionGrantPreApprovalPolicies

C#

[!INCLUDE sample-code] [!INCLUDE sdk-documentation]

Go

[!INCLUDE sample-code] [!INCLUDE sdk-documentation]

Java

[!INCLUDE sample-code] [!INCLUDE sdk-documentation]

JavaScript

[!INCLUDE sample-code] [!INCLUDE sdk-documentation]

PHP

[!INCLUDE sample-code] [!INCLUDE sdk-documentation]

PowerShell

[!INCLUDE sample-code] [!INCLUDE sdk-documentation]

Python

[!INCLUDE sample-code] [!INCLUDE sdk-documentation]

Response

Note: The response object shown here might be shortened for readability.

In the following example:

  • Policy ID 71ba13dc-5947-4e59-bcc5-0ad5c339a853 has the following settings:

    • The condition for the chat resource type:
      • Indicates that all chats regardless of sensitivity labels are in scope
      • Specifies that all application permissions for all APIs are preapproved
    • The condition for the group resource type:
      • Specifies two sensitivity labels that are in scope
      • Specifies two application permissions for the 00000003-0000-0000-c000-000000000000 resource app are preapproved

  • Policy ID bd4b701c-a54e-42b8-9f56-e4b4b229be3b has the following settings:

    • The condition for the group resource type:
      • Indicates that all groups regardless of sensitivity labels are in scope
      • Specifies that all application permissions for the 00000003-0000-0000-c000-000000000000 resource app are preapproved
HTTP/1.1 200 OK
Content-Type: application/json

{
    "@odata.context": "https://graph.microsoft.com/beta/$metadata#policies/permissionGrantPreApprovalPolicies",
    "value": [
        {
            "id": "71ba13dc-5947-4e59-bcc5-0ad5c339a853",
            "deletedDateTime": null,
            "conditions": [
                      {
                  "scopeType": "chat",
                  "sensitivityLabels": {
                      "@odata.type": "#microsoft.graph.allScopeSensitivityLabels",
                      "labelKind": "all"
                  },
                  "permissions": {
                      "@odata.type": "#microsoft.graph.allPreApprovedPermissions",
                      "permissionKind": "all",
                      "permissionType": "application"
                  }
              },
              {
                  "scopeType": "group",
                  "scopeSensitivityLabels": {
                      "@odata.type": "microsoft.graph.enumeratedScopeSensitivityLabels",
                      "labelKind": "enumerated",
                      "sensitivityLabels": [
                          "d9c43deb-f3e1-4422-9fd6-ccf22a3206b8",
                          "c99dade2-aa54-4890-ac1c-a146fa26bd1e"
                      ]
                  },
                  "permissions": {
                      "@odata.type": "#microsoft.graph.enumeratedPreApprovedPermissions",
                      "permissionKind": "enumerated",
                      "permissionType": "application",
                      "resourceApplicationId": "00000003-0000-0000-c000-000000000000",
                      "permissionIds": [
                          "134483aa-3dda-4d65-ac91-b8dda1417875",
                          "9d33613d-f855-483b-bca7-ea63ac9f5485"
                      ]
                  }
              }
            ]
        },
        {
            "id": "bd4b701c-a54e-42b8-9f56-e4b4b229be3b",
            "deletedDateTime": null,
            "conditions": [
                {
                    "scopeType": "group",
                    "sensitivityLabels": {
                        "@odata.type": "#microsoft.graph.allScopeSensitivityLabels",
                        "labelKind": "all"
                    },
                    "permissions": {
                        "@odata.type": "#microsoft.graph.allPermissionsOnResourceApp",
                        "permissionKind": "allPermissionsOnResourceApp",
                        "permissionType": "application",
                        "resourceApplicationId": "00000003-0000-0000-c000-000000000000"
                    }
                }
            ]
        }
    ]
}