Поделиться через


Серверы Microsoft.Sql/elasticPools

Определение ресурсов Bicep

Тип ресурсов server/elasticPools можно развернуть с помощью операций, предназначенных для следующих операций:

Список измененных свойств в каждой версии API см. в журнала изменений.

Формат ресурса

Чтобы создать ресурс Microsoft.Sql/servers/elasticPools, добавьте следующий Bicep в шаблон.

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

Значения свойств

Microsoft.Sql/servers/elasticPools

Name Description Value
location Расположение ресурса. строка (обязательно)
name имя ресурса. строка (обязательно)
parent В Bicep можно указать родительский ресурс для дочернего ресурса. Это свойство необходимо добавить, только если дочерний ресурс объявлен за пределами родительского ресурса.

Дополнительные сведения см. в разделе Дочерний ресурс за пределами родительского ресурса.
Символьное имя ресурса типа: серверы
properties Свойства ресурса. ElasticPoolProperties
sku Номер SKU эластичного пула.

Список номеров SKU может отличаться по регионам и предложению поддержки. Чтобы определить номера SKU (включая имя SKU, уровень или выпуск, семейство и емкость), доступные для вашей подписки в регионе Azure, используйте Capabilities_ListByLocation REST API или следующую команду:

```azurecli
az sql elastic-pool list-editions -l location< -o >table
````
Sku
tags Теги ресурсов Словарь имен и значений тегов. См. теги в шаблонах

ElasticPoolPerDatabaseSettings

Name Description Value
autoPauseDelay Автоматическая приостановка задержки для каждой базы данных в пуле int
maxCapacity Максимальная емкость любой базы данных может использовать. int
minCapacity Минимальная емкость всех баз данных гарантируется. int

ElasticPoolProperties

Name Description Value
autoPauseDelay Время в минутах после автоматической приостановки эластичного пула. Значение -1 означает, что автоматическая приостановка отключена int
availabilityZone Указывает зону доступности, на которую закреплена первичная реплика пула. '1'
'2'
'3'
'NoPreference'
highAvailabilityReplicaCount Количество вторичных реплик, связанных с эластичным пулом эластичного пула выпуска "Критически важный для бизнеса", "Премиум" или "Гипермасштабирование", используемых для обеспечения высокой доступности. Применимо только к эластичным пулам гипермасштабирования. int
licenseType Тип лицензии, применяемый для этого эластичного пула. 'BasePrice'
'LicenseIncluded'
maintenanceConfigurationId Идентификатор конфигурации обслуживания, назначенный эластичному пулу. Эта конфигурация определяет период, когда будут выполняться обновления обслуживания. string
maxSizeBytes Ограничение хранилища для эластичного пула базы данных в байтах. int
minCapacity Минимальная емкость бессерверного пула не будет уменьшаться ниже, если не приостановлено int
perDatabaseSettings Параметры каждой базы данных для эластичного пула. ElasticPoolPerDatabaseSettings
preferredEnclaveType Тип анклава, запрошенного в эластичном пуле. 'Default'
'VBS'
zoneRedundant Независимо от того, является ли этот эластичным пулом избыточным по зонам, то есть реплики этого эластичного пула будут распространяться по нескольким зонам доступности. bool

Sku

Name Description Value
capacity Емкость конкретного номера SKU. int
family Если служба имеет разные поколения оборудования для одного номера SKU, это можно записать здесь. string
name Имя номера SKU, как правило, буква + код номера, например P3. строка (обязательно)
size Размер конкретного номера SKU string
tier Уровень или выпуск конкретного номера SKU, например "Базовый", "Премиум". string

TrackedResourceTags

Name Description Value

Примеры использования

Примеры Bicep

Простой пример развертывания эластичного пула SQL Azure.

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'
  }
}

Определение ресурса шаблона ARM

Тип ресурсов server/elasticPools можно развернуть с помощью операций, предназначенных для следующих операций:

Список измененных свойств в каждой версии API см. в журнала изменений.

Формат ресурса

Чтобы создать ресурс Microsoft.Sql/servers/elasticPools, добавьте следующий код JSON в шаблон.

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

Значения свойств

Microsoft.Sql/servers/elasticPools

Name Description Value
apiVersion Версия API «2025-02-01-превью»
location Расположение ресурса. строка (обязательно)
name имя ресурса. строка (обязательно)
properties Свойства ресурса. ElasticPoolProperties
sku Номер SKU эластичного пула.

Список номеров SKU может отличаться по регионам и предложению поддержки. Чтобы определить номера SKU (включая имя SKU, уровень или выпуск, семейство и емкость), доступные для вашей подписки в регионе Azure, используйте Capabilities_ListByLocation REST API или следующую команду:

```azurecli
az sql elastic-pool list-editions -l location< -o >table
````
Sku
tags Теги ресурсов Словарь имен и значений тегов. См. теги в шаблонах
type Тип ресурса 'Microsoft.Sql/servers/elasticPools'

ElasticPoolPerDatabaseSettings

Name Description Value
autoPauseDelay Автоматическая приостановка задержки для каждой базы данных в пуле int
maxCapacity Максимальная емкость любой базы данных может использовать. int
minCapacity Минимальная емкость всех баз данных гарантируется. int

ElasticPoolProperties

Name Description Value
autoPauseDelay Время в минутах после автоматической приостановки эластичного пула. Значение -1 означает, что автоматическая приостановка отключена int
availabilityZone Указывает зону доступности, на которую закреплена первичная реплика пула. '1'
'2'
'3'
'NoPreference'
highAvailabilityReplicaCount Количество вторичных реплик, связанных с эластичным пулом эластичного пула выпуска "Критически важный для бизнеса", "Премиум" или "Гипермасштабирование", используемых для обеспечения высокой доступности. Применимо только к эластичным пулам гипермасштабирования. int
licenseType Тип лицензии, применяемый для этого эластичного пула. 'BasePrice'
'LicenseIncluded'
maintenanceConfigurationId Идентификатор конфигурации обслуживания, назначенный эластичному пулу. Эта конфигурация определяет период, когда будут выполняться обновления обслуживания. string
maxSizeBytes Ограничение хранилища для эластичного пула базы данных в байтах. int
minCapacity Минимальная емкость бессерверного пула не будет уменьшаться ниже, если не приостановлено int
perDatabaseSettings Параметры каждой базы данных для эластичного пула. ElasticPoolPerDatabaseSettings
preferredEnclaveType Тип анклава, запрошенного в эластичном пуле. 'Default'
'VBS'
zoneRedundant Независимо от того, является ли этот эластичным пулом избыточным по зонам, то есть реплики этого эластичного пула будут распространяться по нескольким зонам доступности. bool

Sku

Name Description Value
capacity Емкость конкретного номера SKU. int
family Если служба имеет разные поколения оборудования для одного номера SKU, это можно записать здесь. string
name Имя номера SKU, как правило, буква + код номера, например P3. строка (обязательно)
size Размер конкретного номера SKU string
tier Уровень или выпуск конкретного номера SKU, например "Базовый", "Премиум". string

TrackedResourceTags

Name Description Value

Примеры использования

Шаблоны быстрого запуска Azure

Следующие шаблоны быстрого запуска Azure развернуть этот тип ресурса.

Template Description
Развертывание нового эластичного пула SQL

Развертывание в Azure
Этот шаблон позволяет развернуть новый пул эластичных баз данных SQL с новым связанным SQL Server и новыми базами данных SQL для назначения ему.

Определение ресурса Terraform (поставщик AzAPI)

Тип ресурсов server/elasticPools можно развернуть с помощью операций, предназначенных для следующих операций:

  • Группы ресурсов

Список измененных свойств в каждой версии API см. в журнала изменений.

Формат ресурса

Чтобы создать ресурс Microsoft.Sql/servers/elasticPools, добавьте следующий объект Terraform в шаблон.

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

Значения свойств

Microsoft.Sql/servers/elasticPools

Name Description Value
location Расположение ресурса. строка (обязательно)
name имя ресурса. строка (обязательно)
parent_id Идентификатор ресурса, который является родительским для этого ресурса. Идентификатор ресурса типа: серверы
properties Свойства ресурса. ElasticPoolProperties
sku Номер SKU эластичного пула.

Список номеров SKU может отличаться по регионам и предложению поддержки. Чтобы определить номера SKU (включая имя SKU, уровень или выпуск, семейство и емкость), доступные для вашей подписки в регионе Azure, используйте Capabilities_ListByLocation REST API или следующую команду:

```azurecli
az sql elastic-pool list-editions -l location< -o >table
````
Sku
tags Теги ресурсов Словарь имен и значений тегов.
type Тип ресурса "Microsoft.Sql/servers/elasticPools@2025-02-01-preview"

ElasticPoolPerDatabaseSettings

Name Description Value
autoPauseDelay Автоматическая приостановка задержки для каждой базы данных в пуле int
maxCapacity Максимальная емкость любой базы данных может использовать. int
minCapacity Минимальная емкость всех баз данных гарантируется. int

ElasticPoolProperties

Name Description Value
autoPauseDelay Время в минутах после автоматической приостановки эластичного пула. Значение -1 означает, что автоматическая приостановка отключена int
availabilityZone Указывает зону доступности, на которую закреплена первичная реплика пула. '1'
'2'
'3'
'NoPreference'
highAvailabilityReplicaCount Количество вторичных реплик, связанных с эластичным пулом эластичного пула выпуска "Критически важный для бизнеса", "Премиум" или "Гипермасштабирование", используемых для обеспечения высокой доступности. Применимо только к эластичным пулам гипермасштабирования. int
licenseType Тип лицензии, применяемый для этого эластичного пула. 'BasePrice'
'LicenseIncluded'
maintenanceConfigurationId Идентификатор конфигурации обслуживания, назначенный эластичному пулу. Эта конфигурация определяет период, когда будут выполняться обновления обслуживания. string
maxSizeBytes Ограничение хранилища для эластичного пула базы данных в байтах. int
minCapacity Минимальная емкость бессерверного пула не будет уменьшаться ниже, если не приостановлено int
perDatabaseSettings Параметры каждой базы данных для эластичного пула. ElasticPoolPerDatabaseSettings
preferredEnclaveType Тип анклава, запрошенного в эластичном пуле. 'Default'
'VBS'
zoneRedundant Независимо от того, является ли этот эластичным пулом избыточным по зонам, то есть реплики этого эластичного пула будут распространяться по нескольким зонам доступности. bool

Sku

Name Description Value
capacity Емкость конкретного номера SKU. int
family Если служба имеет разные поколения оборудования для одного номера SKU, это можно записать здесь. string
name Имя номера SKU, как правило, буква + код номера, например P3. строка (обязательно)
size Размер конкретного номера SKU string
tier Уровень или выпуск конкретного номера SKU, например "Базовый", "Премиум". string

TrackedResourceTags

Name Description Value

Примеры использования

Примеры Terraform

Простой пример развертывания эластичного пула SQL 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    = ["*"]
}

Простой пример развертывания эластичного пула SQL 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    = ["*"]
}