sharePointRestoreSession resource type

Namespace: microsoft.graph

Represents restore-related tasks on artifacts that are protected by a SharePoint protection policy. Restore session APIs are used by SharePoint Online Admins to perform restore-related tasks on artifacts that are protected as part of a SharePoint protection policy.

Inherits from restoreSessionBase.

Methods

Method	Return type	Description
Create	sharePointRestoreSession	Create a new sharePointRestoreSession.
List	siteRestoreArtifact collection	List the siteRestoreArtifact objects for a sharePointRestoreSession for the tenant.
List granularSiteRestoreArtifacts	granularSiteRestoreArtifact collection	Get a list of the granularSiteRestoreArtifact objects and their properties.
Update	sharePointRestoreSession	Update the properties of a sharePointRestoreSession object.

Properties

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.
policyId	String	The identifier of the protection policy that scopes the restore session. When supplied during creation or update, the service validates that the referenced protection units belong to the specified policy. Inherited from restoreSessionBase.
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.

restoreSessionStatus values

Member	Description
draft	All artifacts are added.
activating	All artifacts are scheduled.
active	All or any restore artifacts are scheduled or in progress.
completedWithError	Some artifacts failed to restore, and some succeeded.
completed	All restore artifacts successfully restored.
failed	All restore artifacts failed to restore.
unknownFutureValue	Evolvable enumeration sentinel value. Do not use.

Relationships

Relationship	Type	Description
granularSiteRestoreArtifacts	granularSiteRestoreArtifact collection	A collection of browse session ID and item key details that can be used to restore SharePoint files and folders.
siteRestoreArtifacts	siteRestoreArtifact collection	A collection of restore points and destination details that can be used to restore SharePoint sites.
siteRestoreArtifactsBulkAdditionRequests	siteRestoreArtifactsBulkAdditionRequest collection	A collection of SharePoint site URLs and destination details that can be used to restore SharePoint sites.

JSON representation

The following JSON representation shows the resource type.

{
  "@odata.type": "#microsoft.graph.sharePointRestoreSession",
  "id": "String (identifier)",
  "status": "String",
  "restoreJobType": "String",
  "restoreSessionArtifactCount": {
    "@odata.type": "microsoft.graph.restoreSessionArtifactCount"
  },
  "createdDateTime": "String (timestamp)",
  "createdBy": {
    "@odata.type": "microsoft.graph.identitySet"
  },
  "completedDateTime": "String (timestamp)",
  "lastModifiedDateTime": "String (timestamp)",
  "lastModifiedBy": {
    "@odata.type": "microsoft.graph.identitySet"
  },
  "error": {
    "@odata.type": "microsoft.graph.publicError"
  },
  "policyId": "String"
}