Delen via


Microsoft.Sql-servers/elasticPools

Bicep-resourcedefinitie

Het resourcetype servers/elasticPools kan worden geïmplementeerd met bewerkingen die zijn gericht op:

Zie logboek wijzigenvoor een lijst met gewijzigde eigenschappen in elke API-versie.

Resource-indeling

Als u een Microsoft.Sql/servers/elasticPools-resource wilt maken, voegt u de volgende Bicep toe aan uw sjabloon.

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

Eigenschapswaarden

Microsoft.Sql/servers/elasticPools

Name Description Value
location Resourcelocatie. tekenreeks (vereist)
name De resourcenaam tekenreeks (vereist)
parent In Bicep kunt u de bovenliggende resource voor een onderliggende resource opgeven. U hoeft deze eigenschap alleen toe te voegen wanneer de onderliggende resource buiten de bovenliggende resource wordt gedeclareerd.

Zie onderliggende resource buiten de bovenliggende resourcevoor meer informatie.
Symbolische naam voor resource van het type: servers
properties Resource-eigenschappen. ElasticPoolProperties
sku De SKU voor elastische pools.

De lijst met SKU's kan variëren per regio en ondersteuningsaanbieding. Gebruik de REST API of de volgende opdracht om de SKU-naam, laag/editie, familie en capaciteit te bepalen die beschikbaar zijn voor uw abonnement in een Azure-regio Capabilities_ListByLocation :

```azurecli
az sql elastic-pool list-editions -l location< -o >table
````
Sku
tags Resourcetags Woordenlijst met tagnamen en -waarden. Zie Tags in sjablonen

ElasticPoolPerDatabaseSettings

Name Description Value
autoPauseDelay Vertraging automatisch onderbreken voor per database binnen de pool int
maxCapacity De maximale capaciteit die elke database kan verbruiken. int
minCapacity De minimale capaciteit voor alle databases is gegarandeerd. int

ElasticPoolProperties

Name Description Value
autoPauseDelay Tijd in minuten waarna elastische pool automatisch wordt onderbroken. Een waarde van -1 betekent dat automatische pauze is uitgeschakeld int
availabilityZone Hiermee geeft u de beschikbaarheidszone op waaraan de primaire replica van de pool is vastgemaakt. '1'
'2'
'3'
'NoPreference'
highAvailabilityReplicaCount Het aantal secundaire replica's dat is gekoppeld aan de elastische pool Bedrijfskritiek, Premium of Hyperscale-editie die wordt gebruikt om hoge beschikbaarheid te bieden. Alleen van toepassing op elastische Hyperscale-pools. int
licenseType Het licentietype dat moet worden toegepast op deze elastische pool. 'BasePrice'
'LicenseIncluded'
maintenanceConfigurationId Onderhoudsconfiguratie-id die is toegewezen aan de elastische pool. Met deze configuratie wordt de periode gedefinieerd waarop de onderhoudsupdates plaatsvinden. string
maxSizeBytes De opslaglimiet voor de elastische pool van de database in bytes. int
minCapacity Minimale capaciteit die de serverloze pool hieronder niet verkleint, indien niet onderbroken int
perDatabaseSettings De instellingen per database voor de elastische pool. ElasticPoolPerDatabaseSettings
preferredEnclaveType Het type enclave dat is aangevraagd voor de elastische pool. 'Default'
'VBS'
zoneRedundant Of deze elastische pool zone-redundant is, wat betekent dat de replica's van deze elastische pool worden verdeeld over meerdere beschikbaarheidszones. bool

Sku

Name Description Value
capacity Capaciteit van de specifieke SKU. int
family Als de service verschillende generaties hardware heeft, voor dezelfde SKU, kan die hier worden vastgelegd. string
name De naam van de SKU, meestal een letter + cijfercode, bijvoorbeeld P3. tekenreeks (vereist)
size Grootte van de specifieke SKU string
tier De laag of editie van de specifieke SKU, bijvoorbeeld Basic, Premium. string

TrackedResourceTags

Name Description Value

Resourcedefinitie van ARM-sjabloon

Het resourcetype servers/elasticPools kan worden geïmplementeerd met bewerkingen die zijn gericht op:

Zie logboek wijzigenvoor een lijst met gewijzigde eigenschappen in elke API-versie.

Resource-indeling

Als u een Microsoft.Sql/servers/elasticPools-resource wilt maken, voegt u de volgende JSON toe aan uw sjabloon.

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

Eigenschapswaarden

Microsoft.Sql/servers/elasticPools

Name Description Value
apiVersion De API-versie '2024-11-01-preview'
location Resourcelocatie. tekenreeks (vereist)
name De resourcenaam tekenreeks (vereist)
properties Resource-eigenschappen. ElasticPoolProperties
sku De SKU voor elastische pools.

De lijst met SKU's kan variëren per regio en ondersteuningsaanbieding. Gebruik de REST API of de volgende opdracht om de SKU-naam, laag/editie, familie en capaciteit te bepalen die beschikbaar zijn voor uw abonnement in een Azure-regio Capabilities_ListByLocation :

```azurecli
az sql elastic-pool list-editions -l location< -o >table
````
Sku
tags Resourcetags Woordenlijst met tagnamen en -waarden. Zie Tags in sjablonen
type Het brontype 'Microsoft.Sql/servers/elasticPools'

ElasticPoolPerDatabaseSettings

Name Description Value
autoPauseDelay Vertraging automatisch onderbreken voor per database binnen de pool int
maxCapacity De maximale capaciteit die elke database kan verbruiken. int
minCapacity De minimale capaciteit voor alle databases is gegarandeerd. int

ElasticPoolProperties

Name Description Value
autoPauseDelay Tijd in minuten waarna elastische pool automatisch wordt onderbroken. Een waarde van -1 betekent dat automatische pauze is uitgeschakeld int
availabilityZone Hiermee geeft u de beschikbaarheidszone op waaraan de primaire replica van de pool is vastgemaakt. '1'
'2'
'3'
'NoPreference'
highAvailabilityReplicaCount Het aantal secundaire replica's dat is gekoppeld aan de elastische pool Bedrijfskritiek, Premium of Hyperscale-editie die wordt gebruikt om hoge beschikbaarheid te bieden. Alleen van toepassing op elastische Hyperscale-pools. int
licenseType Het licentietype dat moet worden toegepast op deze elastische pool. 'BasePrice'
'LicenseIncluded'
maintenanceConfigurationId Onderhoudsconfiguratie-id die is toegewezen aan de elastische pool. Met deze configuratie wordt de periode gedefinieerd waarop de onderhoudsupdates plaatsvinden. string
maxSizeBytes De opslaglimiet voor de elastische pool van de database in bytes. int
minCapacity Minimale capaciteit die de serverloze pool hieronder niet verkleint, indien niet onderbroken int
perDatabaseSettings De instellingen per database voor de elastische pool. ElasticPoolPerDatabaseSettings
preferredEnclaveType Het type enclave dat is aangevraagd voor de elastische pool. 'Default'
'VBS'
zoneRedundant Of deze elastische pool zone-redundant is, wat betekent dat de replica's van deze elastische pool worden verdeeld over meerdere beschikbaarheidszones. bool

Sku

Name Description Value
capacity Capaciteit van de specifieke SKU. int
family Als de service verschillende generaties hardware heeft, voor dezelfde SKU, kan die hier worden vastgelegd. string
name De naam van de SKU, meestal een letter + cijfercode, bijvoorbeeld P3. tekenreeks (vereist)
size Grootte van de specifieke SKU string
tier De laag of editie van de specifieke SKU, bijvoorbeeld Basic, Premium. string

TrackedResourceTags

Name Description Value

Gebruiksvoorbeelden

Azure-snelstartsjablonen

De volgende Azure-quickstartsjablonen dit resourcetype implementeren.

Template Description
Een nieuwe elastische SQL-pool implementeren

Implementeren in Azure
Met deze sjabloon kunt u een nieuwe elastische SQL-pool implementeren met de nieuwe gekoppelde SQL Server en nieuwe SQL-databases die eraan kunnen worden toegewezen.

Resourcedefinitie van Terraform (AzAPI-provider)

Het resourcetype servers/elasticPools kan worden geïmplementeerd met bewerkingen die zijn gericht op:

  • Resourcegroepen

Zie logboek wijzigenvoor een lijst met gewijzigde eigenschappen in elke API-versie.

Resource-indeling

Als u een Microsoft.Sql/servers/elasticPools-resource wilt maken, voegt u de volgende Terraform toe aan uw sjabloon.

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

Eigenschapswaarden

Microsoft.Sql/servers/elasticPools

Name Description Value
location Resourcelocatie. tekenreeks (vereist)
name De resourcenaam tekenreeks (vereist)
parent_id De id van de resource die het bovenliggende item voor deze resource is. Id voor resource van het type: servers
properties Resource-eigenschappen. ElasticPoolProperties
sku De SKU voor elastische pools.

De lijst met SKU's kan variëren per regio en ondersteuningsaanbieding. Gebruik de REST API of de volgende opdracht om de SKU-naam, laag/editie, familie en capaciteit te bepalen die beschikbaar zijn voor uw abonnement in een Azure-regio Capabilities_ListByLocation :

```azurecli
az sql elastic-pool list-editions -l location< -o >table
````
Sku
tags Resourcetags Woordenlijst met tagnamen en -waarden.
type Het brontype "Microsoft.Sql/servers/elasticPools@2024-11-01-preview"

ElasticPoolPerDatabaseSettings

Name Description Value
autoPauseDelay Vertraging automatisch onderbreken voor per database binnen de pool int
maxCapacity De maximale capaciteit die elke database kan verbruiken. int
minCapacity De minimale capaciteit voor alle databases is gegarandeerd. int

ElasticPoolProperties

Name Description Value
autoPauseDelay Tijd in minuten waarna elastische pool automatisch wordt onderbroken. Een waarde van -1 betekent dat automatische pauze is uitgeschakeld int
availabilityZone Hiermee geeft u de beschikbaarheidszone op waaraan de primaire replica van de pool is vastgemaakt. '1'
'2'
'3'
'NoPreference'
highAvailabilityReplicaCount Het aantal secundaire replica's dat is gekoppeld aan de elastische pool Bedrijfskritiek, Premium of Hyperscale-editie die wordt gebruikt om hoge beschikbaarheid te bieden. Alleen van toepassing op elastische Hyperscale-pools. int
licenseType Het licentietype dat moet worden toegepast op deze elastische pool. 'BasePrice'
'LicenseIncluded'
maintenanceConfigurationId Onderhoudsconfiguratie-id die is toegewezen aan de elastische pool. Met deze configuratie wordt de periode gedefinieerd waarop de onderhoudsupdates plaatsvinden. string
maxSizeBytes De opslaglimiet voor de elastische pool van de database in bytes. int
minCapacity Minimale capaciteit die de serverloze pool hieronder niet verkleint, indien niet onderbroken int
perDatabaseSettings De instellingen per database voor de elastische pool. ElasticPoolPerDatabaseSettings
preferredEnclaveType Het type enclave dat is aangevraagd voor de elastische pool. 'Default'
'VBS'
zoneRedundant Of deze elastische pool zone-redundant is, wat betekent dat de replica's van deze elastische pool worden verdeeld over meerdere beschikbaarheidszones. bool

Sku

Name Description Value
capacity Capaciteit van de specifieke SKU. int
family Als de service verschillende generaties hardware heeft, voor dezelfde SKU, kan die hier worden vastgelegd. string
name De naam van de SKU, meestal een letter + cijfercode, bijvoorbeeld P3. tekenreeks (vereist)
size Grootte van de specifieke SKU string
tier De laag of editie van de specifieke SKU, bijvoorbeeld Basic, Premium. string

TrackedResourceTags

Name Description Value

Gebruiksvoorbeelden

Terraform-monsters

Een eenvoudig voorbeeld van het implementeren van 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    = ["*"]
}

Een eenvoudig voorbeeld van het implementeren van 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    = ["*"]
}