Skip to content

unifiedrbacapplication-list-customappscopes.md

Latest commit

 

History

History
144 lines (105 loc) · 5.14 KB

unifiedrbacapplication-list-customappscopes.md

File metadata and controls

144 lines (105 loc) · 5.14 KB
title List customAppScopes
description Get a list of customAppScope objects for an RBAC provider.
ms.localizationpriority medium
author cubika
ms.subservice entra-directory-management
doc_type apiPageType
ms.date 04/04/2024

List customAppScopes

Namespace: microsoft.graph

[!INCLUDE beta-disclaimer]

Get a list of customAppScope objects for an RBAC provider.

Currently only the Exchange Online RBAC provider is supported.

[!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]

HTTP request

For an Exchange Online provider:

GET /roleManagement/exchange/customAppScopes

Optional query parameters

This method supports the $filter and $count OData query parameters to help customize the response. Note that $filter doesn't work for nested properties stored in the customAttributes property.

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 customAppScope objects in the response body.

Examples

Request

The following example shows how to request all customAppScope objects of an Exchange Online provider.

HTTP

GET https://graph.microsoft.com/beta/roleManagement/exchange/customAppScopes

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

The following example shows the response.

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

HTTP/1.1 200 OK
Content-type: application/json

{
    "@odata.context": "https://graph.microsoft.com/beta/$metadata#roleManagement/exchange/customAppScopes",
    "value": [
        {
            "id": "a6a7ef59-ff39-46b1-ae6b-2d9c4d6380cd",
            "type": "RecipientScope",
            "displayName": "scope 1",
            "customAttributes": {
                "Exclusive": false,
                "RecipientFilter": "City -eq 'Seattle'"
            }
        },
        {
            "id": "0b708633-b2ea-4673-b630-18922c345560",
            "type": "RecipientScope",
            "displayName": "scope 2",
            "customAttributes": {
                "Exclusive": false,
                "RecipientFilter": "ExternalDirectoryObjectId -eq '45ad6645-57a8-4fef-ad2f-ac5bd3de7d7c'"
            }
        }
    ]
}