備份分割區

觸發資料分割狀態的備份。

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

要求

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

參數

名稱	類型	必要	Location
partitionId	字串 (uuid)	是	路徑
BackupTimeout	整數	No	查詢
api-version	string	是	查詢
timeout	整數 (int64)	No	查詢
BackupPartitionDescription	BackupPartitionDescription	No	主體

---

partitionId

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

分割區的識別。

---

BackupTimeout

類型：整數
必要：否
預設：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 秒。

---

BackupPartitionDescription

類型： BackupPartitionDescription
必要：否

描述要立即備份資料分割的參數。 如果沒有，備份作業會使用與這個分割區相關聯之備份原則中目前的預設參數。

回應

HTTP 狀態碼	描述	回應結構描述
202 (已接受)	202 狀態碼表示已接受作業要求，且將會起始備份。 使用 GetPartitionBackupProgress 作業來取得備份作業的狀態。
所有其他狀態碼	詳細的錯誤回應。	FabricError

範例

備份分割區

此範例示範如何立即觸發分割區的備份，此資料分割已針對定期備份進行設定。 新建立的備份將會儲存在儲存定期備份的相同位置。

要求

POST http://localhost:19080/Partitions/1daae3f5-7fd6-42e9-b1ba-8c05f873994d/$/Backup?api-version=6.4

主體

{}

202 回應

主體

回應主體是空的。

將分割區備份至特定的 Azure 儲存體帳戶

此範例示範如何立即觸發分割區的備份，並將備份儲存至特定的 Azure Blob 儲存體帳戶。

要求

POST http://localhost:19080/Partitions/1daae3f5-7fd6-42e9-b1ba-8c05f873994d/$/Backup?api-version=6.4

主體

{
  "BackupStorage": {
    "StorageKind": "AzureBlobStore",
    "ConnectionString": "DefaultEndpointsProtocol=https;AccountName=storagesample;AccountKey=<PutYourAccountKeyHere>",
    "ContainerName": "BackupContainer"
  }
}

202 回應

主體

回應主體是空的。

使用受控識別將分割區備份至存取的特定 Azure 儲存體位置

此範例示範如何立即觸發分割區的備份，並使用受控識別將備份儲存至特定的 Azure Blob 儲存體帳戶。

要求

POST http://localhost:19080/Partitions/1daae3f5-7fd6-42e9-b1ba-8c05f873994d/$/Backup?api-version=6.4

主體

{
  "BackupStorage": {
    "StorageKind": "ManagedIdentityAzureBlobStore",
    "BlobServiceUri": "https://managedidentitytest.blob.core.windows.net/",
    "ContainerName": "BackupContainer",
    "ManagedIdentityType": "Cluster"
  }
}

202 回應

主體

回應主體是空的。

將分割區備份至特定的內部部署檔案共用

此範例示範如何立即觸發分割區的備份，並將備份儲存到可從所有叢集節點存取的特定檔案共用。

要求

POST http://localhost:19080/Partitions/1daae3f5-7fd6-42e9-b1ba-8c05f873994d/$/Backup?api-version=6.4

主體

{
  "BackupStorage": {
    "StorageKind": "FileShare",
    "Path": "\\\\myshare\\backupshare",
    "PrimaryUserName": "mydomain\\backupaccount",
    "PrimaryPassword": "abcd1234"
  }
}

202 回應

主體

回應主體是空的。

將磁碟分割備份至特定的 Dsms Azure 儲存體位置

此範例示範如何立即觸發分割區的備份，並將備份儲存至特定的 Dsms Azure Blob 儲存體位置。

要求

POST http://localhost:19080/Partitions/1daae3f5-7fd6-42e9-b1ba-8c05f873994d/$/Backup?api-version=6.4

主體

{
  "BackupStorage": {
    "StorageKind": "DsmsAzureBlobStore",
    "StorageCredentialsSourceLocation": "https://sample-dsms.dsms.core.winows.net/dsms/samplecredentiallocation/storageaccounts/samplestorageac/servicefabricbackup/samplebackup",
    "ContainerName": "BackupContainer"
  }
}

202 回應

主體

回應主體是空的。