Partilhar via


Servidores Microsoft.Sql/elasticPools

Definição de recursos do bíceps

O tipo de recurso servers/elasticPools pode ser implantado com operações direcionadas:

Para obter uma lista de propriedades alteradas em cada versão da API, consulte log de alterações.

Formato do recurso

Para criar um recurso Microsoft.Sql/servers/elasticPools, adicione o seguinte Bicep ao seu modelo.

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 propriedade

Microsoft.Sql/servers/elasticPools

Name Description Value
localização Localização do recurso. string (obrigatório)
name O nome do recurso string (obrigatório)
elemento principal No Bicep, você pode especificar o recurso pai para um recurso filho. Você só precisa adicionar essa propriedade quando o recurso filho é declarado fora do recurso pai.

Para obter mais informações, consulte recurso filho fora do recurso pai.
Nome simbólico para recurso do tipo: servidores
properties Propriedades do recurso. ElasticPoolProperties
sku A piscina elástica SKU.

A lista de SKUs pode variar de acordo com a região e a oferta de suporte. Para determinar as SKUs (incluindo o nome, a camada/edição, a família e a capacidade da SKU) que estão disponíveis para sua assinatura em uma região do Azure, use a API REST Capabilities_ListByLocation ou o seguinte comando:

```azurecli
az sql elastic-pool list-editions -l <local> -o tabela
````
Sku
tags Etiquetas de recursos Dicionário de nomes e valores de tags. Consulte Tags em modelos

ElasticPoolPerDatabaseSettings

Name Description Value
autoPauseDelay Atraso de pausa automática por banco de dados dentro do pool int
maxCapacity A capacidade máxima que qualquer banco de dados pode consumir. int
minCapacity A capacidade mínima de todas as bases de dados são garantidas. int

ElasticPoolProperties

Name Description Value
autoPauseDelay Tempo em minutos após o qual o pool elástico é pausado automaticamente. Um valor de -1 significa que a pausa automática está desativada int
availabilityZone Especifica a zona de disponibilidade na qual a réplica primária do pool está fixada. '1'
'2'
'3'
'NoPreference'
highAvailabilityReplicaCount O número de réplicas secundárias associadas ao pool elástico Business Critical, Premium ou Hyperscale edition que são usadas para fornecer alta disponibilidade. Aplicável apenas a pools elásticos Hyperscale. int
licenseType O tipo de licença a ser aplicado para esse pool elástico. 'BasePrice'
'LicenseIncluded'
maintenanceConfigurationId ID de configuração de manutenção atribuído ao pool elástico. Essa configuração define o período em que as atualizações de manutenção ocorrerão. cadeia (de caracteres)
maxSizeBytes O limite de armazenamento para o pool elástico de banco de dados em bytes. int
minCapacity Capacidade mínima que o pool sem servidor não diminuirá abaixo, se não for pausado int
perDatabaseSettings As configurações por banco de dados para o pool elástico. ElasticPoolPerDatabaseSettings
preferredEnclaveType Tipo de enclave solicitado na piscina elástica. 'Default'
'VBS'
zoneRedundant Se esse pool elástico é ou não redundante de zona, o que significa que as réplicas desse pool elástico serão espalhadas por várias zonas de disponibilidade. bool

Sku

Name Description Value
capacidade Capacidade do SKU específico. int
family Se o serviço tiver diferentes gerações de hardware, para o mesmo SKU, isso pode ser capturado aqui. cadeia (de caracteres)
name O nome do SKU, normalmente, uma letra + código numérico, por exemplo, P3. string (obrigatório)
size Tamanho do SKU específico cadeia (de caracteres)
escalão O nível ou edição do SKU específico, por exemplo, Basic, Premium. cadeia (de caracteres)

TrackedResourceTags

Name Description Value

Definição de recurso de modelo ARM

O tipo de recurso servers/elasticPools pode ser implantado com operações direcionadas:

Para obter uma lista de propriedades alteradas em cada versão da API, consulte log de alterações.

Formato do recurso

Para criar um recurso Microsoft.Sql/servers/elasticPools, adicione o seguinte JSON ao seu modelo.

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

Microsoft.Sql/servers/elasticPools

Name Description Value
apiVersion A versão api '2024-11-01-preview'
localização Localização do recurso. string (obrigatório)
name O nome do recurso string (obrigatório)
properties Propriedades do recurso. ElasticPoolProperties
sku A piscina elástica SKU.

A lista de SKUs pode variar de acordo com a região e a oferta de suporte. Para determinar as SKUs (incluindo o nome, a camada/edição, a família e a capacidade da SKU) que estão disponíveis para sua assinatura em uma região do Azure, use a API REST Capabilities_ListByLocation ou o seguinte comando:

```azurecli
az sql elastic-pool list-editions -l <local> -o tabela
````
Sku
tags Etiquetas de recursos Dicionário de nomes e valores de tags. Consulte Tags em modelos
tipo O tipo de recurso 'Microsoft.Sql/servers/elasticPools'

ElasticPoolPerDatabaseSettings

Name Description Value
autoPauseDelay Atraso de pausa automática por banco de dados dentro do pool int
maxCapacity A capacidade máxima que qualquer banco de dados pode consumir. int
minCapacity A capacidade mínima de todas as bases de dados são garantidas. int

ElasticPoolProperties

Name Description Value
autoPauseDelay Tempo em minutos após o qual o pool elástico é pausado automaticamente. Um valor de -1 significa que a pausa automática está desativada int
availabilityZone Especifica a zona de disponibilidade na qual a réplica primária do pool está fixada. '1'
'2'
'3'
'NoPreference'
highAvailabilityReplicaCount O número de réplicas secundárias associadas ao pool elástico Business Critical, Premium ou Hyperscale edition que são usadas para fornecer alta disponibilidade. Aplicável apenas a pools elásticos Hyperscale. int
licenseType O tipo de licença a ser aplicado para esse pool elástico. 'BasePrice'
'LicenseIncluded'
maintenanceConfigurationId ID de configuração de manutenção atribuído ao pool elástico. Essa configuração define o período em que as atualizações de manutenção ocorrerão. cadeia (de caracteres)
maxSizeBytes O limite de armazenamento para o pool elástico de banco de dados em bytes. int
minCapacity Capacidade mínima que o pool sem servidor não diminuirá abaixo, se não for pausado int
perDatabaseSettings As configurações por banco de dados para o pool elástico. ElasticPoolPerDatabaseSettings
preferredEnclaveType Tipo de enclave solicitado na piscina elástica. 'Default'
'VBS'
zoneRedundant Se esse pool elástico é ou não redundante de zona, o que significa que as réplicas desse pool elástico serão espalhadas por várias zonas de disponibilidade. bool

Sku

Name Description Value
capacidade Capacidade do SKU específico. int
family Se o serviço tiver diferentes gerações de hardware, para o mesmo SKU, isso pode ser capturado aqui. cadeia (de caracteres)
name O nome do SKU, normalmente, uma letra + código numérico, por exemplo, P3. string (obrigatório)
size Tamanho do SKU específico cadeia (de caracteres)
escalão O nível ou edição do SKU específico, por exemplo, Basic, Premium. cadeia (de caracteres)

TrackedResourceTags

Name Description Value

Exemplos de uso

Modelos de início rápido do Azure

Os seguintes modelos de início rápido do Azure implantar esse tipo de recurso.

Template Description
implantar um novo do SQL Elastic Pool

Implantar no Azure
Este modelo permite implantar um novo SQL Elastic Pool com seu novo SQL Server associado e novos bancos de dados SQL para atribuir a ele.

Definição de recursos Terraform (provedor AzAPI)

O tipo de recurso servers/elasticPools pode ser implantado com operações direcionadas:

Para obter uma lista de propriedades alteradas em cada versão da API, consulte log de alterações.

Formato do recurso

Para criar um recurso Microsoft.Sql/servers/elasticPools, adicione o seguinte Terraform ao seu modelo.

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 propriedade

Microsoft.Sql/servers/elasticPools

Name Description Value
localização Localização do recurso. string (obrigatório)
name O nome do recurso string (obrigatório)
parent_id A ID do recurso que é o pai para este recurso. ID para recurso do tipo: servidores
properties Propriedades do recurso. ElasticPoolProperties
sku A piscina elástica SKU.

A lista de SKUs pode variar de acordo com a região e a oferta de suporte. Para determinar as SKUs (incluindo o nome, a camada/edição, a família e a capacidade da SKU) que estão disponíveis para sua assinatura em uma região do Azure, use a API REST Capabilities_ListByLocation ou o seguinte comando:

```azurecli
az sql elastic-pool list-editions -l <local> -o tabela
````
Sku
tags Etiquetas de recursos Dicionário de nomes e valores de tags.
tipo O tipo de recurso "Microsoft.Sql/servers/elasticPools@2024-11-01-preview"

ElasticPoolPerDatabaseSettings

Name Description Value
autoPauseDelay Atraso de pausa automática por banco de dados dentro do pool int
maxCapacity A capacidade máxima que qualquer banco de dados pode consumir. int
minCapacity A capacidade mínima de todas as bases de dados são garantidas. int

ElasticPoolProperties

Name Description Value
autoPauseDelay Tempo em minutos após o qual o pool elástico é pausado automaticamente. Um valor de -1 significa que a pausa automática está desativada int
availabilityZone Especifica a zona de disponibilidade na qual a réplica primária do pool está fixada. '1'
'2'
'3'
'NoPreference'
highAvailabilityReplicaCount O número de réplicas secundárias associadas ao pool elástico Business Critical, Premium ou Hyperscale edition que são usadas para fornecer alta disponibilidade. Aplicável apenas a pools elásticos Hyperscale. int
licenseType O tipo de licença a ser aplicado para esse pool elástico. 'BasePrice'
'LicenseIncluded'
maintenanceConfigurationId ID de configuração de manutenção atribuído ao pool elástico. Essa configuração define o período em que as atualizações de manutenção ocorrerão. cadeia (de caracteres)
maxSizeBytes O limite de armazenamento para o pool elástico de banco de dados em bytes. int
minCapacity Capacidade mínima que o pool sem servidor não diminuirá abaixo, se não for pausado int
perDatabaseSettings As configurações por banco de dados para o pool elástico. ElasticPoolPerDatabaseSettings
preferredEnclaveType Tipo de enclave solicitado na piscina elástica. 'Default'
'VBS'
zoneRedundant Se esse pool elástico é ou não redundante de zona, o que significa que as réplicas desse pool elástico serão espalhadas por várias zonas de disponibilidade. bool

Sku

Name Description Value
capacidade Capacidade do SKU específico. int
family Se o serviço tiver diferentes gerações de hardware, para o mesmo SKU, isso pode ser capturado aqui. cadeia (de caracteres)
name O nome do SKU, normalmente, uma letra + código numérico, por exemplo, P3. string (obrigatório)
size Tamanho do SKU específico cadeia (de caracteres)
escalão O nível ou edição do SKU específico, por exemplo, Basic, Premium. cadeia (de caracteres)

TrackedResourceTags

Name Description Value

Exemplos de uso

Amostras Terraform

Um exemplo básico de implantação do SQL Elastic Pool do Azure.

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    = ["*"]
}

Um exemplo básico de implantação do SQL Elastic Pool do Azure.

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    = ["*"]
}