你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站,请访问 https://docs.azure.cn

Long Term Retention Backups - Copy By Resource Group

将现有的长期保留备份复制到其他服务器。

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

包含该资源的资源组名称。 可以从 Azure 资源管理器 API 或门户获取此值。

subscriptionId
path True
  • string

用于标识 Azure 订阅的订阅 ID。

api-version
query True
  • string

要用于请求的 API 版本。

请求正文

Name Type Description
properties.targetBackupStorageRedundancy

复制备份的存储冗余类型

properties.targetDatabaseName
  • string

数据库的名称拥有复制的备份。

properties.targetResourceGroup
  • string

拥有目标服务器的资源组

properties.targetServerFullyQualifiedDomainName
  • string

目标服务器的完全限定域名

properties.targetServerResourceId
  • string

拥有数据库的目标服务器的资源 ID

properties.targetSubscriptionId
  • string

拥有目标服务器的订阅

响应

Name Type Description
200 OK

已成功复制备份。

202 Accepted

正在复制备份。

Other Status Codes

错误响应: ***

  • 400 InvalidLongTermRetentionBackupId - SQL DB 的长期保留备份标识符无效。

  • 400 InvalidParameterValue - 向参数提供无效值。

  • 400 LongTermRetentionMismatchingSubscriptionId - 提供的订阅 ID 与其他输入中的 ID 不匹配

  • 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 DB LTR 备份。

  • 404 SubscriptionDoesNotHaveServer - 找不到请求的服务器

  • 404 ServerNotInSubscriptionResourceGroup - 指定的服务器不存在于指定的资源组和订阅中。

  • 404 ResourceNotFound - 找不到请求的资源。

  • 404 LongTermRetentionMigrationBackupNotFound - 指定的 LTR 备份不存在。

  • 409 LongTermRetentionMigrationRequestConflict - 此 LTR 备份上的冲突操作仍在进行中。

  • 409 LongTermRetentionMigrationBackupConflict - 存在目标数据库的同一备份时间的另一个 LTR 备份。

  • 500 LongTermRetentionMigrationRequestFailedToStartOnTarget - 无法在目标区域中启动 LTR 备份复制请求。

  • 500 LongTermRetentionMigrationRequestCopyFailed - LTR 备份 Blob 复制操作失败。

  • 500 LongTermRetentionMigrationRestoreVerExceeded - 在达到最大尝试后还原验证失败。

  • 500 LongTermRetentionMigrationRestoreVerFailed - 还原验证失败。

示例

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

{
  "properties": {
    "targetServerResourceId": "/subscriptions/00000000-1111-2222-3333-444444444444/providers/Microsoft.Sql/resourceGroups/resourceGroup/servers/testserver2",
    "targetDatabaseName": "testDatabase2",
    "targetBackupStorageRedundancy": "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": "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 操作结果资源。

TargetBackupStorageRedundancy

复制备份的存储冗余类型

BackupStorageRedundancy

复制备份的存储冗余类型

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

CopyLongTermRetentionBackupParameters

包含执行长期保留备份复制操作所需的信息。

Name Type Description
properties.targetBackupStorageRedundancy

复制备份的存储冗余类型

properties.targetDatabaseName
  • string

数据库的名称拥有复制的备份。

properties.targetResourceGroup
  • string

拥有目标服务器的资源组

properties.targetServerFullyQualifiedDomainName
  • string

目标服务器的完全限定域名

properties.targetServerResourceId
  • string

拥有数据库的目标服务器的资源 ID

properties.targetSubscriptionId
  • string

拥有目标服务器的订阅

LongTermRetentionBackupOperationResult

LongTermRetentionBackup 操作结果资源。

Name Type Description
id
  • string

资源 ID。

name
  • string

资源名称。

properties.fromBackupResourceId
  • string

源备份资源 ID

properties.message
  • string

进度消息

properties.operationType
  • string

操作类型。

properties.requestId
  • string

请求 ID。

properties.status
  • string

操作状态

properties.targetBackupStorageRedundancy

复制备份的存储冗余类型

properties.toBackupResourceId
  • string

目标备份资源 ID

type
  • string

资源类型。

TargetBackupStorageRedundancy

复制备份的存储冗余类型

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