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

Databases - Create Or Update

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

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/servers/{serverName}/databases/{databaseName}?api-version=2022-02-01-preview

URI 参数

Name In Required Type Description
databaseName
path True
  • string

数据库的名称。

resourceGroupName
path True
  • string

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

serverName
path True
  • string

服务器的名称。

subscriptionId
path True
  • string

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

api-version
query True
  • string

要用于请求的 API 版本。

请求正文

Name Required Type Description
location True
  • string

资源位置。

identity

数据库的 Azure Active Directory 标识。

properties.autoPauseDelay
  • integer

自动暂停数据库的时间(以分钟为单位)。 值 -1 表示禁用自动暂停

properties.catalogCollation

元数据目录的排序规则。

properties.collation
  • string

数据库的排序规则。

properties.createMode

指定数据库创建模式。

默认值:常规数据库创建。

复制:创建数据库作为现有数据库的副本。 sourceDatabaseId 必须指定为源数据库的资源 ID。

辅助数据库:创建数据库作为现有数据库的次要副本。 sourceDatabaseId 必须指定为现有主数据库的资源 ID。

PointInTimeRestore:通过还原现有数据库的时间点备份来创建数据库。 sourceDatabaseId 必须指定为现有数据库的资源 ID,并且必须指定 restorePointInTime。

恢复:通过还原异地复制的备份来创建数据库。 sourceDatabaseId 必须指定为可恢复的数据库资源 ID 才能还原。

还原:通过还原已删除数据库的备份来创建数据库。 必须指定 sourceDatabaseId。 如果 sourceDatabaseId 是数据库的原始资源 ID,则必须指定 sourceDatabaseDeletionDate。 否则,sourceDatabaseId 必须是可还原的数据库资源 ID,并且将忽略 sourceDatabaseDeletionDate。 还可以指定 restorePointInTime,以便从较早的时间点还原。

RestoreLongTermRetentionBackup:通过从长期保留保管库还原来创建数据库。 recoveryServicesRecoveryPointResourceId 必须指定为恢复点资源 ID。

DataWarehouse 版本不支持 Copy、Secondary 和 RestoreLongTermRetentionBackup。

properties.elasticPoolId
  • string

包含此数据库的弹性池的资源标识符。

properties.federatedClientId
  • string

用于每个数据库 CMK 方案的跨租户的客户端 ID

properties.highAvailabilityReplicaCount
  • integer

与用于提供高可用性的数据库关联的次要副本数。 不适用于弹性池中的超大规模数据库。

properties.isLedgerOn
  • boolean

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

properties.licenseType

要申请此数据库的许可证类型。 LicenseIncluded如果需要许可证,或者BasePrice拥有许可证并且有资格获得Azure 混合权益。

properties.longTermRetentionBackupResourceId
  • string

与此数据库的创建操作关联的长期保留备份的资源标识符。

properties.maintenanceConfigurationId
  • string

分配给数据库的维护配置 ID。 此配置定义维护更新发生时的时间段。

properties.maxSizeBytes
  • integer

以字节表示的数据库的最大大小。

properties.minCapacity
  • number

数据库始终分配的最小容量(如果未暂停)

properties.readScale

只读路由的状态。 如果启用,将应用程序意向设置为只读的连接在其连接字符串中可能会路由到同一区域中的只读次要副本。 不适用于弹性池中的超大规模数据库。

properties.recoverableDatabaseId
  • string

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

properties.recoveryServicesRecoveryPointId
  • string

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

properties.requestedBackupStorageRedundancy

用于存储此数据库的备份的存储帐户类型。

properties.restorableDroppedDatabaseId
  • string

与此数据库的创建操作关联的可还原已删除数据库的资源标识符。

properties.restorePointInTime
  • string

指定要还原以创建新数据库的源数据库的 ISO8601 格式) (的时间点。

properties.sampleName

创建此数据库时要应用的示例架构的名称。

properties.secondaryType

数据库的辅助类型(如果是辅助数据库)。 有效值为 Geo、Named 和 Standby。

properties.sourceDatabaseDeletionDate
  • string

指定删除数据库的时间。

properties.sourceDatabaseId
  • string

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

properties.sourceResourceId
  • string

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

仅 DataWarehouse 版本支持此属性,并允许跨订阅还原。

指定 sourceResourceId 时,sourceDatabaseId、recoverableDatabaseId、restoreableDroppedDatabaseId 和 sourceDatabaseDeletionDate 不得指定,CreateMode 必须是 PointInTimeRestore、Restore 或 Recover。

createMode 为 PointInTimeRestore 时,sourceResourceId 必须是现有数据库或现有 sql 池的资源 ID,并且必须指定 restorePointInTime。

当 createMode 为 Restore 时,sourceResourceId 必须是可还原的已删除数据库或可还原的已删除 sql 池的资源 ID。

CreateMode 恢复时,sourceResourceId 必须是可恢复数据库或可恢复 SQL 池的资源 ID。

当源订阅属于与目标订阅不同的租户时,“x-ms-authorization-auxiliary”标头必须包含源租户的身份验证令牌。 有关“x-ms-authorization-auxiliary”标头的更多详细信息,请参阅 https://docs.microsoft.com/en-us/azure/azure-resource-manager/management/authenticate-multi-tenant

properties.zoneRedundant
  • boolean

此数据库是否为区域冗余,这意味着此数据库的副本将分布在多个可用性区域。

sku

数据库 SKU。

SKU 列表可能因区域和支持产品/服务而异。 若要确定 SKU (,包括可用于 Azure 区域中订阅的 SKU 名称、层/版本、系列和容量) ,请使用 Capabilities_ListByLocation REST API 或以下命令之一:

az sql db list-editions -l <location> -o table
Get-AzSqlServerServiceObjective -Location <location>
tags
  • object

资源标记。

响应

Name Type Description
200 OK

已成功更新数据库。

201 Created

已成功创建数据库。

202 Accepted

正在创建或更新数据库。

Other Status Codes

错误响应: ***

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

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

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

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

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

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

  • 400 MissingCollation - 需要排序规则。

  • 400 MissingMaxSizeBytes - 需要 MaxSizeBytes。

  • 400 MissingSkuName - Sku 名称是必需的。

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

  • 400 InvalidLicenseType - 指定的许可证类型无效。

  • 400 InvalidSkuName - SKU 名称无效。

  • 400 不匹配的SkuNameAndCapacity - SKU 名称和容量不匹配。

  • 400 不匹配的SkuNameAndTier - SKU 名称和层不匹配。

  • 400 不匹配的SkuNameAndFamily - SKU 名称和系列不匹配。

  • 400 LedgerNotAllowedWithSpecifiedCreateMode - IsLedgerOn 不允许使用指定的创建模式。

  • 400 LedgerNotAllowedOnSampleDatabase - 对于示例数据库,不允许使用 IsLedgerOn 创建数据库。

  • 400 DatabaseNameDoesNotMatchSourceDatabaseId - 指定的数据库名称与 sourceDatabaseId 中的数据库名称不匹配。

  • 400 ElasticPoolNotSupportedForExternalBackupRestore - 外部备份还原不支持弹性池

  • 400 InvalidRecoverableDatabaseId - 可恢复的数据库标识符无效。

  • 400 InvalidRecoveryServicesRecoveryPointId - 恢复服务恢复点标识符无效。

  • 400 InvalidRestorableDroppedDatabaseDeletionDate - 给定的可还原删除的数据库删除日期无效

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

  • 400 MissingRecoverableDatabaseId - 缺少可恢复的数据库标识符。

  • 400 MissingRecoveryServicesRecoveryPointId - 缺少恢复服务恢复点 ID。

  • 400 MissingRestorableDroppedDatabaseId - 缺少 restorableDroppedDatabaseId

  • 400 MissingRestorePointInTime - 缺少还原点

  • 400 MissingSourceDatabaseDeletionDate - 缺少源数据库删除日期

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

  • 400 MissingStorageContainerUri - 缺少存储容器 URI

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

  • 400 MultipleIdentitiesOnDatabase - 数据库级别仅支持一个用户分配的托管标识。

  • 400 MultipleIdentityDelegationsOnDatabase - 数据库级别仅支持一个标识委派。

  • 400 MissingPrimaryDelegatedIdentityClientId - 若要使用委托标识,请提供主要委托标识客户端 ID。

  • 400 InvalidStandbyGeoReadScale - 用户尝试在不支持它的备用异地数据库上启用读取缩放。

  • 400 PerDatabaseCMKKeyRotationAttemptedWhileOldThumbprintInUse - 数据库级别的 TDE 保护程序的密钥轮换被阻止,因为活动事务持有使用旧密钥加密的日志。 有关解决此问题的可能策略,请参阅 aka.ms/azuresqldbkeyrotation。

  • 400 TierChangeUnsupportedDueToMemoryOptimizedObject - 数据库无法更新其 SKU,因为它具有内存优化的对象。

  • 在数据库上启用长期备份保留时,不支持 400 PerDBCMKNotSupportedWithLTR - 数据库级 CMK。

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

  • 400 ElasticPoolOverStorageUsage - 尝试在达到弹性池的存储限制时将数据写入数据库。

  • 400 InvalidDatabaseCreateMode - 创建数据库的请求无效。

  • 400 MissingAsymmetricKeyOnTargetServer - 目标服务器无权访问非对称密钥。

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

  • 400 MultipleDroppedDatabasesWithTheSameName - 在服务器上发现了多个具有相同名称的已删除数据库。

  • 400 InvalidAddSecondaryPermission - 用户没有足够的权限在指定服务器上添加辅助数据库。

  • 400 AzureKeyVaultClientError - Azure 密钥保管库客户端遇到错误。

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

  • 400 AzureKeyVaultClientInfoError - 获取 Azure 密钥保管库 客户端的信息时出错。

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

  • 400 IsLedgerDatabaseIsNotSupportedOnResourceType - 此资源类型不支持更改账本属性。

  • 400 InvalidBackupStorageAccountType - 用户在数据库创建/更新期间传递 zrs/lrs,但由于客户未列入允许列表或因为 zrs 在指定区域中不可用而失败。

  • 400 CannotUpdateToFreeDatabase - 不支持将数据库更新到免费 SKU。

  • 400 DatabaseInvalidSkuPropertyCombination - 请求的 SKU 的属性不一致。 请检查是否指定了有效的组合。 有关详细信息,请参阅 https://docs.microsoft.com/en-us/rest/api/sql/capabilities/listbylocation#serviceobjectivecapability

  • 400 DatabaseNamedReplicaPerDatabaseLimitExceeded - 用户尝试创建一个命名副本,该副本将超过每个主数据库允许的数字

  • 400 UnsupportedBackupStorageRedundancyForEdition - 版本不支持请求的备份存储冗余

  • 400 DatabaseIsCurrentlyPinned - Microsoft 已将数据库固定到SQL Server引擎版本。 为了确保数据库未遇到生产问题,数据库上将来的任何缩放操作都将被阻止,直到未固定。 请联系 Microsoft 支持人员获取有关缩放的帮助。

  • 400 RestoreTargetEditionSizeInsufficient - 用户尝试将数据库还原到小于当前分配源大小的版本。

  • 400 InvalidSku - 用户指定了无效 SKU。

  • 400 InvalidTierSkuCombination - 指定的层不支持指定的 SKU。

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

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

  • 400 InvalidIdentityId - 提供的一个或多个标识 ID (s) 无效的 ARM 资源 ID (s) 。 请输入有效 ID (s) ,然后重试。

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

  • 400 FeatureDisabledOnSelectedEdition - 用户尝试使用当前数据库版本上禁用的功能。

  • 400 OfferDisabledOnSubscription - 订阅套餐类型受限于预配请求的资源。

  • 400 UnableToCreateGeoChain - 用户尝试创建辅助数据库 (链接) 即使已配置自动上传账本摘要

  • 400 InvalidNumberOfIdentities - 数据库级别仅支持一个用户分配的托管标识。

  • 400 DatabaseNamedReplicaChainingNotAllowed - 用户尝试创建不允许的命名副本的命名副本。

  • 400 DatabaseNamedReplicaInvalidOperation - 用户尝试对命名副本执行不受支持的操作。

  • 400 DatabaseNamedReplicaInvalidSourceDatabase - 用户尝试在与源数据库不同的订阅或区域中创建命名副本。

  • 400 InvalidTargetSubregion - 不可读辅助数据库的目标服务器不在 DR 配对的 Azure 区域中。

  • 400 CannotAssignIdentityToMaster - 无法向系统数据库分配标识。 不能将数据库标识分配给“master”、“model”、“tempdb”、“msdb”或“resource”数据库。

  • Datawarehouse 版本不支持预览版中的 400 PerDatabaseCMKDWNotSupported - 预览版中的数据库级 CMK。

  • 400 DatabaseCreationBlockedForNonActivatedCMKServer - 为启用了 CMK 的工作区阻止 SQL 池创建,直到激活工作区。 首先,启用清除保护,并在工作区密钥的 Azure 密钥保管库上向工作区托管标识授予获取、包装密钥、解包密钥) 所需的 (权限。 接下来,在授予访问权限后激活工作区。

  • 400 PartnerServerNotCompatible - 用户尝试将数据库从 SAWA V1 服务器复制到斯特林服务器,反之亦然。

  • 400 错误ReplicationLinkState - 操作要求数据库在复制链接上处于预期状态。

  • 400 TargetElasticPoolDoesNotExist - 服务器上不存在弹性池。

  • 400 ElasticPoolSkuCombinationInvalid - 仅当 sku 指定为“ElasticPool”时,才能一起指定弹性池和 sku。

  • 400 ElasticPoolTierCombinationInvalid - 数据库层不同于弹性池服务层。

  • 400 ElasticPoolNameRequired - 用户尝试创建或更新数据库到弹性池服务目标,而无需指定弹性池的名称。

  • 400 MissingThumbprintCrm - CRM 数据库的还原操作失败,因为缺少所需的 TDE 证书。 请重试到现有弹性池的还原操作。

  • 400 ElasticPoolOverStorage - 当达到弹性池的存储限制时,尝试将数据写入数据库。

  • 400 ElasticPoolInconsistentDtuGuaranteeSettings - 尝试为弹性池中超过请求的 DTU 的数据库提供 DTU 最小值。

  • 400 RestoreTargetEditionSizeInsufficientV2 - 用户尝试将数据库还原到小于已还原数据库分配大小的版本。

  • 400 TierChangeUnsupportedDueToCDCEnabledDatabase - 数据库无法更新其 SKU,因为它已启用 CDC。

  • 400 ElasticPoolDatabaseCountOverLimit - 尝试在达到弹性池的数据库计数限制时创建或添加到弹性池。

  • 400 ResourcePoolStorageLimitHitDuringRestore - 由于池中剩余的存储容量,无法将还原的数据库还原到资源池中。

  • 400 CannotChangeToOrFromDataWarehouseTier - 用户尝试将数据库的 SKU 从 DataWarehouse 层更改为非 DataWarehouse 层,反之亦然。

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

  • 400 PerDatabaseCMKRestoreNotSupported - 在预览版中配置数据库级 CMK 时不支持数据库还原。

  • 超大规模版本不支持 400 PerDatabaseCMKHSNotSupported - 预览版中的数据库级 CMK。

  • 400 AzureKeyVaultKeyDisabled - 无法完成服务器上的操作,因为 Azure 密钥保管库 密钥已禁用。

  • 400 PerDatabaseCMKGeoReplicationNotSupported - 在预览版中配置数据库级 CMK 时,不支持异地复制和数据库复制。

  • 400 ElasticPoolDecreaseStorageLimitBelowUsage - 尝试将弹性池的存储限制降低到其存储使用量以下。

  • 400 AzureKeyVaultInvalidExpirationDate - 操作无法完成,因为 Azure 密钥保管库密钥过期日期无效。

  • 400 InvalidStandbyGeoEdition - 用户尝试创建基于 DTU 的备用地理位置。

  • 400 SecurityAzureKeyVaultUrlNullOrEmpty - 操作无法完成,因为 Azure 密钥保管库 Uri 为 null 或空。

  • 400 ElasticPoolInconsistentVcoreGuaranteeSettings - 每个数据库的数据库数和 VCore 最小值不能超过弹性池请求的 VCore 数。

  • 400 UpdateNotAllowedOnPausedDatabase - 用户尝试对暂停的数据库执行更新。

  • 400 AzureKeyVaultNoServerIdentity - 服务器标识未正确配置。

  • 400 InvalidMaxSizeTierCombination - 指定的层不支持指定的数据库最大大小。

  • 400 AzureKeyVaultInvalidUri - 来自 Azure 密钥保管库的无效响应。 请使用有效的 Azure 密钥保管库 URI。

  • 400 AzureKeyVaultMissingPermissions - 服务器缺少对 Azure 密钥保管库所需的权限。

  • 400 InvalidReadScaleEdition - 用户尝试对不支持它的数据库类型启用读取缩放。

  • 400 InvalidReadScaleUnits - 用户尝试提供不支持的读取缩放值。

  • 400 SecurityAzureKeyVaultInvalidKeyName - 由于服务器密钥名称无效,无法完成该操作。

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

  • 400 GeoSecondaryMaxSizeUpdateFailed - 异地辅助数据库是不支持所请求的最大值或异地辅助数据库位于不受支持的区域中的 SLO,或者异地辅助数据库上的更新操作已在进行中。

  • 400 AdalGenericError - 由于遇到 Azure Active Directory 错误,无法完成该操作。

  • 400 AdalServicePrincipalNotFound - 操作无法完成,因为遇到 Azure Active Directory 库服务主体找不到错误。

  • 400 InvalidTier - 用户指定了无效层。

  • 400 AzureKeyVaultMalformedVaultUri - 提供的密钥保管库 uri 无效。

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

  • 400 RequestedDatabaseSizeRequiresShrink - 用户尝试 ALTER DATABASE MODIFY MAXSIZE 以将数据库的 MAXSIZE 修改为较小的大小,然后修改当前大小。

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

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

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

  • 400 SourceDatabaseEditionCouldNotBeUpgraded - 源数据库的版本不能高于目标数据库。

  • 400 SecurityAdalPrincipalCertExpiredError - 操作无法完成,因为 Azure 密钥保管库主体证书已过期。

  • 400 TargetDatabaseEditionCouldNotBeDowngraded - 目标数据库的版本不能低于源数据库。

  • 400 UpdateNotAllowedIfGeoDrOperationInProgress - 由于服务器“上数据库”{0}{1}“的副本或故障转移操作当前正在进行中,因此不允许该操作。

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

  • 400 SecurityInvalidAzureKeyVaultRecoveryLevel - 提供的密钥保管库 uri 无效。

  • 400 KeyMaterialNotFoundOnRemoteServer - 远程服务器无权访问用作 TDE 保护程序的密钥材料。

  • 400 AzureKeyVaultRsaKeyNotSupported - 提供的密钥保管库使用不支持的 RSA 密钥大小或密钥类型。 支持的 RSA 密钥大小为 2048 或 3072,密钥类型为 RSA 或 RSA-HSM。

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

  • 400 ElasticPoolOverFileSpace - 弹性池中的文件空间不足。

  • 400 PartnerDBNotCompatibleForSGXEnclave - 仅当两个数据库都在 DC 系列硬件上运行时,才支持为已启用 enclave 的数据库设置 GeoDR 链接或更新 SLO。

  • 400 UpdateNotAllowedInCurrentReplicationState - 该操作在其当前复制状态下不允许对数据库执行操作。

  • 400 InvalidLicenseType - 用户尝试使用不支持的许可证类型创建或更新数据库或弹性池。

  • 400 GeoReplicaLimitReached - 达到每个副本复制限制。

  • 400 UnsupportedCapacity - 用户尝试使用不支持的容量创建或更新数据库。

  • 400 ReplicationSourceAndTargetMustHaveSameName - 复制源和目标数据库必须具有相同的名称。

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

  • 400 ReplicationSourceAndTargetMustBeInDifferentServers - 复制源和目标数据库必须位于不同的逻辑服务器中。

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

  • 400 UnableToResolveRemoteServer - 由于服务器名称或 DNS 连接问题无效,无法解决远程合作伙伴服务器名称。

  • 400 RemoteDatabaseCopyPermission - 用户没有足够的权限在指定服务器上创建数据库副本。

  • 400 CannotMoveOrDropSyncMetadataDatabase - 无法删除用作同步元数据数据库的数据库。

  • 400 SecurityAzureKeyVaultGeoChainError - 使用 Azure 密钥保管库 (BYOK) 启用透明数据加密时,不支持创建辅助 (称为链接) 的进程。

  • 400 RestoreToFreeEditionNotSupported - 还原和 GeoRestore 目标不能为免费数据库。

  • 400 CannotMoveOrDropJobAccountDatabase - 无法删除与作业帐户关联的数据库。

  • 免费数据库不支持 400 RestoreNotSupportedForFreeEdition - 还原和 GeoRestore。

  • 400 JobAgentDatabaseEditionUnsupported - 不支持指定数据库的服务级别目标用作作业代理数据库。

  • 400 InvalidDroppedDatabase - 源数据库在受支持的恢复期内不存在于服务器上。

  • 400 InvalidLiveDatabase - 源数据库在受支持的恢复期内不存在于服务器上。 如果还原已删除的数据库,请指定其删除日期。

  • 400 InvalidVldbRecoverySlo - 超大规模版本恢复要求源数据库和目标数据库都使用超大规模服务级别目标。

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

  • 400 InvalidVldbRestoreSlo - 超大规模版本时间点还原要求源数据库和目标数据库都使用超大规模服务级别目标。

  • 400 CannotSpecifyPoolOrSlo - 不支持指定弹性池和/或更改服务级别目标或版本。

  • 400 InvalidPublicMaintenanceConfiguration - 用户尝试指定无法转换为内部 ID 的公共维护配置, (格式不正确或错误的区域) 。

  • 400 MaintenanceWindowNotSupportedForNamedReplica - 用户尝试使用不支持的非默认维护时段创建或更新命名副本。

  • 400 ChangeUnsupportedOnEntity - 用户尝试对给定实体执行不受支持的创建/更新/删除操作。

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

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

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

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

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

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

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

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

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

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

  • 400 LongTermRetentionMigrationSubscriptionNotFound - 找不到订阅。

  • 404 OperationIdNotFound - ID 操作不存在。

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

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

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

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

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

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

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

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

  • 405 UnsupportedReplicationOperation - 数据库上启动了不受支持的复制操作。

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

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

  • 409 FreeDbAlreadyExists - 每个区域的订阅只能存在一个免费数据库。

  • 409 ConflictingServerOperation - 服务器当前正在进行操作。

  • 409 SubscriptionDisabled - 已禁用订阅。

  • 409 ConflictingSystemOperationInProgress - 数据库上正在进行系统维护操作,后续操作需要等待,直到完成。

  • 409 ConflictRequestToUpdateBackupRedundancy - 更改备份存储冗余的冲突请求仍在进行中。

  • 409 SkuAssignmentInProgress - 无法处理当前分配请求,因为以前的请求尚未完成。

  • 409 DatabaseElasticPoolMaintenanceConflict - 用户尝试使用与数据库的弹性池冲突的指定维护配置创建或更新数据库。

  • 409 ServerDtuQuotaExceeded - 无法执行该操作,因为服务器将超过允许的数据库吞吐量单位配额。

  • 409 UnableToAlterDatabaseInReplication - 复制关系中数据库上的用户更改版本。

  • 409 CurrentMemoryUsageExceedsSkuQuota - 用户尝试了由于资源消耗较高而无法完成的 SKU 更新操作。

  • 409 ServerKeyNameAlreadyExists - 服务器上已存在服务器密钥。

  • 409 ServerKeyUriAlreadyExists - 服务器上已存在服务器密钥 URI。

  • 409 ServerKeyDoesNotExists - 服务器密钥不存在。

  • 409 UpdateSloInProgress - 用户在进行 SLO 更新时尝试启动不兼容的操作。

  • 409 UpdateSloFailedDatabaseTooBusy - 更新 SLO 操作无法完成,因为数据库太忙。

  • 409 ElasticPoolBusy - 在忙于弹性池上尝试管理操作。

  • 409 AzureKeyVaultKeyNameNotFound - 无法完成该操作,因为 Azure 密钥保管库密钥名称不存在。

  • 409 AzureKeyVaultKeyInUse - 服务器当前正在使用密钥。

  • 409 ServerDisabled - 服务器已禁用。

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

  • 409 SimultaneousSkuChangeNotAllowed - 服务目标更改操作不能同时在复制关系的两个数据库上运行。

  • 409 TargetElasticPoolBeingUpdated - 无法启动弹性池的更新,因为此弹性池中的某个数据库正在进行复制操作

  • 409 InvalidOperationForDatabaseNotInReplicationRelationship - 对已在复制关系中的数据库执行复制种子设定操作。

  • 409 InvalidOperationForDatabaseInReplicationRelationship - 对已在复制关系中的数据库执行复制种子设定操作。

  • 409 ReplicationGeoDrRelation - 数据库已处于复制关系中。 这是重复的请求。

  • 409 DatabaseCopyLimitPerReplicaReached - 用户达到了并发数据库副本的限制。

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

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

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

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

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

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

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

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

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

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

  • 500 LongTermRetentionMigrationRestoreVerFailed - 还原验证失败。

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

  • 503 AzureKeyVaultConnectionFailed - 无法完成服务器上的操作,因为尝试连接到 Azure 密钥保管库失败

  • 503 AzureKeyVaultGenericConnectionError - 无法完成该操作,因为尝试检索密钥保管库信息时遇到错误。

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

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

示例

Creates a data warehouse database as a cross-subscription restore from a backup of a dropped database.
Creates a data warehouse database as a cross-subscription restore from a geo-backup.
Creates a data warehouse database as a cross-subscription restore from a restore point of an existing database.
Creates a database as a copy.
Creates a database as a standby secondary.
Creates a database as an on-line secondary.
Creates a database as named replica secondary.
Creates a database from PointInTimeRestore.
Creates a database with default mode.
Creates a database with ledger on.
Creates a database with minimum number of parameters.
Creates a database with preferred maintenance window.
Creates a database with specified backup storage redundancy.
Creates a VCore database by specifying service objective name.
Creates a VCore database by specifying sku name and capacity.

Creates a data warehouse database as a cross-subscription restore from a backup of a dropped database.

Sample Request

PUT https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-SouthEastAsia/providers/Microsoft.Sql/servers/testsvr/databases/testdw?api-version=2022-02-01-preview

{
  "location": "southeastasia",
  "properties": {
    "createMode": "Restore",
    "sourceResourceId": "/subscriptions/55555555-6666-7777-8888-999999999999/resourceGroups/Default-SQL-SouthEastAsia/providers/Microsoft.Sql/servers/srcsvr/restorableDroppedDatabases/srcdw,131403269876900000"
  }
}

Sample Response

{
  "sku": {
    "name": "DataWarehouse",
    "tier": "DataWarehouse",
    "capacity": 9000
  },
  "kind": "v12.0,user,datawarehouse,gen2",
  "properties": {
    "collation": "SQL_Latin1_General_CP1_CI_AS",
    "maxSizeBytes": 263882790666240,
    "status": "Online",
    "databaseId": "188784c9-d602-4684-86cf-e67b6f03551a",
    "creationDate": "2022-01-24T06:46:14.99Z",
    "currentServiceObjectiveName": "DW1000c",
    "requestedServiceObjectiveName": "DW1000c",
    "defaultSecondaryLocation": "eastus",
    "catalogCollation": "SQL_Latin1_General_CP1_CI_AS",
    "readScale": "Disabled",
    "currentSku": {
      "name": "DataWarehouse",
      "tier": "DataWarehouse",
      "capacity": 9000
    },
    "currentBackupStorageRedundancy": "Geo"
  },
  "location": "southeastasia",
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-SouthEastAsia/providers/Microsoft.Sql/servers/testsvr/databases/testdw",
  "name": "testdw",
  "type": "Microsoft.Sql/servers/databases"
}
{
  "sku": {
    "name": "DataWarehouse",
    "tier": "DataWarehouse",
    "capacity": 9000
  },
  "kind": "v12.0,user,datawarehouse,gen2",
  "properties": {
    "collation": "SQL_Latin1_General_CP1_CI_AS",
    "maxSizeBytes": 263882790666240,
    "status": "Online",
    "databaseId": "188784c9-d602-4684-86cf-e67b6f03551a",
    "creationDate": "2022-01-24T06:46:14.99Z",
    "currentServiceObjectiveName": "DW1000c",
    "requestedServiceObjectiveName": "DW1000c",
    "defaultSecondaryLocation": "eastus",
    "catalogCollation": "SQL_Latin1_General_CP1_CI_AS",
    "readScale": "Disabled",
    "currentSku": {
      "name": "DataWarehouse",
      "tier": "DataWarehouse",
      "capacity": 9000
    },
    "currentBackupStorageRedundancy": "Geo"
  },
  "location": "southeastasia",
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-SouthEastAsia/providers/Microsoft.Sql/servers/testsvr/databases/testdw",
  "name": "testdw",
  "type": "Microsoft.Sql/servers/databases"
}

Creates a data warehouse database as a cross-subscription restore from a geo-backup.

Sample Request

PUT https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-WestUS/providers/Microsoft.Sql/servers/testsvr/databases/testdw?api-version=2022-02-01-preview

{
  "location": "westus",
  "properties": {
    "createMode": "Recovery",
    "sourceResourceId": "/subscriptions/55555555-6666-7777-8888-999999999999/resourceGroups/Default-SQL-EastUS/providers/Microsoft.Sql/servers/srcsvr/recoverabledatabases/srcdw"
  }
}

Sample Response

{
  "sku": {
    "name": "DataWarehouse",
    "tier": "DataWarehouse",
    "capacity": 9000
  },
  "kind": "v12.0,user,datawarehouse,gen2",
  "properties": {
    "collation": "SQL_Latin1_General_CP1_CI_AS",
    "maxSizeBytes": 263882790666240,
    "status": "Online",
    "databaseId": "188784c9-d602-4684-86cf-e67b6f03551a",
    "creationDate": "2022-01-24T06:46:14.99Z",
    "currentServiceObjectiveName": "DW1000c",
    "requestedServiceObjectiveName": "DW1000c",
    "defaultSecondaryLocation": "eastus",
    "catalogCollation": "SQL_Latin1_General_CP1_CI_AS",
    "readScale": "Disabled",
    "currentSku": {
      "name": "DataWarehouse",
      "tier": "DataWarehouse",
      "capacity": 9000
    },
    "currentBackupStorageRedundancy": "Geo"
  },
  "location": "westus",
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-WestUS/providers/Microsoft.Sql/servers/testsvr/databases/testdw",
  "name": "testdw",
  "type": "Microsoft.Sql/servers/databases"
}
{
  "sku": {
    "name": "DataWarehouse",
    "tier": "DataWarehouse",
    "capacity": 9000
  },
  "kind": "v12.0,user,datawarehouse,gen2",
  "properties": {
    "collation": "SQL_Latin1_General_CP1_CI_AS",
    "maxSizeBytes": 263882790666240,
    "status": "Online",
    "databaseId": "188784c9-d602-4684-86cf-e67b6f03551a",
    "creationDate": "2022-01-24T06:46:14.99Z",
    "currentServiceObjectiveName": "DW1000c",
    "requestedServiceObjectiveName": "DW1000c",
    "defaultSecondaryLocation": "eastus",
    "catalogCollation": "SQL_Latin1_General_CP1_CI_AS",
    "readScale": "Disabled",
    "currentSku": {
      "name": "DataWarehouse",
      "tier": "DataWarehouse",
      "capacity": 9000
    },
    "currentBackupStorageRedundancy": "Geo"
  },
  "location": "westus",
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-WestUS/providers/Microsoft.Sql/servers/testsvr/databases/testdw",
  "name": "testdw",
  "type": "Microsoft.Sql/servers/databases"
}

Creates a data warehouse database as a cross-subscription restore from a restore point of an existing database.

Sample Request

PUT https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-SouthEastAsia/providers/Microsoft.Sql/servers/testsvr/databases/testdw?api-version=2022-02-01-preview

{
  "location": "southeastasia",
  "properties": {
    "createMode": "PointInTimeRestore",
    "sourceResourceId": "/subscriptions/55555555-6666-7777-8888-999999999999/resourceGroups/Default-SQL-SouthEastAsia/providers/Microsoft.Sql/servers/srcsvr/databases/srcdw",
    "restorePointInTime": "2022-01-22T05:35:31.503Z"
  }
}

Sample Response

{
  "sku": {
    "name": "DataWarehouse",
    "tier": "DataWarehouse",
    "capacity": 9000
  },
  "kind": "v12.0,user,datawarehouse,gen2",
  "properties": {
    "collation": "SQL_Latin1_General_CP1_CI_AS",
    "maxSizeBytes": 263882790666240,
    "status": "Online",
    "databaseId": "188784c9-d602-4684-86cf-e67b6f03551a",
    "creationDate": "2022-01-24T06:46:14.99Z",
    "currentServiceObjectiveName": "DW1000c",
    "requestedServiceObjectiveName": "DW1000c",
    "defaultSecondaryLocation": "eastus",
    "catalogCollation": "SQL_Latin1_General_CP1_CI_AS",
    "readScale": "Disabled",
    "currentSku": {
      "name": "DataWarehouse",
      "tier": "DataWarehouse",
      "capacity": 9000
    },
    "currentBackupStorageRedundancy": "Geo"
  },
  "location": "southeastasia",
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-SouthEastAsia/providers/Microsoft.Sql/servers/testsvr/databases/testdw",
  "name": "testdw",
  "type": "Microsoft.Sql/servers/databases"
}
{
  "sku": {
    "name": "DataWarehouse",
    "tier": "DataWarehouse",
    "capacity": 9000
  },
  "kind": "v12.0,user,datawarehouse,gen2",
  "properties": {
    "collation": "SQL_Latin1_General_CP1_CI_AS",
    "maxSizeBytes": 263882790666240,
    "status": "Online",
    "databaseId": "188784c9-d602-4684-86cf-e67b6f03551a",
    "creationDate": "2022-01-24T06:46:14.99Z",
    "currentServiceObjectiveName": "DW1000c",
    "requestedServiceObjectiveName": "DW1000c",
    "defaultSecondaryLocation": "eastus",
    "catalogCollation": "SQL_Latin1_General_CP1_CI_AS",
    "readScale": "Disabled",
    "currentSku": {
      "name": "DataWarehouse",
      "tier": "DataWarehouse",
      "capacity": 9000
    },
    "currentBackupStorageRedundancy": "Geo"
  },
  "location": "southeastasia",
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-SouthEastAsia/providers/Microsoft.Sql/servers/testsvr/databases/testdw",
  "name": "testdw",
  "type": "Microsoft.Sql/servers/databases"
}

Creates a database as a copy.

Sample Request

PUT https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-SouthEastAsia/providers/Microsoft.Sql/servers/testsvr/databases/dbcopy?api-version=2022-02-01-preview

{
  "location": "southeastasia",
  "sku": {
    "name": "S0",
    "tier": "Standard"
  },
  "properties": {
    "createMode": "Copy",
    "sourceDatabaseId": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-SouthEastAsia/providers/Microsoft.Sql/servers/testsvr/databases/testdb"
  }
}

Sample Response

{
  "sku": {
    "name": "Standard",
    "tier": "Standard",
    "capacity": 10
  },
  "kind": "v12.0,user",
  "properties": {
    "collation": "SQL_Latin1_General_CP1_CI_AS",
    "maxSizeBytes": 268435456000,
    "status": "Online",
    "databaseId": "6c764297-577b-470f-9af4-96d3d41e2ba3",
    "currentSku": {
      "name": "Standard",
      "tier": "Standard",
      "capacity": 10
    },
    "creationDate": "2017-06-07T04:41:33.937Z",
    "currentBackupStorageRedundancy": "Geo",
    "currentServiceObjectiveName": "S0",
    "defaultSecondaryLocation": "North Europe",
    "earliestRestoreDate": "2017-06-07T04:51:33.937Z",
    "catalogCollation": "SQL_Latin1_General_CP1_CI_AS",
    "readScale": "Disabled",
    "requestedBackupStorageRedundancy": "Geo",
    "requestedServiceObjectiveName": "S0",
    "isLedgerOn": false,
    "isInfraEncryptionEnabled": false,
    "zoneRedundant": false
  },
  "location": "southeastasia",
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-SouthEastAsia/providers/Microsoft.Sql/servers/testsvr/databases/dbcopy",
  "name": "dbcopy",
  "type": "Microsoft.Sql/servers/databases"
}
{
  "sku": {
    "name": "Standard",
    "tier": "Standard",
    "capacity": 10
  },
  "kind": "v12.0,user",
  "properties": {
    "collation": "SQL_Latin1_General_CP1_CI_AS",
    "maxSizeBytes": 268435456000,
    "status": "Online",
    "databaseId": "6c764297-577b-470f-9af4-96d3d41e2ba3",
    "currentSku": {
      "name": "Standard",
      "tier": "Standard",
      "capacity": 10
    },
    "creationDate": "2017-06-07T04:41:33.937Z",
    "currentBackupStorageRedundancy": "Geo",
    "currentServiceObjectiveName": "S0",
    "defaultSecondaryLocation": "North Europe",
    "earliestRestoreDate": "2017-06-07T04:51:33.937Z",
    "catalogCollation": "SQL_Latin1_General_CP1_CI_AS",
    "readScale": "Disabled",
    "requestedBackupStorageRedundancy": "Geo",
    "requestedServiceObjectiveName": "S0",
    "isLedgerOn": false,
    "isInfraEncryptionEnabled": false,
    "zoneRedundant": false
  },
  "location": "southeastasia",
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-SouthEastAsia/providers/Microsoft.Sql/servers/testsvr/databases/dbcopy",
  "name": "dbcopy",
  "type": "Microsoft.Sql/servers/databases"
}

Creates a database as a standby secondary.

Sample Request

PUT https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-SouthEastAsia/providers/Microsoft.Sql/servers/testsvr/databases/testdb?api-version=2022-02-01-preview

{
  "location": "southeastasia",
  "sku": {
    "name": "S0",
    "tier": "Standard"
  },
  "properties": {
    "createMode": "Secondary",
    "secondaryType": "Standby",
    "sourceDatabaseId": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-NorthEurope/providers/Microsoft.Sql/servers/testsvr1/databases/testdb"
  }
}

Sample Response

{
  "sku": {
    "name": "Standard",
    "tier": "Standard",
    "capacity": 10
  },
  "kind": "v12.0,user",
  "properties": {
    "collation": "SQL_Latin1_General_CP1_CI_AS",
    "maxSizeBytes": 268435456000,
    "status": "Online",
    "databaseId": "6c764297-577b-470f-9af4-96d3d41e2ba3",
    "currentSku": {
      "name": "Standard",
      "tier": "Standard",
      "capacity": 10
    },
    "creationDate": "2017-06-07T04:41:33.937Z",
    "currentBackupStorageRedundancy": "Geo",
    "currentServiceObjectiveName": "S0",
    "defaultSecondaryLocation": "North Europe",
    "earliestRestoreDate": "2017-06-07T04:51:33.937Z",
    "catalogCollation": "SQL_Latin1_General_CP1_CI_AS",
    "readScale": "Disabled",
    "requestedBackupStorageRedundancy": "Geo",
    "requestedServiceObjectiveName": "S0",
    "secondaryType": "Standby",
    "isLedgerOn": false,
    "isInfraEncryptionEnabled": false,
    "zoneRedundant": false
  },
  "location": "southeastasia",
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-SouthEastAsia/providers/Microsoft.Sql/servers/testsvr/databases/testdb",
  "name": "testdb",
  "type": "Microsoft.Sql/servers/databases"
}
{
  "sku": {
    "name": "Standard",
    "tier": "Standard",
    "capacity": 10
  },
  "kind": "v12.0,user",
  "properties": {
    "collation": "SQL_Latin1_General_CP1_CI_AS",
    "maxSizeBytes": 268435456000,
    "status": "Online",
    "databaseId": "6c764297-577b-470f-9af4-96d3d41e2ba3",
    "currentSku": {
      "name": "Standard",
      "tier": "Standard",
      "capacity": 10
    },
    "creationDate": "2017-06-07T04:41:33.937Z",
    "currentBackupStorageRedundancy": "Geo",
    "currentServiceObjectiveName": "S0",
    "defaultSecondaryLocation": "North Europe",
    "earliestRestoreDate": "2017-06-07T04:51:33.937Z",
    "catalogCollation": "SQL_Latin1_General_CP1_CI_AS",
    "readScale": "Disabled",
    "requestedBackupStorageRedundancy": "Geo",
    "requestedServiceObjectiveName": "S0",
    "secondaryType": "Standby",
    "isLedgerOn": false,
    "isInfraEncryptionEnabled": false,
    "zoneRedundant": false
  },
  "location": "southeastasia",
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-SouthEastAsia/providers/Microsoft.Sql/servers/testsvr/databases/testdb",
  "name": "testdb",
  "type": "Microsoft.Sql/servers/databases"
}

Creates a database as an on-line secondary.

Sample Request

PUT https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-SouthEastAsia/providers/Microsoft.Sql/servers/testsvr/databases/testdb?api-version=2022-02-01-preview

{
  "location": "southeastasia",
  "sku": {
    "name": "S0",
    "tier": "Standard"
  },
  "properties": {
    "createMode": "Secondary",
    "secondaryType": "Geo",
    "sourceDatabaseId": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-NorthEurope/providers/Microsoft.Sql/servers/testsvr1/databases/testdb"
  }
}

Sample Response

{
  "sku": {
    "name": "Standard",
    "tier": "Standard",
    "capacity": 10
  },
  "kind": "v12.0,user",
  "properties": {
    "collation": "SQL_Latin1_General_CP1_CI_AS",
    "maxSizeBytes": 268435456000,
    "status": "Online",
    "databaseId": "6c764297-577b-470f-9af4-96d3d41e2ba3",
    "currentSku": {
      "name": "Standard",
      "tier": "Standard",
      "capacity": 10
    },
    "creationDate": "2017-06-07T04:41:33.937Z",
    "currentBackupStorageRedundancy": "Geo",
    "currentServiceObjectiveName": "S0",
    "defaultSecondaryLocation": "North Europe",
    "earliestRestoreDate": "2017-06-07T04:51:33.937Z",
    "catalogCollation": "SQL_Latin1_General_CP1_CI_AS",
    "readScale": "Disabled",
    "requestedBackupStorageRedundancy": "Geo",
    "requestedServiceObjectiveName": "S0",
    "secondaryType": "Geo",
    "isLedgerOn": false,
    "isInfraEncryptionEnabled": false,
    "zoneRedundant": false
  },
  "location": "southeastasia",
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-SouthEastAsia/providers/Microsoft.Sql/servers/testsvr/databases/testdb",
  "name": "testdb",
  "type": "Microsoft.Sql/servers/databases"
}
{
  "sku": {
    "name": "Standard",
    "tier": "Standard",
    "capacity": 10
  },
  "kind": "v12.0,user",
  "properties": {
    "collation": "SQL_Latin1_General_CP1_CI_AS",
    "maxSizeBytes": 268435456000,
    "status": "Online",
    "databaseId": "6c764297-577b-470f-9af4-96d3d41e2ba3",
    "currentSku": {
      "name": "Standard",
      "tier": "Standard",
      "capacity": 10
    },
    "creationDate": "2017-06-07T04:41:33.937Z",
    "currentBackupStorageRedundancy": "Geo",
    "currentServiceObjectiveName": "S0",
    "defaultSecondaryLocation": "North Europe",
    "earliestRestoreDate": "2017-06-07T04:51:33.937Z",
    "catalogCollation": "SQL_Latin1_General_CP1_CI_AS",
    "readScale": "Disabled",
    "requestedBackupStorageRedundancy": "Geo",
    "requestedServiceObjectiveName": "S0",
    "secondaryType": "Geo",
    "isLedgerOn": false,
    "isInfraEncryptionEnabled": false,
    "zoneRedundant": false
  },
  "location": "southeastasia",
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-SouthEastAsia/providers/Microsoft.Sql/servers/testsvr/databases/testdb",
  "name": "testdb",
  "type": "Microsoft.Sql/servers/databases"
}

Creates a database as named replica secondary.

Sample Request

PUT https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-SouthEastAsia/providers/Microsoft.Sql/servers/testsvr/databases/testdb?api-version=2022-02-01-preview

{
  "location": "southeastasia",
  "sku": {
    "name": "HS_Gen4",
    "tier": "Hyperscale",
    "capacity": 2
  },
  "properties": {
    "createMode": "Secondary",
    "secondaryType": "Named",
    "sourceDatabaseId": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-NorthEurope/providers/Microsoft.Sql/servers/testsvr1/databases/primarydb"
  }
}

Sample Response

{
  "sku": {
    "name": "HS_Gen4",
    "tier": "Hyperscale",
    "family": "Gen4",
    "capacity": 2
  },
  "kind": "v12.0,user,vcore,hyperscale",
  "properties": {
    "collation": "SQL_Latin1_General_CP1_CI_AS",
    "maxSizeBytes": -1,
    "status": "Online",
    "databaseId": "6c764297-577b-470f-9af4-96d3d41e2ba3",
    "currentSku": {
      "name": "HS_Gen4",
      "tier": "Hyperscale",
      "family": "Gen4",
      "capacity": 2
    },
    "creationDate": "2017-06-07T04:41:33.937Z",
    "currentBackupStorageRedundancy": "Geo",
    "currentServiceObjectiveName": "HS_Gen4_2",
    "defaultSecondaryLocation": "North Europe",
    "earliestRestoreDate": "2017-06-07T04:51:33.937Z",
    "catalogCollation": "SQL_Latin1_General_CP1_CI_AS",
    "readScale": "Disabled",
    "requestedBackupStorageRedundancy": "Geo",
    "requestedServiceObjectiveName": "HS_Gen4_2",
    "highAvailabilityReplicaCount": 0,
    "licenseType": "LicenseIncluded",
    "secondaryType": "Named",
    "isLedgerOn": false,
    "isInfraEncryptionEnabled": false,
    "zoneRedundant": false
  },
  "location": "southeastasia",
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-SouthEastAsia/providers/Microsoft.Sql/servers/testsvr/databases/testdb",
  "name": "testdb",
  "type": "Microsoft.Sql/servers/databases"
}
{
  "sku": {
    "name": "HS_Gen4",
    "tier": "Hyperscale",
    "family": "Gen4",
    "capacity": 2
  },
  "kind": "v12.0,user,vcore,hyperscale",
  "properties": {
    "collation": "SQL_Latin1_General_CP1_CI_AS",
    "maxSizeBytes": -1,
    "status": "Online",
    "databaseId": "6c764297-577b-470f-9af4-96d3d41e2ba3",
    "currentSku": {
      "name": "HS_Gen4",
      "tier": "Hyperscale",
      "family": "Gen4",
      "capacity": 2
    },
    "creationDate": "2017-06-07T04:41:33.937Z",
    "currentBackupStorageRedundancy": "Geo",
    "currentServiceObjectiveName": "HS_Gen4_2",
    "defaultSecondaryLocation": "North Europe",
    "earliestRestoreDate": "2017-06-07T04:51:33.937Z",
    "catalogCollation": "SQL_Latin1_General_CP1_CI_AS",
    "readScale": "Disabled",
    "requestedBackupStorageRedundancy": "Geo",
    "requestedServiceObjectiveName": "HS_Gen4_2",
    "highAvailabilityReplicaCount": 0,
    "licenseType": "LicenseIncluded",
    "secondaryType": "Named",
    "isLedgerOn": false,
    "isInfraEncryptionEnabled": false,
    "zoneRedundant": false
  },
  "location": "southeastasia",
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-SouthEastAsia/providers/Microsoft.Sql/servers/testsvr/databases/testdb",
  "name": "testdb",
  "type": "Microsoft.Sql/servers/databases"
}

Creates a database from PointInTimeRestore.

Sample Request

PUT https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-SouthEastAsia/providers/Microsoft.Sql/servers/testsvr/databases/dbpitr?api-version=2022-02-01-preview

{
  "location": "southeastasia",
  "properties": {
    "createMode": "PointInTimeRestore",
    "sourceDatabaseId": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-SoutheastAsia/providers/Microsoft.Sql/servers/testsvr/databases/testdb",
    "restorePointInTime": "2020-10-22T05:35:31.503Z"
  }
}

Sample Response

{
  "sku": {
    "name": "Standard",
    "tier": "Standard",
    "capacity": 10
  },
  "kind": "v12.0,user",
  "properties": {
    "collation": "SQL_Latin1_General_CP1_CI_AS",
    "maxSizeBytes": 268435456000,
    "status": "Online",
    "databaseId": "2463ef48-53e2-4c26-9781-2d7138080bfd",
    "creationDate": "2020-10-23T20:31:35.807Z",
    "currentServiceObjectiveName": "S0",
    "requestedServiceObjectiveName": "S0",
    "defaultSecondaryLocation": "SoutheastAsia",
    "catalogCollation": "SQL_Latin1_General_CP1_CI_AS",
    "isInfraEncryptionEnabled": false,
    "zoneRedundant": false,
    "earliestRestoreDate": "2020-10-23T20:47:37Z",
    "readScale": "Disabled",
    "currentSku": {
      "name": "Standard",
      "tier": "Standard",
      "capacity": 10
    },
    "currentBackupStorageRedundancy": "Geo",
    "requestedBackupStorageRedundancy": "Geo",
    "isLedgerOn": false
  },
  "location": "SoutheastAsia",
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-SoutheastAsia/providers/Microsoft.Sql/servers/testsvr/databases/dbpitr",
  "name": "dbpitr",
  "type": "Microsoft.Sql/servers/databases"
}
{
  "sku": {
    "name": "Standard",
    "tier": "Standard",
    "capacity": 10
  },
  "kind": "v12.0,user",
  "properties": {
    "collation": "SQL_Latin1_General_CP1_CI_AS",
    "maxSizeBytes": 268435456000,
    "status": "Online",
    "databaseId": "2463ef48-53e2-4c26-9781-2d7138080bfd",
    "creationDate": "2020-10-23T20:31:35.807Z",
    "currentServiceObjectiveName": "S0",
    "requestedServiceObjectiveName": "S0",
    "defaultSecondaryLocation": "SoutheastAsia",
    "catalogCollation": "SQL_Latin1_General_CP1_CI_AS",
    "isInfraEncryptionEnabled": false,
    "zoneRedundant": false,
    "earliestRestoreDate": "2020-10-23T20:47:37Z",
    "readScale": "Disabled",
    "currentSku": {
      "name": "Standard",
      "tier": "Standard",
      "capacity": 10
    },
    "currentBackupStorageRedundancy": "Geo",
    "requestedBackupStorageRedundancy": "Geo",
    "isLedgerOn": false
  },
  "location": "SoutheastAsia",
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-SoutheastAsia/providers/Microsoft.Sql/servers/testsvr/databases/dbpitr",
  "name": "dbpitr",
  "type": "Microsoft.Sql/servers/databases"
}

Creates a database with default mode.

Sample Request

PUT https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-SouthEastAsia/providers/Microsoft.Sql/servers/testsvr/databases/testdb?api-version=2022-02-01-preview

{
  "location": "southeastasia",
  "sku": {
    "name": "S0",
    "tier": "Standard"
  },
  "properties": {
    "createMode": "Default",
    "collation": "SQL_Latin1_General_CP1_CI_AS",
    "maxSizeBytes": 1073741824
  }
}

Sample Response

{
  "sku": {
    "name": "S0",
    "tier": "Standard",
    "capacity": 10
  },
  "kind": "v12.0,user",
  "properties": {
    "collation": "SQL_Latin1_General_CP1_CI_AS",
    "maxSizeBytes": 1073741824,
    "status": "Online",
    "currentSku": {
      "name": "Standard",
      "tier": "Standard",
      "capacity": 10
    },
    "databaseId": "6c764297-577b-470f-9af4-96d3d41e2ba3",
    "creationDate": "2017-06-07T04:41:33.937Z",
    "currentBackupStorageRedundancy": "Geo",
    "currentServiceObjectiveName": "S0",
    "defaultSecondaryLocation": "North Europe",
    "earliestRestoreDate": "2017-06-07T04:51:33.937Z",
    "readScale": "Disabled",
    "requestedBackupStorageRedundancy": "Geo",
    "requestedServiceObjectiveName": "S0",
    "isInfraEncryptionEnabled": false,
    "zoneRedundant": false,
    "catalogCollation": "SQL_Latin1_General_CP1_CI_AS",
    "isLedgerOn": false
  },
  "location": "southeastasia",
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-SouthEastAsia/providers/Microsoft.Sql/servers/testsvr/databases/testdb",
  "name": "testdb",
  "type": "Microsoft.Sql/servers/databases"
}
{
  "sku": {
    "name": "S0",
    "tier": "Standard",
    "capacity": 10
  },
  "kind": "v12.0,user",
  "properties": {
    "collation": "SQL_Latin1_General_CP1_CI_AS",
    "maxSizeBytes": 1073741824,
    "status": "Online",
    "currentSku": {
      "name": "Standard",
      "tier": "Standard",
      "capacity": 10
    },
    "databaseId": "6c764297-577b-470f-9af4-96d3d41e2ba3",
    "creationDate": "2017-06-07T04:41:33.937Z",
    "currentBackupStorageRedundancy": "Geo",
    "currentServiceObjectiveName": "S0",
    "defaultSecondaryLocation": "North Europe",
    "earliestRestoreDate": "2017-06-07T04:51:33.937Z",
    "readScale": "Disabled",
    "requestedBackupStorageRedundancy": "Geo",
    "requestedServiceObjectiveName": "S0",
    "isInfraEncryptionEnabled": false,
    "zoneRedundant": false,
    "catalogCollation": "SQL_Latin1_General_CP1_CI_AS",
    "isLedgerOn": false
  },
  "location": "southeastasia",
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-SouthEastAsia/providers/Microsoft.Sql/servers/testsvr/databases/testdb",
  "name": "testdb",
  "type": "Microsoft.Sql/servers/databases"
}

Creates a database with ledger on.

Sample Request

PUT https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-SouthEastAsia/providers/Microsoft.Sql/servers/testsvr/databases/testdb?api-version=2022-02-01-preview

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

Sample Response

{
  "sku": {
    "name": "Standard",
    "tier": "Standard",
    "capacity": 10
  },
  "kind": "v12.0,user",
  "properties": {
    "collation": "SQL_Latin1_General_CP1_CI_AS",
    "maxSizeBytes": 268435456000,
    "status": "Online",
    "databaseId": "6c764297-577b-470f-9af4-96d3d41e2ba3",
    "currentSku": {
      "name": "Standard",
      "tier": "Standard",
      "capacity": 10
    },
    "creationDate": "2017-06-07T04:41:33.937Z",
    "currentServiceObjectiveName": "S0",
    "currentBackupStorageRedundancy": "Geo",
    "defaultSecondaryLocation": "North Europe",
    "earliestRestoreDate": "2017-06-07T04:51:33.937Z",
    "catalogCollation": "SQL_Latin1_General_CP1_CI_AS",
    "readScale": "Disabled",
    "requestedBackupStorageRedundancy": "Geo",
    "requestedServiceObjectiveName": "S0",
    "zoneRedundant": false,
    "isLedgerOn": true
  },
  "location": "southeastasia",
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-SouthEastAsia/providers/Microsoft.Sql/servers/testsvr/databases/testdb",
  "name": "testdb",
  "type": "Microsoft.Sql/servers/databases"
}
{
  "sku": {
    "name": "Standard",
    "tier": "Standard",
    "capacity": 10
  },
  "kind": "v12.0,user",
  "properties": {
    "collation": "SQL_Latin1_General_CP1_CI_AS",
    "maxSizeBytes": 268435456000,
    "status": "Online",
    "databaseId": "6c764297-577b-470f-9af4-96d3d41e2ba3",
    "currentSku": {
      "name": "Standard",
      "tier": "Standard",
      "capacity": 10
    },
    "creationDate": "2017-06-07T04:41:33.937Z",
    "currentBackupStorageRedundancy": "Zone",
    "currentServiceObjectiveName": "S0",
    "defaultSecondaryLocation": "North Europe",
    "earliestRestoreDate": "2017-06-07T04:51:33.937Z",
    "catalogCollation": "SQL_Latin1_General_CP1_CI_AS",
    "readScale": "Disabled",
    "requestedBackupStorageRedundancy": "Zone",
    "requestedServiceObjectiveName": "S0",
    "zoneRedundant": false,
    "isLedgerOn": false
  },
  "location": "southeastasia",
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-SouthEastAsia/providers/Microsoft.Sql/servers/testsvr/databases/testdb",
  "name": "testdb",
  "type": "Microsoft.Sql/servers/databases"
}

Creates a database with minimum number of parameters.

Sample Request

PUT https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-SouthEastAsia/providers/Microsoft.Sql/servers/testsvr/databases/testdb?api-version=2022-02-01-preview

{
  "location": "southeastasia"
}

Sample Response

{
  "sku": {
    "name": "Standard",
    "tier": "Standard",
    "capacity": 10
  },
  "kind": "v12.0,user",
  "properties": {
    "collation": "SQL_Latin1_General_CP1_CI_AS",
    "maxSizeBytes": 268435456000,
    "status": "Online",
    "databaseId": "6c764297-577b-470f-9af4-96d3d41e2ba3",
    "currentSku": {
      "name": "Standard",
      "tier": "Standard",
      "capacity": 10
    },
    "creationDate": "2017-06-07T04:41:33.937Z",
    "currentServiceObjectiveName": "S0",
    "currentBackupStorageRedundancy": "Geo",
    "defaultSecondaryLocation": "North Europe",
    "earliestRestoreDate": "2017-06-07T04:51:33.937Z",
    "catalogCollation": "SQL_Latin1_General_CP1_CI_AS",
    "readScale": "Disabled",
    "requestedBackupStorageRedundancy": "Geo",
    "requestedServiceObjectiveName": "S0",
    "isLedgerOn": false,
    "isInfraEncryptionEnabled": false,
    "zoneRedundant": false
  },
  "location": "southeastasia",
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-SouthEastAsia/providers/Microsoft.Sql/servers/testsvr/databases/testdb",
  "name": "testdb",
  "type": "Microsoft.Sql/servers/databases"
}
{
  "sku": {
    "name": "Standard",
    "tier": "Standard",
    "capacity": 10
  },
  "kind": "v12.0,user",
  "properties": {
    "collation": "SQL_Latin1_General_CP1_CI_AS",
    "maxSizeBytes": 268435456000,
    "status": "Online",
    "databaseId": "6c764297-577b-470f-9af4-96d3d41e2ba3",
    "currentSku": {
      "name": "Standard",
      "tier": "Standard",
      "capacity": 10
    },
    "creationDate": "2017-06-07T04:41:33.937Z",
    "currentBackupStorageRedundancy": "Geo",
    "currentServiceObjectiveName": "S0",
    "defaultSecondaryLocation": "North Europe",
    "earliestRestoreDate": "2017-06-07T04:51:33.937Z",
    "catalogCollation": "SQL_Latin1_General_CP1_CI_AS",
    "readScale": "Disabled",
    "requestedBackupStorageRedundancy": "Geo",
    "requestedServiceObjectiveName": "S0",
    "isLedgerOn": false,
    "isInfraEncryptionEnabled": false,
    "zoneRedundant": false
  },
  "location": "southeastasia",
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-SouthEastAsia/providers/Microsoft.Sql/servers/testsvr/databases/testdb",
  "name": "testdb",
  "type": "Microsoft.Sql/servers/databases"
}

Creates a database with preferred maintenance window.

Sample Request

PUT https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-SouthEastAsia/providers/Microsoft.Sql/servers/testsvr/databases/testdb?api-version=2022-02-01-preview

{
  "location": "southeastasia",
  "sku": {
    "name": "S2",
    "tier": "Standard"
  },
  "properties": {
    "createMode": "Default",
    "collation": "SQL_Latin1_General_CP1_CI_AS",
    "maxSizeBytes": 1073741824,
    "maintenanceConfigurationId": "/subscriptions/00000000-1111-2222-3333-444444444444/providers/Microsoft.Maintenance/publicMaintenanceConfigurations/SQL_SouthEastAsia_1"
  }
}

Sample Response

{
  "sku": {
    "name": "S2",
    "tier": "Standard"
  },
  "kind": "v12.0,user",
  "properties": {
    "collation": "SQL_Latin1_General_CP1_CI_AS",
    "maxSizeBytes": 1073741824,
    "status": "Online",
    "databaseId": "6c764297-577b-470f-9af4-96d3d41e2ba3",
    "creationDate": "2017-06-07T04:41:33.937Z",
    "currentServiceObjectiveName": "S2",
    "defaultSecondaryLocation": "North Europe",
    "catalogCollation": "SQL_Latin1_General_CP1_CI_AS",
    "isInfraEncryptionEnabled": false,
    "zoneRedundant": false,
    "earliestRestoreDate": "2020-08-29T06:41:18.283Z",
    "readScale": "Disabled",
    "currentSku": {
      "name": "Standard",
      "tier": "Standard",
      "capacity": 50
    },
    "currentBackupStorageRedundancy": "Geo",
    "requestedBackupStorageRedundancy": "Geo",
    "maintenanceConfigurationId": "/subscriptions/00000000-1111-2222-3333-444444444444/providers/Microsoft.Maintenance/publicMaintenanceConfigurations/SQL_SouthEastAsia_1",
    "isLedgerOn": false
  },
  "location": "southeastasia",
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-SouthEastAsia/providers/Microsoft.Sql/servers/testsvr/databases/testdb",
  "name": "testdb",
  "type": "Microsoft.Sql/servers/databases"
}
{
  "sku": {
    "name": "S2",
    "tier": "Standard"
  },
  "kind": "v12.0,user",
  "properties": {
    "collation": "SQL_Latin1_General_CP1_CI_AS",
    "maxSizeBytes": 1073741824,
    "status": "Online",
    "databaseId": "6c764297-577b-470f-9af4-96d3d41e2ba3",
    "creationDate": "2017-06-07T04:41:33.937Z",
    "currentServiceObjectiveName": "S2",
    "defaultSecondaryLocation": "North Europe",
    "catalogCollation": "SQL_Latin1_General_CP1_CI_AS",
    "isInfraEncryptionEnabled": false,
    "zoneRedundant": false,
    "earliestRestoreDate": "2020-08-29T06:41:18.283Z",
    "readScale": "Disabled",
    "currentSku": {
      "name": "Standard",
      "tier": "Standard",
      "capacity": 50
    },
    "currentBackupStorageRedundancy": "Geo",
    "requestedBackupStorageRedundancy": "Geo",
    "maintenanceConfigurationId": "/subscriptions/00000000-1111-2222-3333-444444444444/providers/Microsoft.Maintenance/publicMaintenanceConfigurations/SQL_SouthEastAsia_1",
    "isLedgerOn": false
  },
  "location": "southeastasia",
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-SouthEastAsia/providers/Microsoft.Sql/servers/testsvr/databases/testdb",
  "name": "testdb",
  "type": "Microsoft.Sql/servers/databases"
}

Creates a database with specified backup storage redundancy.

Sample Request

PUT https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-SouthEastAsia/providers/Microsoft.Sql/servers/testsvr/databases/testdb?api-version=2022-02-01-preview

{
  "location": "southeastasia",
  "properties": {
    "requestedBackupStorageRedundancy": "Zone"
  }
}

Sample Response

{
  "sku": {
    "name": "Standard",
    "tier": "Standard",
    "capacity": 10
  },
  "kind": "v12.0,user",
  "properties": {
    "collation": "SQL_Latin1_General_CP1_CI_AS",
    "maxSizeBytes": 268435456000,
    "status": "Online",
    "databaseId": "6c764297-577b-470f-9af4-96d3d41e2ba3",
    "currentSku": {
      "name": "Standard",
      "tier": "Standard",
      "capacity": 10
    },
    "creationDate": "2017-06-07T04:41:33.937Z",
    "currentBackupStorageRedundancy": "Zone",
    "currentServiceObjectiveName": "S0",
    "defaultSecondaryLocation": "North Europe",
    "earliestRestoreDate": "2017-06-07T04:51:33.937Z",
    "catalogCollation": "SQL_Latin1_General_CP1_CI_AS",
    "readScale": "Disabled",
    "requestedBackupStorageRedundancy": "Zone",
    "requestedServiceObjectiveName": "S0",
    "isLedgerOn": false,
    "isInfraEncryptionEnabled": false,
    "zoneRedundant": false
  },
  "location": "southeastasia",
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-SouthEastAsia/providers/Microsoft.Sql/servers/testsvr/databases/testdb",
  "name": "testdb",
  "type": "Microsoft.Sql/servers/databases"
}
{
  "sku": {
    "name": "Standard",
    "tier": "Standard",
    "capacity": 10
  },
  "kind": "v12.0,user",
  "properties": {
    "collation": "SQL_Latin1_General_CP1_CI_AS",
    "maxSizeBytes": 268435456000,
    "status": "Online",
    "databaseId": "6c764297-577b-470f-9af4-96d3d41e2ba3",
    "currentSku": {
      "name": "Standard",
      "tier": "Standard",
      "capacity": 10
    },
    "creationDate": "2017-06-07T04:41:33.937Z",
    "currentBackupStorageRedundancy": "Zone",
    "currentServiceObjectiveName": "S0",
    "defaultSecondaryLocation": "North Europe",
    "earliestRestoreDate": "2017-06-07T04:51:33.937Z",
    "catalogCollation": "SQL_Latin1_General_CP1_CI_AS",
    "readScale": "Disabled",
    "requestedBackupStorageRedundancy": "Zone",
    "requestedServiceObjectiveName": "S0",
    "zoneRedundant": false,
    "isLedgerOn": false,
    "isInfraEncryptionEnabled": false
  },
  "location": "southeastasia",
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-SouthEastAsia/providers/Microsoft.Sql/servers/testsvr/databases/testdb",
  "name": "testdb",
  "type": "Microsoft.Sql/servers/databases"
}

Creates a VCore database by specifying service objective name.

Sample Request

PUT https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-SouthEastAsia/providers/Microsoft.Sql/servers/testsvr/databases/testdb?api-version=2022-02-01-preview

{
  "location": "southeastasia",
  "sku": {
    "name": "BC",
    "family": "Gen4",
    "capacity": 2
  }
}

Sample Response

{
  "sku": {
    "name": "BC_Gen4",
    "tier": "BusinessCritical",
    "family": "Gen4",
    "capacity": 2
  },
  "kind": "v12.0,user",
  "properties": {
    "collation": "SQL_Latin1_General_CP1_CI_AS",
    "earliestRestoreDate": "2017-06-07T04:51:33.937Z",
    "maxSizeBytes": 1073741824,
    "status": "Online",
    "databaseId": "6c764297-577b-470f-9af4-96d3d41e2ba3",
    "creationDate": "2017-06-07T04:41:33.937Z",
    "currentServiceObjectiveName": "BC_Gen4_2",
    "defaultSecondaryLocation": "North Europe",
    "catalogCollation": "SQL_Latin1_General_CP1_CI_AS",
    "licenseType": "LicenseIncluded",
    "maxLogSizeBytes": 104857600,
    "readScale": "Enabled",
    "currentBackupStorageRedundancy": "Geo",
    "requestedBackupStorageRedundancy": "Geo",
    "isLedgerOn": false,
    "isInfraEncryptionEnabled": false,
    "zoneRedundant": false,
    "currentSku": {
      "name": "BC_Gen4",
      "tier": "BusinessCritical",
      "capacity": 2
    }
  },
  "location": "southeastasia",
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-SouthEastAsia/providers/Microsoft.Sql/servers/testsvr/databases/testdb",
  "name": "testdb",
  "type": "Microsoft.Sql/servers/databases"
}
{
  "sku": {
    "name": "BC_Gen4",
    "tier": "BusinessCritical",
    "family": "Gen4",
    "capacity": 2
  },
  "kind": "v12.0,user",
  "properties": {
    "collation": "SQL_Latin1_General_CP1_CI_AS",
    "earliestRestoreDate": "2017-06-07T04:51:33.937Z",
    "maxSizeBytes": 1073741824,
    "status": "Online",
    "databaseId": "6c764297-577b-470f-9af4-96d3d41e2ba3",
    "creationDate": "2017-06-07T04:41:33.937Z",
    "currentServiceObjectiveName": "BC_Gen4_2",
    "defaultSecondaryLocation": "North Europe",
    "catalogCollation": "SQL_Latin1_General_CP1_CI_AS",
    "licenseType": "LicenseIncluded",
    "maxLogSizeBytes": 104857600,
    "readScale": "Enabled",
    "currentBackupStorageRedundancy": "Geo",
    "requestedBackupStorageRedundancy": "Geo",
    "isInfraEncryptionEnabled": false,
    "zoneRedundant": false,
    "isLedgerOn": false,
    "currentSku": {
      "name": "BC_Gen4",
      "tier": "BusinessCritical",
      "capacity": 2
    }
  },
  "location": "southeastasia",
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-SouthEastAsia/providers/Microsoft.Sql/servers/testsvr/databases/testdb",
  "name": "testdb",
  "type": "Microsoft.Sql/servers/databases"
}

Creates a VCore database by specifying sku name and capacity.

Sample Request

PUT https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-SouthEastAsia/providers/Microsoft.Sql/servers/testsvr/databases/testdb?api-version=2022-02-01-preview

{
  "location": "southeastasia",
  "sku": {
    "name": "BC_Gen4",
    "capacity": 2
  }
}

Sample Response

{
  "sku": {
    "name": "BC_Gen4",
    "tier": "BusinessCritical",
    "family": "Gen4",
    "capacity": 2
  },
  "kind": "v12.0,user",
  "properties": {
    "collation": "SQL_Latin1_General_CP1_CI_AS",
    "earliestRestoreDate": "2017-06-07T04:51:33.937Z",
    "maxSizeBytes": 1073741824,
    "status": "Online",
    "databaseId": "6c764297-577b-470f-9af4-96d3d41e2ba3",
    "creationDate": "2017-06-07T04:41:33.937Z",
    "currentServiceObjectiveName": "BC_Gen4_2",
    "defaultSecondaryLocation": "North Europe",
    "catalogCollation": "SQL_Latin1_General_CP1_CI_AS",
    "licenseType": "LicenseIncluded",
    "maxLogSizeBytes": 104857600,
    "readScale": "Enabled",
    "currentBackupStorageRedundancy": "Geo",
    "requestedBackupStorageRedundancy": "Geo",
    "isLedgerOn": false,
    "isInfraEncryptionEnabled": false,
    "zoneRedundant": false,
    "currentSku": {
      "name": "BC_Gen4",
      "tier": "BusinessCritical",
      "capacity": 2
    }
  },
  "location": "southeastasia",
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-SouthEastAsia/providers/Microsoft.Sql/servers/testsvr/databases/testdb",
  "name": "testdb",
  "type": "Microsoft.Sql/servers/databases"
}
{
  "sku": {
    "name": "BC_Gen4",
    "tier": "BusinessCritical",
    "family": "Gen4",
    "capacity": 2
  },
  "kind": "v12.0,user",
  "properties": {
    "collation": "SQL_Latin1_General_CP1_CI_AS",
    "earliestRestoreDate": "2017-06-07T04:51:33.937Z",
    "maxSizeBytes": 1073741824,
    "status": "Online",
    "databaseId": "6c764297-577b-470f-9af4-96d3d41e2ba3",
    "creationDate": "2017-06-07T04:41:33.937Z",
    "currentServiceObjectiveName": "BC_Gen4_2",
    "defaultSecondaryLocation": "North Europe",
    "catalogCollation": "SQL_Latin1_General_CP1_CI_AS",
    "licenseType": "LicenseIncluded",
    "maxLogSizeBytes": 104857600,
    "readScale": "Enabled",
    "currentBackupStorageRedundancy": "Geo",
    "requestedBackupStorageRedundancy": "Geo",
    "isLedgerOn": false,
    "isInfraEncryptionEnabled": false,
    "zoneRedundant": false,
    "currentSku": {
      "name": "BC_Gen4",
      "tier": "BusinessCritical",
      "capacity": 2
    }
  },
  "location": "southeastasia",
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-SouthEastAsia/providers/Microsoft.Sql/servers/testsvr/databases/testdb",
  "name": "testdb",
  "type": "Microsoft.Sql/servers/databases"
}

定义

BackupStorageRedundancy

用于存储此数据库的备份的存储帐户类型。

CatalogCollationType

元数据目录的排序规则。

CreateMode

指定数据库创建模式。

默认值:常规数据库创建。

复制:创建数据库作为现有数据库的副本。 sourceDatabaseId 必须指定为源数据库的资源 ID。

辅助数据库:创建数据库作为现有数据库的次要副本。 sourceDatabaseId 必须指定为现有主数据库的资源 ID。

PointInTimeRestore:通过还原现有数据库的时间点备份来创建数据库。 sourceDatabaseId 必须指定为现有数据库的资源 ID,并且必须指定 restorePointInTime。

恢复:通过还原异地复制的备份来创建数据库。 sourceDatabaseId 必须指定为可恢复的数据库资源 ID 才能还原。

还原:通过还原已删除数据库的备份来创建数据库。 必须指定 sourceDatabaseId。 如果 sourceDatabaseId 是数据库的原始资源 ID,则必须指定 sourceDatabaseDeletionDate。 否则,sourceDatabaseId 必须是可还原的数据库资源 ID,并且将忽略 sourceDatabaseDeletionDate。 还可以指定 restorePointInTime,以便从较早的时间点还原。

RestoreLongTermRetentionBackup:通过从长期保留保管库还原来创建数据库。 recoveryServicesRecoveryPointResourceId 必须指定为恢复点资源 ID。

DataWarehouse 版本不支持 Copy、Secondary 和 RestoreLongTermRetentionBackup。

Database

数据库资源。

DatabaseIdentity

资源的 Azure Active Directory 标识配置。

DatabaseIdentityType

标识类型

DatabaseLicenseType

要申请此数据库的许可证类型。 LicenseIncluded如果需要许可证,或者BasePrice拥有许可证并且有资格获得Azure 混合权益。

DatabaseReadScale

只读路由的状态。 如果启用,将应用程序意向设置为只读的连接在其连接字符串中可能会路由到同一区域中的只读次要副本。 不适用于弹性池中的超大规模数据库。

DatabaseStatus

数据库的状态。

DatabaseUserIdentity

资源的 Azure Active Directory 标识配置。

SampleName

创建此数据库时要应用的示例架构的名称。

SecondaryType

数据库的辅助类型(如果是辅助数据库)。 有效值为 Geo、Named 和 Standby。

Sku

ARM 资源 SKU。

BackupStorageRedundancy

用于存储此数据库的备份的存储帐户类型。

Name Type Description
Geo
  • string
GeoZone
  • string
Local
  • string
Zone
  • string

CatalogCollationType

元数据目录的排序规则。

Name Type Description
DATABASE_DEFAULT
  • string
SQL_Latin1_General_CP1_CI_AS
  • string

CreateMode

指定数据库创建模式。

默认值:常规数据库创建。

复制:创建数据库作为现有数据库的副本。 sourceDatabaseId 必须指定为源数据库的资源 ID。

辅助数据库:创建数据库作为现有数据库的次要副本。 sourceDatabaseId 必须指定为现有主数据库的资源 ID。

PointInTimeRestore:通过还原现有数据库的时间点备份来创建数据库。 sourceDatabaseId 必须指定为现有数据库的资源 ID,并且必须指定 restorePointInTime。

恢复:通过还原异地复制的备份来创建数据库。 sourceDatabaseId 必须指定为可恢复的数据库资源 ID 才能还原。

还原:通过还原已删除数据库的备份来创建数据库。 必须指定 sourceDatabaseId。 如果 sourceDatabaseId 是数据库的原始资源 ID,则必须指定 sourceDatabaseDeletionDate。 否则,sourceDatabaseId 必须是可还原的数据库资源 ID,并且将忽略 sourceDatabaseDeletionDate。 还可以指定 restorePointInTime,以便从较早的时间点还原。

RestoreLongTermRetentionBackup:通过从长期保留保管库还原来创建数据库。 recoveryServicesRecoveryPointResourceId 必须指定为恢复点资源 ID。

DataWarehouse 版本不支持 Copy、Secondary 和 RestoreLongTermRetentionBackup。

Name Type Description
Copy
  • string
Default
  • string
OnlineSecondary
  • string
PointInTimeRestore
  • string
Recovery
  • string
Restore
  • string
RestoreExternalBackup
  • string
RestoreExternalBackupSecondary
  • string
RestoreLongTermRetentionBackup
  • string
Secondary
  • string

Database

数据库资源。

Name Type Description
id
  • string

资源 ID。

identity

数据库的 Azure Active Directory 标识。

kind
  • string

数据库类型。 这是用于Azure 门户体验的元数据。

location
  • string

资源位置。

managedBy
  • string

管理数据库的资源。

name
  • string

资源名称。

properties.autoPauseDelay
  • integer

数据库自动暂停的时间(以分钟为单位)。 值为 -1 表示禁用自动暂停

properties.catalogCollation

元数据目录的排序规则。

properties.collation
  • string

数据库的排序规则。

properties.createMode

指定数据库创建模式。

默认值:常规数据库创建。

复制:将数据库创建为现有数据库的副本。 必须将 sourceDatabaseId 指定为源数据库的资源 ID。

辅助数据库:将数据库创建为现有数据库的次要副本。 必须将 sourceDatabaseId 指定为现有主数据库的资源 ID。

PointInTimeRestore:通过还原现有数据库的时间点备份来创建数据库。 sourceDatabaseId 必须指定为现有数据库的资源 ID,并且必须指定 restorePointInTime。

恢复:通过还原异地复制的备份来创建数据库。 必须将 sourceDatabaseId 指定为可恢复的数据库资源 ID 才能还原。

还原:通过还原已删除数据库的备份来创建数据库。 必须指定 sourceDatabaseId。 如果 sourceDatabaseId 是数据库的原始资源 ID,则必须指定 sourceDatabaseDeletionDate。 否则,sourceDatabaseId 必须是可还原的已删除数据库资源 ID,并且将忽略 sourceDatabaseDeletionDate。 还可以指定 restorePointInTime,以便从以前的时间点还原。

RestoreLongTermRetentionBackup:通过从长期保留保管库还原来创建数据库。 recoveryServicesRecoveryPointResourceId 必须指定为恢复点资源 ID。

DataWarehouse 版本不支持 Copy、Secondary 和 RestoreLongTermRetentionBackup。

properties.creationDate
  • string

数据库的创建日期 (ISO8601 格式) 。

properties.currentBackupStorageRedundancy

用于存储此数据库的备份的存储帐户类型。

properties.currentServiceObjectiveName
  • string

数据库的当前服务级别目标名称。

properties.currentSku

SKU 的名称和层。

properties.databaseId
  • string

数据库的 ID。

properties.defaultSecondaryLocation
  • string

此数据库的默认次要区域。

properties.earliestRestoreDate
  • string

这会记录此数据库的最早开始日期和时间, (ISO8601 格式) 。

properties.elasticPoolId
  • string

包含此数据库的弹性池的资源标识符。

properties.failoverGroupId
  • string

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

properties.federatedClientId
  • string

用于每个数据库 CMK 方案的跨租户的客户端 ID

properties.highAvailabilityReplicaCount
  • integer

与用于提供高可用性的数据库关联的辅助副本数。 不适用于弹性池中的超大规模数据库。

properties.isInfraEncryptionEnabled
  • boolean

为此数据库启用基础结构加密。

properties.isLedgerOn
  • boolean

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

properties.licenseType

要申请此数据库的许可证类型。 LicenseIncluded如果需要许可证,或者BasePrice拥有许可证并且有资格获得Azure 混合权益。

properties.longTermRetentionBackupResourceId
  • string

与此数据库的创建操作关联的长期保留备份的资源标识符。

properties.maintenanceConfigurationId
  • string

分配给数据库的维护配置 ID。 此配置定义维护更新发生时的时间段。

properties.maxLogSizeBytes
  • integer

此数据库的最大日志大小。

properties.maxSizeBytes
  • integer

以字节表示的数据库的最大大小。

properties.minCapacity
  • number

数据库始终分配的最小容量(如果未暂停)

properties.pausedDate
  • string

用户配置或操作暂停数据库的日期 (ISO8601 格式) 。 如果数据库准备就绪,则为 Null。

properties.readScale

只读路由的状态。 如果启用,将应用程序意向设置为在其连接字符串中以只读方式设置的连接可能会路由到同一区域中的只读次要副本。 不适用于弹性池中的超大规模数据库。

properties.recoverableDatabaseId
  • string

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

properties.recoveryServicesRecoveryPointId
  • string

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

properties.requestedBackupStorageRedundancy

用于存储此数据库的备份的存储帐户类型。

properties.requestedServiceObjectiveName
  • string

请求的数据库服务级别目标名称。

properties.restorableDroppedDatabaseId
  • string

与此数据库的创建操作关联的可还原已删除数据库的资源标识符。

properties.restorePointInTime
  • string

指定将还原以创建新数据库的源数据库的 ISO8601 格式) 时间点 (。

properties.resumedDate
  • string

用户操作或数据库登录 (ISO8601 格式) 恢复数据库的日期。 如果数据库暂停,则为 Null。

properties.sampleName

创建此数据库时要应用的示例架构的名称。

properties.secondaryType

数据库的辅助类型(如果是辅助数据库)。 有效值为 Geo、Named 和 Standby。

properties.sourceDatabaseDeletionDate
  • string

指定删除数据库的时间。

properties.sourceDatabaseId
  • string

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

properties.sourceResourceId
  • string

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

此属性仅支持 DataWarehouse 版本,并允许跨订阅还原。

指定 sourceResourceId 时,不得指定 sourceDatabaseId、recoverableDatabaseId、restoreableDroppedDatabaseId 和 sourceDatabaseDeletionDate,并且 CreateMode 必须是 PointInTimeRestore、Restore 或 Recover。

createMode 为 PointInTimeRestore 时,sourceResourceId 必须是现有数据库或现有 sql 池的资源 ID,并且必须指定 restorePointInTime。

当 createMode 为 Restore 时,sourceResourceId 必须是可还原的已删除数据库或可还原的已删除 sql 池的资源 ID。

CreateMode 为 Recover 时,sourceResourceId 必须是可恢复数据库或可恢复 sql 池的资源 ID。

当源订阅属于与目标订阅不同的租户时,“x-ms-authorization-auxiliary”标头必须包含源租户的身份验证令牌。 有关“x-ms-authorization-auxiliary”标头的更多详细信息,请参阅 https://docs.microsoft.com/en-us/azure/azure-resource-manager/management/authenticate-multi-tenant

properties.status

数据库的状态。

properties.zoneRedundant
  • boolean

此数据库是否为区域冗余,这意味着此数据库的副本将分散到多个可用性区域。

sku

数据库 SKU。

SKU 列表可能因区域和支持产品/服务而异。 若要确定 SKU ((包括可用于 Azure 区域中订阅的 SKU 名称、层/版本、系列和容量) ),请使用 Capabilities_ListByLocation REST API 或以下命令之一:

az sql db list-editions -l <location> -o table
Get-AzSqlServerServiceObjective -Location <location>
tags
  • object

资源标记。

type
  • string

资源类型。

DatabaseIdentity

资源的 Azure Active Directory 标识配置。

Name Type Description
tenantId
  • string

Azure Active Directory 租户 ID。

type

标识类型

userAssignedIdentities

要使用的用户分配标识的资源 ID

DatabaseIdentityType

标识类型

Name Type Description
None
  • string
UserAssigned
  • string

DatabaseLicenseType

要申请此数据库的许可证类型。 LicenseIncluded如果需要许可证,或者BasePrice拥有许可证并且有资格获得Azure 混合权益。

Name Type Description
BasePrice
  • string
LicenseIncluded
  • string

DatabaseReadScale

只读路由的状态。 如果启用,将应用程序意向设置为只读的连接在其连接字符串中可能会路由到同一区域中的只读次要副本。 不适用于弹性池中的超大规模数据库。

Name Type Description
Disabled
  • string
Enabled
  • string

DatabaseStatus

数据库的状态。

Name Type Description
AutoClosed
  • string
Copying
  • string
Creating
  • string
Disabled
  • string
EmergencyMode
  • string
Inaccessible
  • string
Offline
  • string
OfflineChangingDwPerformanceTiers
  • string
OfflineSecondary
  • string
Online
  • string
OnlineChangingDwPerformanceTiers
  • string
Paused
  • string
Pausing
  • string
Recovering
  • string
RecoveryPending
  • string
Restoring
  • string
Resuming
  • string
Scaling
  • string
Shutdown
  • string
Standby
  • string
Starting
  • string
Stopped
  • string
Stopping
  • string
Suspect
  • string

DatabaseUserIdentity

资源的 Azure Active Directory 标识配置。

Name Type Description
clientId
  • string

Azure Active Directory 客户端 ID。

principalId
  • string

Azure Active Directory 主体 ID。

SampleName

创建此数据库时要应用的示例架构的名称。

Name Type Description
AdventureWorksLT
  • string
WideWorldImportersFull
  • string
WideWorldImportersStd
  • string

SecondaryType

数据库的辅助类型(如果是辅助数据库)。 有效值为 Geo、Named 和 Standby。

Name Type Description
Geo
  • string
Named
  • string
Standby
  • string

Sku

ARM 资源 SKU。

Name Type Description
capacity
  • integer

特定 SKU 的容量。

family
  • string

如果服务具有不同代的硬件(对于同一 SKU,则可以在此处捕获)。

name
  • string

SKU 的名称,通常为字母 + 数字代码,例如 P3。

size
  • string

特定 SKU 的大小

tier
  • string

特定 SKU 的层或版本,例如基本 SKU、高级版。