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

Long Term Retention Backups - Copy

参考

服务:: SQL Database

API 版本:: 2021-11-01

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

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 订阅的订阅 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		正在复制备份。
Other Status Codes		错误响应： *** 400 InvalidLongTermRetentionBackupId - SQL 数据库的长期保留备份标识符无效。 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 备份。 400 LongTermRetentionMigrationBackupStorageRedundancyNotAllowed - LTR 复制操作不允许更改备份存储冗余。 400 LongTermRetentionMigrationSubscriptionNotFound - 找不到订阅。 404 SubscriptionDoesNotHaveServer - 找不到请求的服务器 404 ServerNotInSubscriptionResourceGroup - 指定的服务器不存在于指定的资源组和订阅中。 404 ResourceNotFound - 找不到请求的资源。 404 LongTermRetentionMigrationBackupNotFound - 指定的 LTR 备份不存在。 404 OperationIdNotFound - ID 为的操作不存在。 409 LongTermRetentionMigrationRequestConflict - 此 LTR 备份上的冲突操作仍在进行中。 409 LongTermRetentionMigrationBackupConflict - 存在目标数据库的另一个备份时间相同的 LTR 备份。 409 OperationCancelled - 用户已取消该操作。 409 操作中断 - 无法完成对资源的操作，因为它被同一资源上的另一个操作中断。 429 SubscriptionTooManyCreateUpdateRequests - 超出可用资源可处理的最大请求数的请求数。 429 SubscriptionTooManyRequests - 超出可用资源可处理的最大请求数的请求数。 500 LongTermRetentionMigrationRequestFailedToStartOnTarget - 无法在目标区域中启动 LTR 备份复制请求。 500 LongTermRetentionMigrationRequestCopyFailed - LTR 备份 Blob 的复制操作失败。 500 LongTermRetentionMigrationRestoreVerExceeded - 还原验证在达到最大尝试次数后失败。 500 LongTermRetentionMigrationRestoreVerFailed - 还原验证失败。 500 OperationTimedOut - 操作超时并自动回滚。请重试该操作。 503 TooManyRequests - 超出可用资源可处理的最大请求数的请求数。

名称

类型

说明

200 OK

LongTermRetentionBackupOperationResult

已成功复制备份。

202 Accepted

正在复制备份。

Other Status Codes

错误响应： ***

400 InvalidLongTermRetentionBackupId - SQL 数据库的长期保留备份标识符无效。
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 备份。
400 LongTermRetentionMigrationBackupStorageRedundancyNotAllowed - LTR 复制操作不允许更改备份存储冗余。
400 LongTermRetentionMigrationSubscriptionNotFound - 找不到订阅。
404 SubscriptionDoesNotHaveServer - 找不到请求的服务器
404 ServerNotInSubscriptionResourceGroup - 指定的服务器不存在于指定的资源组和订阅中。
404 ResourceNotFound - 找不到请求的资源。
404 LongTermRetentionMigrationBackupNotFound - 指定的 LTR 备份不存在。
404 OperationIdNotFound - ID 为的操作不存在。
409 LongTermRetentionMigrationRequestConflict - 此 LTR 备份上的冲突操作仍在进行中。
409 LongTermRetentionMigrationBackupConflict - 存在目标数据库的另一个备份时间相同的 LTR 备份。
409 OperationCancelled - 用户已取消该操作。
409 操作中断 - 无法完成对资源的操作，因为它被同一资源上的另一个操作中断。
429 SubscriptionTooManyCreateUpdateRequests - 超出可用资源可处理的最大请求数的请求数。
429 SubscriptionTooManyRequests - 超出可用资源可处理的最大请求数的请求数。
500 LongTermRetentionMigrationRequestFailedToStartOnTarget - 无法在目标区域中启动 LTR 备份复制请求。
500 LongTermRetentionMigrationRequestCopyFailed - LTR 备份 Blob 的复制操作失败。
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"
  }
}


import com.azure.resourcemanager.sql.models.BackupStorageRedundancy;
import com.azure.resourcemanager.sql.models.CopyLongTermRetentionBackupParameters;

/**
 * Samples for LongTermRetentionBackups Copy.
 */
public final class Main {
    /*
     * x-ms-original-file:
     * specification/sql/resource-manager/Microsoft.Sql/stable/2021-11-01/examples/LongTermRetentionBackupCopy.json
     */
    /**
     * Sample code: Copy the long term retention backup.
     * 
     * @param azure The entry point for accessing resource management APIs in Azure.
     */
    public static void copyTheLongTermRetentionBackup(com.azure.resourcemanager.AzureResourceManager azure) {
        azure.sqlServers().manager().serviceClient().getLongTermRetentionBackups().copy("japaneast", "testserver",
            "testDatabase", "55555555-6666-7777-8888-999999999999;131637960820000000",
            new CopyLongTermRetentionBackupParameters().withTargetServerResourceId(
                "/subscriptions/00000000-1111-2222-3333-444444444444/providers/Microsoft.Sql/resourceGroups/resourceGroup/servers/testserver2")
                .withTargetDatabaseName("testDatabase2").withTargetBackupStorageRedundancy(BackupStorageRedundancy.GEO),
            com.azure.core.util.Context.NONE);
    }
}

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

示例响应

状态代码:: 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

定义

名称	说明
BackupStorageRedundancy	复制的备份的存储冗余类型
CopyLongTermRetentionBackupParameters	包含执行长期保留备份复制操作所需的信息。
LongTermRetentionBackupOperationResult	LongTermRetentionBackup 操作结果资源。

BackupStorageRedundancy

Enumeration

复制的备份的存储冗余类型

值	说明
Geo
GeoZone
Local
Zone

CopyLongTermRetentionBackupParameters

Object

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

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

LongTermRetentionBackupOperationResult

Object

LongTermRetentionBackup 操作结果资源。

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

通过

Long Term Retention Backups - Copy

URI 参数

请求正文

响应

示例

Copy the long term retention backup.

示例请求

示例响应

定义

BackupStorageRedundancy

CopyLongTermRetentionBackupParameters

LongTermRetentionBackupOperationResult

其他资源