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

Long Term Retention Backups - Update 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}/update?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.requestedBackupStorageRedundancy	BackupStorageRedundancy	复制的备份的存储冗余类型

响应

名称	类型	说明
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 - 超出可用资源可处理的最大请求数的请求数。

示例

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

{
  "properties": {
    "requestedBackupStorageRedundancy": "Geo"
  }
}


import com.azure.core.util.Context;
import com.azure.resourcemanager.sql.models.BackupStorageRedundancy;
import com.azure.resourcemanager.sql.models.UpdateLongTermRetentionBackupParameters;

/** Samples for LongTermRetentionBackups UpdateByResourceGroup. */
public final class Main {
    /*
     * x-ms-original-file: specification/sql/resource-manager/Microsoft.Sql/stable/2021-11-01/examples/
     * ResourceGroupBasedLongTermRetentionBackupUpdate.json
     */
    /**
     * Sample code: Update the long term retention backup.
     *
     * @param azure The entry point for accessing resource management APIs in Azure.
     */
    public static void updateTheLongTermRetentionBackup(com.azure.resourcemanager.AzureResourceManager azure) {
        azure.sqlServers().manager().serviceClient().getLongTermRetentionBackups().updateByResourceGroup(
            "testResourceGroup", "japaneast", "testserver", "testDatabase",
            "55555555-6666-7777-8888-999999999999;131637960820000000", new UpdateLongTermRetentionBackupParameters()
                .withRequestedBackupStorageRedundancy(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": "UpdateBackup",
    "status": "Succeeded",
    "targetBackupStorageRedundancy": "Geo"
  }
}

Status code:: 202

定义

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

BackupStorageRedundancy

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

名称	类型	说明
Geo	string
GeoZone	string
Local	string
Zone	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	资源类型。

UpdateLongTermRetentionBackupParameters

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

名称	类型	说明
properties.requestedBackupStorageRedundancy	BackupStorageRedundancy	复制的备份的存储冗余类型

Long Term Retention Backups - Update By Resource Group

URI 参数

请求正文

响应

示例

Update the long term retention backup.

Sample Request

Sample Response

定义

BackupStorageRedundancy

LongTermRetentionBackupOperationResult

UpdateLongTermRetentionBackupParameters

其他资源