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


Long Term Retention Backups - Copy

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

POST https://management.azure.com/subscriptions/{subscriptionId}/providers/Microsoft.Sql/locations/{locationName}/longTermRetentionServers/{longTermRetentionServerName}/longTermRetentionDatabases/{longTermRetentionDatabaseName}/longTermRetentionBackups/{backupName}/copy?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.targetBackupStorageRedundancy

BackupStorageRedundancy

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

properties.targetDatabaseName

string

Имя базы данных, владеющего скопированной резервной копией.

properties.targetResourceGroup

string

Группа ресурсов, владеющая целевым сервером

properties.targetServerFullyQualifiedDomainName

string

Полное доменное имя целевого сервера

properties.targetServerResourceId

string

Идентификатор ресурса целевого сервера, которому принадлежит база данных.

properties.targetSubscriptionId

string

Подписка, владеющая целевым сервером

Ответы

Имя Тип Описание
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 — запросы сверх максимального числа запросов, которые могут быть обработаны доступными ресурсами.

Примеры

Copy 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/copy?api-version=2021-11-01

{
  "properties": {
    "targetServerResourceId": "/subscriptions/00000000-1111-2222-3333-444444444444/providers/Microsoft.Sql/resourceGroups/resourceGroup/servers/testserver2",
    "targetDatabaseName": "testDatabase2",
    "targetBackupStorageRedundancy": "Geo"
  }
}

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

{
  "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": "CopyBackup",
    "status": "Succeeded",
    "toBackupResourceId": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/resourceGroup/providers/Microsoft.Sql/locations/japanEast/longTermRetentionServers/testserver2/longterRetentionDatabases/testDatabase2/longTermRetentionBackups/55555555-6666-7777-8888-111111111111;131637960820000000",
    "targetBackupStorageRedundancy": "Geo"
  }
}

Определения

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

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

CopyLongTermRetentionBackupParameters

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

LongTermRetentionBackupOperationResult

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

BackupStorageRedundancy

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

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

string

GeoZone

string

Local

string

Zone

string

CopyLongTermRetentionBackupParameters

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

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

BackupStorageRedundancy

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

properties.targetDatabaseName

string

Имя базы данных, владеющего скопированной резервной копией.

properties.targetResourceGroup

string

Группа ресурсов, владеющая целевым сервером

properties.targetServerFullyQualifiedDomainName

string

Полное доменное имя целевого сервера

properties.targetServerResourceId

string

Идентификатор ресурса целевого сервера, которому принадлежит база данных.

properties.targetSubscriptionId

string

Подписка, владеющая целевым сервером

LongTermRetentionBackupOperationResult

Ресурс результата операции 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

Тип ресурса.