BackupRestore-Search.Read.All

Allows the app to search the backup snapshots for Microsoft 365 resources, 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-Search.Read.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	f6135c51-c766-4be1-9638-ed90c2ed2443	2b24830f-f435-446f-ab5a-b1e70d9a2eb5
DisplayText	Search for metadata properties in all backup snapshots	Search for metadata properties in backup snapshots
Description	Allows the app to search all backup snapshots for Microsoft 365 resources, without a signed-in user.	Allows the app to search the backup snapshots for Microsoft 365 resources, 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
	POST /solutions/backupRestore/restorePoints/search

	Commands
	Search-MgBackupRestorePoint

	Commands
	Search-MgBetaBackupRestorePoint

Resources

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

Graph reference: artifactQuery

Property	Type	Description
artifactType	restorableArtifact	The type of artifact to search. The possible values are: `message`, `unknownFutureValue`.
queryExpression	String	Specifies criteria to retrieve artifacts.

Graph reference: protectionUnitBase

Property	Type	Description
id	String	The unique identifier of the protection unit.
policyId	String	The unique identifier of the protection policy based on which protection unit was created.
createdBy	identitySet	The identity of person who created the protection unit.
createdDateTime	DateTimeOffset	The time of creation of the protection unit.
error	publicError	Contains error details if an error occurred while creating a protection unit.
lastModifiedBy	identitySet	The identity of person who last modified the protection unit.
lastModifiedDateTime	DateTimeOffset	Timestamp of the last modification of this protection unit.
status	protectionUnitStatus	The status of the protection unit. The possible values are: `protectRequested`, `protected`, `unprotectRequested`, `unprotected`, `removeRequested`, `unknownFutureValue`.

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: restorePointSearchResponse

Property	Type	Description
noResultProtectionUnitIds	String collection	Contains alist of protection units with no restore points.
searchResponseId	String	The unique identifier of the search response.
searchResults	restorePointSearchResult collection	Contains a collection of restore points.

Graph reference: timePeriod

Property	Type	Description
endDateTime	DateTimeOffset	The date time of the end of the time period.
startDateTime	DateTimeOffset	The date time of the start of the time period.

Table of Contents

BackupRestore-Search.Read.All

Graph Methods

Resources