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

Backup Short 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}/backupShortTermRetentionPolicies/default?api-version=2021-11-01

Параметры URI

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

string

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

ShortTermRetentionPolicyName

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

string

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

string

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

string

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

string

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

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

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

DiffBackupIntervalInHours

Интервал разностного резервного копирования в часах. Это количество часов интервала между каждой разностной резервной копией будет поддерживаться. Это применимо только к динамическим базам данных, но не к удаленным базам данных.
properties.retentionDays

integer

Срок хранения резервной копии в днях. Это количество дней, в течение нескольких дней будет поддерживаться восстановление на определенный момент времени.

Ответы

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

BackupShortTermRetentionPolicy

Политика успешно обновлена.
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.

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

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

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

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

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

Определения

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

Краткосрочная политика хранения.
DiffBackupIntervalInHours

Интервал разностного резервного копирования в часах. Это количество часов интервала между каждой разностной резервной копией будет поддерживаться. Это применимо только к динамическим базам данных, но не к удаленным базам данных.
ShortTermRetentionPolicyName

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

BackupShortTermRetentionPolicy

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

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

string

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

string

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

DiffBackupIntervalInHours

Интервал разностного резервного копирования в часах. Это количество часов интервала между каждой разностной резервной копией будет поддерживаться. Это применимо только к динамическим базам данных, но не к удаленным базам данных.
properties.retentionDays

integer

Срок хранения резервной копии в днях. Это количество дней, в течение нескольких дней будет поддерживаться восстановление на определенный момент времени.
type

string

Тип ресурса.

DiffBackupIntervalInHours

Интервал разностного резервного копирования в часах. Это количество часов интервала между каждой разностной резервной копией будет поддерживаться. Это применимо только к динамическим базам данных, но не к удаленным базам данных.

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

string

24

string

ShortTermRetentionPolicyName

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

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

string