BackupRestore-Restore.ReadWrite.All

Allows the app to search the backup snapshots for Microsoft 365 resources, and restore Microsoft 365 resources from a backed-up snapshot, on behalf of the signed in user.

Merill's Note

For an app to access data in Microsoft Graph, the user or administrator must grant it the permissions it needs. This article lists all the Microsoft Graph APIs and your tenant data that can be accessed by the application (vendor/developer) if you consent to the BackupRestore-Restore.ReadWrite.All permission.

If you need to create an audit report of the permissions granted to all the apps in your tenant, you can run the Export-MsIdAppConsentGrantReport command. See How To: Run a quick OAuth app audit of your tenant

Category	Application	Delegated
Identifier	bebd0841-a3d8-4313-a51d-731112c8ee41	9f89e109-94b9-4c9b-b4fc-98cdaa54f574
DisplayText	Read restore all sessions and start restore sessions from backups	Read restore sessions and start restore sessions from backups
Description	Allows the app to search all backup snapshots for Microsoft 365 resources, and restore Microsoft 365 resources from a backed-up snapshot, without a signed-in user.	Allows the app to search the backup snapshots for Microsoft 365 resources, and restore Microsoft 365 resources from a backed-up snapshot, on behalf of the signed in user.
AdminConsentRequired	Yes	Yes

Graph Methods

→ API supports delegated access (access on behalf of a user)
→ API supports app-only access (access without a user)

	Methods
	DELETE /solutions/backupRestore/exchangeRestoreSessions/{exchangeRestoreSessionId}/mailboxRestoreArtifactsBulkAdditionRequests/{mailboxRestoreArtifactsBulkAdditionRequestId}
	DELETE /solutions/backupRestore/oneDriveForBusinessRestoreSessions/{oneDriveForBusinessRestoreSessionId}/driveRestoreArtifactsBulkAdditionRequests/{driveRestoreArtifactsBulkAdditionRequestId}
	DELETE /solutions/backupRestore/restoreSessions/{restoreSessionBaseId}
	DELETE /solutions/backupRestore/sharePointRestoreSessions/{sharePointRestoreSessionId}/siteRestoreArtifactsBulkAdditionRequests/{siteRestoreArtifactsBulkAdditionRequestId}
	GET /solutions/backupRestore/restoreSessions
	PATCH /solutions/backupRestore/exchangeRestoreSessions/{exchangeRestoreSessionId}
	PATCH /solutions/backupRestore/oneDriveForBusinessRestoreSessions/{oneDriveForBusinessRestoreSessionId}
	PATCH /solutions/backupRestore/sharePointRestoreSessions/{sharePointRestoreSessionId}
	POST /solutions/backupRestore/exchangeRestoreSessions
	POST /solutions/backupRestore/exchangeRestoreSessions/{exchangeRestoreSessionId}/mailboxRestoreArtifactsBulkAdditionRequests
	POST /solutions/backupRestore/oneDriveForBusinessRestoreSessions
	POST /solutions/backupRestore/oneDriveForBusinessRestoreSessions/{oneDriveForBusinessRestoreSessionId}/driveRestoreArtifactsBulkAdditionRequests
	POST /solutions/backupRestore/restoreSessions/{restoreSessionBaseId}/activate
	POST /solutions/backupRestore/sharePointRestoreSessions
	POST /solutions/backupRestore/sharePointRestoreSessions/{sharePointRestoreSessionId}/siteRestoreArtifactsBulkAdditionRequests

→ API supports delegated access (access on behalf of a user)
→ API supports app-only access (access without a user)

	Methods
	DELETE /solutions/backupRestore/exchangeRestoreSessions/{exchangeRestoreSessionId}/mailboxRestoreArtifactsBulkAdditionRequests/{mailboxRestoreArtifactsBulkAdditionRequestId}
	DELETE /solutions/backupRestore/oneDriveForBusinessRestoreSessions/{oneDriveForBusinessRestoreSessionId}/driveRestoreArtifactsBulkAdditionRequests/{driveRestoreArtifactsBulkAdditionRequestId}
	DELETE /solutions/backupRestore/restoreSessions/{restoreSessionBaseId}
	DELETE /solutions/backupRestore/sharePointRestoreSessions/{sharePointRestoreSessionId}/siteRestoreArtifactsBulkAdditionRequests/{siteRestoreArtifactsBulkAdditionRequestId}
	GET /solutions/backupRestore/browseSessions
	GET /solutions/backupRestore/oneDriveForBusinessBrowseSessions
	GET /solutions/backupRestore/oneDriveForBusinessBrowseSessions/{oneDriveForBusinessBrowseSessionId}
	GET /solutions/backupRestore/oneDriveForBusinessRestoreSessions/{oneDriveForBusinessRestoreSessionId}/granularDriveRestoreArtifacts
	GET /solutions/backupRestore/restorePoints?$expand=protectionUnit($filter=id eq '{ProtectionUnitID}')&$filter=protectionDateTime lt YYYY-MM-DDTHH:mm:ssZ
	GET /solutions/backupRestore/restoreSessions
	GET /solutions/backupRestore/sharePointBrowseSessions
	GET /solutions/backupRestore/sharePointBrowseSessions/{sharePointBrowseSessionId}
	GET /solutions/backupRestore/sharePointRestoreSessions/{sharePointRestoreSessionId}/granularSiteRestoreArtifacts
	PATCH /solutions/backupRestore/exchangeRestoreSessions/{exchangeRestoreSessionId}
	PATCH /solutions/backupRestore/oneDriveForBusinessRestoreSessions/{oneDriveForBusinessRestoreSessionId}
	PATCH /solutions/backupRestore/sharePointRestoreSessions/{sharePointRestoreSessionId}
	POST /solutions/backupRestore/exchangeRestoreSessions
	POST /solutions/backupRestore/exchangeRestoreSessions/{exchangeRestoreSessionId}/mailboxRestoreArtifactsBulkAdditionRequests
	POST /solutions/backupRestore/oneDriveForBusinessBrowseSessions
	POST /solutions/backupRestore/oneDriveForBusinessBrowseSessions/{oneDriveForBusinessBrowseSessionId}/browse
	POST /solutions/backupRestore/oneDriveForBusinessRestoreSessions
	POST /solutions/backupRestore/oneDriveForBusinessRestoreSessions/{oneDriveForBusinessRestoreSessionId}/driveRestoreArtifactsBulkAdditionRequests
	POST /solutions/backupRestore/restoreSessions/{restoreSessionBaseId}/activate
	POST /solutions/backupRestore/sharePointBrowseSessions
	POST /solutions/backupRestore/sharePointBrowseSessions/{sharePointBrowseSessionId}/browse
	POST /solutions/backupRestore/sharePointRestoreSessions
	POST /solutions/backupRestore/sharePointRestoreSessions/{sharePointRestoreSessionId}/siteRestoreArtifactsBulkAdditionRequests

→ Command supports delegated access (access on behalf of a user)
→ Command supports app-only access (access without a user)

	Commands
	Get-MgSolutionBackupRestoreSession
	Initialize-MgSolutionBackupRestoreSession
	New-MgSolutionBackupRestoreExchangeRestoreSession
	New-MgSolutionBackupRestoreExchangeRestoreSessionMailboxRestoreArtifactBulkAdditionRequest
	New-MgSolutionBackupRestoreOneDriveForBusinessRestoreSession
	New-MgSolutionBackupRestoreOneDriveForBusinessRestoreSessionDriveRestoreArtifactBulkAdditionRequest
	New-MgSolutionBackupRestoreSharePointRestoreSession
	New-MgSolutionBackupRestoreSharePointRestoreSessionSiteRestoreArtifactBulkAdditionRequest
	Remove-MgSolutionBackupRestoreExchangeRestoreSessionMailboxRestoreArtifactBulkAdditionRequest
	Remove-MgSolutionBackupRestoreOneDriveForBusinessRestoreSessionDriveRestoreArtifactBulkAdditionRequest
	Remove-MgSolutionBackupRestoreSession
	Remove-MgSolutionBackupRestoreSharePointRestoreSessionSiteRestoreArtifactBulkAdditionRequest
	Update-MgSolutionBackupRestoreExchangeRestoreSession
	Update-MgSolutionBackupRestoreOneDriveForBusinessRestoreSession
	Update-MgSolutionBackupRestoreSharePointRestoreSession

→ Command supports delegated access (access on behalf of a user)
→ Command supports app-only access (access without a user)

	Commands
	Get-MgBetaSolutionBackupRestoreBrowseSession
	Get-MgBetaSolutionBackupRestoreOneDriveForBusinessBrowseSession
	Get-MgBetaSolutionBackupRestoreOneDriveForBusinessRestoreSessionGranularDriveRestoreArtifact
	Get-MgBetaSolutionBackupRestorePoint
	Get-MgBetaSolutionBackupRestoreSession
	Get-MgBetaSolutionBackupRestoreSharePointBrowseSession
	Get-MgBetaSolutionBackupRestoreSharePointRestoreSessionGranularSiteRestoreArtifact
	Initialize-MgBetaSolutionBackupRestoreSession
	New-MgBetaSolutionBackupRestoreExchangeRestoreSession
	New-MgBetaSolutionBackupRestoreExchangeRestoreSessionMailboxRestoreArtifactBulkAdditionRequest
	New-MgBetaSolutionBackupRestoreOneDriveForBusinessBrowseSession
	New-MgBetaSolutionBackupRestoreOneDriveForBusinessRestoreSession
	New-MgBetaSolutionBackupRestoreOneDriveForBusinessRestoreSessionDriveRestoreArtifactBulkAdditionRequest
	New-MgBetaSolutionBackupRestoreSharePointBrowseSession
	New-MgBetaSolutionBackupRestoreSharePointRestoreSession
	New-MgBetaSolutionBackupRestoreSharePointRestoreSessionSiteRestoreArtifactBulkAdditionRequest
	Remove-MgBetaSolutionBackupRestoreExchangeRestoreSessionMailboxRestoreArtifactBulkAdditionRequest
	Remove-MgBetaSolutionBackupRestoreOneDriveForBusinessRestoreSessionDriveRestoreArtifactBulkAdditionRequest
	Remove-MgBetaSolutionBackupRestoreSession
	Remove-MgBetaSolutionBackupRestoreSharePointRestoreSessionSiteRestoreArtifactBulkAdditionRequest
	Update-MgBetaSolutionBackupRestoreExchangeRestoreSession
	Update-MgBetaSolutionBackupRestoreOneDriveForBusinessRestoreSession
	Update-MgBetaSolutionBackupRestoreSharePointRestoreSession

Resources

Granting this permission allows the calling application to access (and/or update) the following information in your tenant.

Graph reference: browseQueryResponseItem

Property	Type	Description
itemKey	String	Unique identifier of the returned item.
itemsCount	Int32	The count of items present within the items; for example, the count of files in a folder.
name	String	The name of the item.
sizeInBytes	String	The size of the item in bytes.
type	browseQueryResponseItemType	The type of the item. The possible values are: `none`, `site`, `documentLibrary`, `folder`, `file`, `unknownFutureValue`.
webUrl	String	The web URL of the item.

Graph reference: browseSessionBase

Property	Type	Description
backupSizeInBytes	String	The size of the backup in bytes.
createdDateTime	DateTimeOffset	The date and time when the browse session was created. The timestamp type represents date and time information using ISO 8601 format and is always in UTC. For example, midnight UTC on Jan 1, 2014 is `2014-01-01T00:00:00Z`.
error	publicError	Contains the error details if the browse session creation fails.
expirationDateTime	DateTimeOffset	The date and time after which the browse session is deleted automatically.
id	String	The unique identifier of the browse session. Inherited from entity.
restorePointDateTime	DateTimeOffset	The date and time of the restore point on which the browse session is created.
status	browseSessionStatus	The status of the browse session. The possible values are: `creating`, `created`, `failed`, `unknownFutureValue`.

Graph reference: driveRestoreArtifact

Property	Type	Description
id	String	The unique identifier of the restore artifact.
completionDateTime	DateTimeOffset	The time when restoration of restore artifact is completed. Inherited from restoreArtifactBase.
destinationType	destinationType	The restoration destination. Inherited from restoreArtifactBase. The possible values are: `new`, `inPlace`, `unknownFutureValue`.
error	publicError	Contains error details if the restoration fails. Inherited from restoreArtifactBase.
restoredSiteId	String	The new site identifier if destinationType is `new`, and the input site ID if the destinationType is `inPlace`.
restoredSiteName	String	The name of the restored site.
restoredSiteWebUrl	String	The web URL of the restored site.
startDateTime	DateTimeOffset	The time when the restoration started. Inherited from restoreArtifactBase.
status	artifactRestoreStatus	The individual restoration status of the restore artifact. Inherited from restoreArtifactBase. The possible values are: `added`, `scheduling`, `scheduled`, `inProgress`, `succeeded`, `failed`, `unknownFutureValue`.

Graph reference: driveRestoreArtifactsBulkAdditionRequest

Property	Type	Description
createdBy	identitySet	The identity of the person who created the bulk request. Inherited from restoreArtifactsBulkRequestBase.
createdDateTime	DateTimeOffset	The time when the bulk request was created. Inherited from restoreArtifactsBulkRequestBase.
destinationType	destinationType	Indicates the restoration destination. The possible values are: `new`, `inPlace`, `unknownFutureValue`. Inherited from restoreArtifactsBulkRequestBase.
directoryObjectIds	String collection	The list of directory object IDs that are added to the corresponding OneDrive for work or school restore session in a bulk operation.
displayName	String	Name of the addition request. Inherited from restoreArtifactsBulkRequestBase.
drives	String collection	The list of email addresses that are added to the corresponding OneDrive for work or school restore session in a bulk operation.
error	publicError	Error details are populated for resource resolution failures. Inherited from restoreArtifactsBulkRequestBase.
id	String	The unique identifier of the bulk request associated with the restore session. Inherited from restoreArtifactsBulkRequestBase.
lastModifiedBy	identitySet	Identity of the person who last modified this entity. Inherited from restoreArtifactsBulkRequestBase.
lastModifiedDateTime	DateTimeOffset	Timestamp when this entity was last modified. Inherited from restoreArtifactsBulkRequestBase.
protectionTimePeriod	timePeriod	The start and end date time of the protection period. Inherited from restoreArtifactsBulkRequestBase.
protectionUnitIds	String collection	Indicates which protection units to restore. This property isn't implemented yet. Future value; don't use. Inherited from restoreArtifactsBulkRequestBase.
restorePointPreference	restorePointPreference	Indicates which restore point to return. The possible values are: `oldest`, `latest`, `unknownFutureValue`. Inherited from restoreArtifactsBulkRequestBase.
status	restoreArtifactsBulkRequestStatus	The status of the long-running operation. The possible values are: `unknown`, `active`, `completed`, `completedWithErrors`, `unknownFutureValue`. Inherited from restoreArtifactsBulkRequestBase.
tags	restorePointTags	The type of the restore point. The possible values are: `none`, `fastRestore`, `unknownFutureValue`. Inherited from restoreArtifactsBulkRequestBase.

Graph reference: exchangeRestoreSession

Property	Type	Description
id	String	The unique identifier of the restore session created.
completedDateTime	DateTimeOffset	The time of creation of the restore session.
createdBy	identitySet	The identity of person who created the restore session.
createdDateTime	DateTimeOffset	The time of completion of the restore session.
error	publicError	Contains error details if the restore session fails or completes with an error.
lastModifiedBy	identitySet	Identity of the person who last modified this restore session.
lastModifiedDateTime	DateTimeOffset	Timestamp of last modification of this restore session.
restoreJobType	restoreJobType	Indicates whether the restore session was created normally or by a bulk job.
restoreSessionArtifactCount	restoreSessionArtifactCount	The number of metadata artifacts that belong to this restore session.
status	restoreSessionStatus	Status of the restore session. The value is an aggregated status of the restored artifacts. The possible values are: `draft`, `activating`, `active`, `completedWithError`, `completed`, `unknownFutureValue`, `failed`. Use the `Prefer: include-unknown-enum-members` request header to get the following members in this evolvable enum: `failed`.

Graph reference: granularDriveRestoreArtifact

Property	Type	Description
browseSessionId	String	The unique identifier of the browseSession. Inherited from granularRestoreArtifactBase.
completionDateTime	DateTimeOffset	Date time when the artifact's restoration completes. Inherited from granularRestoreArtifactBase.
id	String	The unique identifier for the artifact. Inherited from entity. Inherits from entity
restoredItemKey	String	The unique identifier for the restored artifact. Inherited from granularRestoreArtifactBase.
restoredItemPath	String	The path of the restored artifact. It's the path of the folder where all the artifacts are restored within a granular restore session. Inherited from granularRestoreArtifactBase.
restoredItemWebUrl	String	The web url of the restord artifact. Inherited from granularRestoreArtifactBase.
restorePointDateTime	DateTimeOffset	The restore point date time to which the artifact is restored. Inherited from granularRestoreArtifactBase.
startDateTime	DateTimeOffset	The start time of the restoration. Inherited from granularRestoreArtifactBase.
status	artifactRestoreStatus	Status of the artifact restoration. The possible values are: `added`, `scheduling`, `scheduled`, `inProgress`, `succeeded`, `failed`, `unknownFutureValue`. Inherited from granularRestoreArtifactBase.
webUrl	String	The original web url of the artifact being restored. Inherited from granularRestoreArtifactBase.
directoryObjectId	String	Id of the drive in which artifact is present.

Graph reference: granularMailboxRestoreArtifact

Property	Type	Description
artifactCount	Int32	This property will be deprecated soon. Don't use.
completionDateTime	DateTimeOffset	The time when the restoration of the artifact is completed. Inherited from restoreArtifactBase.
destinationType	destinationType	Indicates the restoration destination. Inherited from restoreArtifactBase. The possible values are: `new`, `inPlace`, `unknownFutureValue`.
error	publicError	Contains error details if the restoration of the artifact fails. Inherited from restoreArtifactBase.
id	String	The unique identifier of the restore artifact.
restoredFolderId	String	The new restored folder identifier for the user.
restoredFolderName	String	The new restored folder name.
restoredItemCount	Int32	The number of items that are being restored in the folder.
searchResponseId	String	.
startDateTime	DateTimeOffset	The time when the restoration of the artifact started. Inherited from restoreArtifactBase.
status	artifactRestoreStatus	The restoration status of the artifact. Inherited from restoreArtifactBase.The possible values are: `added`, `scheduling`, `scheduled`, `inProgress`, `succeeded`, `failed`, `unknownFutureValue`.

Graph reference: granularSiteRestoreArtifact

Property	Type	Description
browseSessionId	String	The unique identifier of the browseSession. Inherited from granularRestoreArtifactBase.
completionDateTime	DateTimeOffset	Date time when the artifact's restoration completes. Inherited from granularRestoreArtifactBase.
id	String	The unique identifier for the artifact. Inherited from entity. Inherits from entity
restoredItemKey	String	The unique identifier for the restored artifact. Inherited from granularRestoreArtifactBase.
restoredItemPath	String	The path of the restored artifact. It's the path of the folder where all the artifacts are restored within a granular restore session. Inherited from granularRestoreArtifactBase.
restoredItemWebUrl	String	The web url of the restord artifact. Inherited from granularRestoreArtifactBase.
restorePointDateTime	DateTimeOffset	The restore point date time to which the artifact is restored. Inherited from granularRestoreArtifactBase.
startDateTime	DateTimeOffset	The start time of the restoration. Inherited from granularRestoreArtifactBase.
status	artifactRestoreStatus	Status of the artifact restoration. The possible values are: `added`, `scheduling`, `scheduled`, `inProgress`, `succeeded`, `failed`, `unknownFutureValue`. Inherited from granularRestoreArtifactBase.
webUrl	String	The original web url of the artifact being restored. Inherited from granularRestoreArtifactBase.
siteId	String	Id of the site in which artifact is present.

Graph reference: mailboxRestoreArtifact

Property	Type	Description
id	String	The unique identifier of the restore artifact.
completionDateTime	DateTimeOffset	The time when the restoration of the artifact is completed. Inherited from restoreArtifactBase.
destinationType	destinationType	Indicates the restoration destination. Inherited from restoreArtifactBase. The possible values are: `new`, `inPlace`, `unknownFutureValue`.
error	publicError	Contains error details if the restoration of the artifact fails. Inherited from restoreArtifactBase.
restoredFolderId	String	The new restored folder identifier for the user.
restoredFolderName	String	The new restored folder name.
restoredItemCount	Int32	The number of items that are being restored in the folder.
startDateTime	DateTimeOffset	The time when the restoration of the artifact started. Inherited from restoreArtifactBase.
status	artifactRestoreStatus	The restoration status of the artifact. Inherited from restoreArtifactBase. The possible values are: `added`, `scheduling`, `scheduled`, `inProgress`, `succeeded`, `failed`, `unknownFutureValue`.

Graph reference: mailboxRestoreArtifactsBulkAdditionRequest

Property	Type	Description
createdBy	identitySet	The identity of the person who created the bulk request. Inherited from restoreArtifactsBulkRequestBase.
createdDateTime	DateTimeOffset	The time when the bulk request was created. Inherited from restoreArtifactsBulkRequestBase.
destinationType	destinationType	Indicates the restoration destination. The possible values are: `new`, `inPlace`, `unknownFutureValue`. Inherited from restoreArtifactsBulkRequestBase.
directoryObjectIds	String collection	The list of directory object IDs that are added to the corresponding Exchange restore session in a bulk operation.
displayName	String	Name of the addition request. Inherited from restoreArtifactsBulkRequestBase.
error	publicError	Error details are populated for resource resolution failures. Inherited from restoreArtifactsBulkRequestBase.
id	String	The unique identifier of the bulk request associated with the restore session. Inherited from restoreArtifactsBulkRequestBase.
lastModifiedBy	identitySet	Identity of the person who last modified this entity. Inherited from restoreArtifactsBulkRequestBase.
lastModifiedDateTime	DateTimeOffset	Timestamp when this entity was last modified. Inherited from restoreArtifactsBulkRequestBase.
mailboxes	String collection	The list of email addresses that are added to the corresponding Exchange restore session in a bulk operation.
protectionTimePeriod	timePeriod	The start and end date time of the protection period. Inherited from restoreArtifactsBulkRequestBase.
protectionUnitIds	String collection	Indicates which protection units to restore. This property isn't implemented yet. Future value; don't use. Inherited from restoreArtifactsBulkRequestBase.
restorePointPreference	restorePointPreference	Indicates which restore point to return. The possible values are: `oldest`, `latest`, `unknownFutureValue`. Inherited from restoreArtifactsBulkRequestBase.
status	restoreArtifactsBulkRequestStatus	The status of the long-running operation. The possible values are: `unknown`, `active`, `completed`, `completedWithErrors`, `unknownFutureValue`. Inherited from restoreArtifactsBulkRequestBase.
tags	restorePointTags	The type of the restore point. The possible values are: `none`, `fastRestore`, `unknownFutureValue`. Inherited from restoreArtifactsBulkRequestBase.

Graph reference: oneDriveForBusinessBrowseSession

Property	Type	Description
backupSizeInBytes	String	The size of the backup in bytes.
createdDateTime	DateTimeOffset	The time of the creation of the browse session.
error	publicError	Contains the error details if the browse session creation fails.
expirationDateTime	DateTimeOffset	The time after which the browse session is deleted automatically.
id	String	The unique identifier of the browse session. Inherited from entity. Inherits from entity
restorePointDateTime	DateTimeOffset	The date time of the restore point on which browse session is created.
status	browseSessionStatus	The status of the browse session. The possible values are: `creating`, `created`, `failed`, `unknownFutureValue`.
directoryObjectId	String	Id of the backed-up OneDrive.

Graph reference: oneDriveForBusinessRestoreSession

Property	Type	Description
id	String	The unique identifier of the restore session created.
completedDateTime	DateTimeOffset	The time of creation of the restore session.
createdBy	identitySet	The identity of person who created the restore session.
createdDateTime	DateTimeOffset	The time of completion of the restore session.
error	publicError	Contains error details if the restore session fails or completes with an error.
lastModifiedBy	identitySet	Identity of the person who last modified this restore session.
lastModifiedDateTime	DateTimeOffset	Timestamp of the last modification of this restore session.
status	restoreSessionStatus	Status of the restore session. The value is an aggregated status of the restored artifacts. The possible values are: `draft`, `activating`, `active`, `completedWithError`, `completed`, `unknownFutureValue`, `failed`. You must use the `Prefer: include-unknown-enum-members` request header to get the following members in this evolvable enum: `failed`.
restoreJobType	restoreJobType	Indicates whether the restore session was created normally or by a bulk job.
restoreSessionArtifactCount	restoreSessionArtifactCount	The number of metadata artifacts that belong to this restore session.

Graph reference: protectionUnitBase

Property	Type	Description
createdBy	identitySet	The identity of the person who created the protection unit.
createdDateTime	DateTimeOffset	The time of creation of the protection unit. The timestamp type represents date and time information using ISO 8601 format and is always in UTC. For example, midnight UTC on Jan 1, 2014 is `2014-01-01T00:00:00Z`.
error	publicError	Contains error details if an error occurred while creating a protection unit.
id	String	The unique identifier of the protection unit. Inherited from entity.
lastModifiedBy	identitySet	The identity of person who last modified the protection unit.
lastModifiedDateTime	DateTimeOffset	Timestamp of the last modification of this protection unit. The timestamp type represents date and time information using ISO 8601 format and is always in UTC. For example, midnight UTC on Jan 1, 2014 is `2014-01-01T00:00:00Z`.
offboardRequestedDateTime	DateTimeOffset	The date and time when protection unit offboard was requested. The timestamp type represents date and time information using ISO 8601 format and is always in UTC. For example, midnight UTC on Jan 1, 2014 is `2014-01-01T00:00:00Z`.
policyId	String	The unique identifier of the protection policy based on which protection unit was created.
protectionSources	protectionSource	Indicates the sources by which a protection unit is currently protected. A protection unit protected by multiple sources is indicated by comma-separated values. The possible values are: `none`, `manual`, `dynamicRule`, `unknownFutureValue`.
status	protectionUnitStatus	The status of the protection unit. The possible values are: `protectRequested`, `protected`, `unprotectRequested`, `unprotected`, `removeRequested`, `unknownFutureValue`, `offboardRequested`, `offboarded`, `cancelOffboardRequested`. Use the `Prefer: include-unknown-enum-members` request header to get the following values from this evolvable enum: `offboardRequested`, `offboarded`, `cancelOffboardRequested`.

Graph reference: restorePoint

Property	Type	Description
id	String	ID of the restore point.
protectionDateTime	DateTimeOffset	Date time when the restore point was created.
expirationDateTime	DateTimeOffset	Expiration date time of the restore point.
tags	restorePointTags	The type of the restore point. The possible values are: `none`, `fastRestore`, `unknownFutureValue`.

Graph reference: restoreSessionBase

Property	Type	Description
id	String	The unique identifier of the restore session.
completedDateTime	DateTimeOffset	The time of completion of the restore session.
createdBy	identitySet	The identity of person who created the restore session.
createdDateTime	DateTimeOffset	The time of creation of the restore session.
error	publicError	Contains error details if the restore session fails or completes with an error.
lastModifiedBy	identitySet	Identity of the person who last modified the restore session.
lastModifiedDateTime	DateTimeOffset	Timestamp of the last modification of the restore session.
restoreJobType	restoreJobType	Indicates whether the restore session was created normally or by a bulk job.
restoreSessionArtifactCount	restoreSessionArtifactCount	The number of metadata artifacts that belong to this restore session.
status	restoreSessionStatus	Status of the restore session. The value is an aggregated status of the restored artifacts. The possible values are: `draft`, `activating`, `active`, `completedWithError`, `completed`, `unknownFutureValue`, `failed`. Use the `Prefer: include-unknown-enum-members` request header to get the following members in this evolvable enum: `failed`.

Graph reference: sharePointBrowseSession

Property	Type	Description
backupSizeInBytes	String	The size of the backup in bytes.
createdDateTime	DateTimeOffset	The time of the creation of the browse session.
error	publicError	Contains the error details if the browse session creation fails.
expirationDateTime	DateTimeOffset	The time after which the browse session is deleted automatically.
id	String	The unique identifier of the browse session. Inherited from entity. Inherits from entity
restorePointDateTime	DateTimeOffset	The date time of the restore point on which browse session is created.
status	browseSessionStatus	The status of the browse session. The possible values are: `creating`, `created`, `failed`, `unknownFutureValue`.
siteId	String	Id of the backed-up SharePoint site.

Graph reference: sharePointRestoreSession

Property	Type	Description
id	String	The unique identifier of the restore session.
completedDateTime	DateTimeOffset	The time of creation of the restore session.
createdBy	identitySet	The identity of person who created the restore session.
createdDateTime	DateTimeOffset	The time of completion of the restore session.
error	publicError	Contains error details if the restore session fails or is completed with error.
lastModifiedBy	identitySet	Identity of the person who last modified this restore session.
lastModifiedDateTime	DateTimeOffset	Timestamp of last modification of this restore session.
restoreJobType	restoreJobType	Indicates whether the restore session was created normally or by a bulk job.
restoreSessionArtifactCount	restoreSessionArtifactCount	The number of metadata artifacts that belong to this restore session.
status	restoreSessionStatus	Status of the restore session. The value is an aggregated status of restore artifacts. The possible values are: `draft`, `activating`, `active`, `completedWithError`, `completed`, `unknownFutureValue`, `failed`. You must use the `Prefer: include-unknown-enum-members` request header to get the following members in this evolvable enum: `failed`.

Graph reference: siteRestoreArtifact

Property	Type	Description
id	String	The unique identifier of the restore artifact.
completionDateTime	DateTimeOffset	The time when restoration of restore artifact is completed. Inherited from restoreArtifactBase.
destinationType	destinationType	Indicates the restoration destination. Inherited from restoreArtifactBase. The possible values are: `new`, `inPlace`, `unknownFutureValue`.
error	publicError	Contains error details if the restoration of the restore artifact fails. Inherited from restoreArtifactBase.
restoredSiteId	String	The new site identifier if the value of the destinationType property is `new`, and the existing site ID if the value is `inPlace`.
restoredSiteName	String	The name of the restored site.
restoredSiteWebUrl	String	The web URL of the restored site.
startDateTime	DateTimeOffset	The time when restoration of the restore artifact started. Inherited from restoreArtifactBase.
status	artifactRestoreStatus	The restoration status of the restore artifact. Inherited from restoreArtifactBase. The possible values are: `added`, `scheduling`, `scheduled`, `inProgress`, `succeeded`, `failed`, `unknownFutureValue`.

Graph reference: siteRestoreArtifactsBulkAdditionRequest

Property	Type	Description
createdBy	identitySet	The identity of the person who created the bulk request. Inherited from restoreArtifactsBulkRequestBase.
createdDateTime	DateTimeOffset	The time when the bulk request was created. Inherited from restoreArtifactsBulkRequestBase.
destinationType	destinationType	Indicates the restoration destination. The possible values are: `new`, `inPlace`, `unknownFutureValue`. Inherited from restoreArtifactsBulkRequestBase.
displayName	String	Name of the addition request. Inherited from restoreArtifactsBulkRequestBase.
error	publicError	Error details are populated for resource resolution failures. Inherited from restoreArtifactsBulkRequestBase.
id	String	The unique identifier of the bulk request associated with the restore session. Inherited from restoreArtifactsBulkRequestBase.
lastModifiedBy	identitySet	Identity of the person who last modified this entity. Inherited from restoreArtifactsBulkRequestBase.
lastModifiedDateTime	DateTimeOffset	Timestamp when this entity was last modified. Inherited from restoreArtifactsBulkRequestBase.
protectionTimePeriod	timePeriod	The start and end date time of the protection period. Inherited from restoreArtifactsBulkRequestBase.
protectionUnitIds	String collection	Indicates which protection units to restore. This property isn't implemented yet. Future value; don't use. Inherited from restoreArtifactsBulkRequestBase.
restorePointPreference	restoreArtifactsBulkRequestStatus	Indicates which restore point to return. The possible values are `oldest`, `latest`, `unknownFutureValue`. Inherited from restoreArtifactsBulkRequestBase.
siteIds	String collection	The list of SharePoint site IDs that are added to the corresponding SharePoint restore session in a bulk operation.
siteWebUrls	String collection	The list of SharePoint site URLs that are added to the corresponding SharePoint restore session in a bulk operation.
status	RestoreArtifactsBulkRequestStatus	The status of the long-running operation. The possible values are: `unknown`, `active`, `completed`, `completedWithErrors`, `unknownFutureValue`. Inherited from restoreArtifactsBulkRequestBase.
tags	restorePointTags	The type of the restore point. The possible values are: `none`, `fastRestore`, `unknownFutureValue`. Inherited from restoreArtifactsBulkRequestBase.

Table of Contents

BackupRestore-Restore.ReadWrite.All

Graph Methods

Resources