Databases - List By Elastic Pool

Obtiene una lista de bases de datos de un grupo elástico.

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

Parámetros de identificador URI

Name In Required Type Description
elasticPoolName
path True
  • string

Nombre del grupo elástico.

resourceGroupName
path True
  • string

Nombre del grupo de recursos que contiene el recurso. Puede obtener este valor en la API del Administrador de recursos o el portal de Azure.

serverName
path True
  • string

Nombre del servidor.

subscriptionId
path True
  • string

El id. de suscripción que identifica una suscripción de Azure.

api-version
query True
  • string

La versión de API que se usará para la solicitud.

Respuestas

Name Type Description
200 OK

Recuperó correctamente una lista de bases de datos de un grupo elástico.

Other Status Codes

Respuestas de error: :

  • 404 SubscriptionDoesNotServer: no se encontró el servidor solicitado

  • 404 ServerNotInSubscriptionResourceGroup: el servidor especificado no existe en el grupo de recursos y la suscripción especificados.

  • 404 CannotFindObject: no se encuentra el objeto porque no existe o porque no tiene permisos

  • 404 ServerNotInSubscriptionResourceGroup: el servidor especificado no existe en el grupo de recursos y la suscripción especificados.

  • 404 ServerNotInSubscription: el servidor especificado no existe en la suscripción especificada.

  • 429 SubscriptionTooManyCreateUpdateRequests: solicitudes más allá del número máximo de solicitudes que los recursos disponibles pueden procesar.

  • 429 SubscriptionTooManyRequests: solicitudes más allá del número máximo de solicitudes que los recursos disponibles pueden procesar.

  • 503 TooManyRequests: solicitudes más allá del número máximo de solicitudes que los recursos disponibles pueden procesar.

  • 504 RequestTimeout: la solicitud de servicio superó el tiempo de espera permitido.

Ejemplos

Gets a list of databases in an elastic pool.

Sample Request

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=2021-02-01-preview

Sample Response

{
  "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"
    }
  ]
}

Definiciones

CatalogCollationType

Intercalación del catálogo de metadatos.

CreateMode

Especifica el modo de creación de la base de datos.

Valor predeterminado: creación normal de la base de datos.

Copiar: crea una base de datos como una copia de una base de datos existente. sourceDatabaseId debe especificarse como identificador de recurso de la base de datos de origen.

Secundario: crea una base de datos como una réplica secundaria de una base de datos existente. sourceDatabaseId debe especificarse como identificador de recurso de la base de datos principal existente.

PointInTimeRestore: crea una base de datos restaurando una copia de seguridad a un momento dado de una base de datos existente. sourceDatabaseId debe especificarse como identificador de recurso de la base de datos existente y se debe especificar restorePointInTime.

Recuperación: crea una base de datos restaurando una copia de seguridad con replicación geográfica. sourceDatabaseId debe especificarse como el identificador de recurso de base de datos recuperable que se va a restaurar.

Restaurar: crea una base de datos restaurando una copia de seguridad de una base de datos eliminada. sourceDatabaseId debe especificarse. Si sourceDatabaseId es el identificador de recurso original de la base de datos, se debe especificar sourceDatabaseDeletionDate. De lo contrario, sourceDatabaseId debe ser el identificador de recurso de base de datos descartable y sourceDatabaseDeletionDate se omite. restorePointInTime también se puede especificar para restaurar desde un momento dado anterior.

RestoreLongTermRetentionBackup: crea una base de datos mediante la restauración desde un almacén de retención a largo plazo. recoveryServicesRecoveryPointResourceId debe especificarse como identificador de recurso del punto de recuperación.

Copy, Secondary y RestoreLongTermRetentionBackup no se admiten para la edición DataWarehouse.

CurrentBackupStorageRedundancy

Tipo de cuenta de almacenamiento que se usa para almacenar las copias de seguridad de esta base de datos.

Database

Un recurso de base de datos.

DatabaseLicenseType

Tipo de licencia que se va a aplicar a esta base de datos. LicenseIncluded si necesita una licencia o si tiene una licencia y BasePrice es apto para el Ventaja híbrida de Azure.

DatabaseListResult

Una lista de bases de datos.

DatabaseReadScale

Estado del enrutamiento de solo lectura. Si está habilitada, las conexiones que tienen la intención de aplicación establecida en readonly en su cadena de conexión se pueden enrutar a una réplica secundaria de solo lectura en la misma región.

DatabaseStatus

Estado de la base de datos.

RequestedBackupStorageRedundancy

Tipo de cuenta de almacenamiento que se va a usar para almacenar las copias de seguridad de esta base de datos.

SampleName

Nombre del esquema de ejemplo que se va a aplicar al crear esta base de datos.

SecondaryType

Tipo secundario de la base de datos si es una base de datos secundaria. Los valores válidos son Geo y Named.

Sku

Una SKU de recurso de ARM.

CatalogCollationType

Intercalación del catálogo de metadatos.

Name Type Description
DATABASE_DEFAULT
  • string
SQL_Latin1_General_CP1_CI_AS
  • string

CreateMode

Especifica el modo de creación de la base de datos.

Valor predeterminado: creación normal de la base de datos.

Copiar: crea una base de datos como una copia de una base de datos existente. sourceDatabaseId debe especificarse como identificador de recurso de la base de datos de origen.

Secundario: crea una base de datos como una réplica secundaria de una base de datos existente. sourceDatabaseId debe especificarse como identificador de recurso de la base de datos principal existente.

PointInTimeRestore: crea una base de datos restaurando una copia de seguridad a un momento dado de una base de datos existente. sourceDatabaseId debe especificarse como identificador de recurso de la base de datos existente y se debe especificar restorePointInTime.

Recuperación: crea una base de datos restaurando una copia de seguridad con replicación geográfica. sourceDatabaseId debe especificarse como el identificador de recurso de base de datos recuperable que se va a restaurar.

Restaurar: crea una base de datos restaurando una copia de seguridad de una base de datos eliminada. sourceDatabaseId debe especificarse. Si sourceDatabaseId es el identificador de recurso original de la base de datos, se debe especificar sourceDatabaseDeletionDate. De lo contrario, sourceDatabaseId debe ser el identificador de recurso de base de datos descartable y sourceDatabaseDeletionDate se omite. restorePointInTime también se puede especificar para restaurar desde un momento dado anterior.

RestoreLongTermRetentionBackup: crea una base de datos mediante la restauración desde un almacén de retención a largo plazo. recoveryServicesRecoveryPointResourceId debe especificarse como identificador de recurso del punto de recuperación.

Copy, Secondary y RestoreLongTermRetentionBackup no se admiten para la edición DataWarehouse.

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

CurrentBackupStorageRedundancy

Tipo de cuenta de almacenamiento que se usa para almacenar las copias de seguridad de esta base de datos.

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

Database

Un recurso de base de datos.

Name Type Description
id
  • string

Identificador del recurso.

kind
  • string

Tipo de base de datos. Se trata de metadatos usados para la Azure Portal usuario.

location
  • string

Ubicación del recurso

managedBy
  • string

Recurso que administra la base de datos.

name
  • string

Nombre del recurso.

properties.autoPauseDelay
  • integer

Tiempo en minutos después del cual la base de datos se pausa automáticamente. Un valor de -1 significa que la pausa automática está deshabilitada

properties.catalogCollation

Intercalación del catálogo de metadatos.

properties.collation
  • string

Intercalación de la base de datos.

properties.createMode

Especifica el modo de creación de la base de datos.

Valor predeterminado: creación normal de la base de datos.

Copiar: crea una base de datos como una copia de una base de datos existente. sourceDatabaseId debe especificarse como identificador de recurso de la base de datos de origen.

Secundaria: crea una base de datos como una réplica secundaria de una base de datos existente. sourceDatabaseId debe especificarse como identificador de recurso de la base de datos principal existente.

PointInTimeRestore: crea una base de datos restaurando una copia de seguridad a un momento dado de una base de datos existente. sourceDatabaseId debe especificarse como identificador de recurso de la base de datos existente y se debe especificar restorePointInTime.

Recuperación: crea una base de datos restaurando una copia de seguridad con replicación geográfica. sourceDatabaseId debe especificarse como el identificador de recurso de base de datos recuperable que se va a restaurar.

Restaurar: crea una base de datos restaurando una copia de seguridad de una base de datos eliminada. se debe especificar sourceDatabaseId. Si sourceDatabaseId es el identificador de recurso original de la base de datos, se debe especificar sourceDatabaseDeletionDate. De lo contrario, sourceDatabaseId debe ser el identificador de recurso de base de datos descartable y sourceDatabaseDeletionDate se omite. también se puede especificar restorePointInTime para restaurar desde un momento dado anterior.

RestoreLongTermRetentionBackup: crea una base de datos mediante la restauración desde un almacén de retención a largo plazo. recoveryServicesRecoveryPointResourceId debe especificarse como identificador de recurso de punto de recuperación.

Copy, Secondary y RestoreLongTermRetentionBackup no se admiten para la edición DataWarehouse.

properties.creationDate
  • string

Fecha de creación de la base de datos (formato ISO8601).

properties.currentBackupStorageRedundancy

Tipo de cuenta de almacenamiento que se usa para almacenar copias de seguridad de esta base de datos.

properties.currentServiceObjectiveName
  • string

Nombre del objetivo de nivel de servicio actual de la base de datos.

properties.currentSku

Nombre y nivel de la SKU.

properties.databaseId
  • string

El Id. de la base de datos.

properties.defaultSecondaryLocation
  • string

Región secundaria predeterminada para esta base de datos.

properties.earliestRestoreDate
  • string

Esto registra la fecha y hora de inicio más tempranas que la restauración está disponible para esta base de datos (formato ISO8601).

properties.elasticPoolId
  • string

Identificador de recursos del grupo elástico que contiene esta base de datos.

properties.failoverGroupId
  • string

Identificador de recursos del grupo de conmutación por error al que pertenece esta base de datos.

properties.highAvailabilityReplicaCount
  • integer

Número de réplicas secundarias asociadas a la base de datos que se usan para proporcionar alta disponibilidad.

properties.isInfraEncryptionEnabled
  • boolean

El cifrado de infraestructura está habilitado para esta base de datos.

properties.isLedgerOn
  • boolean

Si esta base de datos es o no una base de datos de libro de contabilidad, lo que significa que todas las tablas de la base de datos son tablas de libro de contabilidad. Nota: El valor de esta propiedad no se puede cambiar una vez creada la base de datos.

properties.licenseType

Tipo de licencia que se va a aplicar a esta base de datos. LicenseIncluded si necesita una licencia o si tiene una licencia y es apto para el BasePrice Ventaja híbrida de Azure.

properties.longTermRetentionBackupResourceId
  • string

Identificador de recursos de la copia de seguridad de retención a largo plazo asociada al funcionamiento de creación de esta base de datos.

properties.maintenanceConfigurationId
  • string

Identificador de configuración de mantenimiento asignado a la base de datos. Esta configuración define el período en el que se producirán las actualizaciones de mantenimiento.

properties.maxLogSizeBytes
  • integer

Tamaño máximo del registro de esta base de datos.

properties.maxSizeBytes
  • integer

Tamaño máximo de la base de datos expresado en bytes.

properties.minCapacity
  • number

Capacidad mínima que la base de datos siempre habrá asignado, si no está en pausa

properties.pausedDate
  • string

Fecha en la que la configuración o la acción del usuario pausaron la base de datos (formato ISO8601). Null si la base de datos está lista.

properties.readScale

Estado del enrutamiento de solo lectura. Si está habilitada, las conexiones que tienen la intención de aplicación establecida en readonly en su cadena de conexión se pueden enrutar a una réplica secundaria de solo lectura en la misma región.

properties.recoverableDatabaseId
  • string

Identificador de recurso de la base de datos recuperable asociada a la operación de creación de esta base de datos.

properties.recoveryServicesRecoveryPointId
  • string

Identificador de recurso del punto de recuperación asociado a la operación de creación de esta base de datos.

properties.requestedBackupStorageRedundancy

Tipo de cuenta de almacenamiento que se va a usar para almacenar copias de seguridad de esta base de datos.

properties.requestedServiceObjectiveName
  • string

Nombre del objetivo de nivel de servicio solicitado de la base de datos.

properties.restorableDroppedDatabaseId
  • string

Identificador de recurso de la base de datos descartada que se puede restaurar asociada a la operación de creación de esta base de datos.

properties.restorePointInTime
  • string

Especifica el momento dado (formato ISO8601) de la base de datos de origen que se restaurará para crear la nueva base de datos.

properties.resumedDate
  • string

Fecha en que la acción del usuario o el inicio de sesión de la base de datos (formato ISO8601) reanudaron la base de datos. Null si la base de datos está en pausa.

properties.sampleName

Nombre del esquema de ejemplo que se va a aplicar al crear esta base de datos.

properties.secondaryType

Tipo secundario de la base de datos si es una base de datos secundaria. Los valores válidos son Geo y Named.

properties.sourceDatabaseDeletionDate
  • string

Especifica la hora a la que se eliminó la base de datos.

properties.sourceDatabaseId
  • string

Identificador de recurso de la base de datos de origen asociada a la operación de creación de esta base de datos.

properties.status

Estado de la base de datos.

properties.zoneRedundant
  • boolean

Tanto si esta base de datos tiene redundancia de zona como si no, lo que significa que las réplicas de esta base de datos se propagarán entre varias zonas de disponibilidad.

sku

SKU de base de datos.

La lista de SKU puede variar según la región y la oferta de soporte técnico. Para determinar las SKU (incluidos el nombre de SKU, el nivel o la edición, la familia y la capacidad) que están disponibles para la suscripción en una región de Azure, use la API REST o uno de los siguientes Capabilities_ListByLocation comandos:

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

Etiquetas del recurso.

type
  • string

Tipo de recurso.

DatabaseLicenseType

Tipo de licencia que se va a aplicar a esta base de datos. LicenseIncluded si necesita una licencia o si tiene una licencia y BasePrice es apto para el Ventaja híbrida de Azure.

Name Type Description
BasePrice
  • string
LicenseIncluded
  • string

DatabaseListResult

Una lista de bases de datos.

Name Type Description
nextLink
  • string

Vínculo para recuperar la siguiente página de resultados.

value

Matriz de resultados.

DatabaseReadScale

Estado del enrutamiento de solo lectura. Si está habilitada, las conexiones que tienen la intención de aplicación establecida en readonly en su cadena de conexión se pueden enrutar a una réplica secundaria de solo lectura en la misma región.

Name Type Description
Disabled
  • string
Enabled
  • string

DatabaseStatus

Estado de la base de datos.

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
Suspect
  • string

RequestedBackupStorageRedundancy

Tipo de cuenta de almacenamiento que se va a usar para almacenar las copias de seguridad de esta base de datos.

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

SampleName

Nombre del esquema de ejemplo que se va a aplicar al crear esta base de datos.

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

SecondaryType

Tipo secundario de la base de datos si es una base de datos secundaria. Los valores válidos son Geo y Named.

Name Type Description
Geo
  • string
Named
  • string

Sku

Una SKU de recurso de ARM.

Name Type Description
capacity
  • integer

Capacidad de la SKU determinada.

family
  • string

Si el servicio tiene distintas generaciones de hardware, para la misma SKU, se puede capturar aquí.

name
  • string

El nombre de la SKU, normalmente, una letra + código de número, por ejemplo, P3.

size
  • string

Tamaño de la SKU concreta

tier
  • string

El nivel o la edición de la SKU determinada, por ejemplo, Básico, Premium.