Nota
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare ad accedere o modificare le directory.
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare a modificare le directory.
- Latest
- 2025-02-01-preview
- 2025-01-01
- 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
Definizione della risorsa Bicep
Il tipo di risorsa servers/elasticPools può essere distribuito con operazioni destinate a:
Per un elenco delle proprietà modificate in ogni versione dell'API, vedere log delle modifiche.
Esempi di utilizzo
Campioni di Bicep
Un esempio base di distribuzione di 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
}
}
Formato risorsa
Per creare un Microsoft. Risorsa SQL/servers/elasticPools, aggiungi il seguente Bicep al tuo template.
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'
}
}
Valori delle proprietà
Microsoft. Sql/server/elasticPools
| Name | Description | Value |
|---|---|---|
| location | Posizione geografica in cui risiede la risorsa | stringa (obbligatorio) |
| name | Nome della risorsa | stringa (obbligatorio) |
| parent | In Bicep, puoi specificare la risorsa genitore per una risorsa figlia. È necessario aggiungere questa proprietà solo quando la risorsa figlio viene dichiarata all'esterno della risorsa padre. Per altre informazioni, vedere risorsa figlio all'esterno della risorsa padre. |
Nome simbolico per la risorsa di tipo: server |
| properties | Proprietà delle risorse. | ElasticPoolProperties |
| sku | SKU del pool elastico. L'elenco degli SKU può variare in base all'area geografica e all'offerta di supporto. Per determinare le SKU (inclusi il nome SKU, il livello/edizione, la famiglia e la capacità) disponibili per il tuo abbonamento in una regione Azure, usa l'API REST Capabilities_ListByLocation oppure il seguente comando:azurecli<br />az sql elastic-pool list-editions -l <location> -o table<br /> |
Sku |
| tags | Tag delle risorse | Dizionario di nomi e valori di tag. Vedere tag nei modelli |
ElasticPoolPerDatabaseSettings
| Name | Description | Value |
|---|---|---|
| autoPauseDelay | Ritardo pausa automatica per ogni database all'interno del pool | int |
| maxCapacity | Capacità massima che può essere utilizzata da un database. | int |
| minCapacity | È garantita la capacità minima di tutti i database. | int |
ElasticPoolProperties
| Name | Description | Value |
|---|---|---|
| autoPauseDelay | Tempo in minuti dopo il quale il pool elastico viene sospeso automaticamente. Un valore di -1 indica che la sospensione automatica è disabilitata | int |
| availabilityZone | Specifica la zona di disponibilità a cui viene aggiunta la replica primaria del pool. | '1' '2' '3' 'NoPreference' |
| highAvailabilityReplicaCount | Numero di repliche secondarie associate al pool elastico business critical, Premium o Hyperscale edition usato per garantire la disponibilità elevata. Applicabile solo ai pool elastici Hyperscale. | int |
| licenseType | Tipo di licenza da applicare per questo pool elastico. | 'BasePrice' 'LicenseIncluded' |
| maintenanceConfigurationId | ID di configurazione della manutenzione assegnato al pool elastico. Questa configurazione definisce il periodo in cui verranno eseguiti gli aggiornamenti della manutenzione. | string |
| maxSizeBytes | Limite di archiviazione per il pool elastico del database in byte. | int |
| minCapacity | Capacità minima che il pool serverless non si ridurrà al di sotto, se non viene sospeso | int |
| perDatabaseSettings | Impostazioni per database per il pool elastico. | ElasticPoolPerDatabaseSettings |
| preferredEnclaveType | Tipo di enclave richiesto nel pool elastico. | 'Default' 'VBS' |
| zoneRedundant | Indipendentemente dal fatto che questo pool elastico sia ridondante della zona, ovvero le repliche di questo pool elastico verranno distribuite in più zone di disponibilità. | bool |
Sku
| Name | Description | Value |
|---|---|---|
| capacity | Capacità dello SKU specifico. | int |
| family | Se il servizio ha generazioni diverse di hardware, per lo stesso SKU, è possibile acquisire qui. | string |
| name | Il nome dello SKU, in genere, una lettera + codice numerico, ad esempio P3. | stringa (obbligatorio) |
| size | Dimensioni dello SKU specifico | string |
| tier | Il livello o l'edizione dello SKU specifico, ad esempio Basic, Premium. | string |
TrackedResourceTags
| Name | Description | Value |
|---|
Definizione di risorsa del modello di Resource Manager
Il tipo di risorsa servers/elasticPools può essere distribuito con operazioni destinate a:
- Gruppi di risorse - Vedi comandi di distribuzione dei gruppi di risorse Per un elenco delle proprietà modificate in ciascuna versione API, vedi registro delle modifiche.
Esempi di utilizzo
Modelli di Avvio Rapido Azure
I seguenti template Azure Quickstart distribuiscono questo tipo di risorsa.
| Template | Description |
|---|---|
|
Distribuisci un nuovo SQL Elastic Pool |
Questo template ti permette di distribuire un nuovo SQL Elastic Pool con il nuovo SQL Server associato e nuovi database SQL da assegnare. |
Formato risorsa
Per creare un Microsoft. Risorsa SQL/servers/elasticPools, aggiungi il seguente JSON al tuo template.
{
"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"
}
}
Valori delle proprietà
Microsoft. Sql/server/elasticPools
| Name | Description | Value |
|---|---|---|
| apiVersion | Versione dell'API | '2025-02-01-anteprima' |
| location | Posizione geografica in cui risiede la risorsa | stringa (obbligatorio) |
| name | Nome della risorsa | stringa (obbligatorio) |
| properties | Proprietà delle risorse. | ElasticPoolProperties |
| sku | SKU del pool elastico. L'elenco degli SKU può variare in base all'area geografica e all'offerta di supporto. Per determinare le SKU (inclusi il nome SKU, il livello/edizione, la famiglia e la capacità) disponibili per il tuo abbonamento in una regione Azure, usa l'API REST Capabilities_ListByLocation oppure il seguente comando:azurecli<br />az sql elastic-pool list-editions -l <location> -o table<br /> |
Sku |
| tags | Tag delle risorse | Dizionario di nomi e valori di tag. Vedere tag nei modelli |
| type | Tipo di risorsa | 'Microsoft. Sql/servers/elasticPool' |
ElasticPoolPerDatabaseSettings
| Name | Description | Value |
|---|---|---|
| autoPauseDelay | Ritardo pausa automatica per ogni database all'interno del pool | int |
| maxCapacity | Capacità massima che può essere utilizzata da un database. | int |
| minCapacity | È garantita la capacità minima di tutti i database. | int |
ElasticPoolProperties
| Name | Description | Value |
|---|---|---|
| autoPauseDelay | Tempo in minuti dopo il quale il pool elastico viene sospeso automaticamente. Un valore di -1 indica che la sospensione automatica è disabilitata | int |
| availabilityZone | Specifica la zona di disponibilità a cui viene aggiunta la replica primaria del pool. | '1' '2' '3' 'NoPreference' |
| highAvailabilityReplicaCount | Numero di repliche secondarie associate al pool elastico business critical, Premium o Hyperscale edition usato per garantire la disponibilità elevata. Applicabile solo ai pool elastici Hyperscale. | int |
| licenseType | Tipo di licenza da applicare per questo pool elastico. | 'BasePrice' 'LicenseIncluded' |
| maintenanceConfigurationId | ID di configurazione della manutenzione assegnato al pool elastico. Questa configurazione definisce il periodo in cui verranno eseguiti gli aggiornamenti della manutenzione. | string |
| maxSizeBytes | Limite di archiviazione per il pool elastico del database in byte. | int |
| minCapacity | Capacità minima che il pool serverless non si ridurrà al di sotto, se non viene sospeso | int |
| perDatabaseSettings | Impostazioni per database per il pool elastico. | ElasticPoolPerDatabaseSettings |
| preferredEnclaveType | Tipo di enclave richiesto nel pool elastico. | 'Default' 'VBS' |
| zoneRedundant | Indipendentemente dal fatto che questo pool elastico sia ridondante della zona, ovvero le repliche di questo pool elastico verranno distribuite in più zone di disponibilità. | bool |
Sku
| Name | Description | Value |
|---|---|---|
| capacity | Capacità dello SKU specifico. | int |
| family | Se il servizio ha generazioni diverse di hardware, per lo stesso SKU, è possibile acquisire qui. | string |
| name | Il nome dello SKU, in genere, una lettera + codice numerico, ad esempio P3. | stringa (obbligatorio) |
| size | Dimensioni dello SKU specifico | string |
| tier | Il livello o l'edizione dello SKU specifico, ad esempio Basic, Premium. | string |
TrackedResourceTags
| Name | Description | Value |
|---|
Definizione di risorsa Terraform (provider AzAPI)
Il tipo di risorsa servers/elasticPools può essere distribuito con operazioni destinate a:
- Gruppi di risorse Per un elenco delle proprietà modificate in ogni versione dell'API, vedi il registro modifiche.
Esempi di utilizzo
Esempi di Terraform
Un esempio base di distribuzione di 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 = ["*"]
}
Un esempio base di distribuzione di 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 = ["*"]
}
Formato risorsa
Per creare un Microsoft. Risorsa SQL/servers/elasticPools, aggiungi il seguente Terraform al tuo template.
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"
}
}
}
Valori delle proprietà
Microsoft. Sql/server/elasticPools
| Name | Description | Value |
|---|---|---|
| location | Posizione geografica in cui risiede la risorsa | stringa (obbligatorio) |
| name | Nome della risorsa | stringa (obbligatorio) |
| parent_id | ID della risorsa padre per questa risorsa. | ID per la risorsa di tipo: server |
| properties | Proprietà delle risorse. | ElasticPoolProperties |
| sku | SKU del pool elastico. L'elenco degli SKU può variare in base all'area geografica e all'offerta di supporto. Per determinare le SKU (inclusi il nome SKU, il livello/edizione, la famiglia e la capacità) disponibili per il tuo abbonamento in una regione Azure, usa l'API REST Capabilities_ListByLocation oppure il seguente comando:azurecli<br />az sql elastic-pool list-editions -l <location> -o table<br /> |
Sku |
| tags | Tag delle risorse | Dizionario di nomi e valori di tag. |
| type | Tipo di risorsa | "Microsoft. Sql/servers/elasticPools@2025-02-01-anteprima" |
ElasticPoolPerDatabaseSettings
| Name | Description | Value |
|---|---|---|
| autoPauseDelay | Ritardo pausa automatica per ogni database all'interno del pool | int |
| maxCapacity | Capacità massima che può essere utilizzata da un database. | int |
| minCapacity | È garantita la capacità minima di tutti i database. | int |
ElasticPoolProperties
| Name | Description | Value |
|---|---|---|
| autoPauseDelay | Tempo in minuti dopo il quale il pool elastico viene sospeso automaticamente. Un valore di -1 indica che la sospensione automatica è disabilitata | int |
| availabilityZone | Specifica la zona di disponibilità a cui viene aggiunta la replica primaria del pool. | '1' '2' '3' 'NoPreference' |
| highAvailabilityReplicaCount | Numero di repliche secondarie associate al pool elastico business critical, Premium o Hyperscale edition usato per garantire la disponibilità elevata. Applicabile solo ai pool elastici Hyperscale. | int |
| licenseType | Tipo di licenza da applicare per questo pool elastico. | 'BasePrice' 'LicenseIncluded' |
| maintenanceConfigurationId | ID di configurazione della manutenzione assegnato al pool elastico. Questa configurazione definisce il periodo in cui verranno eseguiti gli aggiornamenti della manutenzione. | string |
| maxSizeBytes | Limite di archiviazione per il pool elastico del database in byte. | int |
| minCapacity | Capacità minima che il pool serverless non si ridurrà al di sotto, se non viene sospeso | int |
| perDatabaseSettings | Impostazioni per database per il pool elastico. | ElasticPoolPerDatabaseSettings |
| preferredEnclaveType | Tipo di enclave richiesto nel pool elastico. | 'Default' 'VBS' |
| zoneRedundant | Indipendentemente dal fatto che questo pool elastico sia ridondante della zona, ovvero le repliche di questo pool elastico verranno distribuite in più zone di disponibilità. | bool |
Sku
| Name | Description | Value |
|---|---|---|
| capacity | Capacità dello SKU specifico. | int |
| family | Se il servizio ha generazioni diverse di hardware, per lo stesso SKU, è possibile acquisire qui. | string |
| name | Il nome dello SKU, in genere, una lettera + codice numerico, ad esempio P3. | stringa (obbligatorio) |
| size | Dimensioni dello SKU specifico | string |
| tier | Il livello o l'edizione dello SKU specifico, ad esempio Basic, Premium. | string |
TrackedResourceTags
| Name | Description | Value |
|---|