Show / Hide Table of Contents

ManagedTenants.ReadWrite.All

Allows the app to read and write all managed tenant information on behalf of the signed-in user.

Graph Methods

Type: A = Application Permission, D = Delegate Permission

Ver Type Method
V1 D GET /tenantRelationships/managedTenants/managementActions
V1 D GET /tenantRelationships/managedTenants/managementActions/{managementActionId}
V1 D GET /tenantRelationships/managedTenants/managementActionTenantDeploymentStatuses
V1 D GET /tenantRelationships/managedTenants/managementActionTenantDeploymentStatuses/{managementActionTenantDeploymentStatusId}
V1 D GET /tenantRelationships/managedTenants/managementIntents
V1 D GET /tenantRelationships/managedTenants/managementIntents/{managementIntentId}
V1 D GET /tenantRelationships/managedTenants/managementTemplates
V1 D GET /tenantRelationships/managedTenants/managementTemplates/{managementTemplateId}
V1 D GET /tenantRelationships/managedTenants/myRoles
V1 D GET /tenantRelationships/managedTenants/tenantGroups
V1 D GET /tenantRelationships/managedTenants/tenantGroups/{tenantGroupId}
V1 D GET /tenantRelationships/managedTenants/tenants
V1 D GET /tenantRelationships/managedTenants/tenants/{tenantId}
V1 D GET /tenantRelationships/managedTenants/tenantsCustomizedInformation
V1 D GET /tenantRelationships/managedTenants/tenantsCustomizedInformation/{tenantCustomizedInformationId}
V1 D GET /tenantRelationships/managedTenants/tenantsDetailedInformation
V1 D GET /tenantRelationships/managedTenants/tenantsDetailedInformation/{tenantDetailedInformationId}
V1 D GET /tenantRelationships/managedTenants/tenantUsage
V1 D PATCH /tenantRelationships/managedTenants/tenantsCustomizedInformation/{tenantCustomizedInformationId}
V1 D POST /tenantRelationships/managedTenants/managementActions/{managementActionId}/apply
V1 D POST /tenantRelationships/managedTenants/managementActionTenantDeploymentStatuses/changeDeploymentStatus
V1 D POST /tenantRelationships/managedTenants/tenantGroups/tenantSearch
V1 D POST /tenantRelationships/managedTenants/tenants/{tenantId}/offboardTenant
V1 D POST /tenantRelationships/managedTenants/tenants/{tenantId}/resetTenantOnboardingStatus

Delegate Permission

Id b31fa710-c9b3-4d9e-8f5e-8036eecddab9
Consent Type Admin
Display String Read and write all managed tenant information
Description Allows the app to read and write all managed tenant information on behalf of the signed-in user.

Resources

managedTenant

managementAction

Property Type Description
category managementCategory The category for the management action. Possible values are: custom, devices, identity, unknownFutureValue. Optional. Read-only.
description String The description for the management action. Optional. Read-only.
displayName String The display name for the management action. Optional. Read-only.
id String The unique identifier for the management action. Required. Read-only.
referenceTemplateId String The reference for the management template used to generate the management action. Required. Read-only.
workloadActions microsoft.graph.managedTenants.workloadAction collection The collection of workload actions associated with the management action. Required. Read-only.

managementActionDeploymentStatus

Property Type Description
managementActionId String The identifier for the management action. Required. Read-only.
managementTemplateId String The management template identifier that was used to generate the management action. Required. Read-only.
status managementActionStatus The status of the management action. Possible values are: toAddress, completed, error, timeOut, inProgress, planned, resolvedBy3rdParty, resolvedThroughAlternateMitigation, riskAccepted, unknownFutureValue. Required.
workloadActionDeploymentStatuses microsoft.graph.managedTenants.workloadActionDeploymentStatus collection The collection of workload action deployment statues for the given management action. Optional.

managementActionTenantDeploymentStatus

Property Type Description
id String The unique identifier for the tenant level deployment status. Required. Read-only.
statuses microsoft.graph.managedTenants.managementActionDeploymentStatus collection The collection of deployment status for each instance of a management action. Optional.
tenantGroupId String The identifier for the tenant group that is associated with the management action. Required. Read-only.
tenantId String The Azure Active Directory tenant identifier for the managed tenant. Required. Read-only.

managementIntent

Property Type Description
displayName String The display name for the management intent. Optional. Read-only.
id String The unique identifier for the management intent. Required. Read-only.
isGlobal Boolean A flag indicating whether the management intent is global. Required. Read-only.
managementTemplates microsoft.graph.managedTenants.managementTemplateDetailedInfo collection The collection of management templates associated with the management intent. Optional. Read-only.

managementTemplate

Property Type Description
category managementCategory The management category for the management template. Possible values are: custom, devices, identity, unknownFutureValue. Required. Read-only.
description String The description for the management template. Optional. Read-only.
displayName String The display name for the management template. Required. Read-only.
id String The unique identifier for the management template. Required. Read-only.
parameters microsoft.graph.managedTenants.templateParameter collection The collection of parameters used by the management template. Optional. Read-only.
workloadActions microsoft.graph.managedTenants.workloadAction collection The collection of workload actions associated with the management template. Optional. Read-only.

myRole

Property Type Description
assignments microsoft.graph.managedTenants.roleAssignment collection A collection of role assignments for the managed tenant.
tenantId String The Azure Active Directory tenant identifier for the managed tenant. Optional. Read-only.

tenant

Property Type Description
contract microsoft.graph.managedTenants.tenantContract The relationship details for the tenant with the managing entity.
createdDateTime DateTimeOffset The date and time the tenant was created in the multi-tenant management platform. Optional. Read-only.
displayName String The display name for the tenant. Required. Read-only.
id String The Azure Active Directory tenant identifier for the tenant. Required. Read-only.
lastUpdatedDateTime DateTimeOffset The date and time the tenant was last updated within the multi-tenant management platform. Optional. Read-only.
tenantId String The Azure Active Directory tenant identifier for the managed tenant. Optional. Read-only.
tenantStatusInformation microsoft.graph.managedTenants.tenantStatusInformation The onboarding status information for the tenant. Optional. Read-only.

tenantContactInformation

Property Type Description
email String The email address for the contact. Optional
name String The name for the contact. Required.
notes String The notes associated with the contact. Optional
phone String The phone number for the contact. Optional.
title String The title for the contact. Required.

tenantCustomizedInformation

Property Type Description
contacts microsoft.graph.managedTenants.tenantContactInformation collection The collection of contacts for the managed tenant. Optional.
displayName String The display name for the managed tenant. Required. Read-only.
id String The Azure Active Directory tenant identifier for the managed tenant. Required. Read-only.
tenantId String The Azure Active Directory tenant identifier for the managed tenant. Optional. Read-only.
website String The website for the managed tenant. Required.

tenantDetailedInformation

Property Type Description
city String The city where the managed tenant is located. Optional. Read-only.
countryCode String The code for the country where the managed tenant is located. Optional. Read-only.
countryName String The name for the country where the managed tenant is located. Optional. Read-only.
defaultDomainName String The default domain name for the managed tenant. Optional. Read-only.
displayName String The display name for the managed tenant.
id String The unique identifier for this entity. Required. Read-only.
industryName String The business industry associated with the managed tenant. Optional. Read-only.
region String The region where the managed tenant is located. Optional. Read-only.
segmentName String The business segment associated with the managed tenant. Optional. Read-only.
tenantId String The Azure Active Directory tenant identifier for the managed tenant.
verticalName String The vertical associated with the managed tenant. Optional. Read-only.

tenantGroup

Property Type Description
allTenantsIncluded Boolean A flag indicating whether all managed tenant are included in the tenant group. Required. Read-only.
displayName String The display name for the tenant group. Optional. Read-only.
id String The unique identifier for the tenant group. Required. Read-only.
managementActions microsoft.graph.managedTenants.managementActionInfo collection The collection of management action associated with the tenant group. Optional. Read-only.
managementIntents microsoft.graph.managedTenants.managementIntentInfo collection The collection of management intents associated with the tenant group. Optional. Read-only.
tenantIds String collection The collection of managed tenant identifiers include in the tenant group. Optional. Read-only.

tenantUsage

Property Type Description
id String The unique identifier for the tenant. Required. Read-only.
reportDateTime DateTimeOffset The day the report was generated for the previous month. Required. Read-only.
serviceUsages microsoft.graph.managedTenants.serviceUsage collection The number of monthly active users for each service in the tenant. Example services: Excel, Exchange, Intune, Outlook, Teams, Word. Required. Read-only.
tenantId String The Azure Active Directory tenant identifier for the managed tenant. Read-only.
totalActiveUsers Int32 The total number of unique, active users. Required. Read-only.
In This Article
Back to top Created by merill | Submit feedback