Поделиться через

Managed Instance Long Term Retention Policies - Create Or Update

  • Ссылка
Служба:
SQL Database
Версия API:
2021-11-01

Задает долгосрочную политику хранения управляемой базы данных.

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

Параметры URI

Имя В Обязательно Тип Описание
databaseName
 path True

string

Имя базы данных.
managedInstanceName
 path True

string

Имя управляемого экземпляра.
policyName
 path True

ManagedInstanceLongTermRetentionPolicyName

Имя политики. Всегда должно быть по умолчанию.
resourceGroupName
 path True

string

Имя группы ресурсов, содержащей ресурс. Это значение можно получить из API Azure Resource Manager или портала.
subscriptionId
 path True

string

Идентификатор подписки, идентифицирующий подписку Azure.
api-version
 query True

string

Версия API, используемая для запроса.

Текст запроса

Имя Тип Описание
properties.monthlyRetention

string

Ежемесячная политика хранения для резервной копии LTR в формате ISO 8601.
properties.weekOfYear

integer (int32)

Неделя года для ежегодного резервного копирования в формате ISO 8601.
properties.weeklyRetention

string

Еженедельная политика хранения для резервной копии LTR в формате ISO 8601.
properties.yearlyRetention

string

Ежегодная политика хранения для резервной копии LTR в формате ISO 8601.

Ответы

Имя Тип Описание
200 OK

ManagedInstanceLongTermRetentionPolicy

Успешно установите политику LTR для управляемой базы данных.
202 Accepted

Принято
Other Status Codes

Ответы на ошибки: ***

  • 400 InvalidResourceRequestBody — свойства ресурса или ресурса в тексте запроса пусты или недопустимы.

  • 400 InvalidParameterValue — недопустимое значение было присвоено параметру.

  • 400 LongTermRetentionMissingWeekOfYear - WeekOfYear требуется установить от 1 до 52, чтобы установить ежегодное хранение.

  • 400 LTRNotSupportedForPerDBCMK — долгосрочное хранение резервных копий не поддерживается при настройке CMK на уровне базы данных в предварительной версии.

  • 400 LongTermRetentionPolicyNotSupported — долгосрочное хранение не поддерживается в этой базе данных.

  • 400 LongTermRetentionPolicyInvalid — политика долгосрочного хранения недопустима.

  • 404 SubscriptionDoesNotHaveServer — запрошенный сервер не найден

  • 404 ServerNotInSubscriptionResourceGroup — указанный сервер не существует в указанной группе ресурсов и подписке.

  • 404 ResourceNotFound — запрошенный ресурс не найден.

  • 404 OperationIdNotFound — операция с идентификатором не существует.

  • 409 OperationCancelled — операция отменена пользователем.

  • 409 Operation Прервана — операция с ресурсом не удалось завершить, так как она была прервана другой операцией в том же ресурсе.

  • 429 SubscriptionTooManyCreateUpdateRequests — запросы, превышающие максимальные запросы, которые могут обрабатываться доступными ресурсами.

  • 429 SubscriptionTooManyRequests — запросы, превышающие максимальные запросы, которые могут обрабатываться доступными ресурсами.

  • 500 OperationTimedOut — время ожидания операции истекло и автоматически откатился. Повторите операцию.

  • 503 TooManyRequests — запросы, превышающие максимальные запросы, которые могут обрабатываться доступными ресурсами.

Примеры

Create or update the LTR policy for the managed database.

Образец запроса

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

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

Пример ответа

Код состояния:
200 
{
  "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
  }
}
Код состояния:
202

Определения

Имя Описание
ManagedInstanceLongTermRetentionPolicy

Долгосрочная политика хранения.
ManagedInstanceLongTermRetentionPolicyName

Имя политики. Всегда должно быть по умолчанию.

ManagedInstanceLongTermRetentionPolicy

Object

Долгосрочная политика хранения.

Имя Тип Описание
id

string

Идентификатор ресурса.
name

string

Имя ресурса.
properties.monthlyRetention

string

Ежемесячная политика хранения для резервной копии LTR в формате ISO 8601.
properties.weekOfYear

integer (int32)

Неделя года для ежегодного резервного копирования в формате ISO 8601.
properties.weeklyRetention

string

Еженедельная политика хранения для резервной копии LTR в формате ISO 8601.
properties.yearlyRetention

string

Ежегодная политика хранения для резервной копии LTR в формате ISO 8601.
type

string

Тип ресурса.

ManagedInstanceLongTermRetentionPolicyName

Перечисление

Имя политики. Всегда должно быть по умолчанию.

Значение Описание
default