restoreSessionBase: アクティブ化

名前空間: microsoft.graph

下書き restoreSessionBase オブジェクトを アクティブにします。

保護ユニットの復元には、次の点が適用されます。

• 復元される SharePoint サイトと OneDrive アカウントは、準備完了状態ではロックされません。
• 新しい URL に復元された SharePoint サイトと OneDrive サイトの場合、ユーザーは元のサイトに対して持っていたのと同じアクセス許可を持っていません。 復元されたサイトへのアクセス許可を持っているのは、グローバル管理者または SharePoint 管理者だけです。 ただし、インプレースまたは同じ URL への復元では、復元時の元のサイトからのアクセス許可が保持されます。
• ごみ箱から削除された SharePoint サイトと OneDrive ユーザー コンテンツの復元はサポートされていません。
• 訴訟ホールドまたはインプレース ホールドの対象になっているメールボックス、OneDrive アカウント、SharePoint サイトは、訴訟ホールドが削除されない限り復元できません。 訴訟ホールドの下で SharePoint サイトを復元するには、サイトを新しい URL に復元する必要があります。
• メールボックスの下書きアイテムはバックアップされず、復元できません。
• メールボックスの現在の状態が復元しようとしている時点と同じ場合、復元は実行されません。
• 新しい URL に復元された SharePoint サイトと OneDrive アカウントでは、復元が完了するまで、その新しい URL に対する読み取り専用ロックが適用されます。 グローバル管理者は、ドキュメントをダウンロードすることも、読み取り専用ロックを手動で削除することもできます。
• 新しい場所への復元が実行されると、新しい場所のプロパティの詳細を設定するには、15 分以上かかることがあります。
• グローバル管理者、SharePoint 管理者、または Exchange 管理者は、一度に最大 1,000 個の SharePoint サイト、1,000 人の OneDrive ユーザー、および 1,000 個のメールボックスを同時にキューに入れ、復元を開始できます。

この API は、次の国内クラウド展開で使用できます。

アクセス許可

この API の最小特権としてマークされているアクセス許可またはアクセス許可を選択します。 アプリで必要な場合にのみ、より高い特権のアクセス許可またはアクセス許可を使用します。 委任されたアクセス許可とアプリケーションのアクセス許可の詳細については、「アクセス許可の種類」を参照してください。 これらのアクセス許可の詳細については、「アクセス許可のリファレンス」を参照してください。

HTTP 要求

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

要求ヘッダー

要求本文

このメソッドには、要求本文を指定しません。

応答

成功した場合、このアクションは応答コード 200 OK と、応答本文に restoreSessionBase オブジェクトを返します。

考えられるエラー応答の一覧については、「 Backup Storage API エラー応答」を参照してください。

例

要求

次の例は要求を示しています。

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

応答

次の例は応答を示しています。

注: ここに示す応答オブジェクトは、読みやすさのために短縮されている場合があります。

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