Freigeben über


Erstellen von driveRestoreArtifactsBulkAdditionRequest

Namespace: microsoft.graph

Erstellen Sie ein driveRestoreArtifactsBulkAdditionRequest-Objekt , das einer oneDriveForBusinessRestoreSession zugeordnet ist.

In den folgenden Schritten wird beschrieben, wie Sie eine oneDriveForBusinessRestoreSession mit Massenhinzufügen von Artefakten erstellen und verwalten.

  1. Erstellen Sie eine neue oneDriveForBusinessRestoreSession mit leerer Nutzlast.
  2. Erstellen Sie ein neues driveRestoreArtifactsBulkAdditionRequest-Objekt , das einer oneDriveForBusinessRestoreSession zugeordnet ist.
  3. Rufen Sie die status der driveRestoreArtifactsBulkAdditionRequest für die OneDrive for Work- oder School-Wiederherstellungssitzung ab. Die anfängliche status bei der Erstellung ist active und bleibt in diesem Zustand, bis oneDriveForBusinessRestoreSession aktiviert wird.
  4. Aktivieren Sie die im ersten Schritt erstellte oneDriveForBusinessRestoreSession .
  5. Überwachen Sie die status von driveRestoreArtifactsBulkAdditionRequest. Wenn alle Laufwerke der entsprechenden oneDriveForBusinessRestoreSession hinzugefügt werden, ändert sich der status von driveRestoreArtifactsBulkAdditionRequest in completed. Wenn während der Ressourcenauflösung Fehler auftreten, ändert sich die status in completedWithErrors.

Diese API ist in den folgenden nationalen Cloudbereitstellungen verfügbar.

Weltweiter Service US Government L4 US Government L5 (DOD) China, betrieben von 21Vianet

Berechtigungen

Wählen Sie die Berechtigungen aus, die für diese API als am wenigsten privilegiert markiert sind. Verwenden Sie eine höhere Berechtigung oder Berechtigungen nur, wenn Ihre App dies erfordert. Ausführliche Informationen zu delegierten Berechtigungen und Anwendungsberechtigungen finden Sie unter Berechtigungstypen. Weitere Informationen zu diesen Berechtigungen finden Sie in der Berechtigungsreferenz.

Berechtigungstyp Berechtigung mit den geringsten Rechten Berechtigungen mit höheren Berechtigungen
Delegiert (Geschäfts-, Schul- oder Unikonto) BackupRestore-Restore.ReadWrite.All Nicht verfügbar.
Delegiert (persönliches Microsoft-Konto) Nicht unterstützt Nicht unterstützt
Application BackupRestore-Restore.ReadWrite.All Nicht verfügbar.

HTTP-Anforderung

POST /solutions/backupRestore/oneDriveForBusinessRestoreSessions/{oneDriveForBusinessRestoreSessionId}/driveRestoreArtifactsBulkAdditionRequests

Anforderungsheader

Name Beschreibung
Authorization Bearer {token}. Erforderlich. Erfahren Sie mehr über Authentifizierung und Autorisierung.
Content-Type application/json. Erforderlich.

Anforderungstext

Geben Sie im Anforderungstext eine JSON-Darstellung des driveRestoreArtifactsBulkAdditionRequest-Objekts an.

Sie können die folgenden Eigenschaften angeben, wenn Sie ein driveRestoreArtifactsBulkAdditionRequest-Objekt erstellen.

Eigenschaft Typ Beschreibung
directoryObjectIds Zeichenfolgensammlung Die Liste der Verzeichnisobjekt-IDs. Optional.
drives String collection Die Liste der E-Mail-Adressen von OneDrive für Geschäfts-, Schul- oder Unikonten. Optional.

Antwort

Bei erfolgreicher Ausführung gibt die Methode den 201 Created Antwortcode und ein driveRestoreArtifactsBulkAdditionRequest-Objekt im Antworttext zurück.

Eine Liste der möglichen Fehlerantworten finden Sie unter Fehlerantworten der Backup Storage-API.

Beispiele

Anforderung

Das folgende Beispiel zeigt eine Anforderung, die dem angegebenen OneDrive eine Liste von Laufwerken für die Geschäfts-, Schul- oder Uniwiederherstellung in einem Massenvorgang hinzufügt.

POST https://graph.microsoft.com/v1.0/solutions/backupRestore/oneDriveForBusinessRestoreSessions/493635f0-b8c0-4c7f-bcb7-b20c85d97efe/driveRestoreArtifactsBulkAdditionRequests
Content-Type: application/json

{
  "displayName": "ODB-BulkRestoreArtifacts",
  "drives": [
    "contoso1@micorosft.com",
    "consotos2@microsoft.com",
    "contoso3@microsoft.com"
  ],
  "directoryObjectIds": [],
  "protectionUnitIds": [],
  "protectionTimePeriod": {
    "startDateTime": "2021-01-01T00:00:00Z",
    "endDateTime": "2021-01-08T00:00:00Z"
  },
  "destinationType": "new",
  "tags": "fastRestore",
  "restorePointPreference": "latest"
}

Antwort

Das folgende Beispiel zeigt die Antwort.

HTTP/1.1 201 Created
Content-Type: application/json

{
  "@odata.context": "/solutions/backupRestore/$metadata#siteRestoreArtifactsBulkAdditionRequest/$entity",
  "id": "9cf59538-5289-4024-9fa4-9c6c2b39aaa6",
  "destinationType": "new",
  "tags": "fastRestore",
  "restorePointPreference": "latest",
  "displayName": "ODB-BulkRestoreArtifacts",
  "status": "active",
  "createdDateTime": "2024-12-03T13:09:46.3725247Z",
  "lastModifiedDateTime": "2024-12-03T13:09:46.3725247Z",
  "drives": [],
  "protectionTimePeriod": {
    "startDateTime": "2024-11-26T00:00:00Z",
    "endDateTime": "2024-12-03T00:00:00Z"
  },
  "createdBy": {
    "user": {
      "identity": "fb70be35-8c8e-4c8a-b55d-f8cd95c5e23a"
    }
  },
  "lastModifiedBy": {
    "user": {
      "identity": "fb70be35-8c8e-4c8a-b55d-f8cd95c5e23a"
    }
  }
}