restoreSessionBase: activate

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

Активируйте проект объекта restoreSessionBase .

К восстановлению блока защиты относятся следующие моменты:

• Восстанавливаемые сайты SharePoint и учетные записи OneDrive не блокируются только в состоянии готовности.
• Для сайтов SharePoint и OneDrive, восстановленных по новым URL-адресам, пользователи не имеют те же разрешения, что и для исходного сайта. Только глобальный администратор или администратор SharePoint имеет разрешение на восстановленный сайт. Однако для восстановления на месте или восстановления по тому же URL-адресу разрешения с исходного сайта на момент восстановления сохраняются.
• Восстановление содержимого сайта SharePoint и пользователя OneDrive, удаленного из корзины, не поддерживается.
• Почтовые ящики, учетные записи OneDrive и сайты SharePoint, которые находятся под удержанием по закону или на месте, не могут быть восстановлены, если не будет удалено удержание по закону. Чтобы восстановить сайт SharePoint под удержанием по закону, необходимо восстановить сайт по новому URL-адресу.
• Черновики элементов почтового ящика не архивируются и не могут быть восстановлены.
• Восстановление не выполняется, если текущее состояние почтового ящика совпадает с моментом времени, в который вы пытаетесь восстановить почтовый ящик.
• Сайты SharePoint и учетные записи OneDrive, восстановленные по новому URL-адресу, блокируют этот новый URL-адрес только для чтения, пока восстановление не завершится. Глобальный администратор по-прежнему может скачивать документы или удалять блокировку только для чтения вручную.
• При восстановлении в новом расположении заполнение сведений о свойстве нового расположения может занять более 15 минут.
• Глобальный администратор, администратор SharePoint или администратор Exchange могут инициировать восстановление до 1000 сайтов SharePoint, 1000 пользователей OneDrive и 1000 почтовых ящиков, помещенных в очередь одновременно.

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

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

Разрешения

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

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

HTTP-запрос

POST /solutions/backupRestore/restoreSessions/{restoreSessionBaseId}/activate

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

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

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

Не указывайте текст запроса для этого метода.

Отклик

В случае успешного выполнения это действие возвращает код отклика 200 OK и объект restoreSessionBase в теле отклика.

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

Примеры

Запрос

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

HTTP

POST https://graph.microsoft.com/v1.0/solutions/backupRestore/restoreSessions/61633878-8321-4950-bfaf-ed285bdd1461/activate

C#

// Code snippets are only available for the latest version. Current version is 5.x

// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=csharp
var result = await graphClient.Solutions.BackupRestore.RestoreSessions["{restoreSessionBase-id}"].Activate.PostAsync();

Подробнее о том, как добавить SDK в свой проект и создать экземпляр authProvider, см. в документации по SDK.

CLI

mgc solutions backup-restore restore-sessions activate post --restore-session-base-id {restoreSessionBase-id}

Подробнее о том, как добавить SDK в свой проект и создать экземпляр authProvider, см. в документации по SDK.

Go

// Code snippets are only available for the latest major version. Current major version is $v1.*

// Dependencies
import (
	  "context"
	  msgraphsdk "github.com/microsoftgraph/msgraph-sdk-go"
	  //other-imports
)


// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=go
activate, err := graphClient.Solutions().BackupRestore().RestoreSessions().ByRestoreSessionBaseId("restoreSessionBase-id").Activate().Post(context.Background(), nil)

Подробнее о том, как добавить SDK в свой проект и создать экземпляр authProvider, см. в документации по SDK.

Java

// Code snippets are only available for the latest version. Current version is 6.x

GraphServiceClient graphClient = new GraphServiceClient(requestAdapter);

var result = graphClient.solutions().backupRestore().restoreSessions().byRestoreSessionBaseId("{restoreSessionBase-id}").activate().post();

Подробнее о том, как добавить SDK в свой проект и создать экземпляр authProvider, см. в документации по SDK.

JavaScript

const options = {
	authProvider,
};

const client = Client.init(options);

await client.api('/solutions/backupRestore/restoreSessions/61633878-8321-4950-bfaf-ed285bdd1461/activate')
	.post();

Подробнее о том, как добавить SDK в свой проект и создать экземпляр authProvider, см. в документации по SDK.

PHP

<?php
use Microsoft\Graph\GraphServiceClient;


$graphServiceClient = new GraphServiceClient($tokenRequestContext, $scopes);


$result = $graphServiceClient->solutions()->backupRestore()->restoreSessions()->byRestoreSessionBaseId('restoreSessionBase-id')->activate()->post()->wait();

Подробнее о том, как добавить SDK в свой проект и создать экземпляр authProvider, см. в документации по SDK.

PowerShell

Import-Module Microsoft.Graph.Bookings

Initialize-MgBackupRestoreSession -RestoreSessionBaseId $restoreSessionBaseId

Подробнее о том, как добавить SDK в свой проект и создать экземпляр authProvider, см. в документации по SDK.

Python

# Code snippets are only available for the latest version. Current version is 1.x
from msgraph import GraphServiceClient
# To initialize your graph_client, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=python

result = await graph_client.solutions.backup_restore.restore_sessions.by_restore_session_base_id('restoreSessionBase-id').activate.post()

Подробнее о том, как добавить SDK в свой проект и создать экземпляр authProvider, см. в документации по SDK.

Отклик

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

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

HTTP/1.1 200 OK
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": "activating",
  "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"
}