Compartir a través de


Servidores Microsoft.Sql/elasticPools

Definición de recursos de Bicep

El tipo de recurso servers/elasticPools se puede implementar con operaciones destinadas a:

Para obtener una lista de las propiedades modificadas en cada versión de API, consulte registro de cambios.

Formato de recurso

Para crear un recurso Microsoft.Sql/servers/elasticPools, agregue lo siguiente a la plantilla de Bicep.

resource symbolicname 'Microsoft.Sql/servers/elasticPools@2024-11-01-preview' = {
  parent: resourceSymbolicName
  location: 'string'
  name: 'string'
  properties: {
    autoPauseDelay: int
    availabilityZone: 'string'
    highAvailabilityReplicaCount: int
    licenseType: 'string'
    maintenanceConfigurationId: 'string'
    maxSizeBytes: int
    minCapacity: int
    perDatabaseSettings: {
      autoPauseDelay: int
      maxCapacity: int
      minCapacity: int
    }
    preferredEnclaveType: 'string'
    zoneRedundant: bool
  }
  sku: {
    capacity: int
    family: 'string'
    name: 'string'
    size: 'string'
    tier: 'string'
  }
  tags: {
    {customized property}: 'string'
  }
}

Valores de propiedad

Microsoft.Sql/servers/elasticPools

Name Description Value
location Ubicación del recurso. string (obligatorio)
name El nombre del recurso string (obligatorio)
parent En Bicep, puede especificar el recurso primario para un recurso secundario. Solo tiene que agregar esta propiedad cuando el recurso secundario se declara fuera del recurso primario.

Para obtener más información, consulte recurso secundario fuera del recurso primario.
Nombre simbólico del recurso de tipo: servidores
properties Propiedades de recursos. ElasticPoolProperties
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 API rest de Capabilities_ListByLocation o el siguiente comando:

```azurecli
Lista de -l <> Ubicación -o tabla de AZ SQL Elastic-Pool
````
Sku
tags Etiquetas de recursos Diccionario de nombres y valores de etiqueta. Consulte etiquetas de en plantillas

ElasticPoolPerDatabaseSettings

Name Description Value
autoPauseDelay Retraso de pausa automática para cada base de datos dentro del grupo int
maxCapacity Capacidad máxima que puede consumir una base de datos. int
minCapacity Se garantiza la capacidad mínima de todas las bases de datos. int

ElasticPoolProperties

Name Description Value
autoPauseDelay Tiempo en minutos después del cual el grupo elástico se pausa automáticamente. Un valor de -1 significa que la pausa automática está deshabilitada int
availabilityZone Especifica la zona de disponibilidad a la que está anclada la réplica principal del grupo. '1'
'2'
'3'
'NoPreference'
highAvailabilityReplicaCount Número de réplicas secundarias asociadas al grupo elástico crítico para la empresa, Premium o Hiperescala que se usan para proporcionar alta disponibilidad. Solo se aplica a los grupos elásticos de Hiperescala. int
licenseType Tipo de licencia que se va a solicitar para este grupo elástico. 'BasePrice'
'LicenseIncluded'
maintenanceConfigurationId 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. string
maxSizeBytes Límite de almacenamiento para el grupo elástico de base de datos en bytes. int
minCapacity Capacidad mínima que el grupo sin servidor no se reducirá, si no está en pausa int
perDatabaseSettings Configuración por base de datos para el grupo elástico. ElasticPoolPerDatabaseSettings
preferredEnclaveType Tipo de enclave solicitado en el grupo elástico. 'Default'
'VBS'
zoneRedundant 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. bool

Sku

Name Description Value
capacity Capacidad de la SKU determinada. int
family Si el servicio tiene diferentes generaciones de hardware, para la misma SKU, se puede capturar aquí. string
name El nombre de la SKU, normalmente, una letra + código de número, por ejemplo, P3. string (obligatorio)
size Tamaño de la SKU determinada string
tier Nivel o edición de la SKU concreta, por ejemplo, Básico, Premium. string

TrackedResourceTags

Name Description Value

Ejemplos de uso

Ejemplos de Bicep

Ejemplo básico de implementación del grupo elástico de Azure SQL.

param resourceName string = 'acctest0001'
param location string = 'westeurope'
@secure()
@description('The administrator login password for the SQL server')
param administratorLoginPassword string

resource server 'Microsoft.Sql/servers@2021-02-01-preview' = {
  name: resourceName
  location: location
  properties: {
    administratorLogin: '4dm1n157r470r'
    administratorLoginPassword: null
    minimalTlsVersion: '1.2'
    publicNetworkAccess: 'Enabled'
    restrictOutboundNetworkAccess: 'Disabled'
    version: '12.0'
  }
}

resource elasticPool 'Microsoft.Sql/servers/elasticPools@2020-11-01-preview' = {
  parent: server
  name: resourceName
  location: location
  properties: {
    maintenanceConfigurationId: resourceId('Microsoft.Maintenance/publicMaintenanceConfigurations', 'SQL_Default')
    maxSizeBytes: 5242880000
    perDatabaseSettings: {
      maxCapacity: 5
      minCapacity: 0
    }
    zoneRedundant: false
  }
  sku: {
    capacity: 50
    family: ''
    name: 'BasicPool'
    tier: 'Basic'
  }
}

Definición de recursos de plantilla de ARM

El tipo de recurso servers/elasticPools se puede implementar con operaciones destinadas a:

Para obtener una lista de las propiedades modificadas en cada versión de API, consulte registro de cambios.

Formato de recurso

Para crear un recurso Microsoft.Sql/servers/elasticPools, agregue el siguiente JSON a la plantilla.

{
  "type": "Microsoft.Sql/servers/elasticPools",
  "apiVersion": "2024-11-01-preview",
  "name": "string",
  "location": "string",
  "properties": {
    "autoPauseDelay": "int",
    "availabilityZone": "string",
    "highAvailabilityReplicaCount": "int",
    "licenseType": "string",
    "maintenanceConfigurationId": "string",
    "maxSizeBytes": "int",
    "minCapacity": "int",
    "perDatabaseSettings": {
      "autoPauseDelay": "int",
      "maxCapacity": "int",
      "minCapacity": "int"
    },
    "preferredEnclaveType": "string",
    "zoneRedundant": "bool"
  },
  "sku": {
    "capacity": "int",
    "family": "string",
    "name": "string",
    "size": "string",
    "tier": "string"
  },
  "tags": {
    "{customized property}": "string"
  }
}

Valores de propiedad

Microsoft.Sql/servers/elasticPools

Name Description Value
apiVersion La versión de api '2024-11-01-preview'
location Ubicación del recurso. string (obligatorio)
name El nombre del recurso string (obligatorio)
properties Propiedades de recursos. ElasticPoolProperties
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 API rest de Capabilities_ListByLocation o el siguiente comando:

```azurecli
Lista de -l <> Ubicación -o tabla de AZ SQL Elastic-Pool
````
Sku
tags Etiquetas de recursos Diccionario de nombres y valores de etiqueta. Consulte etiquetas de en plantillas
type El tipo de recurso 'Microsoft.Sql/servers/elasticPools'

ElasticPoolPerDatabaseSettings

Name Description Value
autoPauseDelay Retraso de pausa automática para cada base de datos dentro del grupo int
maxCapacity Capacidad máxima que puede consumir una base de datos. int
minCapacity Se garantiza la capacidad mínima de todas las bases de datos. int

ElasticPoolProperties

Name Description Value
autoPauseDelay Tiempo en minutos después del cual el grupo elástico se pausa automáticamente. Un valor de -1 significa que la pausa automática está deshabilitada int
availabilityZone Especifica la zona de disponibilidad a la que está anclada la réplica principal del grupo. '1'
'2'
'3'
'NoPreference'
highAvailabilityReplicaCount Número de réplicas secundarias asociadas al grupo elástico crítico para la empresa, Premium o Hiperescala que se usan para proporcionar alta disponibilidad. Solo se aplica a los grupos elásticos de Hiperescala. int
licenseType Tipo de licencia que se va a solicitar para este grupo elástico. 'BasePrice'
'LicenseIncluded'
maintenanceConfigurationId 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. string
maxSizeBytes Límite de almacenamiento para el grupo elástico de base de datos en bytes. int
minCapacity Capacidad mínima que el grupo sin servidor no se reducirá, si no está en pausa int
perDatabaseSettings Configuración por base de datos para el grupo elástico. ElasticPoolPerDatabaseSettings
preferredEnclaveType Tipo de enclave solicitado en el grupo elástico. 'Default'
'VBS'
zoneRedundant 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. bool

Sku

Name Description Value
capacity Capacidad de la SKU determinada. int
family Si el servicio tiene diferentes generaciones de hardware, para la misma SKU, se puede capturar aquí. string
name El nombre de la SKU, normalmente, una letra + código de número, por ejemplo, P3. string (obligatorio)
size Tamaño de la SKU determinada string
tier Nivel o edición de la SKU concreta, por ejemplo, Básico, Premium. string

TrackedResourceTags

Name Description Value

Ejemplos de uso

Plantillas de inicio rápido de Azure

Los siguientes plantillas de inicio rápido de Azure implementar este tipo de recurso.

Template Description
Implementar un nuevo grupo elástico de SQL

Implementación en Azure
Esta plantilla le permite implementar un nuevo grupo elástico de SQL con su nuevo servidor SQL Server asociado y nuevas bases de datos SQL para asignarlo.

Definición de recursos de Terraform (proveedor AzAPI)

El tipo de recurso servers/elasticPools se puede implementar con operaciones destinadas a:

  • Grupos de recursos

Para obtener una lista de las propiedades modificadas en cada versión de API, consulte registro de cambios.

Formato de recurso

Para crear un recurso Microsoft.Sql/servers/elasticPools, agregue el siguiente terraform a la plantilla.

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.Sql/servers/elasticPools@2024-11-01-preview"
  name = "string"
  parent_id = "string"
  location = "string"
  tags = {
    {customized property} = "string"
  }
  body = {
    properties = {
      autoPauseDelay = int
      availabilityZone = "string"
      highAvailabilityReplicaCount = int
      licenseType = "string"
      maintenanceConfigurationId = "string"
      maxSizeBytes = int
      minCapacity = int
      perDatabaseSettings = {
        autoPauseDelay = int
        maxCapacity = int
        minCapacity = int
      }
      preferredEnclaveType = "string"
      zoneRedundant = bool
    }
    sku = {
      capacity = int
      family = "string"
      name = "string"
      size = "string"
      tier = "string"
    }
  }
}

Valores de propiedad

Microsoft.Sql/servers/elasticPools

Name Description Value
location Ubicación del recurso. string (obligatorio)
name El nombre del recurso string (obligatorio)
parent_id Identificador del recurso que es el elemento primario de este recurso. Identificador del recurso de tipo: servidores
properties Propiedades de recursos. ElasticPoolProperties
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 API rest de Capabilities_ListByLocation o el siguiente comando:

```azurecli
Lista de -l <> Ubicación -o tabla de AZ SQL Elastic-Pool
````
Sku
tags Etiquetas de recursos Diccionario de nombres y valores de etiqueta.
type El tipo de recurso "Microsoft.Sql/servers/elasticPools@2024-11-01-preview"

ElasticPoolPerDatabaseSettings

Name Description Value
autoPauseDelay Retraso de pausa automática para cada base de datos dentro del grupo int
maxCapacity Capacidad máxima que puede consumir una base de datos. int
minCapacity Se garantiza la capacidad mínima de todas las bases de datos. int

ElasticPoolProperties

Name Description Value
autoPauseDelay Tiempo en minutos después del cual el grupo elástico se pausa automáticamente. Un valor de -1 significa que la pausa automática está deshabilitada int
availabilityZone Especifica la zona de disponibilidad a la que está anclada la réplica principal del grupo. '1'
'2'
'3'
'NoPreference'
highAvailabilityReplicaCount Número de réplicas secundarias asociadas al grupo elástico crítico para la empresa, Premium o Hiperescala que se usan para proporcionar alta disponibilidad. Solo se aplica a los grupos elásticos de Hiperescala. int
licenseType Tipo de licencia que se va a solicitar para este grupo elástico. 'BasePrice'
'LicenseIncluded'
maintenanceConfigurationId 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. string
maxSizeBytes Límite de almacenamiento para el grupo elástico de base de datos en bytes. int
minCapacity Capacidad mínima que el grupo sin servidor no se reducirá, si no está en pausa int
perDatabaseSettings Configuración por base de datos para el grupo elástico. ElasticPoolPerDatabaseSettings
preferredEnclaveType Tipo de enclave solicitado en el grupo elástico. 'Default'
'VBS'
zoneRedundant 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. bool

Sku

Name Description Value
capacity Capacidad de la SKU determinada. int
family Si el servicio tiene diferentes generaciones de hardware, para la misma SKU, se puede capturar aquí. string
name El nombre de la SKU, normalmente, una letra + código de número, por ejemplo, P3. string (obligatorio)
size Tamaño de la SKU determinada string
tier Nivel o edición de la SKU concreta, por ejemplo, Básico, Premium. string

TrackedResourceTags

Name Description Value

Ejemplos de uso

Ejemplos de Terraform

Ejemplo básico de implementación del grupo elástico de Azure SQL.

terraform {
  required_providers {
    azapi = {
      source = "Azure/azapi"
    }
    azurerm = {
      source = "hashicorp/azurerm"
    }
  }
}

provider "azurerm" {
  features {
  }
}

provider "azapi" {
  skip_provider_registration = false
}

variable "resource_name" {
  type    = string
  default = "acctest0001"
}

variable "location" {
  type    = string
  default = "westeurope"
}

variable "administrator_login_password" {
  type        = string
  description = "The administrator login password for the SQL server"
  sensitive   = true
}

data "azurerm_client_config" "current" {
}

resource "azapi_resource" "resourceGroup" {
  type     = "Microsoft.Resources/resourceGroups@2020-06-01"
  name     = var.resource_name
  location = var.location
}

resource "azapi_resource" "server" {
  type      = "Microsoft.Sql/servers@2021-02-01-preview"
  parent_id = azapi_resource.resourceGroup.id
  name      = var.resource_name
  location  = var.location
  body = {
    properties = {
      administratorLogin            = "4dm1n157r470r"
      administratorLoginPassword    = var.administrator_login_password
      minimalTlsVersion             = "1.2"
      publicNetworkAccess           = "Enabled"
      restrictOutboundNetworkAccess = "Disabled"
      version                       = "12.0"
    }
  }
  schema_validation_enabled = false
  response_export_values    = ["*"]
}

data "azapi_resource_id" "publicMaintenanceConfiguration" {
  type      = "Microsoft.Maintenance/publicMaintenanceConfigurations@2023-04-01"
  parent_id = "/subscriptions/${data.azurerm_client_config.current.subscription_id}"
  name      = "SQL_Default"
}

resource "azapi_resource" "elasticPool" {
  type      = "Microsoft.Sql/servers/elasticPools@2020-11-01-preview"
  parent_id = azapi_resource.server.id
  name      = var.resource_name
  location  = var.location
  body = {
    properties = {
      maintenanceConfigurationId = data.azapi_resource_id.publicMaintenanceConfiguration.id
      maxSizeBytes               = 5.24288e+09
      perDatabaseSettings = {
        maxCapacity = 5
        minCapacity = 0
      }
      zoneRedundant = false
    }
    sku = {
      capacity = 50
      family   = ""
      name     = "BasicPool"
      tier     = "Basic"
    }
  }
  schema_validation_enabled = false
  response_export_values    = ["*"]
}

Ejemplo básico de implementación del grupo elástico de Azure SQL.

terraform {
  required_providers {
    azapi = {
      source = "Azure/azapi"
    }
    azurerm = {
      source = "hashicorp/azurerm"
    }
  }
}

provider "azurerm" {
  features {
  }
}

provider "azapi" {
  skip_provider_registration = false
}

variable "resource_name" {
  type    = string
  default = "acctest0001"
}

variable "location" {
  type    = string
  default = "westeurope"
}

variable "administrator_login_password" {
  type        = string
  description = "The administrator login password for the SQL server"
  sensitive   = true
}

data "azurerm_client_config" "current" {
}

resource "azapi_resource" "resourceGroup" {
  type     = "Microsoft.Resources/resourceGroups@2020-06-01"
  name     = var.resource_name
  location = var.location
}

resource "azapi_resource" "server" {
  type      = "Microsoft.Sql/servers@2021-02-01-preview"
  parent_id = azapi_resource.resourceGroup.id
  name      = var.resource_name
  location  = var.location
  body = {
    properties = {
      administratorLogin            = "4dm1n157r470r"
      administratorLoginPassword    = var.administrator_login_password
      minimalTlsVersion             = "1.2"
      publicNetworkAccess           = "Enabled"
      restrictOutboundNetworkAccess = "Disabled"
      version                       = "12.0"
    }
  }
  schema_validation_enabled = false
  response_export_values    = ["*"]
}

data "azapi_resource_id" "publicMaintenanceConfiguration" {
  type      = "Microsoft.Maintenance/publicMaintenanceConfigurations@2023-04-01"
  parent_id = "/subscriptions/${data.azurerm_client_config.current.subscription_id}"
  name      = "SQL_Default"
}

resource "azapi_resource" "elasticPool" {
  type      = "Microsoft.Sql/servers/elasticPools@2020-11-01-preview"
  parent_id = azapi_resource.server.id
  name      = var.resource_name
  location  = var.location
  body = {
    properties = {
      maintenanceConfigurationId = data.azapi_resource_id.publicMaintenanceConfiguration.id
      maxSizeBytes               = 5.24288e+09
      perDatabaseSettings = {
        maxCapacity = 5
        minCapacity = 0
      }
      zoneRedundant = false
    }
    sku = {
      capacity = 50
      family   = ""
      name     = "BasicPool"
      tier     = "Basic"
    }
  }
  schema_validation_enabled = false
  response_export_values    = ["*"]
}