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

Backup Short Term Retention Policies - Create Or Update

汇报数据库的短期保留策略。

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/servers/{serverName}/databases/{databaseName}/backupShortTermRetentionPolicies/default?api-version=2022-02-01-preview

URI 参数

Name In Required Type Description
databaseName
path True
  • string

数据库的名称。

policyName
path True

策略名称。 应始终为“default”。

resourceGroupName
path True
  • string

包含该资源的资源组名称。 可以从 Azure 资源管理器 API 或门户获取此值。

serverName
path True
  • string

服务器的名称。

subscriptionId
path True
  • string

用于标识 Azure 订阅的订阅 ID。

api-version
query True
  • string

要用于请求的 API 版本。

请求正文

Name Type Description
properties.diffBackupIntervalInHours

差异备份间隔(以小时为单位)。 这是每个差异备份之间的间隔小时数。 这仅适用于实时数据库,但不适用于已删除的数据库。

properties.retentionDays
  • integer

备份保留期(以天为单位)。 这是支持多少天时间点还原。

响应

Name Type Description
200 OK

已成功更新策略。

202 Accepted

已接受

Other Status Codes

错误响应: ***

  • 400 InvalidParameterValue - 为参数提供无效值。

  • 400 InvalidBackupRetentionPeriod - 保留天数 {0} 不是有效的配置。 有效的备份保留期(以天为单位)必须介于 {1} 和 {2}

  • 400 InvalidDiffBackupIntervalHours - 差异备份间隔小时数 {0} 不是有效的配置。 有效的差异备份间隔必须是 {1} 小时。

  • 400 FeatureDisabledOnSelectedEdition - 用户尝试使用当前数据库版本上禁用的功能。

  • 404 SubscriptionDoesNotHaveServer - 找不到请求的服务器

  • 404 ServerNotInSubscriptionResourceGroup - 指定的服务器在指定的资源组和订阅中不存在。

  • 404 ResourceNotFound - 找不到请求的资源。

  • 404 SourceDatabaseNotFound - 源数据库不存在。

  • 404 CannotFindObject - 找不到对象,因为它不存在或您没有权限

  • 409 ConflictingDatabaseOperation - 数据库上已有一些操作,当前操作应等到操作完成。

  • 409 ConflictingSystemOperationInProgress - 数据库上正在进行系统维护操作,后续操作需要等待,直到完成。

  • 429 SubscriptionTooManyCreateUpdateRequests - 请求超出可用资源可以处理的最大请求数。

  • 429 SubscriptionTooManyRequests - 请求超出可用资源可以处理的最大请求数。

  • 503 TooManyRequests - 请求超出可用资源可处理的最大请求数。

  • 504 RequestTimeout - 服务请求超出了允许的超时。

示例

Update the short term retention policy for the database.

Sample Request

PATCH https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/resourceGroup/providers/Microsoft.Sql/servers/testsvr/databases/testdb/backupShortTermRetentionPolicies/default?api-version=2022-02-01-preview

{
  "properties": {
    "retentionDays": 7,
    "diffBackupIntervalInHours": 24
  }
}

Sample Response

{
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/providers/Microsoft.Sql/resourceGroups/resourceGroup/servers/testsvr/databases/testdb/backupShortTermRetentionPolicies/default",
  "name": "default",
  "type": "Microsoft.Sql/servers/databases/backupShortTermRetentionPolicies",
  "properties": {
    "retentionDays": 7,
    "diffBackupIntervalInHours": 24
  }
}

定义

BackupShortTermRetentionPolicy

短期保留策略。

DiffBackupIntervalInHours

差异备份间隔(以小时为单位)。 这是每个差异备份之间的间隔小时数。 这仅适用于实时数据库,但不适用于已删除的数据库。

ShortTermRetentionPolicyName

策略名称。 应始终为“default”。

BackupShortTermRetentionPolicy

短期保留策略。

Name Type Description
id
  • string

资源 ID。

name
  • string

资源名称。

properties.diffBackupIntervalInHours

差异备份间隔(以小时为单位)。 这是每个差异备份之间的间隔小时数。 这仅适用于实时数据库,但不适用于已删除的数据库。

properties.retentionDays
  • integer

备份保留期(以天为单位)。 这是支持多少天时间点还原。

type
  • string

资源类型。

DiffBackupIntervalInHours

差异备份间隔(以小时为单位)。 这是每个差异备份之间的间隔小时数。 这仅适用于实时数据库,但不适用于已删除的数据库。

Name Type Description
12
  • string
24
  • string

ShortTermRetentionPolicyName

策略名称。 应始终为“default”。

Name Type Description
default
  • string