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

Long Term Retention Backups - Copy By Resource Group

参考

Service:: SQL Database

API Version:: 2021-11-01

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

POST https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/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	服务器名称
resourceGroupName	path	True	string	包含该资源的资源组名称。可以从 Azure 资源管理器 API 或门户获取此值。
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/resourceGroups/testResourceGroup/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.core.util.Context;
import com.azure.resourcemanager.sql.models.BackupStorageRedundancy;
import com.azure.resourcemanager.sql.models.CopyLongTermRetentionBackupParameters;

/** Samples for LongTermRetentionBackups CopyByResourceGroup. */
public final class Main {
    /*
     * x-ms-original-file: specification/sql/resource-manager/Microsoft.Sql/stable/2021-11-01/examples/
     * ResourceGroupBasedLongTermRetentionBackupCopy.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().copyByResourceGroup(
            "testResourceGroup", "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),
            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

Sample Response

Status code:: 200

{
  "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"
  }
}

Status code:: 202

定义

名称	说明
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	拥有数据库的目标服务器的资源 ID
properties.targetSubscriptionId	string	拥有目标服务器的订阅

LongTermRetentionBackupOperationResult

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 By Resource Group

URI 参数

请求正文

响应

示例

Copy the long term retention backup.

Sample Request

Sample Response

定义

BackupStorageRedundancy

CopyLongTermRetentionBackupParameters

LongTermRetentionBackupOperationResult

其他资源