Skip to content

tenantgovernanceservices-relatedtenant.md

Latest commit

 

History

History
65 lines (52 loc) · 4.07 KB

tenantgovernanceservices-relatedtenant.md

File metadata and controls

65 lines (52 loc) · 4.07 KB
title relatedTenant resource type
description Represents a tenant that has been discovered as related to the current tenant through tenant discovery.
author hafowler
ms.date 03/19/2026
ms.localizationpriority medium
ms.subservice entra-tenant-governance
doc_type resourcePageType

relatedTenant resource type

Namespace: microsoft.graph.tenantGovernanceServices

[!INCLUDE beta-disclaimer]

Represents a tenant that has been discovered as related to the current tenant through the tenant discovery feature. Related tenants are discovered based on B2B collaboration activity, billing relationships, multi-tenant application usage, and other indicators of inter-tenant relationships.

Important

The related tenants feature must be explicitly enabled before the tenant governance APIs can be used. To enable related tenants, call the enableRelatedTenants action.

Inherits from microsoft.graph.entity.

Methods

Method Return type Description
List microsoft.graph.tenantGovernanceServices.relatedTenant collection Get a list of the relatedTenant objects and their properties.
Get microsoft.graph.tenantGovernanceServices.relatedTenant Read the properties of a relatedTenant object.
Refresh None Trigger a refresh operation to update the list of related tenants.
Refresh status microsoft.graph.tenantGovernanceServices.relatedTenantsRefreshStatus Check the status of a related tenants refresh operation.

Properties

Property Type Description
createdDateTime DateTimeOffset The date and time when the related tenant was discovered. The timestamp type represents date and time information using ISO 8601 format and is always in UTC.
id String The Microsoft Entra tenant ID of the related tenant. Inherited from entity.

Relationships

Relationship Type Description
appB2BSignInActivityMetrics microsoft.graph.tenantGovernanceServices.b2BSignInActivityMetrics B2B sign-in activity metrics for this related tenant. Expanded by default.
b2BRegistrationMetrics microsoft.graph.tenantGovernanceServices.b2bRegistrationMetrics B2B registration metrics for this related tenant. Expanded by default.
b2BSignInActivityMetrics microsoft.graph.tenantGovernanceServices.b2BSignInActivityMetrics B2B sign-in activity metrics for this related tenant. Expanded by default.
billingMetrics microsoft.graph.tenantGovernanceServices.billingMetrics Billing metrics for this related tenant. Expanded by default.
multiTenantApplicationMetrics microsoft.graph.tenantGovernanceServices.multiTenantApplicationMetrics Multi-tenant application usage metrics for this related tenant. Expanded by default.

JSON representation

The following JSON representation shows the resource type.

{
  "@odata.type": "#microsoft.graph.tenantGovernanceServices.relatedTenant",
  "id": "String (identifier)",
  "createdDateTime": "String (timestamp)"
}