你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

创建备份策略

创建备份策略。

创建一个备份策略，该策略稍后可与 Service Fabric 应用程序、服务或分区相关联，以便进行定期备份。

请求

方法	请求 URI
POST	/BackupRestore/BackupPolicies/$/Create?api-version=6.4&timeout={timeout}&ValidateConnection={ValidateConnection}

参数

名称	类型	必须	位置
api-version	string	是	查询
timeout	整数 (int64)	否	查询
ValidateConnection	boolean	否	查询
BackupPolicyDescription	BackupPolicyDescription	“是”	Body

---

api-version

类型：字符串
必需：是
默认：

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)
必需：否
默认：
InclusiveMaximum： 4294967295
InclusiveMinimum： 1

执行操作的服务器超时，以秒为单位。 此超时指定客户端可以等待请求的操作完成的持续时间。 此参数的默认值为 60 秒。

---

ValidateConnection

类型：布尔值
必需：否
默认：

指定在创建或更新备份策略之前是否验证存储连接和凭据。

---

BackupPolicyDescription

类型： BackupPolicyDescription
必需：是

描述备份策略。

响应

HTTP 状态代码	说明	响应架构
201 (已创建)	成功的操作返回 201 状态代码并创建新的备份策略。
所有其他状态代码	详细的错误响应。	FabricError

示例

使用 Azure 作为备份位置创建基于时间的备份策略

此示例演示如何创建备份策略，该策略每天在 UTC 时间上午 9 点和下午 5 点执行备份两次，该策略将在 3 个月后删除，Azure Blob 存储作为备份位置。

请求

POST http://localhost:19080/BackupRestore/BackupPolicies/$/Create?api-version=6.4

正文

{
  "Name": "DailyAzureBackupPolicy",
  "AutoRestoreOnDataLoss": false,
  "MaxIncrementalBackups": "3",
  "Schedule": {
    "ScheduleKind": "TimeBased",
    "ScheduleFrequencyType": "Daily",
    "RunTimes": [
      "0001-01-01T09:00:00Z",
      "0001-01-01T17:00:00Z"
    ]
  },
  "Storage": {
    "StorageKind": "AzureBlobStore",
    "FriendlyName": "Azure_storagesample",
    "ConnectionString": "DefaultEndpointsProtocol=https;AccountName=storagesample;AccountKey=<PutYourAccountKeyHere>",
    "ContainerName": "BackupContainer"
  },
  "RetentionPolicy": {
    "RetentionPolicyType": "Basic",
    "MinimumNumberOfBackups": "20",
    "RetentionDuration": "P3M"
  }
}

201 响应

正文

响应正文为空。

创建基于时间的备份策略，将 Azure 用作使用托管标识访问的备份位置

此示例演示如何创建一个备份策略，该策略在每天上午 9 点和 UTC 下午 5 点执行备份两次，该策略将在 3 个月后删除，使用托管标识将 Azure Blob 存储作为备份位置。

请求

POST http://localhost:19080/BackupRestore/BackupPolicies/$/Create?api-version=6.4

正文

{
  "Name": "DailyAzureMIBackupPolicy",
  "AutoRestoreOnDataLoss": false,
  "MaxIncrementalBackups": "3",
  "Schedule": {
    "ScheduleKind": "TimeBased",
    "ScheduleFrequencyType": "Daily",
    "RunTimes": [
      "0001-01-01T09:00:00Z",
      "0001-01-01T17:00:00Z"
    ]
  },
  "Storage": {
    "StorageKind": "ManagedIdentityAzureBlobStore",
    "FriendlyName": "AzureMI_storagesample",
    "BlobServiceUri": "https://managedidentitytest.blob.core.windows.net/",
    "ContainerName": "BackupContainer",
    "ManagedIdentityType": "Cluster"
  },
  "RetentionPolicy": {
    "RetentionPolicyType": "Basic",
    "MinimumNumberOfBackups": "20",
    "RetentionDuration": "P3M"
  }
}

201 响应

正文

响应正文为空。

创建基于频率的备份策略，其中文件共享作为备份位置

此示例演示如何创建备份策略，该策略每隔 10 分钟备份一次，该策略将在 20 天后删除，并将文件共享作为备份位置。

请求

POST http://localhost:19080/BackupRestore/BackupPolicies/$/Create?api-version=6.4

正文

{
  "Name": "FileShare10MinBackupPolicy",
  "AutoRestoreOnDataLoss": false,
  "MaxIncrementalBackups": "3",
  "Schedule": {
    "ScheduleKind": "FrequencyBased",
    "Interval": "PT10M"
  },
  "Storage": {
    "StorageKind": "FileShare",
    "FriendlyName": "FileShare_myshare",
    "Path": "\\\\myshare\\backupshare",
    "PrimaryUserName": "backupaccount",
    "PrimaryPassword": "abcd1234"
  },
  "RetentionPolicy": {
    "RetentionPolicyType": "Basic",
    "MinimumNumberOfBackups": "20",
    "RetentionDuration": "P20D"
  }
}

201 响应

正文

响应正文为空。

使用 Dsms Azure 作为备份位置创建基于时间的备份策略

此示例演示如何创建备份策略，该策略在每天上午 9 点和 UTC 下午 5 点执行备份两次，该策略将在 3 个月后删除，并将 Dsms Azure Blob 存储作为备份位置。

请求

POST http://localhost:19080/BackupRestore/BackupPolicies/$/Create?api-version=6.4

正文

{
  "Name": "SampleDsmsBackupPolicy",
  "AutoRestoreOnDataLoss": false,
  "MaxIncrementalBackups": "3",
  "Schedule": {
    "ScheduleKind": "TimeBased",
    "ScheduleFrequencyType": "Daily",
    "RunTimes": [
      "0001-01-01T09:00:00Z",
      "0001-01-01T17:00:00Z"
    ]
  },
  "Storage": {
    "StorageKind": "DsmsAzureBlobStore",
    "FriendlyName": "DsmsAzure_storagesample",
    "StorageCredentialsSourceLocation": "https://sample-dsms.dsms.core.winows.net/dsms/samplecredentiallocation/storageaccounts/samplestorageac/servicefabricbackup/samplebackup",
    "ContainerName": "BackupContainer"
  },
  "RetentionPolicy": {
    "RetentionPolicyType": "Basic",
    "MinimumNumberOfBackups": "20",
    "RetentionDuration": "P3M"
  }
}

201 响应

正文

响应正文为空。