RecordsManagement.Read.All

Allows the application to read any data from Records Management, such as configuration, labels, and policies on behalf of the signed-in user.

Graph Methods

Type: A = Application Permission, D = Delegate Permission

Ver	Type	Method
V1	D	GET /security/labels/retentionLabels
V1	D	GET /security/labels/retentionLabels/{retentionLabelId}
V1	D	GET /security/labels/retentionLabels/{retentionLabelId}/eventType
V1	D	GET /security/triggers/retentionEvents
V1	D	GET /security/triggers/retentionEvents/{retentionEventId}
V1	D	GET /security/triggers/retentionEvents/{retentionEventId}/labels/{retentionLabelId}
V1	D	GET /security/triggers/retentionEvents/{retentionEventId}/retentionEventType
V1	D	GET /security/triggerTypes/retentionEventTypes
V1	D	GET /security/triggerTypes/retentionEventTypes/{retentionEventTypeId}

Delegate Permission

Id	07f995eb-fc67-4522-ad66-2b8ca8ea3efd
Consent Type	Admin
Display String	Read Records Management configuration, labels, and policies
Description	Allows the application to read any data from Records Management, such as configuration, labels, and policies on behalf of the signed-in user.

Application Permission

Id	ac3a2b8e-03a3-4da9-9ce0-cbe28bf1accd
Display String	Read Records Management configuration, labels and policies
Description	Allows the application to read any data from Records Management, such as configuration, labels, and policies without the signed in user.

Resources

retentionEvent

Property	Type	Description
createdBy	microsoft.graph.identitySet	The user who created the retentionEvent.
createdDateTime	DateTimeOffset	The date time when the retentionEvent was created.
description	String	Optional information about the event.
displayName	String	Name of the event.
eventPropagationResult	microsoft.graph.security.eventPropagationResult	Represents the success status of a created event and additional information.
eventQueries	microsoft.graph.security.eventQueries collection	Represents the workload (SharePoint Online, OneDrive for Business, Exchange Online) and identification information associated with a retention event.
retentionEventStatus	microsoft.graph.security.retentionEventStatus collection	Status of event propogation to the scoped locations after the event has been created.
eventTriggerDateTime	DateTimeOffset	Optional time when the event should be triggered.
id	String	Represents the unique ID of the user who created the retentionEvent. entity.
lastModifiedBy	microsoft.graph.identitySet	The user who last modified the retentionEvent.
lastModifiedDateTime	DateTimeOffset	The latest date time when the retentionEvent was modified.
lastStatusUpdateDateTime	DateTimeOffset	Last time the status of the event was updated.

retentionEventType

Property	Type	Description
createdBy	microsoft.graph.identitySet	The user who created the retentionEventType.
createdDateTime	DateTimeOffset	The date time when the retentionEventType was created.
description	String	Optional information about the event type.
displayName	String	Name of the event type.
id	String	Represents the unique ID of the user who created the retentionEventType. entity.
lastModifiedBy	microsoft.graph.identitySet	The user who last modified the retentionEventType.
lastModifiedDateTime	DateTimeOffset	The latest date time when the retentionEventType was modified.

retentionLabel

Property	Type	Description
actionAfterRetentionPeriod	microsoft.graph.security.actionAfterRetentionPeriod	Specifies the action to take on a document with this label applied during the retention period. The possible values are: none, delete, startDispositionReview, unknownFutureValue.
behaviorDuringRetentionPeriod	microsoft.graph.security.behaviorDuringRetentionPeriod	Specifies how the behavior of a document with this label should be during the retention period. The possible values are: doNotRetain, retain, retainAsRecord, retainAsRegulatoryRecord, unknownFutureValue.
createdBy	microsoft.graph.identitySet	Represents the user who created the retentionLabel.
createdDateTime	DateTimeOffset	Represents the date and time in which the retentionLabel is created.
descriptionForAdmins	String	Provides label information for the admin. Optional.
descriptionForUsers	String	Provides the label information for the user. Optional.
displayName	String	Unique string that defines a label name.
dispositionReviewStages	microsoft.graph.security.dispositionReviewStage collection	Review stages during which reviewers are notified to determine whether a document must be deleted or retained.
id	String	Unique ID of the retentionLabel. entity.
isInUse	Boolean	Specifies whether the label is currently being used.
lastModifiedBy	microsoft.graph.identitySet	The user who last modified the retentionLabel.
lastModifiedDateTime	DateTimeOffset	The latest date time when the retentionLabel was modified.
retentionDuration	microsoft.graph.security.retentionDuration	Specifies the number of days to retain the content.
retentionTrigger	microsoft.graph.security.retentionTrigger	Specifies whether the retention duration is calculated from the content creation date, labeled date, or last modification date. The possible values are: dateLabeled, dateCreated, dateModified, dateOfEvent, unknownFutureValue.
defaultRecordBehavior	microsoft.graph.security.defaultRecordBehavior	Specifies the locked or unlocked state of a record label when it is created.The possible values are: startLocked, startUnlocked, unknownFutureValue.
labelToBeApplied	String	Specifies the replacement label to be applied automatically after the retention period of the current label ends.