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

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/servers/{serverName}/databases/{databaseName}/backupLongTermRetentionPolicies/default?api-version=2021-11-01

Параметры URI

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

string

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

LongTermRetentionPolicyName

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

string

Имя группы ресурсов, к которой относится ресурс. Это значение можно получить от API-интерфейса диспетчера ресурсов Azure или портала.
serverName
 path True

string

Имя сервера.
subscriptionId
 path True

string

Идентификатор подписки Azure.
api-version
 query True

string

Версия API для использования в запросе.

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

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

string

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

integer

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

string

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

string

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

Ответы

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

LongTermRetentionPolicy

Политика успешно настроена.
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 OperationInterrupted — не удалось завершить операцию с ресурсом, так как она была прервана другой операцией с тем же ресурсом.

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

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

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

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

Примеры

Create or update the long term retention policy for the database.

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

PUT https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/resourceGroup/providers/Microsoft.Sql/servers/testserver/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/providers/Microsoft.Sql/resourceGroups/resourceGroup/servers/testserver/databases/testDatabase/backupLongTermRetentionPolicies/default",
  "name": "default",
  "type": "Microsoft.Sql/resourceGroups/servers/databases/backupLongTermRetentionPolicies",
  "properties": {
    "weeklyRetention": "P1M",
    "monthlyRetention": "P1Y",
    "yearlyRetention": "P5Y",
    "weekOfYear": 5
  }
}
Код состояния:
202

Определения

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

Политика долгосрочного хранения.
LongTermRetentionPolicyName

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

LongTermRetentionPolicy

Политика долгосрочного хранения.

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

string

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

string

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

string

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

integer

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

string

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

string

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

string

Тип ресурса.

LongTermRetentionPolicyName

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

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

string