Long Term Retention Backups - Copy

服务:

SQL Database

API 版本:

2025-01-01

复制现有的长期保留备份。

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

URI 参数

名称	在	必需	类型	说明
backupName	path	True	string	备份名称。
locationName	path	True	string	数据库的位置。
longTermRetentionDatabaseName	path	True	string	数据库的名称
longTermRetentionServerName	path	True	string	服务器的名称
subscriptionId	path	True	string	标识 Azure 订阅的订阅 ID。
api-version	query	True	string	要用于请求的 API 版本。

请求正文

名称	类型	说明
properties.targetBackupStorageRedundancy	BackupStorageRedundancy	复制备份的存储冗余类型
properties.targetDatabaseName	string	数据库的名称拥有复制的备份。
properties.targetResourceGroup	string	拥有目标服务器的资源组
properties.targetServerFullyQualifiedDomainName	string	目标服务器的完全限定域名
properties.targetServerResourceId	string	拥有数据库的目标服务器的资源 ID
properties.targetSubscriptionId	string	拥有目标服务器的订阅

响应

名称	类型	说明
200 OK	LongTermRetentionBackupOperationResult	已成功复制备份。
202 Accepted		正在复制备份。 标头 Location: string
Other Status Codes	ErrorResponse	错误响应： *** 400 ManagedInstanceStoppingOrStopped - 实例处于停止/停止状态时提交的冲突作 400 ManagedInstanceStarting - 实例处于启动状态时提交的冲突作 400 InvalidLongTermRetentionBackupId - SQL DB 的长期保留备份标识符无效。 400 InvalidParameterValue - 为参数提供无效值。 400 LongTermRetentionMismatchingSubscriptionId - 提供的订阅 ID 与其他输入中的 ID 不匹配 400 LongTermRetentionMismatchingResourceGroupName - 提供的资源组名称与其他输入中的名称不匹配 400 LongTermRetentionMismatchingServerName - 提供的服务器名称与其他输入中的名称不匹配 400 DeleteLtrSubscriptionMissing - 删除长期保留备份需要订阅 ID。 400 DeleteLtrServerMissing - 删除长期保留备份需要服务器名称。 400 DeleteLtrDatabaseMissing - 删除长期保留备份需要数据库名称。 400 LtrBackupResourceIdIncorrect - 提供的长期保留备份资源 ID 或备份名称不正确。 400 UpdateBackupStorageAccessTierLTRFailedOnZoneRedundantBackupStorage - 不支持在区域冗余备份存储上存档长期保留备份。 请改用本地冗余或异地冗余存储类型。 400 UpdateBackupStorageAccessTierLtrSubscriptionMissing - 需要订阅 ID 才能更新长期保留备份。 400 UpdateBackupStorageAccessTierLtrServerMissing - 更新长期保留备份需要服务器名称。 400 UpdateBackupStorageAccessTierLtrDatabaseMissing - 更新长期保留备份需要数据库名称。 400 UpdateBackupStorageAccessTierLtrBackupResourceIdIncorrect - 提供的长期保留备份资源 ID 或备份名称不正确。 400 LTRBackupNotExists - 由于备份不存在，因此无法完成作。 400 LongTermRetentionMigrationBackupStorageRedundancyNotAllowed - LTR 复制作不允许更改备份存储冗余。 400 LtrRestoreFailedArchiveStorageTier - 不支持还原存档的长期保留备份。 只能在解除冻结或定期的长期保留备份上执行还原。 400 LtrArchiveStorageTierNotEnabled - 未启用存档长期保留备份。 400 LtrArchiveWrongParameters - 所需 （backupStorageAccessTier， operationMode） 组合不支持 ChangeLongTermRetentionBackupAccessTier。 仅允许（存档、移动）和（热复制）。 400 LTRArchiveRedundancyChangeFailed - 在设置具有“存档”备份存储访问层的长期保留策略时，不支持将备份存储冗余类型更新为区域冗余存储 400 LongTermRetentionMigrationSubscriptionNotFound - 找不到订阅。 400 LtrOperationFailedBackupImmutable - 删除长期保留备份失败，因为备份是不可变的。 400 DeleteLtrBackupWithLegalHold - 无法删除备份，因为备份已设置合法保留。 删除法律保留并重试。 400 LTRBackupImmutableNotSet - 无法完成作，因为备份未配置为不可变性。 400 LTRBackupImmutabilityLocked - 无法完成作，因为备份不可变且已锁定。 400 LongTermRetentionMigrationRequestNotSupported - 不允许订阅 LTR 备份迁移功能。 400 LongTermRetentionMigrationCrossClusterRequestNotSupported - 不允许源订阅和目标订阅为 LTR 备份复制功能进行通信。 400 LongTermRetentionMigrationParameterMissing -作缺少必需的参数。 400 LongTermRetentionMigrationSameServerNotSupported - 不支持在同一服务器中复制 LTR 备份。 400 LongTermRetentionMigrationTargetServerNotFound - 目标服务器不存在或尚未准备好执行 LTR 备份复制作。 400 LongTermRetentionMigrationTargetDatabaseNotFound - 目标数据库不存在于服务器上。 400 LongTermRetentionMigrationStorageTypeNotSupported - 目标区域中不支持指定的备份存储冗余。 400 LongTermRetentionMigrationStorageMismatch - 数据库的主动备份冗余与客户请求的备份冗余不匹配。 400 LongTermRetentionMigrationDatabaseTypeNotSupported - 仅托管实例和 Azure SQL DB LTR 备份支持 LTR 迁移。 404 ServerNotInSubscriptionResourceGroup - 指定的服务器在指定的资源组和订阅中不存在。 404 SubscriptionDoesNotHaveServer - 找不到请求的服务器 404 ResourceNotFound - 找不到请求的资源。 404 LongTermRetentionMigrationBackupNotFound - 指定的 LTR 备份不存在。 404 OperationIdNotFound - ID作不存在。 409 LongTermRetentionMigrationRequestConflict - 此 LTR 备份上的冲突作仍在进行中。 409 LongTermRetentionMigrationBackupConflict - 存在与目标数据库相同的备份时间的另一个 LTR 备份。 409 CannotCancelOperation - 管理作处于无法取消的状态。 409 OperationCancelled -作已被用户取消。 409 OperationInterrupted - 无法完成资源上的作，因为它被同一资源上的另一个作中断。 429 SubscriptionTooManyCreateUpdateRequests - 请求超出可用资源可以处理的最大请求数。 429 SubscriptionTooManyRequests - 请求超出可用资源可以处理的最大请求数。 500 LongTermRetentionMigrationRequestCopyFailed - LTR 备份 Blob 复制作失败。 500 LongTermRetentionMigrationRestoreVerExceeded - 在达到最大尝试后还原验证失败。 500 LongTermRetentionMigrationRestoreVerFailed - 还原验证失败。 500 LongTermRetentionMigrationRequestFailedToStartOnTarget - 无法在目标区域中启动 LTR 备份复制请求。 500 OperationTimedOut -作超时并自动回滚。 请重试该操作。 503 TooManyRequests - 请求超出可用资源可以处理的最大请求数。

示例

Copy the long term retention backup.

示例请求

HTTP

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=2025-01-01

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

状态代码:

202

Location: https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/providers/Microsoft.Sql/locations/japanEast/longTermRetentionBackupOperationResults/a1aa7c77-961b-4fbb-bcd6-aa9acfcd1706?api-version=2021-05-01

定义

名称	说明
BackupStorageRedundancy	复制备份的存储冗余类型
CopyLongTermRetentionBackupParameters	包含执行长期保留备份复制作所需的信息。
ErrorAdditionalInfo	资源管理错误附加信息。
ErrorDetail	错误详细信息。
ErrorResponse	错误响应
LongTermRetentionBackupOperationResult	LongTermRetentionBackup作结果资源。

BackupStorageRedundancy

枚举

复制备份的存储冗余类型

值	说明
Geo
Local
Zone
GeoZone

CopyLongTermRetentionBackupParameters

对象

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

名称	类型	说明
properties.targetBackupStorageRedundancy	BackupStorageRedundancy	复制备份的存储冗余类型
properties.targetDatabaseName	string	数据库的名称拥有复制的备份。
properties.targetResourceGroup	string	拥有目标服务器的资源组
properties.targetServerFullyQualifiedDomainName	string	目标服务器的完全限定域名
properties.targetServerResourceId	string	拥有数据库的目标服务器的资源 ID
properties.targetSubscriptionId	string	拥有目标服务器的订阅

ErrorAdditionalInfo

对象

资源管理错误附加信息。

名称	类型	说明
info	object	附加信息。
type	string	附加信息类型。

ErrorDetail

对象

错误详细信息。

名称	类型	说明
additionalInfo	ErrorAdditionalInfo[]	错误附加信息。
code	string	错误代码。
details	ErrorDetail[]	错误详细信息。
message	string	错误消息。
target	string	错误目标。

ErrorResponse

对象

错误响应

名称	类型	说明
error	ErrorDetail	错误对象。

LongTermRetentionBackupOperationResult

对象

LongTermRetentionBackup作结果资源。

名称	类型	说明
id	string	资源 ID。
name	string	资源名称。
properties.fromBackupResourceId	string	源备份资源 ID
properties.message	string	进度消息
properties.operationType	string	作类型。
properties.requestId	string (uuid)	请求 ID。
properties.status	string	操作状态
properties.targetBackupStorageRedundancy	BackupStorageRedundancy	复制备份的存储冗余类型
properties.toBackupResourceId	string	目标备份资源 ID
type	string	资源类型。