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

Managed Databases - Create Or Update

创建新的数据库或更新现有数据库。

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/managedInstances/{managedInstanceName}/databases/{databaseName}?api-version=2023-08-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 版本。

请求正文

名称 必需 类型 说明
___location True

string

资源位置。

properties.autoCompleteRestore

boolean

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

properties.catalogCollation

CatalogCollationType

元数据目录的排序规则。

properties.collation

string

托管数据库的排序规则。

properties.createMode

ManagedDatabaseCreateMode

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

properties.crossSubscriptionRestorableDroppedDatabaseId

string

可还原的跨订阅删除的数据库资源 ID,用于在创建此数据库时还原。

properties.crossSubscriptionSourceDatabaseId

string

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

properties.crossSubscriptionTargetManagedInstanceId

string

跨订阅还原中使用的目标托管实例 ID。

properties.isLedgerOn

boolean

此数据库是否为账本数据库,这意味着数据库中的所有表都是账本表。 注意:创建数据库后,无法更改此属性的值。

properties.lastBackupName

string

用于还原此托管数据库的上次备份文件名。

properties.longTermRetentionBackupResourceId

string

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

properties.recoverableDatabaseId

string

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

properties.restorableDroppedDatabaseId

string

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

properties.restorePointInTime

string (date-time)

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

properties.sourceDatabaseId

string

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

properties.storageContainerIdentity

string

有條件的。 如果 createMode 为 RestoreExternalBackup,则使用此值。 指定用于存储容器身份验证的标识。 可以是“SharedAccessSignature”或“ManagedIdentity”;如果未指定“SharedAccessSignature”,则假定为

properties.storageContainerSasToken

string

有條件的。 如果 createMode 为 RestoreExternalBackup 且 storageContainerIdentity 不是 ManagedIdentity,则此值是必需的。 指定存储容器 sas 令牌。

properties.storageContainerUri

string

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

tags

object

资源标记。

响应

名称 类型 说明
200 OK

ManagedDatabase

已成功更新数据库。

201 Created

ManagedDatabase

已成功创建数据库。

202 Accepted

接受

标头

Location: string

Other Status Codes

ErrorResponse

错误响应: ***

  • 400 ManagedInstanceStoppingOrStopped - 实例处于停止/停止状态时提交的冲突作

  • 400 ManagedInstanceStarting - 实例处于启动状态时提交的冲突作

  • 400 AkvEndpointNotReachableFromNode - AKV 终结点“{0}”无法从 SQL 访问,位于服务器“{1}”。

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

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

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

  • 400 CannotUpdateIsLedgerDatabase - 无法更新现有数据库的账本属性。

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

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

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

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

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

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

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

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

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

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

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

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

  • 400 ManagedInstanceStoppingOrStopped - 实例处于停止/停止状态时提交的冲突作

  • 400 InvalidBackupRetentionPeriod - {0} 的保留期不是有效的配置。 有效的备份保留期必须在 {1} 和 {2} 之间

  • 400 ManagedInstanceStarting - 实例处于启动状态时提交的冲突作

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

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

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

  • 400 ManagedInstanceUpdateSloInProgress - “作无法完成,因为托管实例'{0}'的服务层更改正在进行中。 请等待作完成,然后重试。

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

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

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

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

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

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

  • 400 InvalidCrossSubscriptionTargetManagedInstanceId - 跨订阅目标托管实例标识符无效。

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

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

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

  • 400 MissingCollation - 需要排序规则。

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

  • 400 MissingRestorePointInTime - 缺少还原时间点

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

  • 400 MissingStorageContainerUri - 缺少存储容器 URI

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

  • 400 CrossSubscriptionRestorableDroppedDatabaseIdGivenForRestoreWithCrossSubscriptionSourceDatabaseId - 无法在给定 crossSubscriptionRestorableDroppedDatabaseId 时指定 crossSubscriptionDatabaseId。

  • 400 MissmatchingCrossSubscriptionTargetManagedInstanceIdWithUrl - 提供的 crossSubscriptionTargetManagedInstanceId 必须与 URL 中的实例匹配。

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

  • 400 InvalidLongTermRetentionManagedInstanceBackupId - 托管实例的长期保留备份标识符无效。

  • 400 LongTermRetentiontBackupOperationResultsInvalidODataQuery - 指定的 OData 查询无效或不受支持

  • 400 LongTermRetentionMigrationRequestNotSupported - 不允许订阅 LTR 备份迁移功能。

  • 400 LongTermRetentionMigrationCrossClusterRequestNotSupported - 不允许源订阅和目标订阅为 LTR 备份复制功能进行通信。

  • 400 LongTermRetentionMigrationParameterMissing -作缺少必需的参数。

  • 400 LongTermRetentionMigrationSameServerNotSupported - 不支持在同一服务器中复制 LTR 备份。

  • 400 LongTermRetentionMigrationTargetServerNotFound - 目标服务器不存在或尚未准备好执行 LTR 备份复制作。

  • 400 LongTermRetentionMigrationTargetDatabaseNotFound - 目标数据库不存在于服务器上。

  • 400 LongTermRetentionMigrationStorageTypeNotSupported - 目标区域中不支持指定的备份存储冗余。

  • 400 LongTermRetentionMigrationStorageMismatch - 数据库的主动备份冗余与客户请求的备份冗余不匹配。

  • 400 LtrOperationFailedBackupImmutable - 删除长期保留备份失败,因为备份是不可变的。

  • 400 LongTermRetentionMigrationDatabaseTypeNotSupported - 仅托管实例和 Azure SQL DB LTR 备份支持 LTR 迁移。

  • 400 LongTermRetentionMigrationBackupStorageRedundancyNotAllowed - LTR 复制作不允许更改备份存储冗余。

  • 400 LtrRestoreFailedArchiveStorageTier - 不支持还原存档的长期保留备份。 只能在解除冻结或定期的长期保留备份上执行还原。

  • 400 LtrArchiveStorageTierNotEnabled - 未启用存档长期保留备份。

  • 400 LtrArchiveWrongParameters - 所需 (backupStorageAccessTier, operationMode) 组合不支持 ChangeLongTermRetentionBackupAccessTier。 仅允许(存档、移动)和(热复制)。

  • 400 LTRArchiveRedundancyChangeFailed - 在设置具有“存档”备份存储访问层的长期保留策略时,不支持将备份存储冗余类型更新为区域冗余存储

  • 400 LongTermRetentionMigrationSubscriptionNotFound - 找不到订阅。

  • 400 ManagementServiceManagedServerDisabled - 由于禁用托管实例“{0}”,作失败。 请启用托管实例,然后重试。

  • 400 MiGeoRestoreWithWrongBackupStorageRedundancy - 对于具有 LRS/ZRS 备份存储冗余的托管实例,不允许 Geo-Restore。

  • 400 LastBackupNameHasNewline - 请勿在 lastBackupName 中使用禁止字符(“\n”、“\r”)。

  • 400 LastBackupNameHasNonAsciiCharacter -作已中止,因为“LastBackupName”参数包含无效字符。 仅允许 ASCII 字符。

  • 400 ProvisioningDisabled - 按原样显示资源作授权者的错误消息,无需更改

  • 400 LRSCutoverDatabaseDoesNotExist -作已中止,因为请求中指定的数据库名称与指定服务器上的任何数据库名称不匹配。

  • 400 LRSCutoverDatabaseNotInRestoringState -作已中止,因为指定的数据库未处于还原状态。

  • 400 LRSCutoverDatabaseAlreadyRestored -作已中止,因为已还原指定的数据库。

  • 400 LRSCutoverAlreadyInitiated -作已中止,因为指定的数据库的直接转换正在进行中。

  • 400 ManagementServiceFeatureDisabled - 用户尝试使用禁用的功能。

  • 400 AadOnlyAuthenticationIsEnabled - 已启用 Azure Active Directory 仅身份验证。 请与系统管理员联系。

  • 400 UpdateingInstanceAndBackupRedundancy - 实例区域冗余和备份存储冗余不能在同一请求中更新。

  • 400 DeleteOfManagedInstanceIsDisabled - 禁用托管实例的删除作。

  • 400 RequestCantLandOnPaaSv2Platform - 请求需要登陆 PaaSv2 平台,但未启用 PaaSv2。

  • 400 CustomMaintenanceWindowIsDisabled - 未启用自定义维护时段。

  • 400 DeleteOfVersion2VirtualClusterIsDisabled - 未启用版本 2 的虚拟群集删除。

  • 400 DeleteOfVirtualClusterIsDisabled - 未启用虚拟群集删除。

  • 400 MICantBeMovedFromOrToInstancePool - 无法将现有托管实例移动到托管实例池。

  • 400 DnsRefreshOnVirtualClusterIsDisabled - 未启用虚拟群集上的 DNS 记录刷新。

  • 400 TimeoutDuringRestore - 尝试连接到还原目标时遇到超时。

  • 400 AutoCompleteMissingLastBackupName - 自动完成还原请求必须提供 lastBackupName 参数。

  • 400 MissingThumbprint - 找不到服务器证书。

  • 400 BlobStorageServerFailure - Blob 存储服务器失败。

  • 400 BackupSetNotFound - 找不到用于还原数据库的备份。 请联系支持人员还原数据库。

  • 400 FullBackupNotFound - 找不到完整备份。

  • 400 RestoreFromStripedBackupsNotEnabled - 不支持从条带备份还原。

  • 400 BrokenRestorePlanNoFullBackup - 还原计划已中断,因为没有完整备份。

  • 400 BrokenRestorePlanWrongLogBackupLSN - 还原计划中断,因为当前日志备份的 firstLsn 不 <= 下一个日志备份的 lastLsn。

  • 400 BrokenRestorePlanWrongDiffBackupLSN - 还原计划中断,因为差异备份的 firstLsn 不是 >= 完整备份的第一个Lsn。

  • 400 BrokenRestorePlanGapInLogBackups - 还原计划中断,因为当前日志备份的 firstLsn 不等于上一个日志备份的 lastLsn。

  • 400 TargetServerDoesNotExist - 目标服务器 {0} 不存在或尚未就绪。 请检查是否存在并重试还原请求。

  • 400 TargetServerRestoreNotAllowed - 目标服务器 {0} 当前未处于允许启动还原的状态。

  • 400 XtpInitializedDuringRestore - 内存优化文件组必须为空,才能在 SQL 数据库托管实例的“常规用途”层上还原。

  • 400 FullBackupMissingChecksum - 提供的完整备份缺少校验和。

  • 400 FullBackupDamaged - 提供的完整备份已损坏。

  • 400 MissingStripeInBackupSet - 提供的备份集具有一个或多个缺失的条带。

  • 400 BackupsFromMultipleDatabasesDetectedInTheContainerWhileRestoreInProgress - 容器文件夹中有多个数据库的备份。 请确保容器文件夹具有来自单个数据库的备份。{0}

  • 400 BrokenRestorePlanWrongDiffBaseGUID - 还原计划中断,因为差异备份的 DifferentialBaseGuid 与完整备份的 BackupSetGuid 不匹配。

  • 400 CorruptedPagesInBackupSet -作已中止,因为 RESTORE 检测到备份集中的一个或多个损坏的页面。

  • 400 ManagedIdentityIssueDetectedWhileRestoreInProgress - 未正确设置托管标识。 请验证并重试。

  • 400 CorruptedPagesListMaintenance -作已中止,因为处理未进行校验和的备份时发生了内部错误。

  • 400 StorageBrokenIssueDetectedWhileInProgress - 存储连接已中断。 自动重试...

  • 400 PartiallyContainedDatabaseUnsupported - “不支持部分包含数据库的备份”。

  • 400 RequiredBackupIsNotLastRestored - 无法完成迁移,因为提供的备份文件名不是还原的最后一个备份文件的名称。

  • 400 ManagedInstanceStorageLimitHit - 托管实例已达到其存储限制。

  • 400 IncompatiblePhysicalLayoutTooFewDataFiles - 数据库备份包含不兼容的物理布局。 备份中未找到任何数据文件。

  • 400 IncompatiblePhysicalLayoutNonOnlineDataFilesExist - 数据库备份包含不兼容的物理布局。 存在非联机数据文件。

  • 400 IncompatiblePhysicalLayoutWrongNumberOfLogFiles - 数据库备份包含不兼容的物理布局。 不支持多个日志文件。

  • 400 IncompatiblePhysicalLayoutNonOnlineLogFilesExist - 数据库备份包含不兼容的物理布局。 存在非联机日志文件。

  • 400 IncompatiblePhysicalLayoutTooManyNonDataLogFiles - 数据库备份包含不兼容的物理布局。 过多的非数据/日志文件。

  • 400 ExternalBackupAlreadySignaledToComplete - 还原请求已发出完成信号。

  • 400 ExternalBackupRestoreHasNotBeenStarted - 还原请求只能在还原启动后完成。

  • 400 ExternalBackupUpgradeInProgress - 还原请求无法完成,因为升级正在进行。

  • 400 IncompatiblePhysicalLayoutTooManyXTPFiles - 数据库备份包含不兼容的物理布局。 在包含MEMORY_OPTIMIZED_DATA的文件组中找到多个文件。

  • 400 BlobStorageFailure - Blob 存储失败。

  • 400 BackupsFromMultipleDatabasesDetectedInTheContainerFromTheStart - 容器文件夹中有多个数据库的备份。 请确保容器文件夹具有来自单个数据库的备份。{0}

  • 400 ManagedIdentityIssueDetectedFromTheStart - 未正确设置托管标识。 请验证并重试。

  • 400 StorageBrokenIssueDetectedAtTheStart - 存储连接中断。 请验证并重试。

  • 400 StorageBrokenIssueDetectedTerminateRetries - 存储连接仍然中断。 请验证并重试。

  • 400 BackupSetBroken - 备份集已损坏。

  • 400 SqlRestoreError - 还原备份时发生不可重试的错误。

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

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

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

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

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

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

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

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

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

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

  • 404 LongTermRetentionMigrationBackupNotFound - 指定的 LTR 备份不存在。

  • 404 OperationIdNotFound - ID作不存在。

  • 409 SubscriptionDisabled - 已禁用订阅。

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

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

  • 409 ConflictingDatabaseOperation - 数据库上已经有一些作,当前作应等到作完成。

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

  • 409 LongTermRetentionMigrationRequestConflict - 此 LTR 备份上的冲突作仍在进行中。

  • 409 LongTermRetentionMigrationBackupConflict - 存在与目标数据库相同的备份时间的另一个 LTR 备份。

  • 409 MiCreateFailedNonDelegatedSubnet - 用户尝试在子网中部署未委托给 Microsoft.Sql/managedInstances 的托管实例或托管实例池。

  • 409 InstancePoolBusy - 实例池正忙于另一个正在进行的作

  • 409 ConflictingManagedInstanceOperation - 托管实例当前正在进行作。

  • 409 BackupRedundancyUpdateAndInstanceRedundancyConflict - 实例是多 az,但备份存储正在从区域冗余更新为非区域冗余。

  • 409 InstanceRedundancyUpdateWhileBackupRedundancyUpdateInProgress - 无法更新实例冗余,因为备份存储冗余更新正在进行中。

  • 409 InstanceRedundancyUpdateAndBackupRedundancyConflict - 备份存储是非区域冗余的,但实例冗余正在更新为区域冗余。

  • 409 BackupRedundancyUpdateConflict - 无法更新备份存储冗余,因为备份存储冗余更新正在进行中。

  • 409 MiDropFailedOnAuthLocks - 用户尝试删除已对资源应用了锁定的子网中的最后一个托管实例。

  • 409 CannotCancelOperation - 管理作处于无法取消的状态。

  • 409 OperationCancelled -作已被用户取消。

  • 409 OperationInterrupted - 无法完成资源上的作,因为它被同一资源上的另一个作中断。

  • 412 InstanceNotReadyForBackupRedundancyUpdate - 无法更新备份存储冗余,因为实例尚未就绪。

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

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

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

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

  • 429 ConflictingSubscriptionOperation - 订阅当前正在进行作。

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

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

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

  • 500 LongTermRetentionMigrationRequestFailedToStartOnTarget - 无法在目标区域中启动 LTR 备份复制请求。

  • 500 LongTermRetentionMigrationRequestCopyFailed - LTR 备份 Blob 复制作失败。

  • 500 LongTermRetentionMigrationRestoreVerExceeded - 在达到最大尝试后还原验证失败。

  • 500 LongTermRetentionMigrationRestoreVerFailed - 还原验证失败。

  • 500 OperationTimedOut -作超时并自动回滚。 请重试该作。

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

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

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

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

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

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

示例

Creates a new managed database by restoring from an external backup
Creates a new managed database by restoring from an external backup using managed identity
Creates a new managed database from restoring a geo-replicated backup
Creates a new managed database from restoring a long term retention backup
Creates a new managed database using cross subscription point in time restore
Creates a new managed database using point in time restore
Creates a new managed database with ledger on.
Creates a new managed database with maximal properties
Creates a new managed database with minimal properties

Creates a new managed database by restoring from an external backup

示例请求

PUT https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-SouthEastAsia/providers/Microsoft.Sql/managedInstances/managedInstance/databases/managedDatabase?api-version=2023-08-01

{
  "properties": {
    "createMode": "RestoreExternalBackup",
    "storageContainerUri": "https://myaccountname.blob.core.windows.net/backups",
    "storageContainerSasToken": "sv=2015-12-11&sr=c&sp=rl&sig=1234",
    "collation": "SQL_Latin1_General_CP1_CI_AS",
    "autoCompleteRestore": true,
    "lastBackupName": "last_backup_name"
  },
  "___location": "southeastasia"
}

示例响应

{
  "tags": {
    "tagKey1": "TagValue1"
  },
  "___location": "southeastasia",
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-SouthEastAsia/providers/Microsoft.Sql/managedInstances/testsvr/databases/testdb1",
  "name": "testdb1",
  "properties": {
    "collation": "SQL_Latin1_General_CP1_CI_AS",
    "status": "Online",
    "creationDate": "2017-06-07T04:41:33.937Z",
    "defaultSecondaryLocation": "North Europe",
    "isLedgerOn": false
  },
  "type": "Microsoft.Sql/managedInstances/databases"
}
{
  "tags": {
    "tagKey1": "TagValue1"
  },
  "___location": "southeastasia",
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-SouthEastAsia/providers/Microsoft.Sql/managedInstances/testsvr/databases/testdb2",
  "name": "testdb2",
  "properties": {
    "collation": "SQL_Latin1_General_CP1_CI_AS",
    "status": "Online",
    "creationDate": "2017-06-07T04:41:33.937Z",
    "defaultSecondaryLocation": "North Europe",
    "isLedgerOn": false
  },
  "type": "Microsoft.Sql/managedInstances/databases"
}

Creates a new managed database by restoring from an external backup using managed identity

示例请求

PUT https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-SouthEastAsia/providers/Microsoft.Sql/managedInstances/managedInstance/databases/managedDatabase?api-version=2023-08-01

{
  "properties": {
    "createMode": "RestoreExternalBackup",
    "storageContainerUri": "https://myaccountname.blob.core.windows.net/backups",
    "storageContainerIdentity": "ManagedIdentity",
    "collation": "SQL_Latin1_General_CP1_CI_AS",
    "autoCompleteRestore": true,
    "lastBackupName": "last_backup_name"
  },
  "___location": "southeastasia"
}

示例响应

{
  "tags": {
    "tagKey1": "TagValue1"
  },
  "___location": "southeastasia",
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-SouthEastAsia/providers/Microsoft.Sql/managedInstances/testsvr/databases/testdb1",
  "name": "testdb1",
  "properties": {
    "collation": "SQL_Latin1_General_CP1_CI_AS",
    "status": "Online",
    "creationDate": "2017-06-07T04:41:33.937Z",
    "defaultSecondaryLocation": "North Europe",
    "isLedgerOn": false
  },
  "type": "Microsoft.Sql/managedInstances/databases"
}
{
  "tags": {
    "tagKey1": "TagValue1"
  },
  "___location": "southeastasia",
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-SouthEastAsia/providers/Microsoft.Sql/managedInstances/testsvr/databases/testdb2",
  "name": "testdb2",
  "properties": {
    "collation": "SQL_Latin1_General_CP1_CI_AS",
    "status": "Online",
    "creationDate": "2017-06-07T04:41:33.937Z",
    "defaultSecondaryLocation": "North Europe",
    "isLedgerOn": false
  },
  "type": "Microsoft.Sql/managedInstances/databases"
}

Creates a new managed database from restoring a geo-replicated backup

示例请求

PUT https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-SouthEastAsia/providers/Microsoft.Sql/managedInstances/server1/databases/testdb_recovered?api-version=2023-08-01

{
  "___location": "southeastasia",
  "properties": {
    "createMode": "Recovery",
    "recoverableDatabaseId": "/subscriptions/11111111-2222-3333-4444-555555555555/resourceGroups/Default-SQL-WestEurope/providers/Microsoft.Sql/managedInstances/testsvr/recoverableDatabases/testdb"
  }
}

示例响应

{
  "tags": {
    "tagKey1": "TagValue1"
  },
  "___location": "southeastasia",
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-SouthEastAsia/providers/Microsoft.Sql/managedInstances/server1/recoverableDatabases/testdb_recovered",
  "name": "testdb_recovered",
  "properties": {
    "collation": "SQL_Latin1_General_CP1_CI_AS",
    "status": "Online",
    "creationDate": "2018-11-07T04:41:33.937Z",
    "isLedgerOn": false
  },
  "type": "Microsoft.Sql/managedInstances/databases"
}
{
  "tags": {
    "tagKey1": "TagValue1"
  },
  "___location": "southeastasia",
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-SouthEastAsia/providers/Microsoft.Sql/managedInstances/testsvr/recoverableDatabases/testdb_recovered",
  "name": "testdb_recovered",
  "properties": {
    "collation": "SQL_Latin1_General_CP1_CI_AS",
    "status": "Online",
    "creationDate": "2018-11-07T04:41:33.937Z",
    "isLedgerOn": false
  },
  "type": "Microsoft.Sql/managedInstances/databases"
}

Creates a new managed database from restoring a long term retention backup

示例请求

PUT https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-SouthEastAsia/providers/Microsoft.Sql/managedInstances/managedInstance/databases/managedDatabase?api-version=2023-08-01

{
  "properties": {
    "createMode": "RestoreExternalBackup",
    "storageContainerUri": "https://myaccountname.blob.core.windows.net/backups",
    "storageContainerSasToken": "sv=2015-12-11&sr=c&sp=rl&sig=1234",
    "collation": "SQL_Latin1_General_CP1_CI_AS"
  },
  "___location": "southeastasia"
}

示例响应

{
  "tags": {
    "tagKey1": "TagValue1"
  },
  "___location": "southeastasia",
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-SouthEastAsia/providers/Microsoft.Sql/managedInstances/testsvr/databases/testdb1",
  "name": "testdb1",
  "properties": {
    "collation": "SQL_Latin1_General_CP1_CI_AS",
    "status": "Online",
    "creationDate": "2017-06-07T04:41:33.937Z",
    "defaultSecondaryLocation": "North Europe",
    "isLedgerOn": false
  },
  "type": "Microsoft.Sql/managedInstances/databases"
}
{
  "tags": {
    "tagKey1": "TagValue1"
  },
  "___location": "southeastasia",
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-SouthEastAsia/providers/Microsoft.Sql/managedInstances/testsvr/databases/testdb2",
  "name": "testdb2",
  "properties": {
    "collation": "SQL_Latin1_General_CP1_CI_AS",
    "status": "Online",
    "creationDate": "2017-06-07T04:41:33.937Z",
    "defaultSecondaryLocation": "North Europe",
    "isLedgerOn": false
  },
  "type": "Microsoft.Sql/managedInstances/databases"
}

Creates a new managed database using cross subscription point in time restore

示例请求

PUT https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-SouthEastAsia/providers/Microsoft.Sql/managedInstances/managedInstance/databases/managedDatabase?api-version=2023-08-01

{
  "___location": "southeastasia",
  "properties": {
    "createMode": "PointInTimeRestore",
    "crossSubscriptionTargetManagedInstanceId": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-SouthEastAsia/providers/Microsoft.Sql/managedInstances/testsvr",
    "crossSubscriptionSourceDatabaseId": "/subscriptions/11111111-2222-3333-4444-555555555555/resourceGroups/Default-SQL-SouthEastAsia/providers/Microsoft.Sql/managedInstances/testsvr2/databases/testdb",
    "restorePointInTime": "2017-07-14T05:35:31.503Z"
  }
}

示例响应

{
  "tags": {
    "tagKey1": "TagValue1"
  },
  "___location": "southeastasia",
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-SouthEastAsia/providers/Microsoft.Sql/managedInstances/testsvr/databases/testdb1",
  "name": "testdb1",
  "properties": {
    "collation": "SQL_Latin1_General_CP1_CI_AS",
    "status": "Online",
    "creationDate": "2017-06-07T04:41:33.937Z",
    "defaultSecondaryLocation": "North Europe",
    "isLedgerOn": false
  },
  "type": "Microsoft.Sql/managedInstances/databases"
}
{
  "tags": {
    "tagKey1": "TagValue1"
  },
  "___location": "southeastasia",
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-SouthEastAsia/providers/Microsoft.Sql/managedInstances/testsvr/databases/testdb2",
  "name": "testdb2",
  "properties": {
    "collation": "SQL_Latin1_General_CP1_CI_AS",
    "status": "Online",
    "creationDate": "2017-06-07T04:41:33.937Z",
    "defaultSecondaryLocation": "North Europe",
    "isLedgerOn": false
  },
  "type": "Microsoft.Sql/managedInstances/databases"
}

Creates a new managed database using point in time restore

示例请求

PUT https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-SouthEastAsia/providers/Microsoft.Sql/managedInstances/managedInstance/databases/managedDatabase?api-version=2023-08-01

{
  "___location": "southeastasia",
  "properties": {
    "createMode": "PointInTimeRestore",
    "sourceDatabaseId": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-SouthEastAsia/providers/Microsoft.Sql/managedInstances/testsvr/databases/testdb",
    "restorePointInTime": "2017-07-14T05:35:31.503Z"
  }
}

示例响应

{
  "tags": {
    "tagKey1": "TagValue1"
  },
  "___location": "southeastasia",
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-SouthEastAsia/providers/Microsoft.Sql/managedInstances/testsvr/databases/testdb1",
  "name": "testdb1",
  "properties": {
    "collation": "SQL_Latin1_General_CP1_CI_AS",
    "status": "Online",
    "creationDate": "2017-06-07T04:41:33.937Z",
    "defaultSecondaryLocation": "North Europe",
    "isLedgerOn": false
  },
  "type": "Microsoft.Sql/managedInstances/databases"
}
{
  "tags": {
    "tagKey1": "TagValue1"
  },
  "___location": "southeastasia",
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-SouthEastAsia/providers/Microsoft.Sql/managedInstances/testsvr/databases/testdb2",
  "name": "testdb2",
  "properties": {
    "collation": "SQL_Latin1_General_CP1_CI_AS",
    "status": "Online",
    "creationDate": "2017-06-07T04:41:33.937Z",
    "defaultSecondaryLocation": "North Europe",
    "isLedgerOn": false
  },
  "type": "Microsoft.Sql/managedInstances/databases"
}

Creates a new managed database with ledger on.

示例请求

PUT https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-SouthEastAsia/providers/Microsoft.Sql/managedInstances/managedInstance/databases/managedDatabase?api-version=2023-08-01

{
  "___location": "southeastasia",
  "properties": {
    "isLedgerOn": true
  }
}

示例响应

{
  "tags": {
    "tagKey1": "TagValue1"
  },
  "___location": "southeastasia",
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-SouthEastAsia/providers/Microsoft.Sql/managedInstances/testcl/databases/testdb1",
  "name": "testdb1",
  "properties": {
    "collation": "SQL_Latin1_General_CP1_CI_AS",
    "status": "Online",
    "creationDate": "2017-06-07T04:41:33.937Z",
    "defaultSecondaryLocation": "North Europe",
    "isLedgerOn": true
  },
  "type": "Microsoft.Sql/managedInstances/databases"
}
{
  "tags": {
    "tagKey1": "TagValue1"
  },
  "___location": "southeastasia",
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-SouthEastAsia/providers/Microsoft.Sql/managedInstances/testcl/databases/testdb2",
  "name": "testdb2",
  "properties": {
    "collation": "SQL_Latin1_General_CP1_CI_AS",
    "status": "Online",
    "creationDate": "2017-06-07T04:41:33.937Z",
    "defaultSecondaryLocation": "North Europe",
    "isLedgerOn": true
  },
  "type": "Microsoft.Sql/managedInstances/databases"
}
Location: https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-SouthEastAsia/providers/Microsoft.Sql/locations/southeastasia/operationStatus/default/operationId/00000000-0000-0000-0000-000000000000?api-version=2022-08-01

Creates a new managed database with maximal properties

示例请求

PUT https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-SouthEastAsia/providers/Microsoft.Sql/managedInstances/managedInstance/databases/managedDatabase?api-version=2023-08-01

{
  "tags": {
    "tagKey1": "TagValue1"
  },
  "___location": "southeastasia"
}

示例响应

{
  "tags": {
    "tagKey1": "TagValue1"
  },
  "___location": "southeastasia",
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-SouthEastAsia/providers/Microsoft.Sql/managedInstances/testsvr/databases/testdb1",
  "name": "testdb1",
  "properties": {
    "collation": "SQL_Latin1_General_CP1_CI_AS",
    "status": "Online",
    "creationDate": "2017-06-07T04:41:33.937Z",
    "defaultSecondaryLocation": "North Europe",
    "isLedgerOn": false
  },
  "type": "Microsoft.Sql/managedInstances/databases"
}
{
  "tags": {
    "tagKey1": "TagValue1"
  },
  "___location": "southeastasia",
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-SouthEastAsia/providers/Microsoft.Sql/managedInstances/testsvr/databases/testdb2",
  "name": "testdb2",
  "properties": {
    "collation": "SQL_Latin1_General_CP1_CI_AS",
    "status": "Online",
    "creationDate": "2017-06-07T04:41:33.937Z",
    "defaultSecondaryLocation": "North Europe",
    "isLedgerOn": false
  },
  "type": "Microsoft.Sql/managedInstances/databases"
}
Location: https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-SouthEastAsia/providers/Microsoft.Sql/locations/southeastasia/operationStatus/default/operationId/00000000-0000-0000-0000-000000000000?api-version=2017-03-01

Creates a new managed database with minimal properties

示例请求

PUT https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-SouthEastAsia/providers/Microsoft.Sql/managedInstances/managedInstance/databases/managedDatabase?api-version=2023-08-01

{
  "___location": "southeastasia"
}

示例响应

{
  "___location": "southeastasia",
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-SouthEastAsia/providers/Microsoft.Sql/managedInstances/testsvr/databases/testdb1",
  "name": "testdb1",
  "properties": {
    "collation": "SQL_Latin1_General_CP1_CI_AS",
    "status": "Online",
    "creationDate": "2017-06-07T04:41:33.937Z",
    "defaultSecondaryLocation": "North Europe",
    "isLedgerOn": false
  },
  "type": "Microsoft.Sql/managedInstances/databases"
}
{
  "___location": "southeastasia",
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-SouthEastAsia/providers/Microsoft.Sql/managedInstances/testsvr/databases/testdb2",
  "name": "testdb2",
  "properties": {
    "collation": "SQL_Latin1_General_CP1_CI_AS",
    "status": "Online",
    "creationDate": "2017-06-07T04:41:33.937Z",
    "defaultSecondaryLocation": "North Europe",
    "isLedgerOn": false
  },
  "type": "Microsoft.Sql/managedInstances/databases"
}
Location: https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-SouthEastAsia/providers/Microsoft.Sql/locations/southeastasia/operationStatus/default/operationId/00000000-0000-0000-0000-000000000000?api-version=2017-03-01

定义

名称 说明
CatalogCollationType

元数据目录的排序规则。

ErrorAdditionalInfo

资源管理错误附加信息。

ErrorDetail

错误详细信息。

ErrorResponse

错误响应

ManagedDatabase

托管数据库资源。

ManagedDatabaseCreateMode

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

ManagedDatabaseStatus

数据库的状态。

CatalogCollationType

元数据目录的排序规则。

说明
DATABASE_DEFAULT
SQL_Latin1_General_CP1_CI_AS

ErrorAdditionalInfo

资源管理错误附加信息。

名称 类型 说明
info

object

其他信息。

type

string

其他信息类型。

ErrorDetail

错误详细信息。

名称 类型 说明
additionalInfo

ErrorAdditionalInfo[]

错误附加信息。

code

string

错误代码。

details

ErrorDetail[]

错误详细信息。

message

string

错误消息。

target

string

错误目标。

ErrorResponse

错误响应

名称 类型 说明
error

ErrorDetail

错误对象。

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:通过从外部备份文件还原来创建数据库。 必须指定排序规则、StorageContainerUri 和 StorageContainerSasToken。 恢复:通过还原异地复制的备份来创建数据库。 RecoverableDatabaseId 必须指定为可恢复的数据库资源 ID 才能还原。 RestoreLongTermRetentionBackup:通过从长期保留备份(需要 longTermRetentionBackupResourceId)还原来创建数据库。

properties.creationDate

string (date-time)

数据库的创建日期。

properties.crossSubscriptionRestorableDroppedDatabaseId

string

可还原的跨订阅删除的数据库资源 ID,用于在创建此数据库时还原。

properties.crossSubscriptionSourceDatabaseId

string

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

properties.crossSubscriptionTargetManagedInstanceId

string

跨订阅还原中使用的目标托管实例 ID。

properties.defaultSecondaryLocation

string

地理配对区域。

properties.earliestRestorePoint

string (date-time)

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

properties.failoverGroupId

string

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

properties.isLedgerOn

boolean

此数据库是否为账本数据库,这意味着数据库中的所有表都是账本表。 注意:创建数据库后,无法更改此属性的值。

properties.lastBackupName

string

用于还原此托管数据库的上次备份文件名。

properties.longTermRetentionBackupResourceId

string

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

properties.recoverableDatabaseId

string

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

properties.restorableDroppedDatabaseId

string

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

properties.restorePointInTime

string (date-time)

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

properties.sourceDatabaseId

string

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

properties.status

ManagedDatabaseStatus

数据库的状态。

properties.storageContainerIdentity

string

有條件的。 如果 createMode 为 RestoreExternalBackup,则使用此值。 指定用于存储容器身份验证的标识。 可以是“SharedAccessSignature”或“ManagedIdentity”;如果未指定“SharedAccessSignature”,则假定为

properties.storageContainerSasToken

string

有條件的。 如果 createMode 为 RestoreExternalBackup 且 storageContainerIdentity 不是 ManagedIdentity,则此值是必需的。 指定存储容器 sas 令牌。

properties.storageContainerUri

string

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

tags

object

资源标记。

type

string

资源类型。

ManagedDatabaseCreateMode

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

说明
Default
PointInTimeRestore
Recovery
RestoreExternalBackup
RestoreLongTermRetentionBackup

ManagedDatabaseStatus

数据库的状态。

说明
Creating
DbCopying
DbMoving
Inaccessible
Offline
Online
Restoring
Shutdown
Starting
Stopped
Stopping
Updating