Microsoft. Server SQL/elasticPools

Definisi sumber daya Bicep

Jenis sumber daya server/elasticPools dapat disebarkan dengan operasi yang menargetkan:

  • Grup sumber daya - Lihat perintah penyebaran grup sumber daya

Untuk daftar properti yang diubah di setiap versi API, lihat mengubah log.

Contoh Penggunaan

Sampel Bicep

Contoh dasar penyebaran Azure SQL Elastic Pool.

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: administratorLoginPassword
    minimalTlsVersion: '1.2'
    publicNetworkAccess: 'Enabled'
    restrictOutboundNetworkAccess: 'Disabled'
    version: '12.0'
  }
}

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

Format sumber daya

Untuk membuat Microsoft. Sql/servers/elasticPools, tambahkan Bicep berikut ke templat Anda.

resource symbolicname 'Microsoft.Sql/servers/elasticPools@2026-08-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'
  }
}

Nilai Properti

Microsoft. Sql/server/elasticPools

Name Description Value
lokasi Lokasi geografis tempat sumber daya berada string (diperlukan)
name Nama sumber daya string (diperlukan)
induk Di Bicep, Anda dapat menentukan sumber daya induk untuk sumber daya turunan. Anda hanya perlu menambahkan properti ini ketika sumber daya anak dideklarasikan di luar sumber daya induk.

Untuk informasi selengkapnya, lihat sumber daya Turunan di luar sumber daya induk.
Nama simbolis untuk sumber daya jenis: server
properties Properti sumber daya. ElasticPoolProperties
sku SKU kumpulan elastis.

Daftar SKU dapat bervariasi menurut wilayah dan penawaran dukungan. Untuk menentukan SKU (termasuk nama SKU, tingkatan/edisi, keluarga, dan kapasitas) yang tersedia untuk langganan Anda di wilayah Azure, gunakan Capabilities_ListByLocation REST API atau perintah berikut:

azurecli<br />az sql elastic-pool list-editions -l &lt;location&gt; -o table<br />
Sku
tags Tag sumber daya Kamus nama dan nilai tag. Lihat Tag dalam templat

ElasticPoolPerDatabaseSettings

Name Description Value
autoPauseDelay Penundaan Jeda Otomatis untuk per database dalam kumpulan int
maxCapacity Kapasitas maksimum yang dapat digunakan oleh satu database. int
minCapacity Kapasitas minimum semua database dijamin. int

ElasticPoolProperties

Name Description Value
autoPauseDelay Waktu dalam menit setelah kumpulan elastis secara otomatis dijeda. Nilai -1 berarti jeda otomatis dinonaktifkan int
availabilityZone Menentukan zona ketersediaan tempat replika utama kumpulan disematkan. '1'
'2'
'3'
'NoPreference'
highAvailabilityReplicaCount Jumlah replika sekunder yang terkait dengan kumpulan elastis edisi Business Critical, Premium, atau Hyperscale yang digunakan untuk memberikan ketersediaan tinggi. Hanya berlaku untuk kumpulan elastis Hyperscale. int
licenseType Jenis lisensi yang akan diterapkan untuk kumpulan elastis ini. 'BasePrice'
'LicenseIncluded'
maintenanceConfigurationId Id konfigurasi pemeliharaan yang ditetapkan ke kumpulan elastis. Konfigurasi ini menentukan periode kapan pembaruan pemeliharaan akan terjadi. string
maxSizeBytes Batas penyimpanan untuk kumpulan elastis database dalam byte. int
minCapacity Kapasitas minimal yang tidak akan menyusut di bawah ini, jika tidak dijeda int
perDatabaseSettings Pengaturan per database untuk kumpulan elastis. ElasticPoolPerDatabaseSettings
preferredEnclaveType Jenis enklave yang diminta pada kumpulan elastis. 'Default'
'VBS'
zoneRedundant Apakah kumpulan elastis ini redundan zona atau tidak, yang berarti replika kumpulan elastis ini akan tersebar di beberapa zona ketersediaan. bool

Sku

Name Description Value
kapasitas Kapasitas SKU tertentu. int
family Jika layanan memiliki generasi perangkat keras yang berbeda, untuk SKU yang sama, maka itu dapat ditangkap di sini. string
name Nama SKU, biasanya, kode huruf + Angka, misalnya P3. string (diperlukan)
size Ukuran SKU tertentu string
tier Tingkat atau edisi SKU tertentu, misalnya Dasar, Premium. string

TrackedResourceTags

Name Description Value

Definisi sumber daya templat ARM

Jenis sumber daya server/elasticPools dapat disebarkan dengan operasi yang menargetkan:

Contoh Penggunaan

Templat Mulai Cepat Azure

Templat Mulai Cepat Azure berikut menyebarkan jenis sumber daya ini.

Template Description
Menyebarkan SQL Elastic Pool

Deploy ke Azure
Templat ini memungkinkan Anda untuk menyebarkan Kumpulan Elastis SQL baru dengan SQL Server terkait baru dan Database SQL baru untuk ditetapkan ke sana.

Format sumber daya

Untuk membuat Microsoft. Sql/servers/elasticPools, tambahkan JSON berikut ke templat Anda.

{
  "type": "Microsoft.Sql/servers/elasticPools",
  "apiVersion": "2026-08-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"
  }
}

Nilai Properti

Microsoft. Sql/server/elasticPools

Name Description Value
apiVersion Versi api '2026-08-01-pratinjau'
lokasi Lokasi geografis tempat sumber daya berada string (diperlukan)
name Nama sumber daya string (diperlukan)
properties Properti sumber daya. ElasticPoolProperties
sku SKU kumpulan elastis.

Daftar SKU dapat bervariasi menurut wilayah dan penawaran dukungan. Untuk menentukan SKU (termasuk nama SKU, tingkatan/edisi, keluarga, dan kapasitas) yang tersedia untuk langganan Anda di wilayah Azure, gunakan Capabilities_ListByLocation REST API atau perintah berikut:

azurecli<br />az sql elastic-pool list-editions -l &lt;location&gt; -o table<br />
Sku
tags Tag sumber daya Kamus nama dan nilai tag. Lihat Tag dalam templat
jenis Jenis sumber daya "Microsoft. Sql/server/elasticPools'

ElasticPoolPerDatabaseSettings

Name Description Value
autoPauseDelay Penundaan Jeda Otomatis untuk per database dalam kumpulan int
maxCapacity Kapasitas maksimum yang dapat digunakan oleh satu database. int
minCapacity Kapasitas minimum semua database dijamin. int

ElasticPoolProperties

Name Description Value
autoPauseDelay Waktu dalam menit setelah kumpulan elastis secara otomatis dijeda. Nilai -1 berarti jeda otomatis dinonaktifkan int
availabilityZone Menentukan zona ketersediaan tempat replika utama kumpulan disematkan. '1'
'2'
'3'
'NoPreference'
highAvailabilityReplicaCount Jumlah replika sekunder yang terkait dengan kumpulan elastis edisi Business Critical, Premium, atau Hyperscale yang digunakan untuk memberikan ketersediaan tinggi. Hanya berlaku untuk kumpulan elastis Hyperscale. int
licenseType Jenis lisensi yang akan diterapkan untuk kumpulan elastis ini. 'BasePrice'
'LicenseIncluded'
maintenanceConfigurationId Id konfigurasi pemeliharaan yang ditetapkan ke kumpulan elastis. Konfigurasi ini menentukan periode kapan pembaruan pemeliharaan akan terjadi. string
maxSizeBytes Batas penyimpanan untuk kumpulan elastis database dalam byte. int
minCapacity Kapasitas minimal yang tidak akan menyusut di bawah ini, jika tidak dijeda int
perDatabaseSettings Pengaturan per database untuk kumpulan elastis. ElasticPoolPerDatabaseSettings
preferredEnclaveType Jenis enklave yang diminta pada kumpulan elastis. 'Default'
'VBS'
zoneRedundant Apakah kumpulan elastis ini redundan zona atau tidak, yang berarti replika kumpulan elastis ini akan tersebar di beberapa zona ketersediaan. bool

Sku

Name Description Value
kapasitas Kapasitas SKU tertentu. int
family Jika layanan memiliki generasi perangkat keras yang berbeda, untuk SKU yang sama, maka itu dapat ditangkap di sini. string
name Nama SKU, biasanya, kode huruf + Angka, misalnya P3. string (diperlukan)
size Ukuran SKU tertentu string
tier Tingkat atau edisi SKU tertentu, misalnya Dasar, Premium. string

TrackedResourceTags

Name Description Value

Definisi sumber daya Terraform (penyedia AzAPI)

Jenis sumber daya server/elasticPools dapat disebarkan dengan operasi yang menargetkan:

  • Grup sumber daya Untuk daftar properti yang diubah di setiap versi API, lihat log perubahan.

Contoh Penggunaan

Sampel Terraform

Contoh dasar penyebaran Azure SQL Elastic Pool.

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

Contoh dasar penyebaran Azure SQL Elastic Pool.

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

Format sumber daya

Untuk membuat Microsoft. Sql/servers/elasticPools, tambahkan Terraform berikut ke templat Anda.

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.Sql/servers/elasticPools@2026-08-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"
    }
  }
}

Nilai Properti

Microsoft. Sql/server/elasticPools

Name Description Value
lokasi Lokasi geografis tempat sumber daya berada string (diperlukan)
name Nama sumber daya string (diperlukan)
parent_id ID sumber daya yang merupakan induk untuk sumber daya ini. ID untuk sumber daya jenis: server
properties Properti sumber daya. ElasticPoolProperties
sku SKU kumpulan elastis.

Daftar SKU dapat bervariasi menurut wilayah dan penawaran dukungan. Untuk menentukan SKU (termasuk nama SKU, tingkatan/edisi, keluarga, dan kapasitas) yang tersedia untuk langganan Anda di wilayah Azure, gunakan Capabilities_ListByLocation REST API atau perintah berikut:

azurecli<br />az sql elastic-pool list-editions -l &lt;location&gt; -o table<br />
Sku
tags Tag sumber daya Kamus nama dan nilai tag.
jenis Jenis sumber daya "Microsoft. sql/servers/elasticPools@2026-08-01-preview"

ElasticPoolPerDatabaseSettings

Name Description Value
autoPauseDelay Penundaan Jeda Otomatis untuk per database dalam kumpulan int
maxCapacity Kapasitas maksimum yang dapat digunakan oleh satu database. int
minCapacity Kapasitas minimum semua database dijamin. int

ElasticPoolProperties

Name Description Value
autoPauseDelay Waktu dalam menit setelah kumpulan elastis secara otomatis dijeda. Nilai -1 berarti jeda otomatis dinonaktifkan int
availabilityZone Menentukan zona ketersediaan tempat replika utama kumpulan disematkan. '1'
'2'
'3'
'NoPreference'
highAvailabilityReplicaCount Jumlah replika sekunder yang terkait dengan kumpulan elastis edisi Business Critical, Premium, atau Hyperscale yang digunakan untuk memberikan ketersediaan tinggi. Hanya berlaku untuk kumpulan elastis Hyperscale. int
licenseType Jenis lisensi yang akan diterapkan untuk kumpulan elastis ini. 'BasePrice'
'LicenseIncluded'
maintenanceConfigurationId Id konfigurasi pemeliharaan yang ditetapkan ke kumpulan elastis. Konfigurasi ini menentukan periode kapan pembaruan pemeliharaan akan terjadi. string
maxSizeBytes Batas penyimpanan untuk kumpulan elastis database dalam byte. int
minCapacity Kapasitas minimal yang tidak akan menyusut di bawah ini, jika tidak dijeda int
perDatabaseSettings Pengaturan per database untuk kumpulan elastis. ElasticPoolPerDatabaseSettings
preferredEnclaveType Jenis enklave yang diminta pada kumpulan elastis. 'Default'
'VBS'
zoneRedundant Apakah kumpulan elastis ini redundan zona atau tidak, yang berarti replika kumpulan elastis ini akan tersebar di beberapa zona ketersediaan. bool

Sku

Name Description Value
kapasitas Kapasitas SKU tertentu. int
family Jika layanan memiliki generasi perangkat keras yang berbeda, untuk SKU yang sama, maka itu dapat ditangkap di sini. string
name Nama SKU, biasanya, kode huruf + Angka, misalnya P3. string (diperlukan)
size Ukuran SKU tertentu string
tier Tingkat atau edisi SKU tertentu, misalnya Dasar, Premium. string

TrackedResourceTags

Name Description Value