Elastic Pools - Create Or Update

Crea o actualiza un grupo elástico.

PUT 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.

Cuerpo de la solicitud

Nombre Requerido Tipo Description
location True

string

Ubicación del recurso

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.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.

Respuestas

Nombre Tipo Description
200 OK

ElasticPool

Se ha actualizado el grupo elástico.

201 Created

ElasticPool

Creación del grupo elástico

202 Accepted

Aceptado

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).

  • 400 InvalidResourceRequestBody: las propiedades de recurso o recurso del cuerpo de la solicitud están vacías o no son válidas.

  • 400 InvalidResourceId: identificador de recurso no válido.

  • 400 InvalidSkuName: nombre de SKU no válido.

  • 400 CoincidenciatchedSkuNameAndCapacity: error de coincidencia entre el nombre y la capacidad de la SKU.

  • 400 Error de coincidenciaSkuNameAndTier: error de coincidencia entre el nombre y el nivel de SKU.

  • 400 CoincidenciatchedSkuNameAndFamily: error de coincidencia entre el nombre de la SKU y la familia.

  • 400 Error de coincidenciaSubscriptionWithUrl: la suscripción proporcionada no coincide con la suscripción en la dirección URL.

  • 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 ElasticPoolNotFound: el grupo elástico especificado no existe para el servidor especificado.

  • 405 NotSupported: esta funcionalidad no se admite.

  • 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.

  • 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.

  • 429 SubscriptionTooManyCreateUpdateRequests: solicitudes más allá de las solicitudes máximas que los recursos disponibles pueden procesar.

  • 429 SubscriptionTooManyRequests: solicitudes más allá de las solicitudes máximas que los recursos disponibles pueden procesar.

  • 429 SubscriptionTooManyCreateUpdateRequests: solicitudes más allá de las solicitudes máximas que los recursos disponibles pueden procesar.

  • 429 SubscriptionTooManyRequests: solicitudes más allá de las solicitudes máximas que los recursos disponibles pueden procesar.

  • 500 ElasticPoolFailedMoveDbToElasticPool: no se pudo mover la base de datos al grupo elástico debido a restricciones de recursos internos. Puede ser una condición transitoria, vuelva a intentarlo.

  • 500 OperationTimedOut: la operación agota el tiempo de espera y se revierte automáticamente. Vuelva a intentar la operación y,

  • 500 ElasticPoolFailedMoveDbToElasticPool: no se pudo mover la base de datos al grupo elástico debido a restricciones de recursos internos. Puede ser una condición transitoria, vuelva a intentarlo.

  • 503 ServiceTemporarilyUnavailable: característica no disponible temporalmente.

  • 503 TooManyRequests: solicitudes más allá de las solicitudes máximas que los recursos disponibles pueden procesar.

  • 503 ServiceTemporarilyUnavailable: característica no disponible temporalmente.

  • 503 TooManyRequests: solicitudes más allá de las solicitudes máximas que los recursos disponibles pueden procesar.

Ejemplos

Create or update elastic pool with all parameter
Create or update elastic pool with maintenance configuration parameter
Create or update elastic pool with minimum parameters
Create or update Hyperscale elastic pool with high availability replica count parameter

Create or update elastic pool with all parameter

Solicitud de ejemplo

PUT 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

{
  "location": "Japan East",
  "sku": {
    "name": "GP_Gen4_2",
    "tier": "GeneralPurpose",
    "capacity": 2
  },
  "properties": {
    "perDatabaseSettings": {
      "minCapacity": 0.25,
      "maxCapacity": 2
    }
  }
}

Respuesta de muestra

{
  "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_Gen4_2",
    "tier": "GeneralPurpose",
    "capacity": 2
  },
  "properties": {
    "creationDate": "2017-02-10T01:25:25.033Z",
    "state": "Ready",
    "maxSizeBytes": 5242880000,
    "perDatabaseSettings": {
      "minCapacity": 0.25,
      "maxCapacity": 2
    }
  }
}
{
  "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_Gen4_2",
    "tier": "GeneralPurpose",
    "capacity": 2
  },
  "properties": {
    "creationDate": "2017-02-10T01:25:25.033Z",
    "state": "Ready",
    "maxSizeBytes": 5242880000,
    "perDatabaseSettings": {
      "minCapacity": 0.25,
      "maxCapacity": 2
    }
  }
}

Create or update elastic pool with maintenance configuration parameter

Solicitud de ejemplo

PUT 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

{
  "location": "Japan East",
  "properties": {
    "maintenanceConfigurationId": "/subscriptions/00000000-1111-2222-3333-444444444444/providers/Microsoft.Maintenance/publicMaintenanceConfigurations/SQL_JapanEast_1"
  }
}

Respuesta de muestra

{
  "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": "StandardPool",
    "tier": "Standard",
    "capacity": 100
  },
  "properties": {
    "creationDate": "2017-02-10T01:25:25.033Z",
    "state": "Ready",
    "maxSizeBytes": 102400,
    "perDatabaseSettings": {
      "minCapacity": 0,
      "maxCapacity": 100
    },
    "maintenanceConfigurationId": "/subscriptions/00000000-1111-2222-3333-444444444444/providers/Microsoft.Maintenance/publicMaintenanceConfigurations/SQL_JapanEast_1"
  }
}
{
  "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": "StandardPool",
    "tier": "Standard",
    "capacity": 100
  },
  "properties": {
    "creationDate": "2017-02-10T01:25:25.033Z",
    "state": "Ready",
    "maxSizeBytes": 102400,
    "perDatabaseSettings": {
      "minCapacity": 0,
      "maxCapacity": 100
    },
    "maintenanceConfigurationId": "/subscriptions/00000000-1111-2222-3333-444444444444/providers/Microsoft.Maintenance/publicMaintenanceConfigurations/SQL_JapanEast_1"
  }
}

Create or update elastic pool with minimum parameters

Solicitud de ejemplo

PUT 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

{
  "location": "Japan East"
}

Respuesta de muestra

{
  "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": "StandardPool",
    "tier": "Standard",
    "capacity": 100
  },
  "properties": {
    "creationDate": "2017-02-10T01:25:25.033Z",
    "state": "Ready",
    "maxSizeBytes": 102400,
    "perDatabaseSettings": {
      "minCapacity": 0,
      "maxCapacity": 100
    }
  }
}
{
  "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": "StandardPool",
    "tier": "Standard",
    "capacity": 100
  },
  "properties": {
    "creationDate": "2017-02-10T01:25:25.033Z",
    "state": "Ready",
    "maxSizeBytes": 102400,
    "perDatabaseSettings": {
      "minCapacity": 0,
      "maxCapacity": 100
    }
  }
}

Create or update Hyperscale elastic pool with high availability replica count parameter

Solicitud de ejemplo

PUT 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

{
  "location": "Japan East",
  "sku": {
    "name": "HS_Gen5_4"
  },
  "properties": {
    "highAvailabilityReplicaCount": 2
  }
}

Respuesta de muestra

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

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.