Elastic Pools - Get

Servicio:

SQL Database

Versión de la API:

2021-11-01

Obtiene un grupo elástico.

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

Parámetros de identificador URI

Nombre	En	Requerido	Tipo	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	El 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

Nombre	Tipo	Description
200 OK	ElasticPool	Correcto
Other Status Codes		Respuestas de error: *** 400 ElasticPoolOverStorageUsage: se intenta escribir datos en una base de datos cuando se alcanza el límite de almacenamiento del grupo elástico. 400 InvalidSku: el usuario especificó una SKU no válida. 400 InvalidTierSkuCombination: el nivel especificado no admite la SKU especificada. 400 ServerQuotaExceeded: el servidor alcanzó su límite para la unidad de rendimiento de base de datos permitida. 400 ElasticPoolAlreadyExists: el servidor ya contiene un grupo elástico con el nombre especificado. 400 SubscriptionVcoreQuotaExceeded: no se pudo realizar la operación porque la suscripción superaría la cuota de núcleo virtual permitida. 400 InvalidInputValueForEdition: no se admite la edición especificada para el aprovisionamiento de grupos elásticos. 400 ElasticPoolDtuBelowLimit: el valor de DTU solicitado es demasiado bajo para el nivel de servicio del grupo elástico solicitado. 400 ElasticPoolDtuAboveLimit: el valor de DTU solicitado es demasiado alto para el nivel de servicio del grupo elástico solicitado. 400 InvalidMaxSize: tamaño máximo no válido. 400 ElasticPoolDbDtuMaxBelowLimit: el número máximo de DTU solicitado por base de datos es demasiado bajo para el nivel de servicio del grupo elástico solicitado. 400 ElasticPoolDbDtuMaxAboveLimit: el número máximo de DTU solicitado por base de datos es demasiado alto para el nivel de servicio del grupo elástico solicitado. 400 InvalidInputValueForDatabaseDtuMax: intenta establecer el máximo de DTU por base de datos para el grupo de recursos que no coincide con los valores permitidos. 400 ElasticPoolDbDtuMinAboveLimit: el DTU mínimo solicitado por base de datos es demasiado alto para el nivel de servicio solicitado. 400 ElasticPoolOverStorage: se intenta escribir datos en una base de datos cuando se alcanza el límite de almacenamiento del grupo elástico. 400 InvalidInputValueForDatabaseDtuMin: intenta establecer el valor mínimo de DTU por base de datos para el grupo de recursos que no coincide con los valores permitidos. 400 ElasticPoolInconsistentDtuGuaranteeSettings: intento de proporcionar DTU min para las bases de datos del grupo elástico que superen las DTU solicitadas del grupo elástico. 400 ElasticPoolDtuUnsupported: el usuario intentó crear o actualizar un grupo elástico con una capacidad de DTU que no se admite. 400 ElasticPoolStorageAboveLimitGB: intenta establecer el límite de almacenamiento del grupo elástico por debajo del límite admitido. 400 ElasticPoolsNotEnabled: los grupos elásticos no se han habilitado en esta región. 400 ElasticPoolNotEmpty: solicitud para eliminar un grupo elástico que no está vacío. 400 ElasticPoolStorageBelowLimitGB: intenta establecer el límite de almacenamiento del grupo elástico por debajo del límite admitido. 400 ElasticPoolStorageNotAllowedGB: intenta establecer el límite de almacenamiento del grupo elástico en gb que no coincide con los valores permitidos. 400 ElasticPoolDatabaseLimit: el grupo elástico ha alcanzado su límite para el número de bases de datos. 400 ElasticPoolDecreaseStorageLimitBelowUsage: intenta reducir el límite de almacenamiento del grupo elástico por debajo de su uso de almacenamiento. 400 InvalidInputValueDatabaseDtuMinLargerThanMax: intentando establecer el valor mínimo de DTU por base de datos superior al máximo de DTU por base de datos. 400 ElasticPoolInconsistentVcoreGuaranteeSettings: el número de bases de datos y núcleo virtual mínimo por base de datos no puede superar los núcleos virtuales solicitados del grupo elástico. 400 ElasticPoolStorageBelowLimitMB: intenta establecer el límite de almacenamiento del grupo elástico por debajo del límite admitido. 400 ElasticPoolStorageNotAllowedMB: intenta establecer el límite de almacenamiento del grupo elástico en mb, que no coincide con los valores permitidos. 400 ElasticPoolCapacityStorageNotAllowedMB: intenta establecer el límite de almacenamiento del grupo elástico en mb que no coincide con los valores permitidos. 400 ElasticPoolStorageAboveLimitMB: intenta establecer el límite de almacenamiento del grupo elástico por debajo del límite admitido. 400 RegionDoesNotSupportVersion: un usuario intentó crear un servidor de una versión especificada en una ubicación donde no se admite esa versión del servidor. 400 InvalidTier: el usuario especificó un nivel no válido. 400 SourceDatabaseEditionCouldNotBeUpgraded: la base de datos de origen no puede tener una edición superior a la base de datos de destino. 400 TargetDatabaseEditionCouldNotBeDowngraded: la base de datos de destino no puede tener una edición inferior a la base de datos de origen. 400 ElasticPoolUpdateHkNotAllowed: el grupo elástico no puede reducir su nivel de servicio de Premium a Estándar o Básico, ya que una o varias de sus bases de datos usan objetos optimizados para memoria. 400 UpdateNotAllowedIfGeoDrOperationInProgress: la operación no se permite porque la operación de copia o conmutación por error para la base de datos "{0}" en el servidor "{1}" está actualmente en curso. 400 RegionDoesNotAllowProvisioning: la ubicación seleccionada no acepta nuevos servidores de Windows Azure SQL Database. Esto puede cambiar más adelante. 400 ElasticPoolOverFileSpace: espacio de archivos insuficiente en el grupo elástico. 400 ElasticPoolDbDtuMinBelowLimit: el valor de DTU solicitado por base de datos mínimo es demasiado bajo para el nivel de servicio del grupo elástico solicitado. 400 ElasticPoolDbVcoreMaxBelowLimit: el número máximo de núcleos virtuales solicitado por base de datos es demasiado bajo para el nivel de servicio del grupo elástico solicitado. 400 ElasticPoolDbVcoreMaxAboveLimit: el número máximo de núcleos virtuales solicitado por base de datos es demasiado alto para el nivel de servicio del grupo elástico solicitado. 400 InvalidInputValueForDatabaseVcoreMax: intenta establecer el máximo de núcleos virtuales por base de datos para el grupo de recursos que no coincide con los valores permitidos. 400 ElasticPoolDbVcoreMinBelowLimit: el número mínimo de núcleo virtual solicitado por base de datos es demasiado bajo para el nivel de servicio del grupo elástico solicitado. 400 InvalidInputValueForDatabaseVcoreMin: intenta establecer el mínimo de núcleo virtual por base de datos para el grupo de recursos que no coincide con los valores permitidos. 400 PartnerDBNotCompatibleForSGXEnclave: solo se admite el intento de establecer el vínculo GeoDR o actualizar SLO para la base de datos habilitada para enclave cuando ambas bases de datos se ejecutan en hardware de la serie DC. 400 InvalidInputValueDatabaseVcoreMinLargerThanMax: intento de establecer el mínimo de núcleo virtual por base de datos superior al máximo de núcleo virtual por base de datos. 400 InvalidLicenseType: el usuario intentó crear o actualizar una base de datos o un grupo elástico con un tipo de licencia no admitido. 400 ProvisioningDisabled: muestra el mensaje de error del autorizador de la operación de recursos tal cual, sin cambios 400 InvalidPublicMaintenanceConfiguration: el usuario intentó especificar la configuración de mantenimiento público que no se puede convertir en identificador interno (región incorrecta o incorrecta). 404 SubscriptionDoesNotHaveServer: no se encontró el servidor solicitado 404 ServerNotInSubscriptionResourceGroup: el servidor especificado no existe en el grupo de recursos y la suscripción especificados. 404 ElasticPoolNotFound: el grupo elástico especificado no existe para el servidor especificado. 404 OperationIdNotFound: la operación con id. no existe. 404 ResourceNotFound: no se encontró el recurso solicitado. 405 NotSupported: esta funcionalidad no se admite. 409 ElasticPoolBusy: se intentó realizar una operación de administración en un grupo elástico que está ocupado. 409 ServerDisabled: el servidor está deshabilitado. 409 SimultaneousSkuChangeNotAllowed: las operaciones de cambio de objetivo de servicio no se pueden ejecutar en ambas bases de datos de una relación de replicación al mismo tiempo. 409 ElasticPoolUpdateLinksNotInCatchup: no se puede actualizar el grupo elástico mientras una de sus bases de datos realiza una operación de conmutación por error de copia o replicación geográfica. 409 OperationCancelled: el usuario ha cancelado la operación. 409 OperationInterrupted: no se pudo completar la operación en el recurso porque se interrumpió por otra operación en el mismo recurso. 429 SubscriptionTooManyCreateUpdateRequests: solicitudes más allá de las solicitudes máximas que los recursos disponibles pueden procesar. 429 SubscriptionTooManyRequests: solicitudes más allá del número máximo de solicitudes que pueden procesar los recursos disponibles. 500 ElasticPoolFailedMoveDbToElasticPool: no se pudo mover la base de datos al grupo elástico debido a restricciones de recursos internos. Esto puede ser una condición transitoria, vuelva a intentarlo. 500 OperationTimedOut: se agota el tiempo de espera de la operación y se revierte automáticamente. Vuelva a intentar la operación y, 503 ServiceTemporarilyUnavailable: característica no disponible temporalmente. 503 TooManyRequests: solicitudes más allá del número máximo de solicitudes que se pueden procesar mediante recursos disponibles.

Ejemplos

Get a Hyperscale elastic pool

Get an elastic pool

Get a Hyperscale elastic pool

Solicitud de ejemplo

HTTP

GET https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/sqlcrudtest-2369/providers/Microsoft.Sql/servers/sqlcrudtest-8069/elasticPools/sqlcrudtest-8102?api-version=2021-11-01

Java

/**
 * Samples for ElasticPools Get.
 */
public final class Main {
    /*
     * x-ms-original-file:
     * specification/sql/resource-manager/Microsoft.Sql/stable/2021-11-01/examples/HyperscaleElasticPoolGet.json
     */
    /**
     * Sample code: Get a Hyperscale elastic pool.
     * 
     * @param azure The entry point for accessing resource management APIs in Azure.
     */
    public static void getAHyperscaleElasticPool(com.azure.resourcemanager.AzureResourceManager azure) {
        azure.sqlServers().manager().serviceClient().getElasticPools().getWithResponse("sqlcrudtest-2369",
            "sqlcrudtest-8069", "sqlcrudtest-8102", com.azure.core.util.Context.NONE);
    }
}

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

Respuesta de muestra

status code:

200

{
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/sqlcrudtest-2369/providers/Microsoft.Sql/servers/sqlcrudtest-8069/elasticPools/sqlcrudtest-8102",
  "name": "sqlcrudtest-8102",
  "type": "Microsoft.Sql/servers/elasticPools",
  "location": "Japan East",
  "kind": "vcore,pool",
  "sku": {
    "name": "HS_Gen5",
    "tier": "Hyperscale",
    "family": "Gen5",
    "capacity": 4
  },
  "properties": {
    "state": "Ready",
    "creationDate": "2021-08-26T03:46:20.57Z",
    "maxSizeBytes": 0,
    "perDatabaseSettings": {
      "minCapacity": 0,
      "maxCapacity": 4
    },
    "zoneRedundant": false,
    "licenseType": "LicenseIncluded",
    "maintenanceConfigurationId": "/subscriptions/00000000-1111-2222-3333-444444444444/providers/Microsoft.Maintenance/publicMaintenanceConfigurations/SQL_Default",
    "highAvailabilityReplicaCount": 2
  }
}

Get an elastic pool

Solicitud de ejemplo

HTTP

GET https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/sqlcrudtest-2369/providers/Microsoft.Sql/servers/sqlcrudtest-8069/elasticPools/sqlcrudtest-8102?api-version=2021-11-01

Java

/**
 * Samples for ElasticPools Get.
 */
public final class Main {
    /*
     * x-ms-original-file:
     * specification/sql/resource-manager/Microsoft.Sql/stable/2021-11-01/examples/ElasticPoolGet.json
     */
    /**
     * Sample code: Get an elastic pool.
     * 
     * @param azure The entry point for accessing resource management APIs in Azure.
     */
    public static void getAnElasticPool(com.azure.resourcemanager.AzureResourceManager azure) {
        azure.sqlServers().manager().serviceClient().getElasticPools().getWithResponse("sqlcrudtest-2369",
            "sqlcrudtest-8069", "sqlcrudtest-8102", com.azure.core.util.Context.NONE);
    }
}

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

Respuesta de muestra

status code:

200

{
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/sqlcrudtest-2369/providers/Microsoft.Sql/servers/sqlcrudtest-8069/elasticPools/sqlcrudtest-8102",
  "name": "sqlcrudtest-8102",
  "type": "Microsoft.Sql/servers/elasticPools",
  "location": "Japan East",
  "kind": null,
  "sku": {
    "name": "GP_Gen5_2",
    "tier": "GeneralPurpose",
    "capacity": 2
  },
  "properties": {
    "creationDate": "2017-10-10T01:25:25.033Z",
    "state": "Ready",
    "maxSizeBytes": 5242880000,
    "perDatabaseSettings": {
      "minCapacity": 0.25,
      "maxCapacity": 1
    },
    "zoneRedundant": true,
    "licenseType": "LicenseIncluded",
    "maintenanceConfigurationId": "/subscriptions/00000000-1111-2222-3333-444444444444/providers/Microsoft.Maintenance/publicMaintenanceConfigurations/SQL_JapanEast_1"
  }
}

Definiciones

Nombre	Description
ElasticPool	Un grupo elástico.
ElasticPoolLicenseType	Tipo de licencia que se va a aplicar a este grupo elástico.
ElasticPoolPerDatabaseSettings	Por configuración de base de datos de un grupo elástico.
ElasticPoolState	Estado del grupo elástico.
Sku	Una SKU de recursos de ARM.

ElasticPool

Un grupo elástico.

Nombre	Tipo	Description
id	string	Identificador del recurso.
kind	string	Tipo de grupo elástico. Estos son los metadatos que se usan para la experiencia de Azure Portal.
location	string	Ubicación del recurso
name	string	Nombre del recurso.
properties.creationDate	string	Fecha de creación del grupo elástico (ISO8601 formato).
properties.highAvailabilityReplicaCount	integer	Número de réplicas secundarias asociadas al grupo elástico que se usan para proporcionar alta disponibilidad. Solo se aplica a grupos elásticos de Hiperescala.
properties.licenseType	ElasticPoolLicenseType	Tipo de licencia que se va a aplicar a este grupo elástico.
properties.maintenanceConfigurationId	string	Identificador de configuración de mantenimiento asignado al grupo elástico. Esta configuración define el período en el que se producirán las actualizaciones de mantenimiento.
properties.maxSizeBytes	integer	Límite de almacenamiento para el grupo elástico de base de datos en bytes.
properties.minCapacity	number	La capacidad mínima que el grupo sin servidor no se reducirá por debajo, si no está en pausa
properties.perDatabaseSettings	ElasticPoolPerDatabaseSettings	La configuración por base de datos del grupo elástico.
properties.state	ElasticPoolState	Estado del grupo elástico.
properties.zoneRedundant	boolean	Si este grupo elástico es con redundancia de zona, lo que significa que las réplicas de este grupo elástico se distribuirán entre varias zonas de disponibilidad.
sku	Sku	SKU del grupo elástico. La lista de SKU puede variar según la región y la oferta de soporte técnico. Para determinar las SKU (incluido el nombre de la SKU, la edición, la familia y la capacidad) que están disponibles para la suscripción en una región de Azure, use la Capabilities_ListByLocation API REST o el siguiente comando: az sql elastic-pool list-editions -l <location> -o table
tags	object	Etiquetas del recurso.
type	string	Tipo de recurso.

ElasticPoolLicenseType

Tipo de licencia que se va a aplicar a este grupo elástico.

Nombre	Tipo	Description
BasePrice	string
LicenseIncluded	string

ElasticPoolPerDatabaseSettings

Por configuración de base de datos de un grupo elástico.

Nombre	Tipo	Description
maxCapacity	number	La capacidad máxima que pueda consumir cualquier base de datos.
minCapacity	number	Se garantiza la capacidad mínima de todas las bases de datos.

ElasticPoolState

Estado del grupo elástico.

Nombre	Tipo	Description
Creating	string
Disabled	string
Ready	string

Sku

Una SKU de recursos de ARM.

Nombre	Tipo	Description
capacity	integer	Capacidad de la SKU determinada.
family	string	Si el servicio tiene diferentes generaciones de hardware, para la misma SKU, se puede capturar aquí.
name	string	El nombre de la SKU, normalmente, una letra + código numérico, por ejemplo, P3.
size	string	Tamaño de la SKU determinada
tier	string	Nivel o edición de la SKU concreta, por ejemplo, Básico, Premium.