Long Term Retention Backups - Update By Resource Group

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

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

Параметры URI

Name In Required Type Description
backupName
path True
  • string

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

locationName
path True
  • string

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

longTermRetentionDatabaseName
path True
  • string

Имя базы данных

longTermRetentionServerName
path True
  • string

имя сервера;

resourceGroupName
path True
  • string

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

subscriptionId
path True
  • string

Идентификатор подписки Azure.

api-version
query True
  • string

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

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

Name Type Description
properties.requestedBackupStorageRedundancy

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

Ответы

Name Type Description
200 OK

Успешно обновлена резервная копия.

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 базы данных.

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

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

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

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

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

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

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

  • 500 LongTermRetentionMigrationRequestCopyFailed — операция копирования завершилась сбоем для больших двоичных объектов резервного копирования LTR.

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

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

Примеры

Update the long term retention backup.

Sample Request

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

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

Sample Response

{
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/testResourceGroup/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/resourceGroups/testResourceGroup/providers/Microsoft.Sql/locations/japanEast/longTermRetentionServers/testserver/longterRetentionDatabases/testDatabase/longTermRetentionBackups/55555555-6666-7777-8888-999999999999;131637960820000000",
    "operationType": "UpdateBackup",
    "status": "Succeeded",
    "targetBackupStorageRedundancy": "Geo"
  }
}

Определения

BackupStorageRedundancy

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

LongTermRetentionBackupOperationResult

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

RequestedBackupStorageRedundancy

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

UpdateLongTermRetentionBackupParameters

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

BackupStorageRedundancy

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

Name Type Description
Geo
  • string
Local
  • string
Zone
  • string

LongTermRetentionBackupOperationResult

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

Name Type Description
id
  • string

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

name
  • string

Имя ресурса.

properties.fromBackupResourceId
  • string

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

properties.message
  • string

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

properties.operationType
  • string

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

properties.requestId
  • string

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

properties.status
  • string

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

properties.targetBackupStorageRedundancy

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

properties.toBackupResourceId
  • string

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

type
  • string

Тип ресурса.

RequestedBackupStorageRedundancy

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

Name Type Description
Geo
  • string
Local
  • string
Zone
  • string

UpdateLongTermRetentionBackupParameters

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

Name Type Description
properties.requestedBackupStorageRedundancy

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