custodian resource type
Namespace: microsoft.graph.ediscovery
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.
In the context of eDiscovery, represents a user and all of their digital assets, such as email and documents.
Methods
Method | Return type | Description |
---|---|---|
List custodians | microsoft.graph.ediscovery.custodian collection | Get a list of custodian objects and their properties. |
Create custodian | microsoft.graph.ediscovery.custodian | Create a new custodian object. |
Get custodian | microsoft.graph.ediscovery.custodian | Read the properties and relationships of a custodian object. |
Update custodian | microsoft.graph.ediscovery.custodian | Update the properties of a custodian object. |
release | None | Release a custodian from a case. |
activate | None | Reactivate a custodian that has been released from a case and make them part of the case again. |
List siteSources | microsoft.graph.ediscovery.siteSource collection | Get the siteSource resources associated with the custodian. |
Create siteSources | microsoft.graph.ediscovery.siteSource | Create a new siteSource object. |
List unifiedGroupSources | microsoft.graph.ediscovery.unifiedGroupSource collection | Get the list of unifiedGroupSource resources associated with the custodian. |
Create unifiedGroupSources | microsoft.graph.ediscovery.unifiedGroupSource | Create a new unifiedGroupSource object. |
List userSources | microsoft.graph.ediscovery.userSource collection | Get the list of userSource resources associated with the custodian. |
Create userSources | microsoft.graph.ediscovery.userSource | Create a new userSource object. |
Properties
Property | Type | Description |
---|---|---|
acknowledgedDateTime | DateTimeOffset | Date and time the custodian acknowledged a hold notification. |
applyHoldToSources | Boolean | Identifies whether a custodian's sources were placed on hold during creation. |
createdDateTime | DateTimeOffset | Date and time when the custodian was added to the case. |
displayName | String | Display name of the custodian. |
String | Email address of the custodian. | |
id | String | The ID for the custodian in the specified case. Read-only. |
lastModifiedDateTime | DateTimeOffset | Date and time the custodian object was last modified |
releasedDateTime | DateTimeOffset | Date and time the custodian was released from the case. |
status | microsoft.graph.ediscovery.custodianStatus | Status of the custodian. Possible values are: active , released . |
custodianStatus values
Member | Description |
---|---|
active | Custodian is an active part of the case. |
released | Custodian is released from the case. |
Relationships
Relationship | Type | Description |
---|---|---|
siteSources | microsoft.graph.ediscovery.siteSource collection | Data source entity for SharePoint sites associated with the custodian. |
unifiedGroupSources | microsoft.graph.ediscovery.unifiedGroupSource collection | Data source entity for groups associated with the custodian. |
userSources | microsoft.graph.ediscovery.userSource collection | Data source entity for a the custodian. This is the container for a custodian's mailbox and OneDrive for Business site. |
JSON representation
The following is a JSON representation of the resource.
{
"@odata.type": "#microsoft.graph.ediscovery.custodian",
"email": "String",
"applyHoldToSources": "Boolean",
"status": "String",
"createdDateTime": "String (timestamp)",
"lastModifiedDateTime": "String (timestamp)",
"releasedDateTime": "String (timestamp)",
"acknowledgedDateTime": "String (timestamp)",
"id": "String (identifier)",
"displayName": "String"
}
Feedback
https://aka.ms/ContentUserFeedback.
Coming soon: Throughout 2024 we will be phasing out GitHub Issues as the feedback mechanism for content and replacing it with a new feedback system. For more information see:Submit and view feedback for