Nota
O acesso a esta página requer autorização. Podes tentar iniciar sessão ou mudar de diretório.
O acesso a esta página requer autorização. Podes tentar mudar de diretório.
- 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
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 |
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 = ["*"]
}