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

Databases - legacy - List By Elastic Pool

服务:: SQL Database

API 版本:: 2020-11-01-preview

获取弹性池中的数据库列表。

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/servers/{serverName}/elasticPools/{elasticPoolName}/databases?api-version=2020-11-01-preview

URI 参数

名称	在	必需	类型	说明
elasticPoolName	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 版本。

响应

名称	类型	说明
200 OK	DatabaseListResult	已成功检索弹性池中的数据库列表。
Other Status Codes		错误响应： *** 404 SubscriptionDoesNotHaveServer - 找不到请求的服务器 404 ServerNotInSubscriptionResourceGroup - 指定的服务器在指定的资源组和订阅中不存在。 404 CannotFindObject - 找不到对象，因为它不存在，或者您没有权限 404 ServerNotInSubscriptionResourceGroup - 指定的服务器在指定的资源组和订阅中不存在。 404 ServerNotInSubscription - 指定的服务器在指定的订阅上不存在。 429 SubscriptionTooManyCreateUpdateRequests - 请求超出可用资源可以处理的最大请求数。 429 SubscriptionTooManyRequests - 请求超出可用资源可以处理的最大请求数。 503 TooManyRequests - 请求超出可用资源可以处理的最大请求数。 504 RequestTimeout - 服务请求超过了允许的超时。

名称

类型

说明

200 OK

DatabaseListResult

已成功检索弹性池中的数据库列表。

Other Status Codes

错误响应： ***

404 SubscriptionDoesNotHaveServer - 找不到请求的服务器
404 ServerNotInSubscriptionResourceGroup - 指定的服务器在指定的资源组和订阅中不存在。
404 CannotFindObject - 找不到对象，因为它不存在，或者您没有权限
404 ServerNotInSubscriptionResourceGroup - 指定的服务器在指定的资源组和订阅中不存在。
404 ServerNotInSubscription - 指定的服务器在指定的订阅上不存在。
429 SubscriptionTooManyCreateUpdateRequests - 请求超出可用资源可以处理的最大请求数。
429 SubscriptionTooManyRequests - 请求超出可用资源可以处理的最大请求数。
503 TooManyRequests - 请求超出可用资源可以处理的最大请求数。
504 RequestTimeout - 服务请求超过了允许的超时。

示例

Gets a list of databases in an elastic pool.

示例请求

HTTP

GET https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-SouthEastAsia/providers/Microsoft.Sql/servers/testsvr/elasticPools/pool1/databases?api-version=2020-11-01-preview

示例响应

状态代码:: 200

{
  "value": [
    {
      "sku": {
        "name": "ElasticPool",
        "tier": "Standard"
      },
      "kind": "v12.0,user",
      "properties": {
        "collation": "SQL_Latin1_General_CP1_CI_AS",
        "maxSizeBytes": 268435456000,
        "elasticPoolId": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-SouthEastAsia/providers/Microsoft.Sql/servers/testsvr/elasticPools/Pool1",
        "status": "Online",
        "databaseId": "bfe0735f-bc87-447f-b2c2-481f4b100614",
        "creationDate": "2017-07-12T22:08:39.163Z",
        "currentServiceObjectiveName": "ElasticPool",
        "defaultSecondaryLocation": "North Europe",
        "catalogCollation": "SQL_Latin1_General_CP1_CI_AS"
      },
      "location": "southeastasia",
      "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-SouthEastAsia/providers/Microsoft.Sql/servers/testsvr/databases/DB001",
      "name": "DB001",
      "type": "Microsoft.Sql/servers/databases"
    },
    {
      "sku": {
        "name": "ElasticPool",
        "tier": "Standard"
      },
      "kind": "v12.0,user",
      "properties": {
        "collation": "SQL_Latin1_General_CP1_CI_AS",
        "maxSizeBytes": 268435456000,
        "elasticPoolId": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-SouthEastAsia/providers/Microsoft.Sql/servers/testsvr/elasticPools/Pool1",
        "status": "Online",
        "databaseId": "82246152-3177-4357-b81c-a16d87ce3593",
        "creationDate": "2017-07-12T22:10:10.773Z",
        "currentServiceObjectiveName": "ElasticPool",
        "defaultSecondaryLocation": "North Europe",
        "catalogCollation": "SQL_Latin1_General_CP1_CI_AS"
      },
      "location": "southeastasia",
      "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-SouthEastAsia/providers/Microsoft.Sql/servers/testsvr/databases/DB002",
      "name": "DB002",
      "type": "Microsoft.Sql/servers/databases"
    }
  ]
}

定义

名称	说明
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。
CurrentBackupStorageRedundancy	用于存储此数据库的备份的存储帐户类型。
Database	数据库资源。
DatabaseLicenseType	要申请此数据库的许可证类型。如果需要许可证，`LicenseIncluded`，或者 `BasePrice` 拥有许可证并且有资格获得 Azure 混合权益。
DatabaseListResult	数据库列表。
DatabaseReadScale	只读路由的状态。如果启用，将应用程序意向设置为只读的连接在其连接字符串中可能会路由到同一区域中的只读次要副本。
DatabaseStatus	数据库的状态。
RequestedBackupStorageRedundancy	用于存储此数据库的备份的存储帐户类型。
SampleName	创建此数据库时要应用的示例架构的名称。
SecondaryType	数据库的辅助类型（如果是辅助数据库）。有效值为 Geo 和 Named。
Sku	ARM 资源 SKU。

CatalogCollationType

枚举

元数据目录的排序规则。

值	说明
DATABASE_DEFAULT
SQL_Latin1_General_CP1_CI_AS

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。

值	说明
Default
Copy
Secondary
PointInTimeRestore
Restore
Recovery
RestoreExternalBackup
RestoreExternalBackupSecondary
RestoreLongTermRetentionBackup
OnlineSecondary

CurrentBackupStorageRedundancy

枚举

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

值	说明
Geo
Local
Zone

Database

Object

数据库资源。

名称	类型	说明
id	string	资源 ID。
kind	string	数据库类型。这是用于 Azure 门户体验的元数据。
location	string	资源位置。
managedBy	string	管理数据库的资源。
name	string	资源名称。
properties.autoPauseDelay	integer (int32)	数据库自动暂停的时间（以分钟为单位）。 -1 值表示禁用自动暂停
properties.catalogCollation	CatalogCollationType	元数据目录的排序规则。
properties.collation	string	数据库的排序规则。
properties.createMode	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 (date-time)	数据库的创建日期（ISO8601格式）。
properties.currentBackupStorageRedundancy	CurrentBackupStorageRedundancy	用于存储此数据库的备份的存储帐户类型。
properties.currentServiceObjectiveName	string	数据库的当前服务级别目标名称。
properties.currentSku	Sku	SKU 的名称和层。
properties.databaseId	string (uuid)	数据库的 ID。
properties.defaultSecondaryLocation	string	此数据库的默认次要区域。
properties.earliestRestoreDate	string (date-time)	这会记录此数据库的最早开始日期和时间（ISO8601格式）。
properties.elasticPoolId	string	包含此数据库的弹性池的资源标识符。
properties.failoverGroupId	string	此数据库所属的故障转移组资源标识符。
properties.highAvailabilityReplicaCount	integer (int32)	与用于提供高可用性的数据库关联的次要副本数。
properties.licenseType	DatabaseLicenseType	要申请此数据库的许可证类型。如果需要许可证，`LicenseIncluded`，或者 `BasePrice` 拥有许可证并且有资格获得 Azure 混合权益。
properties.longTermRetentionBackupResourceId	string	与此数据库的创建作关联的长期保留备份的资源标识符。
properties.maintenanceConfigurationId	string	分配给数据库的维护配置 ID。此配置定义维护更新的发生时间。
properties.maxLogSizeBytes	integer (int64)	此数据库的最大日志大小。
properties.maxSizeBytes	integer (int64)	以字节表示的数据库的最大大小。
properties.minCapacity	number (double)	数据库始终分配的最小容量（如果未暂停）
properties.pausedDate	string (date-time)	由用户配置或作（ISO8601格式）暂停数据库的日期。如果数据库准备就绪，则为 Null。
properties.readScale	DatabaseReadScale	只读路由的状态。如果启用，将应用程序意向设置为只读的连接在其连接字符串中可能会路由到同一区域中的只读次要副本。
properties.recoverableDatabaseId	string	与此数据库的创建作关联的可恢复数据库的资源标识符。
properties.recoveryServicesRecoveryPointId	string	与此数据库的创建作关联的恢复点的资源标识符。
properties.requestedBackupStorageRedundancy	RequestedBackupStorageRedundancy	用于存储此数据库的备份的存储帐户类型。
properties.requestedServiceObjectiveName	string	请求的数据库服务级别目标名称。
properties.restorableDroppedDatabaseId	string	与此数据库的创建作关联的可还原已删除数据库的资源标识符。
properties.restorePointInTime	string (date-time)	指定将还原以创建新数据库的源数据库的时间点（ISO8601格式）。
properties.resumedDate	string (date-time)	用户作或数据库登录恢复数据库的日期（ISO8601格式）。如果暂停数据库，则为 Null。
properties.sampleName	SampleName	创建此数据库时要应用的示例架构的名称。
properties.secondaryType	SecondaryType	数据库的辅助类型（如果是辅助数据库）。有效值为 Geo 和 Named。
properties.sourceDatabaseDeletionDate	string (date-time)	指定删除数据库的时间。
properties.sourceDatabaseId	string	与此数据库的创建作关联的源数据库的资源标识符。
properties.status	DatabaseStatus	数据库的状态。
properties.zoneRedundant	boolean	此数据库是否为区域冗余，这意味着此数据库的副本将分布在多个可用性区域。
sku	Sku	数据库 SKU。 SKU 列表可能因区域和支持产品/服务而异。若要确定 Azure 区域中订阅可用的 SKU（包括 SKU 名称、层/版本、系列和容量），请使用 `Capabilities_ListByLocation` REST API 或以下命令之一： `az sql db list-editions -l <location> -o table` `Get-AzSqlServerServiceObjective -Location <location>`
tags	object	资源标记。
type	string	资源类型。

DatabaseLicenseType

枚举

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

值	说明
LicenseIncluded
BasePrice

DatabaseListResult

Object

数据库列表。

名称	类型	说明
nextLink	string	用于检索下一页结果的链接。
value	Database[]	结果数组。

DatabaseReadScale

枚举

只读路由的状态。如果启用，将应用程序意向设置为只读的连接在其连接字符串中可能会路由到同一区域中的只读次要副本。

值	说明
Enabled
Disabled

DatabaseStatus

枚举

数据库的状态。

值	说明
Online
Restoring
RecoveryPending
Recovering
Suspect
Offline
Standby
Shutdown
EmergencyMode
AutoClosed
Copying
Creating
Inaccessible
OfflineSecondary
Pausing
Paused
Resuming
Scaling
OfflineChangingDwPerformanceTiers
OnlineChangingDwPerformanceTiers
Disabled

RequestedBackupStorageRedundancy

枚举

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

值	说明
Geo
Local
Zone

SampleName

枚举

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

值	说明
AdventureWorksLT
WideWorldImportersStd
WideWorldImportersFull

SecondaryType

枚举

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

值	说明
Geo
Named

Sku

Object

ARM 资源 SKU。

名称	类型	说明
capacity	integer (int32)	特定 SKU 的容量。
family	string	如果服务具有不同代的硬件（对于同一 SKU，则可以在此处捕获）。
name	string	SKU 的名称，通常为字母 + 数字代码，例如 P3。
size	string	特定 SKU 的大小
tier	string	特定 SKU 的层或版本，例如基本 SKU、高级版。