次の方法で共有

パーティションの復元

  • [アーティクル]

指定した復元パーティションの説明を使用して、パーティションの状態の復元をトリガーします。

指定したバックアップ ポイントを使用して、ステートフル永続化パーティションの の状態を復元します。 パーティションが既に定期的にバックアップされている場合、既定では、バックアップ ポリシーで指定されたストレージでバックアップ ポイントが検索されます。 また、復元パーティションの説明の一部としてバックアップ ストレージの詳細を本文で指定することで、同じものをオーバーライドすることもできます。 復元が開始されると、GetRestoreProgress 操作を使用してその進行状況を追跡できます。 操作がタイムアウトした場合は、クエリ パラメーターに復元タイムアウト値を大きく指定します。

Request

Method 要求 URI
POST /Partitions/{partitionId}/$/Restore?RestoreTimeout={RestoreTimeout}&api-version=6.4&timeout={timeout}

パラメーター

名前 Type 必須 場所
partitionId string (UUID) はい パス
RestoreTimeout 整数 (integer) いいえ クエリ
api-version string はい クエリ
timeout integer (int64) いいえ クエリ
RestorePartitionDescription RestorePartitionDescription はい Body

partitionId

型: string (uuid)
必須: はい

パーティションの ID。

RestoreTimeout

型: 整数
必須: いいえ
既定値:

復元操作が完了するまでの最大待機時間を分単位で指定します。 その後、操作はタイムアウト エラーで戻ります。 ただし、特定のコーナーケースでは、タイムアウトで完了した場合でも復元操作が完了する可能性があります。 タイムアウト エラーが発生した場合は、より大きなタイムアウト値でこの操作を再度呼び出すようにお勧めします。 同じ の既定値は 10 分です。

api-version

型: string
必須: はい
既定値:

API のバージョン。 このパラメーターは必須であり、その値は '6.4' である必要があります。

Service Fabric REST API のバージョンは、API が導入または変更されたランタイム バージョンに基づいています。 Service Fabric ランタイムでは、複数のバージョンの API がサポートされています。 このバージョンは、サポートされている API の最新バージョンです。 より低い API バージョンが渡された場合、返される応答は、この仕様に記載されている応答とは異なる場合があります。

さらに、ランタイムは、現在のバージョンのランタイムまで、サポートされている最新バージョンより高いバージョンを受け入れます。 そのため、最新の API バージョンが 6.0 で、ランタイムが 6.1 の場合、ランタイムはその API のバージョン 6.1 を受け入れます。 ただし、API の動作は、文書化されている 6.0 バージョンに従います。

timeout

型: integer (int64)
必須: いいえ
既定値:
InclusiveMaximum: 4294967295
InclusiveMinimum: 1

操作を実行するためのサーバー タイムアウト (秒単位)。 このタイムアウトは、要求した操作が完了するまでクライアントが待機できる期間を指定します。 このパラメーターの既定値は 60 秒です。

RestorePartitionDescription

種類: RestorePartitionDescription
必須: はい

パーティションを復元するパラメーターについて説明します。

応答

HTTP 状態コード 説明 応答スキーマ
202 (承認済み) 202 状態コードは、操作要求が受け入れられ、復元が開始されることを示します。 GetPartitionRestoreProgress 操作を使用して、復元操作の状態を取得します。
その他すべての状態コード 詳細なエラー応答。
 FabricError

使用例

パーティションの復元をトリガーする

この例では、復元に使用するバックアップを指定して、パーティションの復元を今すぐトリガーする方法を示します。

要求

POST http://localhost:19080/Partitions/1daae3f5-7fd6-42e9-b1ba-8c05f873994d/$/Restore?api-version=6.4
本文
{
  "BackupId": "3a056ac9-7206-43c3-8424-6f6103003eba",
  "BackupStorage": {
    "StorageKind": "AzureBlobStore",
    "ConnectionString": "DefaultEndpointsProtocol=https;AccountName=storagesample;AccountKey=<PutYourAccountKeyHere>",
    "ContainerName": "BackupContainer"
  },
  "BackupLocation": "CalcApp\\CalcService\\1daae3f5-7fd6-42e9-b1ba-8c05f873994d\\2018-01-01 09.00.55.zip"
}

202 応答

本文

応答本文は空です。