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

Managed Instance Long Term Retention Policies - Create Or Update

设置托管数据库的长期保留策略。

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

URI 参数

Name In Required Type Description
databaseName
path True
  • string

数据库的名称。

managedInstanceName
path True
  • string

托管实例的名称。

policyName
path True

策略名称。 应始终为默认值。

resourceGroupName
path True
  • string

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

subscriptionId
path True
  • string

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

api-version
query True
  • string

要用于请求的 API 版本。

请求正文

Name Type Description
properties.monthlyRetention
  • string

ISO 8601 格式的 LTR 备份的每月保留策略。

properties.weekOfYear
  • integer

采用 ISO 8601 格式的年度备份的一周。

properties.weeklyRetention
  • string

ISO 8601 格式的 LTR 备份的每周保留策略。

properties.yearlyRetention
  • string

ISO 8601 格式的 LTR 备份的年度保留策略。

响应

Name Type Description
200 OK

已成功为托管数据库设置 LTR 策略。

202 Accepted

已接受

Other Status Codes

错误响应: ***

  • 400 InvalidResourceRequestBody - 请求正文中的资源或资源属性为空或无效。

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

  • 400 LongTermRetentionMissingWeekOfYear - WeekOfYear 需要在 1 到 52 之间设置才能设置每年保留期。

  • 在预览版中配置数据库级 CMK 时,不支持 400 LTRNotSupportedForPerDBCMK - 长期备份保留期。

  • 400 LongTermRetentionPolicyNotSupported - 此数据库不支持长期保留。

  • 400 LongTermRetentionPolicyInvalid - 长期保留策略无效。

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

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

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

示例

Create or update the LTR policy for the managed database.

Sample Request

PUT https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/testResourceGroup/providers/Microsoft.Sql/managedInstances/testInstance/databases/testDatabase/backupLongTermRetentionPolicies/default?api-version=2022-02-01-preview

{
  "properties": {
    "weeklyRetention": "P1M",
    "monthlyRetention": "P1Y",
    "yearlyRetention": "P5Y",
    "weekOfYear": 5
  }
}

Sample Response

{
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/testResourceGroup/providers/Microsoft.Sql/managedInstances/testInstance/databases/testDatabase/backupLongTermRetentionPolicies/default",
  "name": "default",
  "type": "Microsoft.Sql/resourceGroups/managedInstances/databases/backupLongTermRetentionPolicies",
  "properties": {
    "weeklyRetention": "P1M",
    "monthlyRetention": "P1Y",
    "yearlyRetention": "P5Y",
    "weekOfYear": 5
  }
}

定义

ManagedInstanceLongTermRetentionPolicy

长期保留策略。

ManagedInstanceLongTermRetentionPolicyName

策略名称。 应始终为默认值。

ManagedInstanceLongTermRetentionPolicy

长期保留策略。

Name Type Description
id
  • string

资源 ID。

name
  • string

资源名称。

properties.monthlyRetention
  • string

ISO 8601 格式的 LTR 备份的每月保留策略。

properties.weekOfYear
  • integer

采用 ISO 8601 格式的年度备份的一周。

properties.weeklyRetention
  • string

ISO 8601 格式的 LTR 备份的每周保留策略。

properties.yearlyRetention
  • string

ISO 8601 格式的 LTR 备份的年度保留策略。

type
  • string

资源类型。

ManagedInstanceLongTermRetentionPolicyName

策略名称。 应始终为默认值。

Name Type Description
default
  • string