Nota:
El acceso a esta página requiere autorización. Puede intentar iniciar sesión o cambiar directorios.
El acceso a esta página requiere autorización. Puede intentar cambiar los directorios.
- Latest
- 2024-11-01-preview
- 2024-05-01-preview
- 2023-08-01
- 2023-08-01-preview
- 2023-05-01-preview
- 2023-02-01-preview
- 2022-11-01-preview
- 2022-08-01-preview
- 2022-05-01-preview
- 2022-02-01-preview
- 2021-11-01
- 2021-11-01-preview
- 2021-08-01-preview
- 2021-05-01-preview
- 2021-02-01-preview
- 2020-11-01-preview
- 2020-08-01-preview
- 2020-02-02-preview
- 2017-10-01-preview
- 2014-04-01
Definición de recursos de Bicep
El tipo de recurso servers/elasticPools se puede implementar con operaciones destinadas a:
- grupos de recursos: consulte comandos de implementación de 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 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:
- grupos de recursos: consulte comandos de implementación de 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 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 |
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 = ["*"]
}