還原分割區

發行項
07/19/2023

使用指定的還原分割區描述，觸發資料分割狀態的還原。

使用指定的備份點還原具狀態保存資料分割的狀態。如果分割區已定期備份，則預設會在備份原則中指定的儲存體中尋找備份點。您也可以將備份儲存體詳細資料指定為本文中還原資料分割描述的一部分，以覆寫相同的內容。一旦起始還原，就可以使用 GetRestoreProgress 作業來追蹤其進度。如果作業逾時，請在查詢參數中指定更大的還原逾時值。

要求

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

參數

名稱	類型	必要	Location
`partitionId`	字串 (uuid)	是	路徑
`RestoreTimeout`	整數	No	查詢
`api-version`	string	是	查詢
`timeout`	整數 (int64)	No	查詢
`RestorePartitionDescription`	RestorePartitionDescription	是	body

`partitionId`

類型：字串 (uuid)
必要：是

分割區的識別。

`RestoreTimeout`

類型：整數
必要：否
預設：10

指定還原作業完成的等候時間上限，以分鐘為單位。之後，作業會傳回逾時錯誤。不過，在某些情況下，即使還原作業完成逾時，也可能會經過。如果發生逾時錯誤，建議使用更大的逾時值再次叫用此作業。相同的預設值為 10 分鐘。

`api-version`

類型：字串
必要：是
預設：6.4

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`

類型：整數 (int64)
必要：否
預設：60
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 回應

主體

回應主體是空的。

共用方式為