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

Backup Short Term Retention Policies - Update

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

Обновления политики краткосрочного хранения базы данных.

PATCH 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

Имя политики. Всегда должен иметь значение "default".
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.

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

PATCH 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

Имя политики. Всегда должен иметь значение "default".

BackupShortTermRetentionPolicy

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

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

string

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

string

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

DiffBackupIntervalInHours

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

integer

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

string

Тип ресурса.

DiffBackupIntervalInHours

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

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

string

24

string

ShortTermRetentionPolicyName

Имя политики. Всегда должен иметь значение "default".

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

string