Skip to content

onpremisessyncbehavior-get.md

Latest commit

 

History

History
132 lines (98 loc) · 5.11 KB

onpremisessyncbehavior-get.md

File metadata and controls

132 lines (98 loc) · 5.11 KB
title Get onPremisesSyncBehavior
description Read the properties of an onPremisesSyncBehavior object.
author rubytek-git
ms.reviewer Darshan.Maiya,rteklemariam
ms.date 06/30/2025
ms.localizationpriority medium
ms.subservice entra-directory-management
doc_type apiPageType

Get onPremisesSyncBehavior

Namespace: microsoft.graph

[!INCLUDE beta-disclaimer]

Read the properties of an onPremisesSyncBehavior object. The isCloudManaged property indicates whether the object's source of authority is set to the cloud. If true, updates from on-premises Active Directory are blocked in the cloud; if false, updates from on-premises Active Directory are allowed in the cloud and the object can be taken over by on-premises Active Directory.

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

Supported resource Delegated (work or school account) Delegated (personal Microsoft account) Application
group Group-OnPremisesSyncBehavior.ReadWrite.All Not supported. Group-OnPremisesSyncBehavior.ReadWrite.All
orgContact Contacts-OnPremisesSyncBehavior.ReadWrite.All Not supported. Contacts-OnPremisesSyncBehavior.ReadWrite.All
user User-OnPremisesSyncBehavior.ReadWrite.All Not supported. User-OnPremisesSyncBehavior.ReadWrite.All

Important

In delegated scenarios with work or school accounts, the signed-in user must be assigned a supported Microsoft Entra role or a custom role with a supported role permission. Hybrid Administrator is the least privileged role supported for this operation.

HTTP request

GET /contacts/{id}/onPremisesSyncBehavior
GET /groups/{id}/onPremisesSyncBehavior
GET /users/{id}/onPremisesSyncBehavior

Optional query parameters

Not Supported.

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 an onPremisesSyncBehavior object in the response body.

Examples

Request

The following example shows a request.

HTTP

GET https://graph.microsoft.com/beta/groups/673f83c9-7e84-4db8-9a63-b8a8c309fdad/onPremisesSyncBehavior

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

{
  "value": {
    "@odata.type": "#microsoft.graph.onPremisesSyncBehavior",
    "id": "673f83c9-7e84-4db8-9a63-b8a8c309fdad",
    "isCloudManaged": true
  }
}