Создание sharePointRestoreSession

Пространство имен: microsoft.graph

Важно!

API версии /beta в Microsoft Graph могут быть изменены. Использование этих API в производственных приложениях не поддерживается. Чтобы определить, доступен ли API в версии 1.0, используйте селектор версий.

Создайте новый объект sharePointRestoreSession . Чтобы создать сеанс детализированного восстановления, в полезных данных должны присутствовать детализированные артефакты восстановления сайта. Запрос не может включать как granularSiteRestoreArtifact , так и siteRestoreArtifact в одном и том же запросе на создание или обновление .

Если при создании сеанса восстановления полезные данные не предоставляются, запрос создает пустой standard сеанс восстановления по умолчанию.

Этот API доступен в следующих национальных облачных развертываниях.

Глобальная служба Правительство США L4 Правительство США L5 (DOD) Китай управляется 21Vianet
✅ ❌ ❌ ❌

Разрешения

Выберите разрешение или разрешения, помеченные как наименее привилегированные для этого API. Используйте более привилегированное разрешение или разрешения только в том случае, если это требуется приложению. Дополнительные сведения о делегированных разрешениях и разрешениях приложений см. в разделе Типы разрешений. Дополнительные сведения об этих разрешениях см. в справочнике по разрешениям.

Тип разрешения Разрешения с наименьшими привилегиями Более высокие привилегированные разрешения
Делегированные (рабочая или учебная учетная запись) BackupRestore-Restore.ReadWrite.All Недоступно.
Делегированные (личная учетная запись Майкрософт) Не поддерживается. Не поддерживается.
Приложение BackupRestore-Restore.ReadWrite.All Недоступно.

HTTP-запрос

POST /solutions/backupRestore/sharePointRestoreSessions

Заголовки запросов

Имя Описание
Авторизация Bearer {token}. Обязательно. Дополнительные сведения о проверке подлинности и авторизации.
Content-Type application/json. Обязательно.

Текст запроса

В тексте запроса укажите представление объекта sharePointRestoreSession в формате JSON.

При создании объекта sharePointRestoreSession можно указать следующие свойства.

Свойство Тип Описание
@microsoft.graph.conflictBehavior String Поведение разрешения конфликтов при восстановлении каждого детализированного артефакта восстановления в сеансе. Возможные значения: fail (по умолчанию), replace, rename. Поддерживается только для сеансов детализированного восстановления. Необязательный параметр.
granularSiteRestoreArtifacts коллекция granularSiteRestoreArtifact Коллекция объектов granularSiteRestoreArtifact . Обязательно.
siteRestoreArtifacts коллекция siteRestoreArtifact Семейство объектов siteRestoreArtifact . Обязательно.

Отклик

В случае успешного 201 Created выполнения этот метод возвращает код отклика и объект sharePointRestoreSession в теле отклика.

Список возможных ответов на ошибки см. в разделе Ответы на ошибки API хранилища резервных копий.

Примеры

Пример 1. Создание стандартного сеанса восстановления

В следующем примере показано, как создать стандартный сеанс восстановления.

Запрос

Ниже показан пример запроса.

POST https://graph.microsoft.com/beta/solutions/backupRestore/sharePointRestoreSessions
Content-Type: application/json

{
  "siteRestoreArtifacts": [
    {
      "restorePoint": { "id": "1f1fccc3-a642-4f61-bf49-f37b9a888279" },
      "destinationType": "inPlace"
    },
    {
      "restorePoint": { "id": "1f1fccc3-a642-4f61-bf49-f37b9a888280" },
      "destinationType": "inPlace"
    }
  ]
}

Отклик

Ниже показан пример отклика.

Примечание. Объект отклика, показанный здесь, может быть сокращен для удобочитаемости.

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

{
  "@odata.context": " /solutions/backupRestore/$metadata#restoreSessions/$entity",
  "@odata.id": "/solutions/backupRestore/sharepointRestoreSessions(61633878-8321-4950-bfaf-ed285bdd1461)",
  "@odata.type": "#microsoft.graph.sharepointRestoreSession",
  "id": "61633878-8321-4950-bfaf-ed285bdd1461",
  "status": "draft",
  "restoreJobType": "standard",
  "restoreSessionArtifactCount": {
    "total": 2,
    "completed": 0,
    "inProgress": 2,
    "failed": 0
  },
  "createdBy": {
    "application": {
      "id": "1fec8e78-bce4-4aaf-ab1b-5451cc387264",
      "displayName": "Microsoft Enhanced Restore"
    },
    "user": {
      "id": "845457dc-4bb2-4815-bef3-8628ebd1952e",
      "displayName": "User1"
    }
  },
  "createdDateTime": "2015-06-19T12:01:03.45Z",
  "lastModifiedBy": {
    "application": {
      "id": "1fec8e78-bce4-4aaf-ab1b-5451cc387264",
      "displayName": "Microsoft Enhanced Restore"
    },
    "user": {
      "id": "845457dc-4bb2-4815-bef3-8628ebd1952e",
      "displayName": "User2"
    }
  },
  "lastModifiedDateTime": "2015-06-19T12:01:03.45Z"
}

Пример 2. Создание сеанса детализированного восстановления

В следующем примере показано, как создать сеанс детализированного восстановления.

Запрос

Ниже показан пример запроса.

POST https://graph.microsoft.com/beta/solutions/backupRestore/sharePointRestoreSessions
Content-Type: application/json

{
  "granularSiteRestoreArtifacts": [
    {
      "browseSessionId": "eJxVjEEKwjAQRfc80xeIleluFd2HRkZCgAIEu9CO3aUv78W4H_q_NgQY2gSJHT8IoOhrl5AzosZGBk6",
      "id": "a535851e-9fc6-4eb1-90ab-2955fd9117b5,2a8b7eaf-092a-4561-a25a-998ad2e5142e,38eec3f1-b879-44a6-8ae6-05bd46ed4b3d,ce66019f-cdf9-4575-aa81-de3aabe844a2"
    },
    {
      "browseSessionId": "eJxVjEEKwjAQRfc80xeIleluFd2HRkZCgAIEu9CO3aUv78W4H_q_NgQY2gSJHT8IoOhrl5AzosZGBk6",
      "id": "b535851e-9fc6-4eb1-90ab-2955fd9117b5,2a8b7eaf-092a-4561-a25a-998ad2e5142e,38eec3f1-b879-44a6-8ae6-05bd46ed4b3d,ce66019f-cdf9-4575-aa81-de3aabe844a2"
    }
  ]
}

Отклик

Ниже показан пример отклика.

Примечание. Объект отклика, показанный здесь, может быть сокращен для удобочитаемости.

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

{
  "@odata.context": "/solutions/backupRestore/$metadata#sharePointRestoreSessions/$entity",
  "id": "23e0638e-3ad7-4c7e-8749-72175d046e30",
  "status": "draft",
  "restoreJobType": "granular",
  "createdDateTime": "2025-06-28T15:05:54.1352557Z",
  "lastModifiedDateTime": "2025-06-28T15:05:54.4852234Z",
  "createdBy": {
    "application": {
      "id": "1fec8e78-bce4-4aaf-ab1b-5451cc387264",
      "displayName": "Microsoft Enhanced Restore"
    },
    "user": {
      "id": "845457dc-4bb2-4815-bef3-8628ebd1952e",
      "displayName": "User1"
    }
  },
  "lastModifiedBy": {
    "application": {
      "id": "1fec8e78-bce4-4aaf-ab1b-5451cc387264",
      "displayName": "Microsoft Enhanced Restore"
    },
    "user": {
      "id": "845457dc-4bb2-4815-bef3-8628ebd1952e",
      "displayName": "User2"
    }
  },
  "restoreSessionArtifactCount": {
      "total": 2,
      "inProgress": 0,
      "completed": 0,
      "failed": 0
  }
}

Пример 3. Создание сеанса детализированного восстановления с восстановлением на месте и конфликтным поведением

В следующем примере показано, как создать сеанс детализированного восстановления, который восстанавливает артефакты на месте с заданным поведением разрешения конфликтов. Заметка @microsoft.graph.conflictBehavior применяется равномерно ко всем артефактам в сеансе. Если этот параметр не указан, по умолчанию используется fail.

Примечание: Заметка @microsoft.graph.conflictBehavior поддерживается только для сеансов детализированного восстановления. Если этот параметр указан в сеансе без детализации, 400 Bad Request возвращается объект .

Смешанный тип назначения в рамках одного сеанса детализированного восстановления не поддерживается.

Запрос

Ниже показан пример запроса.

POST https://graph.microsoft.com/beta/solutions/backupRestore/sharePointRestoreSessions
Content-Type: application/json

{
  "@microsoft.graph.conflictBehavior": "rename",
  "granularSiteRestoreArtifacts": [
    {
      "browseSessionId": "eJxVjEEKwjAQRfc80xeIleluFd2HRkZCgAIEu9CO3aUv78W4H_q_NgQY2gSJHT8IoOhrl5AzosZGBk6",
      "id": "a535851e-9fc6-4eb1-90ab-2955fd9117b5,2a8b7eaf-092a-4561-a25a-998ad2e5142e,38eec3f1-b879-44a6-8ae6-05bd46ed4b3d,ce66019f-cdf9-4575-aa81-de3aabe844a2",
      "destinationType": "inPlace"
    },
    {
      "browseSessionId": "eJxVjEEKwjAQRfc80xeIleluFd2HRkZCgAIEu9CO3aUv78W4H_q_NgQY2gSJHT8IoOhrl5AzosZGBk6",
      "id": "b535851e-9fc6-4eb1-90ab-2955fd9117b5,2a8b7eaf-092a-4561-a25a-998ad2e5142e,38eec3f1-b879-44a6-8ae6-05bd46ed4b3d,ce66019f-cdf9-4575-aa81-de3aabe844a2",
      "destinationType": "inPlace"
    }
  ]
}

Отклик

Ниже показан пример отклика.

Примечание. Объект отклика, показанный здесь, может быть сокращен для удобочитаемости.

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

{
  "@odata.context": "/solutions/backupRestore/$metadata#sharePointRestoreSessions/$entity",
  "id": "23e0638e-3ad7-4c7e-8749-72175d046e30",
  "status": "draft",
  "restoreJobType": "granular",
  "createdDateTime": "2025-06-28T15:05:54.1352557Z",
  "lastModifiedDateTime": "2025-06-28T15:05:54.4852234Z",
  "createdBy": {
    "application": {
      "id": "1fec8e78-bce4-4aaf-ab1b-5451cc387264",
      "displayName": "Microsoft Enhanced Restore"
    },
    "user": {
      "id": "845457dc-4bb2-4815-bef3-8628ebd1952e",
      "displayName": "User1"
    }
  },
  "lastModifiedBy": {
    "application": {
      "id": "1fec8e78-bce4-4aaf-ab1b-5451cc387264",
      "displayName": "Microsoft Enhanced Restore"
    },
    "user": {
      "id": "845457dc-4bb2-4815-bef3-8628ebd1952e",
      "displayName": "User2"
    }
  },
  "restoreSessionArtifactCount": {
      "total": 2,
      "inProgress": 0,
      "completed": 0,
      "failed": 0
  }
}
  • Last updated on