Skip to content

tenantgovernanceservices-governancerelationship.md

Latest commit

 

History

History
72 lines (60 loc) · 4.44 KB

tenantgovernanceservices-governancerelationship.md

File metadata and controls

72 lines (60 loc) · 4.44 KB
title governanceRelationship resource type
description Represents an established governance relationship between a governing tenant and a governed tenant.
author hafowler
ms.date 03/10/2026
ms.localizationpriority medium
ms.subservice entra-tenant-governance
doc_type resourcePageType

governanceRelationship resource type

Namespace: microsoft.graph.tenantGovernanceServices

[!INCLUDE beta-disclaimer]

Represents an established governance relationship between a governing tenant and a governed tenant. A governance relationship is created when a governanceRequest is accepted by the governed tenant.

Inherits from microsoft.graph.entity.

Methods

Method Return type Description
List microsoft.graph.tenantGovernanceServices.governanceRelationship collection Get a list of the governanceRelationship objects and their properties.
Get microsoft.graph.tenantGovernanceServices.governanceRelationship Read the properties of a governanceRelationship object.
Update microsoft.graph.tenantGovernanceServices.governanceRelationship Update the status property to initiate termination of the governance relationship.

Properties

Property Type Description
createdType microsoft.graph.tenantGovernanceServices.relationshipCreationType Indicates how the relationship was created. The possible values are: approvedByAdmin, addOnTenant, unknownFutureValue.

Supports $filter (eq, ne) and $orderBy.
creationDateTime DateTimeOffset The date and time when the relationship was created. The timestamp type represents date and time information using ISO 8601 format and is always in UTC. For example, midnight UTC on Jan 1, 2026 is 2026-01-01T00:00:00Z.

Supports $filter (lt, le, gt, ge, eq, ne) and $orderBy.
governedTenantId String The Microsoft Entra tenant ID of the governed tenant.

Supports $filter (eq, ne) and $orderBy.
governedTenantName String The display name of the governed tenant.

Supports $filter (eq, ne) and $orderBy.
governingTenantId String The Microsoft Entra tenant ID of the governing tenant.

Supports $filter (eq, ne) and $orderBy.
governingTenantName String The display name of the governing tenant.

Supports $filter (eq, ne) and $orderBy.
id String The unique identifier for the governance relationship. Inherited from entity.

Supports $filter (eq, ne) and $orderBy.
policySnapshot microsoft.graph.tenantGovernanceServices.relationshipPolicy A snapshot of the governance policy applied to this relationship, including delegated administration role assignments and multi-tenant applications to provision.
status microsoft.graph.tenantGovernanceServices.relationshipStatus The current status of the governance relationship. The possible values are: active, terminated, terminationRequestedByGoverningTenant, unknownFutureValue.

Supports $filter (eq, ne) and $orderBy.

Relationships

None.

JSON representation

The following JSON representation shows the resource type.

{
  "@odata.type": "#microsoft.graph.tenantGovernanceServices.governanceRelationship",
  "createdType": "String",
  "creationDateTime": "String (timestamp)",
  "id": "String (identifier)",
  "status": "String",
  "governingTenantId": "String",
  "governedTenantId": "String",
  "governingTenantName": "String",
  "governedTenantName": "String",
  "policySnapshot": {
    "@odata.type": "microsoft.graph.tenantGovernanceServices.relationshipPolicy"
  }
}