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

Managed Databases - Update

更新现有的数据库。

PATCH https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/managedInstances/{managedInstanceName}/databases/{databaseName}?api-version=2021-11-01

URI 参数

名称 必需 类型 说明
databaseName
path True

string

数据库的名称。

managedInstanceName
path True

string

托管实例的名称。

resourceGroupName
path True

string

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

subscriptionId
path True

string

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

api-version
query True

string

要用于请求的 API 版本。

请求正文

名称 类型 说明
properties.autoCompleteRestore

boolean

是否自动完成此托管数据库的还原。

properties.catalogCollation

CatalogCollationType

元数据目录的排序规则。

properties.collation

string

托管数据库的排序规则。

properties.createMode

ManagedDatabaseCreateMode

托管数据库创建模式。 PointInTimeRestore:通过还原现有数据库的时间点备份来创建数据库。 必须指定 SourceDatabaseName、SourceManagedInstanceName 和 PointInTime。 RestoreExternalBackup:通过从外部备份文件还原来创建数据库。 必须指定 Collation、StorageContainerUri 和 StorageContainerSasToken。 恢复:通过还原异地复制的备份来创建数据库。 RecoverableDatabaseId 必须指定为要还原的可恢复数据库资源 ID。 RestoreLongTermRetentionBackup:通过从长期保留备份还原 (所需的 longTermRetentionBackupResourceId) 来创建数据库。

properties.lastBackupName

string

用于还原此托管数据库的最后一个备份文件名。

properties.longTermRetentionBackupResourceId

string

要用于还原此托管数据库的长期保留备份的名称。

properties.recoverableDatabaseId

string

与此数据库的创建操作关联的可恢复数据库的资源标识符。

properties.restorableDroppedDatabaseId

string

创建此数据库时要还原的可还原已删除数据库资源 ID。

properties.restorePointInTime

string

条件。 如果 createMode 为 PointInTimeRestore,则此值是必需的。 指定要还原以创建新数据库的源数据库的时间点 (ISO8601 格式) 。

properties.sourceDatabaseId

string

与此数据库的创建操作关联的源数据库的资源标识符。

properties.storageContainerSasToken

string

条件。 如果 createMode 为 RestoreExternalBackup,则此值是必需的。 指定存储容器 sas 令牌。

properties.storageContainerUri

string

条件。 如果 createMode 为 RestoreExternalBackup,则此值是必需的。 指定存储此还原备份的存储容器的 URI。

tags

object

资源标记。

响应

名称 类型 说明
200 OK

ManagedDatabase

已成功更新数据库。

202 Accepted

正在更新托管数据库。

Other Status Codes

错误响应: ***

  • 400 PitrPointInTimeInvalid - 时间 {0} 点无效。 有效的时间点范围从 {1} 早几天到现在,而不是在源服务器创建时间之前。

  • 400 CannotUseTrailingWhitespacesInDatabaseName - 数据库名称验证失败。

  • 400 StorageAccountFull - 托管实例已达到基础 Azure 存储帐户的总容量。 Azure 高级存储帐户的分配空间限制为 35TB。

  • 400 AkvHostNotResolvingFromNode - AKV 主机“”无法从服务器“{0}”{1}上的 SQL 解析。

  • 400 InvalidBackupRetentionPeriod - 的 {0} 保留天数不是有效的配置。 有效的备份保留期(以天为单位)必须介于 和 之间{1}{2}

  • 400 ManagedDatabaseNameInUse - 数据库“”{0}已存在。 请选择其他数据库名称。

  • 400 NoMoreSpaceInManagedInstance - 托管实例已达到其存储限制。 托管实例的存储使用量不能超过 (%d) MB。

  • 400 ManagedInstanceUpdateSloInProgress - “由于托管实例的服务层正在更改,因此无法完成操作。{0}” 请等待正常执行的操作完成,然后重试。”

  • 400 SameKeyMaterialNotFoundOnRemoteServer - 辅助服务器没有主服务器的加密保护程序的密钥材料。

  • 400 SourceDatabaseNotFound - 源数据库不存在。

  • 400 RegionDoesNotSupportVersion - 用户尝试在不支持该服务器版本的位置创建指定版本的服务器。

  • 400 PasswordNotComplex - 提供的密码不够复杂。

  • 400 CannotUseReservedDatabaseName - 此操作中不能使用保留的数据库名称。

  • 400 InvalidServerName - 指定的服务器名称无效。

  • 400 SourceServerNotFound - CreateDatabaseAsCopy API 调用中提供的源数据库 ID 的服务器部分不会映射到现有服务器。

  • 400 TokenTooLong - 提供的令牌太长。

  • 400 CurrentDatabaseSizeExceedsMaxSize - 用户尝试将数据库的最大大小减小到小于当前使用情况的大小。

  • 400 InvalidCollation - 服务器无法识别排序规则。

  • 400 AkvEndpointNotReachableFromNode - 服务器“”{0}上的 SQL 无法访问 AKV 终结点“”。{1}

  • 400 ServerNotFound - 找不到请求的服务器。

  • 400 UnsupportedServiceName - 指定的名称是无效名称,因为它包含一个或多个不受支持的 unicode 字符。

  • 400 CurrentDatabaseLogSizeExceedsMaxSize - 用户尝试将数据库更改为最大日志大小低于当前使用情况的 SKU。

  • 400 DatabaseNumberLimitReached - 达到SQL 数据库 托管实例数据库的最大数目。

  • 400 InvalidDatabaseCreateOrUpdateRequest - 创建或更新数据库操作的请求正文无效。

  • 400 InvalidResourceId - 资源标识符无效。

  • 400 InvalidSourceDatabaseId - 源数据库标识符无效。

  • 400 InvalidRestorableDroppedDatabaseId - 无效的可还原删除数据库标识符

  • 400 MismatchingResourceGroupNameWithUrl - 提供的资源组名称与 URL 中的名称不匹配。

  • 400 MismatchingServerNameWithUrl - 提供的服务器名称与 URL 中的名称不匹配。

  • 400 MismatchingSubscriptionWithUrl - 提供的订阅与 URL 中的订阅不匹配。

  • 400 MissingCollation - 需要排序规则。

  • 400 MissingSourceDatabaseId - 缺少源数据库标识符。

  • 400 MissingRestorePointInTime - 缺少还原时间点

  • 400 MissingStorageContainerSasToken - 缺少存储容器 SAS 令牌

  • 400 MissingStorageContainerUri - 缺少存储容器 URI

  • 400 RestoreableDroppedDatabaseIdGivenForRestoreWithSourceDatabaseId - 在还原创建模式下已提供 sourceDatabaseId 时,无法指定 restoreableDroppedDatabaseId

  • 400 CannotUseReservedDatabaseName - 此操作中不能使用保留的数据库名称。

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

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

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

  • 404 CannotFindServerCertificateWithThumbprint - 找不到指纹为“”{0}的服务器证书。 请使用 PowerShell Cmdlet“Add-AzureRmSqlManagedInstanceTransparentDataEncryptionCertificate”创建证书。

  • 404 CannotFindObject - 找不到对象,因为它不存在或你没有权限

  • 404 SubscriptionNotFound - 找不到请求的订阅。

  • 404 DatabaseDoesNotExist - 用户指定了此服务器实例上不存在的数据库名称。

  • 404 ServerNotInSubscription - 指定的服务器不存在于指定的订阅中。

  • 404 RestoreSourceDatabaseNotFound - 在“”{0}时找不到可还原的数据库“{1}”。

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

  • 409 RemoteDatabaseExists - 目标服务器上已存在目标数据库名称。

  • 409 冲突的DatabaseOperation - 数据库上已经有一些操作,当前操作应等到操作完成。

  • 409 SubscriptionDisabled - 订阅已禁用。

  • 409 ManagementServiceDatabaseBusy - 数据库“”{0}正忙于另一个操作。 请稍后尝试操作。

  • 409 ConflictingSystemOperationInProgress - 数据库上的系统维护操作正在进行中,进一步的操作需要等到它完成。

  • 429 SubscriptionTooManyCreateUpdateRequests - 超出可用资源可处理的最大请求数的请求数。

  • 429 SubscriptionTooManyRequests - 超出可用资源可处理的最大请求数的请求数。

  • 500 ActivateOrDeactivateWorkflowThrottling - 激活或停用工作流失败,因为并发工作流太多

  • 503 DatabaseUnavailable - 操作失败,因为数据库不可用。

  • 503 TooManyRequests - 超出可用资源可处理的最大请求数的请求数。

  • 504 RequestTimeout - 服务请求超出允许的超时。

示例

Updates a managed database with maximal properties
Updates a managed database with minimal properties

Updates a managed database with maximal properties

示例请求

PATCH https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-SouthEastAsia/providers/Microsoft.Sql/managedInstances/managedInstance/databases/testdb?api-version=2021-11-01

{
  "tags": {
    "tagKey1": "TagValue1"
  }
}

示例响应

{
  "tags": {
    "tagKey1": "TagValue1"
  },
  "location": "southeastasia",
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-SouthEastAsia/providers/Microsoft.Sql/servers/testsvr/databases/testdb",
  "name": "testdb"
}

Updates a managed database with minimal properties

示例请求

PATCH https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-SouthEastAsia/providers/Microsoft.Sql/managedInstances/managedInstance/databases/testdb?api-version=2021-11-01

{
  "tags": {
    "tagKey1": "TagValue1"
  }
}

示例响应

{
  "tags": {
    "tagKey1": "TagValue1"
  },
  "location": "southeastasia",
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-SouthEastAsia/providers/Microsoft.Sql/servers/testsvr/databases/testdb",
  "name": "testdb"
}

定义

名称 说明
CatalogCollationType

元数据目录的排序规则。

ManagedDatabase

托管数据库资源。

ManagedDatabaseCreateMode

托管数据库创建模式。 PointInTimeRestore:通过还原现有数据库的时间点备份来创建数据库。 必须指定 SourceDatabaseName、SourceManagedInstanceName 和 PointInTime。 RestoreExternalBackup:通过从外部备份文件还原来创建数据库。 必须指定 Collation、StorageContainerUri 和 StorageContainerSasToken。 恢复:通过还原异地复制的备份来创建数据库。 RecoverableDatabaseId 必须指定为要还原的可恢复数据库资源 ID。 RestoreLongTermRetentionBackup:通过从长期保留备份还原 (所需的 longTermRetentionBackupResourceId) 来创建数据库。

ManagedDatabaseStatus

数据库的状态。

ManagedDatabaseUpdate

托管数据库更新。

CatalogCollationType

元数据目录的排序规则。

名称 类型 说明
DATABASE_DEFAULT

string

SQL_Latin1_General_CP1_CI_AS

string

ManagedDatabase

托管数据库资源。

名称 类型 说明
id

string

资源 ID。

location

string

资源位置。

name

string

资源名称。

properties.autoCompleteRestore

boolean

是否自动完成此托管数据库的还原。

properties.catalogCollation

CatalogCollationType

元数据目录的排序规则。

properties.collation

string

托管数据库的排序规则。

properties.createMode

ManagedDatabaseCreateMode

托管数据库创建模式。 PointInTimeRestore:通过还原现有数据库的时间点备份来创建数据库。 必须指定 SourceDatabaseName、SourceManagedInstanceName 和 PointInTime。 RestoreExternalBackup:通过从外部备份文件还原来创建数据库。 必须指定 Collation、StorageContainerUri 和 StorageContainerSasToken。 恢复:通过还原异地复制的备份来创建数据库。 RecoverableDatabaseId 必须指定为要还原的可恢复数据库资源 ID。 RestoreLongTermRetentionBackup:通过从长期保留备份还原 (所需的 longTermRetentionBackupResourceId) 来创建数据库。

properties.creationDate

string

数据库的创建日期。

properties.defaultSecondaryLocation

string

地理配对区域。

properties.earliestRestorePoint

string

时间点还原的最早还原时间点。

properties.failoverGroupId

string

此托管数据库所属的实例故障转移组资源标识符。

properties.lastBackupName

string

用于还原此托管数据库的最后一个备份文件名。

properties.longTermRetentionBackupResourceId

string

要用于还原此托管数据库的长期保留备份的名称。

properties.recoverableDatabaseId

string

与此数据库的创建操作关联的可恢复数据库的资源标识符。

properties.restorableDroppedDatabaseId

string

创建此数据库时要还原的可还原已删除数据库资源 ID。

properties.restorePointInTime

string

条件。 如果 createMode 为 PointInTimeRestore,则此值是必需的。 指定要还原以创建新数据库的源数据库的时间点 (ISO8601 格式) 。

properties.sourceDatabaseId

string

与此数据库的创建操作关联的源数据库的资源标识符。

properties.status

ManagedDatabaseStatus

数据库的状态。

properties.storageContainerSasToken

string

条件。 如果 createMode 为 RestoreExternalBackup,则此值是必需的。 指定存储容器 sas 令牌。

properties.storageContainerUri

string

条件。 如果 createMode 为 RestoreExternalBackup,则此值是必需的。 指定存储此还原备份的存储容器的 URI。

tags

object

资源标记。

type

string

资源类型。

ManagedDatabaseCreateMode

托管数据库创建模式。 PointInTimeRestore:通过还原现有数据库的时间点备份来创建数据库。 必须指定 SourceDatabaseName、SourceManagedInstanceName 和 PointInTime。 RestoreExternalBackup:通过从外部备份文件还原来创建数据库。 必须指定 Collation、StorageContainerUri 和 StorageContainerSasToken。 恢复:通过还原异地复制的备份来创建数据库。 RecoverableDatabaseId 必须指定为要还原的可恢复数据库资源 ID。 RestoreLongTermRetentionBackup:通过从长期保留备份还原 (所需的 longTermRetentionBackupResourceId) 来创建数据库。

名称 类型 说明
Default

string

PointInTimeRestore

string

Recovery

string

RestoreExternalBackup

string

RestoreLongTermRetentionBackup

string

ManagedDatabaseStatus

数据库的状态。

名称 类型 说明
Creating

string

Inaccessible

string

Offline

string

Online

string

Restoring

string

Shutdown

string

Updating

string

ManagedDatabaseUpdate

托管数据库更新。

名称 类型 说明
properties.autoCompleteRestore

boolean

是否自动完成此托管数据库的还原。

properties.catalogCollation

CatalogCollationType

元数据目录的排序规则。

properties.collation

string

托管数据库的排序规则。

properties.createMode

ManagedDatabaseCreateMode

托管数据库创建模式。 PointInTimeRestore:通过还原现有数据库的时间点备份来创建数据库。 必须指定 SourceDatabaseName、SourceManagedInstanceName 和 PointInTime。 RestoreExternalBackup:通过从外部备份文件还原来创建数据库。 必须指定 Collation、StorageContainerUri 和 StorageContainerSasToken。 恢复:通过还原异地复制的备份来创建数据库。 RecoverableDatabaseId 必须指定为要还原的可恢复数据库资源 ID。 RestoreLongTermRetentionBackup:通过从长期保留备份还原 (所需的 longTermRetentionBackupResourceId) 来创建数据库。

properties.creationDate

string

数据库的创建日期。

properties.defaultSecondaryLocation

string

地理配对区域。

properties.earliestRestorePoint

string

时间点还原的最早还原时间点。

properties.failoverGroupId

string

此托管数据库所属的实例故障转移组资源标识符。

properties.lastBackupName

string

用于还原此托管数据库的最后一个备份文件名。

properties.longTermRetentionBackupResourceId

string

要用于还原此托管数据库的长期保留备份的名称。

properties.recoverableDatabaseId

string

与此数据库的创建操作关联的可恢复数据库的资源标识符。

properties.restorableDroppedDatabaseId

string

创建此数据库时要还原的可还原已删除数据库资源 ID。

properties.restorePointInTime

string

条件。 如果 createMode 为 PointInTimeRestore,则此值是必需的。 指定要还原以创建新数据库的源数据库的时间点 (ISO8601 格式) 。

properties.sourceDatabaseId

string

与此数据库的创建操作关联的源数据库的资源标识符。

properties.status

ManagedDatabaseStatus

数据库的状态。

properties.storageContainerSasToken

string

条件。 如果 createMode 为 RestoreExternalBackup,则此值是必需的。 指定存储容器 sas 令牌。

properties.storageContainerUri

string

条件。 如果 createMode 为 RestoreExternalBackup,则此值是必需的。 指定存储此还原备份的存储容器的 URI。

tags

object

资源标记。