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

Databases - List Inaccessible By Server

获取逻辑服务器中无法访问的数据库的列表

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/servers/{serverName}/inaccessibleDatabases?api-version=2021-08-01-preview

URI 参数

Name In Required Type Description
resourceGroupName
path True
  • string

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

serverName
path True
  • string

服务器的名称。

subscriptionId
path True
  • string

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

api-version
query True
  • string

要用于请求的 API 版本。

响应

Name Type Description
200 OK

成功检索逻辑服务器中不可访问的数据库列表

Other Status Codes

错误响应: ***

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

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

示例

Gets a list of inaccessible databases in a logical server

Sample Request

GET https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-SouthEastAsia/providers/Microsoft.Sql/servers/testsvr/inaccessibleDatabases?api-version=2021-08-01-preview

Sample Response

{
  "value": [
    {
      "sku": {
        "name": "BC_Gen4",
        "tier": "BusinessCritical",
        "capacity": 2
      },
      "kind": "v12.0,user,vcore",
      "properties": {
        "collation": "SQL_Latin1_General_CP1_CI_AS",
        "maxSizeBytes": 268435456000,
        "status": "Inaccessible",
        "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"
      },
      "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 混合权益。

DatabaseListResult

数据库的列表。

DatabaseReadScale

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

DatabaseStatus

数据库的状态。

DatabaseUserIdentity

资源的 Azure Active Directory 标识配置。

SampleName

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

SecondaryType

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

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。

properties.sourceDatabaseDeletionDate
  • string

指定删除数据库的时间。

properties.sourceDatabaseId
  • string

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

properties.sourceResourceId
  • string

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

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

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

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

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

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

当源订阅属于与目标订阅不同的租户时,“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

DatabaseListResult

数据库的列表。

Name Type Description
nextLink
  • string

用于检索下一页结果的链接。

value

结果数组。

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。

Name Type Description
Geo
  • string
Named
  • string

Sku

ARM 资源 SKU。

Name Type Description
capacity
  • integer

特定 SKU 的容量。

family
  • string

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

name
  • string

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

size
  • string

特定 SKU 的大小

tier
  • string

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