delegatedAdminRelationship resource type

Namespace: microsoft.graph

Represents a delegated admin relationship between a partner and customer.

Methods

Method	Return type	Description
Create	delegatedAdminRelationship	Create a new delegatedAdminRelationship object.
List	delegatedAdminRelationship collection	Get a list of the delegatedAdminRelationship objects and their properties.
Get	delegatedAdminRelationship	Read the properties and relationships of a delegatedAdminRelationship object.
Update	delegatedAdminRelationship	Update the properties of a delegatedAdminRelationship object.
Delete	None	Delete a delegatedAdminRelationship object.

Properties

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	DateTimeOffset	The date and time in ISO 8601 format and in UTC time when the relationship became active. Read-only.
autoExtendDuration	Duration	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	DateTimeOffset	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	DateTimeOffset	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	DateTimeOffset	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.

delegatedAdminRelationshipStatus values

Member	Description
created	The partner has created a new relationship. In this state, the relationship can be modified.
approvalPending	The partner has finalized the relationship through the lockForApproval action of a delegatedAdminRelationshipRequest object.
approved	The customer has approved the relationship through the approve action of a delegatedAdminRelationshipRequest object.
activating	The system starts provisioning of the relationship.
active	The system completes the provisioning of the relationship.
expiring	The relationship has passed its expiration date.
expired	The system completes the deprovisioning of the relationship.
terminationRequested	The partner or customer has requested termination of the relationship through the terminate action of a delegatedAdminRelationshipRequest object.
terminating	The system starts deprovisioning the relationship.
terminated	The system has completed deprovisioning the relationship.
unknownFutureValue	Evolvable enumeration sentinel value. Don't use.

Relationships

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.

JSON representation

The following JSON representation shows the resource type.

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