Get Policy
Important
APIs under the /beta
version in Microsoft Graph are subject to change. Use of these APIs in production applications is not supported.
Retrieve the properties of a policy.
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) | Policy.Read.All, Directory.Read.All, Directory.AccessAsUser.All |
Delegated (personal Microsoft account) | Not supported. |
Application | Policy.Read.All, Directory.Read.All |
HTTP request
GET /policies/{id}
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 200 OK
response code and a policy object in the response body. If unsucccessful...
Example
The following example retrieves a specific policy.
Request
Here is an example of the request.
GET https://graph.microsoft.com/beta/policies/{id}
Response
Here is an example of the 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
{
"@odata.context":"https://graph.microsoft.com/beta/$metadata#policies/$entity",
"id":"id-value",
"alternativeIdentifier":null,
"definition":["policy-definition"],
"displayName":"name-value",
"isOrganizationDefault":boolean-value,
"keyCredentials":[key-credentials],
"type":"type-value"
}
Feedback
Loading feedback...