governanceRelationship resource type

Namespace: microsoft.graph.tenantGovernanceServices

Important

APIs under the /beta version in Microsoft Graph are subject to change. Use of these APIs in production applications is not supported. To determine whether an API is available in v1.0, use the Version selector.

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"
  }
}