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

Long Term Retention Backups - Update

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

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

POST https://management.azure.com/subscriptions/{subscriptionId}/providers/Microsoft.Sql/locations/{locationName}/longTermRetentionServers/{longTermRetentionServerName}/longTermRetentionDatabases/{longTermRetentionDatabaseName}/longTermRetentionBackups/{backupName}/update?api-version=2021-11-01

Параметры URI

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

string

Имя резервной копии.
locationName
 path True

string

Расположение базы данных.
longTermRetentionDatabaseName
 path True

string

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

string

имя сервера;
subscriptionId
 path True

string

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

string

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

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

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

BackupStorageRedundancy

Тип избыточности хранилища скопированной резервной копии

Ответы

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

LongTermRetentionBackupOperationResult

Резервная копия успешно обновлена.
202 Accepted

Выполняется обновление резервной копии.
Other Status Codes

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

  • 400 InvalidLongTermRetentionBackupId — недопустимый идентификатор резервной копии долгосрочного хранения для баз данных SQL.

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

  • 400 LongTermRetentionMismatchingSubscriptionId — указанный идентификатор подписки не совпадает с идентификатором в других входных данных.

  • 400 LongTermRetentionMismatchingResourceGroupName — предоставленное имя группы ресурсов не совпадает с именем в других входных данных.

  • 400 LongTermRetentionMismatchingServerName — предоставленное имя сервера не совпадает с именем в других входных данных.

  • 400 LongTermRetentionMigrationRequestNotSupported — подписка не поддерживает функцию миграции резервного копирования LTR.

  • 400 LongTermRetentionMigrationCrossClusterRequestNotSupported — исходная и целевая подписки не могут обмениваться данными для функции резервного копирования LTR.

  • 400 LongTermRetentionMigrationParameterMissing — отсутствует обязательный параметр для операции.

  • 400 LongTermRetentionMigrationSameServerNotSupported — функция копирования LTR не поддерживается для копирования резервных копий LTR на одном сервере.

  • 400 LongTermRetentionMigrationTargetServerNotFound — целевой сервер не существует или не готов к операции резервного копирования LTR.

  • 400 LongTermRetentionMigrationTargetDatabaseNotFound — целевая база данных не существует на сервере.

  • 400 LongTermRetentionMigrationStorageTypeNotSupported — указанная избыточность хранилища резервных копий не поддерживается в целевом регионе.

  • 400 LongTermRetentionMigrationStorageMismatch — активная избыточность резервного копирования базы данных не соответствует избыточности резервных копий, запрошенной клиентом.

  • 400 LongTermRetentionMigrationDatabaseTypeNotSupported — миграция LTR поддерживается только для резервных копий управляемого экземпляра и Azure SQL базы данных LTR.

  • 400 LongTermRetentionMigrationBackupStorageRedundancyNotAllowed — изменение избыточности хранилища резервных копий не допускается для операций копирования LTR.

  • 400 LongTermRetentionMigrationSubscriptionNotFound — не удалось найти подписку.

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

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

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

  • 404 LongTermRetentionMigrationBackupNotFound — указанная резервная копия LTR не существует.

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

  • 409 LongTermRetentionMigrationRequestConflict — конфликтная операция с этой резервной копией LTR еще выполняется.

  • 409 LongTermRetentionMigrationBackupConflict — существует другая резервная копия LTR с тем же временем резервного копирования для целевой базы данных.

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

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

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

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

  • 500 LongTermRetentionMigrationRequestFailedToStartOnTarget — не удалось запустить запрос на резервное копирование LTR в целевом регионе.

  • 500 LongTermRetentionMigrationRequestCopyFailed — сбой операции копирования для резервных BLOB-объектов LTR.

  • 500 LongTermRetentionMigrationRestoreVerExceeded — проверка восстановления завершилась сбоем после достижения максимального количества попыток.

  • 500 LongTermRetentionMigrationRestoreVerFailed — сбой проверки восстановления.

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

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

Примеры

Update the long term retention backup.

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

POST https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/providers/Microsoft.Sql/locations/japaneast/longTermRetentionServers/testserver/longTermRetentionDatabases/testDatabase/longTermRetentionBackups/55555555-6666-7777-8888-999999999999;131637960820000000/update?api-version=2021-11-01

{
  "properties": {
    "requestedBackupStorageRedundancy": "Geo"
  }
}

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

Код состояния:
200 
{
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/providers/Microsoft.Sql/locations/japanEast/longTermRetentionBackupOperationResults/a1aa7c77-961b-4fbb-bcd6-aa9acfcd1706",
  "name": "a1aa7c77-961b-4fbb-bcd6-aa9acfcd1706",
  "type": "Microsoft.Sql/locations/longTermRetentionBackupOperationResults",
  "properties": {
    "requestId": "a1aa7c77-961b-4fbb-bcd6-aa9acfcd1706",
    "fromBackupResourceId": "/subscriptions/00000000-1111-2222-3333-444444444444/providers/Microsoft.Sql/locations/japanEast/longTermRetentionServers/testserver/longterRetentionDatabases/testDatabase/longTermRetentionBackups/55555555-6666-7777-8888-999999999999;131637960820000000",
    "operationType": "UpdateBackup",
    "status": "Succeeded",
    "targetBackupStorageRedundancy": "Geo"
  }
}
Код состояния:
202

Определения

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

Тип избыточности хранилища скопированной резервной копии
LongTermRetentionBackupOperationResult

Ресурс результата операции LongTermRetentionBackup.
UpdateLongTermRetentionBackupParameters

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

BackupStorageRedundancy

Enumeration

Тип избыточности хранилища скопированной резервной копии

Значение Описание
Geo
GeoZone
Local
Zone

LongTermRetentionBackupOperationResult

Object

Ресурс результата операции LongTermRetentionBackup.

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

string

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

string

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

string

Идентификатор исходного ресурса резервного копирования
properties.message

string

Сообщение о ходе выполнения
properties.operationType

string

Тип операции.
properties.requestId

string

Идентификатор запроса.
properties.status

string

Состояние операции
properties.targetBackupStorageRedundancy

BackupStorageRedundancy

Тип избыточности хранилища скопированной резервной копии
properties.toBackupResourceId

string

Идентификатор целевого ресурса резервного копирования
type

string

Тип ресурса.

UpdateLongTermRetentionBackupParameters

Object

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

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

BackupStorageRedundancy

Тип избыточности хранилища скопированной резервной копии