DelegatedAdminRelationship.Read.All
Allows the app to read details of delegated admin relationships with customers like access details (that includes roles) and the duration as well as specific role assignments to security groups without a signed-in user.
Permission Details
Read Delegated Admin relationships with customers
Allows the app to read details of delegated admin relationships with customers like access details (that includes roles) and the duration as well as specific role assignments to security groups without a signed-in user.
f6e9e124-4586-492f-adc0-c6f96e4823fd
Read Delegated Admin relationships with customers
Allows the app to read details of delegated admin relationships with customers like access details (that includes roles) and the duration as well as specific role assignments to security groups on behalf of the signed-in user.
0c0064ea-477b-4130-82a5-4c2cc4ff68aa
Properties
Properties is shown from stable Microsoft Graph v1.0 metadata.
| Property | Type | Description |
|---|---|---|
accessDetails |
delegatedAdminAccessDetails |
The access details that contain the identifiers of the administrative roles that the partner admin is requesting in the customer tenant. |
activatedDateTime |
DateTimeOffsetNullable |
The date and time in ISO 8601 format and in UTC time when the relationship became active. Read-only. |
autoExtendDuration |
DurationNullable |
The duration by which the validity of the relationship is automatically extended, denoted in ISO 8601 format. Supported values are: P0D, PT0S, P180D. The default value is PT0S. PT0S indicates that the relationship expires when the endDateTime is reached and it isn't automatically extended. |
createdDateTime |
DateTimeOffsetNullable |
The date and time in ISO 8601 format and in UTC time when the relationship was created. Read-only. |
customer |
delegatedAdminRelationshipCustomerParticipant |
The display name and unique identifier of the customer of the relationship. This is configured either by the partner at the time the relationship is created or by the system after the customer approves the relationship. Can't be changed by the customer. |
displayName |
String |
The display name of the relationship used for ease of identification. Must be unique across all delegated admin relationships of the partner and is set by the partner only when the relationship is in the created status and can't be changed by the customer. Maximum length is 50 characters. |
duration |
Duration |
The duration of the relationship in ISO 8601 format. Must be a value between P1D and P2Y inclusive. This is set by the partner only when the relationship is in the created status and can't be changed by the customer. |
endDateTime |
DateTimeOffsetNullable |
The date and time in ISO 8601 format and in UTC time when the status of relationship changes to either terminated or expired. Calculated as endDateTime = activatedDateTime + duration. Read-only. |
id |
String |
The unique identifier of the relationship. Read-only. Inherited from entity. |
lastModifiedDateTime |
DateTimeOffsetNullable |
The date and time in ISO 8601 format and in UTC time when the relationship was last modified. Read-only. |
status |
delegatedAdminRelationshipStatus |
The status of the relationship. Read Only. The possible values are: activating, active, approvalPending, approved, created, expired, expiring, terminated, terminating, terminationRequested, unknownFutureValue. Supports $orderby. |
accessAssignments |
delegatedAdminAccessAssignment collection |
The access assignments associated with the delegated admin relationship. |
operations |
delegatedAdminRelationshipOperation collection |
The long running operations associated with the delegated admin relationship. |
requests |
delegatedAdminRelationshipRequest collection |
The requests associated with the delegated admin relationship. |
JSON Representation
JSON representation is shown from stable Microsoft Graph v1.0 metadata.
{
"@odata.type": "#microsoft.graph.delegatedAdminRelationship",
"accessDetails": {
"@odata.type": "microsoft.graph.delegatedAdminAccessDetails"
},
"activatedDateTime": "String (timestamp)",
"autoExtendDuration": "String (duration)",
"createdDateTime": "String (timestamp)",
"customer": {
"@odata.type": "microsoft.graph.delegatedAdminRelationshipCustomerParticipant"
},
"displayName": "String",
"duration": "String (duration)",
"endDateTime": "String (timestamp)",
"id": "String (identifier)",
"lastModifiedDateTime": "String (timestamp)",
"status": "String"
}
Relationships
Relationships is shown from stable Microsoft Graph v1.0 metadata.
| Relationship | Type | Description |
|---|---|---|
accessAssignments |
delegatedAdminAccessAssignment collection |
The access assignments associated with the delegated admin relationship. |
operations |
delegatedAdminRelationshipOperation collection |
The long running operations associated with the delegated admin relationship. |
requests |
delegatedAdminRelationshipRequest collection |
The requests associated with the delegated admin relationship. |
accessDetails |
delegatedAdminAccessDetails |
Related accessDetails data exposed by this resource. |
Graph Methods
Microsoft Graph v1.0 endpoints are mapped directly from refreshed Microsoft Learn permissions tables.
Microsoft Graph beta endpoints are mapped directly from refreshed Microsoft Learn permissions tables.
Microsoft Graph PowerShell v1.0 commands are mapped directly from refreshed Microsoft Learn PowerShell snippets.
Microsoft Graph PowerShell beta commands are mapped directly from refreshed Microsoft Learn PowerShell snippets.
Code Examples
// Code snippets are only available for the latest version. Current version is 5.x
// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=csharp
var result = await graphClient.TenantRelationships.DelegatedAdminRelationships["{delegatedAdminRelationship-id}"].AccessAssignments["{delegatedAdminAccessAssignment-id}"].GetAsync();
const options = {
authProvider,
};
const client = Client.init(options);
let delegatedAdminAccessAssignment = await client.api('/tenantRelationships/delegatedAdminRelationships/72a7ae7e-4887-4e34-9755-2e1e9b26b943-63f017cb-9e0d-4f14-94bd-4871902b3409/accessAssignments/da9d6cf90-083a-47dc-ace2-1da98be3f344')
.get();
Import-Module Microsoft.Graph.Identity.Partner
Get-MgTenantRelationshipDelegatedAdminRelationshipAccessAssignment -DelegatedAdminRelationshipId $delegatedAdminRelationshipId -DelegatedAdminAccessAssignmentId $delegatedAdminAccessAssignmentId
# Code snippets are only available for the latest version. Current version is 1.x
from msgraph import GraphServiceClient
# To initialize your graph_client, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=python
result = await graph_client.tenant_relationships.delegated_admin_relationships.by_delegated_admin_relationship_id('delegatedAdminRelationship-id').access_assignments.by_delegated_admin_access_assignment_id('delegatedAdminAccessAssignment-id').get()
App Registration
Navigate to Azure Portal
Go to App registrations in Microsoft Entra admin center
Add API Permission
Select your app → API permissions → Add a permission → Microsoft Graph
Select Permission Type
Choose Application permissions or delegated permissions and search for DelegatedAdminRelationship.Read.All
Grant Admin Consent
Application permissions always require admin consent.