Get onPremisesDirectorySynchronization
Namespace: microsoft.graph
Read the properties and relationships of an onPremisesDirectorySynchronization object.
This API is supported in the following national cloud deployments.
Global service | US Government L4 | US Government L5 (DOD) | China operated by 21Vianet |
---|---|---|---|
✅ | ❌ | ❌ | ❌ |
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) | OnPremDirectorySynchronization.Read.All, OnPremDirectorySynchronization.ReadWrite.All |
Delegated (personal Microsoft account) | Not supported. |
Application | OnPremDirectorySynchronization.Read.All, OnPremDirectorySynchronization.ReadWrite.All |
For delegated scenarios, the user needs to be assigned the Global Administrator role.
HTTP request
GET /directory/onPremisesSynchronization
Optional query parameters
This method supports the $select
OData query parameter to help customize the response. For general information, see OData query parameters.
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 an onPremisesDirectorySynchronization object in the response body.
Examples
Request
The following is an example of a request.
GET https://graph.microsoft.com/beta/directory/onPremisesSynchronization/{id}
Response
The following is an example of 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#directory/onPremisesSynchronization/$entity",
"id": "12cce4b4-4ab8-40b7-be4d-f5d7742ec185",
"configuration": {
"accidentalDeletionPrevention": {
"synchronizationPreventionType": "enabledForCount",
"alertThreshold": 500
}
},
"features": {
"passwordSyncEnabled": false,
"passwordWritebackEnabled": false,
"directoryExtensionsEnabled": false,
"quarantineUponUpnConflictEnabled": true,
"quarantineUponProxyAddressesConflictEnabled": true,
"softMatchOnUpnEnabled": true,
"cloudPasswordPolicyForPasswordSyncedUsersEnabled": false,
"fopeConflictResolutionEnabled": false,
"unifiedGroupWritebackEnabled": false,
"userWritebackEnabled": false,
"deviceWritebackEnabled": false,
"synchronizeUpnForManagedUsersEnabled": true,
"userForcePasswordChangeOnLogonEnabled": false,
"concurrentOrgIdProvisioningEnabled": false,
"concurrentCredentialUpdateEnabled": false,
"groupWriteBackEnabled": false,
"blockSoftMatchEnabled": false,
"blockCloudObjectTakeoverThroughHardMatchEnabled": false,
"bypassDirSyncOverridesEnabled": false
}
}
Feedback
Submit and view feedback for