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

Managed 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/managedInstances/{managedInstanceName}/databases/{databaseName}/backupShortTermRetentionPolicies/default?api-version=2021-11-01

Параметры URI

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

string

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

string

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

ManagedShortTermRetentionPolicyName

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

string

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

string

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

string

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

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

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

integer

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

Ответы

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

ManagedBackupShortTermRetentionPolicy

Политика успешно обновлена.
202 Accepted

Принято
Other Status Codes

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

  • 400 InvalidBackupRetentionDays — дни {0} хранения не являются допустимой конфигурацией. Допустимое хранение резервных копий должно быть с шагом в 7 дней (7, 14, 21 и т. д.)

  • 400 InvalidRestorableDroppedDatabaseDeletionDate — указана недопустимая дата удаления базы данных с возможностью восстановления

  • 400 InvalidRestorableDroppedDatabaseId — недопустимый восстанавливаемый идентификатор базы данных

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

  • 400 InvalidBackupRetentionPeriod — дни {0} хранения не являются допустимой конфигурацией. Допустимое хранение резервных копий в днях должно находиться между {1} и {2}

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

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

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

  • 404 SourceDatabaseNotFound — база данных-источник не существует.

  • 404 CannotFindObject — не удается найти объект, так как он не существует или у вас нет разрешений

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

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

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

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

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

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

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

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

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

  • 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/managedInstances/testsvr/databases/testdb/backupShortTermRetentionPolicies/default?api-version=2021-11-01

{
  "properties": {
    "retentionDays": 14
  }
}

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

Код состояния:
200 
{
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/resourceGroup/providers/Microsoft.Sql/managedInstances/testsvr/databases/testdb/backupShortTermRetentionPolicies/default",
  "name": "default",
  "type": "Microsoft.Sql/managedInstances/databases/backupShortTermRetentionPolicies",
  "properties": {
    "retentionDays": 14
  }
}
Код состояния:
202

Определения

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

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

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

ManagedBackupShortTermRetentionPolicy

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

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

string

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

string

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

integer

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

string

Тип ресурса.

ManagedShortTermRetentionPolicyName

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

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

string