restoreSessionBase: ativar

Namespace: microsoft.graph

Ativar um rascunho de objeto restoreSessionBase .

Os seguintes pontos se aplicam à restauração de uma unidade de proteção:

• Os sites do SharePoint e as contas do OneDrive que estão sendo restaurados não estão bloqueados em um estado somente pronto.
• Para sites do SharePoint e do OneDrive restaurados para novas URLs, os usuários não têm as mesmas permissões que tinham para o site original. Somente o administrador global ou o administrador do SharePoint tem permissão para o site restaurado. No entanto, para restaurações in-loco ou para a mesma URL, as permissões do site original no momento da restauração são preservadas.
• Não há suporte para a restauração do conteúdo do site do SharePoint e do usuário do OneDrive que foi removido da lixeira.
• As caixas de correio, as contas do OneDrive e os sites do SharePoint que estão sob retenções legais ou in-loco não podem ser restaurados, a menos que a retenção legal seja removida. Para restaurar um site do SharePoint em bloqueio legal, você precisa restaurar o site para uma nova URL.
• Os itens de rascunho de caixa de correio não têm backup e não podem ser restaurados.
• Uma restauração não será executada se o estado atual da caixa de correio for igual ao momento para o qual você está tentando restaurá-la.
• Os sites do SharePoint e as contas do OneDrive que são restaurados para uma nova URL têm um bloqueio somente leitura nessa nova URL até que a restauração seja concluída. O administrador global ainda pode baixar documentos ou remover o bloqueio somente leitura manualmente.
• Quando uma restauração para um novo local é executada, o preenchimento dos detalhes da propriedade do novo local pode levar mais de 15 minutos.
• O administrador global, o administrador do SharePoint ou o administrador do Exchange pode iniciar uma restauração de até 1.000 sites do SharePoint, 1.000 usuários do OneDrive e 1.000 caixas de correio enfileiradas em paralelo ao mesmo tempo.

Essa API está disponível nas seguintes implantações de nuvem nacional.

Permissões

Escolha a(s) permissão(s) marcada(s) como menos privilegiada(s) para essa API. Use uma permissão ou permissões com privilégios mais altos somente se o aplicativo exigir. Para obter detalhes sobre permissões delegadas e de aplicativo, consulte Tipos de permissão. Para saber mais sobre essas permissões, consulte a referência de permissões.

Solicitação HTTP

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

Cabeçalhos de solicitação

Corpo da solicitação

Não forneça um corpo de solicitação para esse método.

Resposta

Se for bem-sucedida, essa ação retornará um código de 200 OK resposta e um objeto restoreSessionBase no corpo da resposta.

Para obter uma lista de possíveis respostas de erro, consulte Respostas de erro da API de armazenamento de backup.

Exemplos

Solicitação

O exemplo a seguir mostra uma solicitação.

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

// 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();

// 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)

// 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();

const options = {
	authProvider,
};

const client = Client.init(options);

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

<?php
use Microsoft\Graph\GraphServiceClient;


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


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

Import-Module Microsoft.Graph.BackupRestore

Initialize-MgSolutionBackupRestoreSession -RestoreSessionBaseId $restoreSessionBaseId

# 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()

Resposta

O exemplo a seguir mostra a resposta.

Observação: o objeto de resposta mostrado aqui pode ser encurtado para legibilidade.

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",
  "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"
}