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

Managed Databases - Get

获取托管数据库。

GET 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 版本。

响应

名称 类型 说明
200 OK

ManagedDatabase

已成功检索指定的托管数据库。

Other Status Codes

ErrorResponse

错误响应: ***

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

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

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

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

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

示例

Gets a managed database

示例请求

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

示例响应

{
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/testrg/providers/Microsoft.Sql/managedInstances/testcl/databases/testdb1",
  "location": "southeastasia",
  "name": "testdb1",
  "properties": {
    "collation": "SQL_Latin1_General_CP1_CI_AS",
    "creationDate": "2017-08-04T15:00:17.73Z",
    "defaultSecondaryLocation": "North Europe",
    "status": "Online",
    "isLedgerOn": false
  },
  "type": "Microsoft.Sql/managedInstances/databases"
}

定义

名称 说明
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
RestoreExternalBackup
PointInTimeRestore
Recovery
RestoreLongTermRetentionBackup

ManagedDatabaseStatus

数据库的状态。

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