Restore Points - Create

Служба:

SQL Database

Версия API:

2023-08-01

Создает точку восстановления для хранилища данных.

POST https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/servers/{serverName}/databases/{databaseName}/restorePoints?api-version=2023-08-01

Параметры URI

Имя	В	Обязательно	Тип	Описание
databaseName	path	True	string	Имя базы данных.
resourceGroupName	path	True	string	Имя группы ресурсов, содержащей ресурс. Это значение можно получить из API Azure Resource Manager или портала.
serverName	path	True	string	Имя сервера.
subscriptionId	path	True	string	Идентификатор подписки, идентифицирующий подписку Azure.
api-version	query	True	string	Версия API, используемая для запроса.

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

Имя	Обязательно	Тип	Описание
restorePointLabel	True	string	Метка точки восстановления для применения

Ответы

Имя	Тип	Описание
200 OK	RestorePoint	Успешно создан запрос точки восстановления.
201 Created	RestorePoint	Успешно создан запрос точки восстановления.
202 Accepted		Принятый Заголовки Location: string
Other Status Codes	ErrorResponse	Ответы на ошибки: *** 400 FeatureDisabledOnSelectedEdition — пользователь попытался использовать функцию, которая отключена в текущем выпуске базы данных. 400 BackupNotAllowedOnDeactivatedDatabase — не удается создать точку восстановления в деактивированной базе данных. 400 RestorePointLimitReached — точка восстановления не может быть создана, так как база данных превысит допустимую квоту точек восстановления. 400 RestorePointAttemptToDeleteSystemBackup — не удается удалить точку восстановления системы. 404 DatabaseRestorePointNotFound — не удается найти точку восстановления базы данных. 404 SubscriptionDoesNotHaveServer — запрошенный сервер не найден 404 DatabaseDoesNotExist — пользователь указал имя базы данных, которое не существует на этом экземпляре сервера. 404 OperationIdNotFound — операция с идентификатором не существует. 408 DatabaseRestorePointTimedOut — не удалось создать точку восстановления базы данных. 409 CannotCancelOperation — операция управления находится в состоянии, которое не может быть отменено. 409 OperationCancelled — операция отменена пользователем. 409 Operation Прервана — операция с ресурсом не удалось завершить, так как она была прервана другой операцией в том же ресурсе. 429 SubscriptionTooManyCreateUpdateRequests — запросы, превышающие максимальные запросы, которые могут обрабатываться доступными ресурсами. 429 SubscriptionTooManyRequests — запросы, превышающие максимальные запросы, которые могут обрабатываться доступными ресурсами. 500 OperationTimedOut — время ожидания операции истекло и автоматически откатился. Повторите операцию. 503 TooManyRequests — запросы, превышающие максимальные запросы, которые могут обрабатываться доступными ресурсами.

Примеры

Creates datawarehouse database restore point.

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

HTTP

POST https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-SouthEastAsia/providers/Microsoft.Sql/servers/testserver/databases/testDatabase/restorePoints?api-version=2023-08-01

{
  "restorePointLabel": "mylabel"
}

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

Код состояния:

200

{
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/providers/Microsoft.Sql/servers/testserver/databases/testDatabase/restorePoints/131546477590000000",
  "name": "131546477590000000",
  "type": "Microsoft.Sql/servers/databases/restorePoints",
  "location": "japaneast",
  "properties": {
    "restorePointType": "DISCRETE",
    "restorePointCreationDate": "2017-03-10T08:00:00Z",
    "restorePointLabel": "mylabel"
  }
}

Код состояния:

201

{
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/providers/Microsoft.Sql/servers/testserver/databases/testDatabase/restorePoints/131546477590000000",
  "name": "131546477590000000",
  "type": "Microsoft.Sql/servers/databases/restorePoints",
  "location": "southeastasia",
  "properties": {
    "restorePointType": "DISCRETE",
    "restorePointCreationDate": "2017-03-10T08:00:00Z",
    "restorePointLabel": "mylabel"
  }
}

Код состояния:

202

Location: https://management.azure.com/00000000-1111-2222-3333-444444444444/providers/Microsoft.Sql/locations/japaneast/manageddatabaserestoreazureasyncoperation/00000000-1111-2222-3333-444444444444?api-version=2022-11-01-preview

Определения

Имя	Описание
CreateDatabaseRestorePointDefinition	Содержит сведения, необходимые для выполнения операции создания точки восстановления базы данных.
ErrorAdditionalInfo	Дополнительные сведения об ошибке управления ресурсами.
ErrorDetail	Сведения об ошибке.
ErrorResponse	Ответ на ошибку
RestorePoint	Точки восстановления базы данных.
RestorePointType	Тип точки восстановления

CreateDatabaseRestorePointDefinition

Объект

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

Имя	Тип	Описание
restorePointLabel	string	Метка точки восстановления для применения

ErrorAdditionalInfo

Объект

Дополнительные сведения об ошибке управления ресурсами.

Имя	Тип	Описание
info	object	Дополнительные сведения.
type	string	Дополнительный тип сведений.

ErrorDetail

Объект

Сведения об ошибке.

Имя	Тип	Описание
additionalInfo	ErrorAdditionalInfo[]	Дополнительные сведения об ошибке.
code	string	Код ошибки.
details	ErrorDetail[]	Сведения об ошибке.
message	string	Сообщение об ошибке.
target	string	Целевой объект ошибки.

ErrorResponse

Объект

Ответ на ошибку

Имя	Тип	Описание
error	ErrorDetail	Объект ошибки.

RestorePoint

Объект

Точки восстановления базы данных.

Имя	Тип	Описание
id	string	Идентификатор ресурса.
location	string	Расположение ресурса.
name	string	Имя ресурса.
properties.earliestRestoreDate	string (date-time)	Самое раннее время восстановления этой базы данных
properties.restorePointCreationDate	string (date-time)	Время резервного копирования
properties.restorePointLabel	string	Метка точки восстановления для запроса резервного копирования пользователем
properties.restorePointType	RestorePointType	Тип точки восстановления
type	string	Тип ресурса.

RestorePointType

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

Тип точки восстановления

Значение	Описание
CONTINUOUS
DISCRETE