Get directoryRole
Retrieve the properties of a directoryRole object.
Permissions
One of the following permissions is required to call this API. To learn more, including how to choose permissions, see Permissions.
Permission type | Permissions (from least to most privileged) |
---|---|
Delegated (work or school account) | Directory.Read.All, Directory.ReadWrite.All, Directory.AccessAsUser.All |
Delegated (personal Microsoft account) | Not supported. |
Application | Directory.Read.All, Directory.ReadWrite.All |
HTTP request
GET /directoryRoles/{id}
Optional query parameters
This method does not support the OData Query Parameters to help customize the response (e.g. $filter is not supported here).
Request headers
Name | Type | Description |
---|---|---|
Authorization | string | 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 directoryRole object in the response body.
Example
Request
GET https://graph.microsoft.com/v1.0/directoryRoles/{id}
Response
Note: The response object shown here may be truncated for brevity. All of the properties will be returned from an actual call.
HTTP/1.1 200 OK
Content-type: application/json
{
"description": "description-value",
"displayName": "displayName-value",
"roleTemplateId": "roleTemplateId-value",
"id": "id-value"
}
Feedback
We'd love to hear your thoughts. Choose the type you'd like to provide:
Our feedback system is built on GitHub Issues. Read more on our blog.
Loading feedback...