Microsoft.Sql 서버/elasticPools

• 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

Bicep 리소스 정의

서버/elasticPools 리소스 종류는 다음을 대상으로 하는 작업으로 배포할 수 있습니다.

• 리소스 그룹 - 리소스 그룹 배포 명령 참조

각 API 버전에서 변경된 속성 목록은 변경 로그참조하세요.

리소스 형식

Microsoft.Sql/servers/elasticPools 리소스를 만들려면 템플릿에 다음 Bicep을 추가합니다.

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

속성 값

Microsoft.Sql/servers/elasticPools

Name	Description	Value
location	리소스 위치입니다.	string(필수)
name	리소스 이름	string(필수)
parent	Bicep에서 자식 리소스에 대한 부모 리소스를 지정할 수 있습니다. 자식 리소스가 부모 리소스 외부에서 선언된 경우에만 이 속성을 추가해야 합니다. 자세한 내용은 부모 리소스외부의 자식 리소스 참조하세요.	형식 리소스의 기호 이름: 서버
properties	리소스 속성입니다.	ElasticPoolProperties
sku	탄력적 풀 SKU입니다. SKU 목록은 지역 및 지원 제품에 따라 다를 수 있습니다. Azure 지역의 구독에 사용할 수 있는 SKU 이름, 계층/버전, 제품군 및 용량을 포함하여 SKU를 확인하려면 Capabilities_ListByLocation REST API 또는 다음 명령을 사용합니다. ```azurecli az sql elastic-pool list-editions -l <위치> -o 테이블 ````	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	탄력적 풀에 할당된 유지 관리 구성 ID입니다. 이 구성은 유지 관리 업데이트가 발생하는 기간을 정의합니다.	string
maxSizeBytes	데이터베이스 탄력적 풀에 대한 스토리지 제한(바이트)입니다.	int
minCapacity	일시 중지되지 않은 경우 서버리스 풀이 아래로 축소되지 않는 최소 용량	int
perDatabaseSettings	탄력적 풀에 대한 데이터베이스별 설정입니다.	ElasticPoolPerDatabaseSettings
preferredEnclaveType	탄력적 풀에서 요청된 enclave의 유형입니다.	'Default' 'VBS'
zoneRedundant	이 탄력적 풀이 영역 중복인지 여부입니다. 즉, 이 탄력적 풀의 복제본이 여러 가용성 영역에 분산됩니다.	bool

Sku

Name	Description	Value
capacity	특정 SKU의 용량입니다.	int
family	서비스에 여러 세대의 하드웨어가 있는 경우 동일한 SKU에 대해 여기에서 캡처할 수 있습니다.	string
name	SKU의 이름(일반적으로 문자 + 숫자 코드(예: P3)입니다.	string(필수)
size	특정 SKU의 크기	string
tier	특정 SKU의 계층 또는 버전(예: Basic, Premium)입니다.	string

TrackedResourceTags

Name	Description	Value

사용 예제

Bicep 샘플

Azure SQL 탄력적 풀 배포의 기본 예제입니다.

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 템플릿 리소스 정의

서버/elasticPools 리소스 종류는 다음을 대상으로 하는 작업으로 배포할 수 있습니다.

• 리소스 그룹 - 리소스 그룹 배포 명령 참조

각 API 버전에서 변경된 속성 목록은 변경 로그참조하세요.

리소스 형식

Microsoft.Sql/servers/elasticPools 리소스를 만들려면 템플릿에 다음 JSON을 추가합니다.

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

속성 값

Microsoft.Sql/servers/elasticPools

Name	Description	Value
apiVersion	api 버전	'2024-11-01-preview'
location	리소스 위치입니다.	string(필수)
name	리소스 이름	string(필수)
properties	리소스 속성입니다.	ElasticPoolProperties
sku	탄력적 풀 SKU입니다. SKU 목록은 지역 및 지원 제품에 따라 다를 수 있습니다. Azure 지역의 구독에 사용할 수 있는 SKU 이름, 계층/버전, 제품군 및 용량을 포함하여 SKU를 확인하려면 Capabilities_ListByLocation REST API 또는 다음 명령을 사용합니다. ```azurecli az sql elastic-pool list-editions -l <위치> -o 테이블 ````	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	탄력적 풀에 할당된 유지 관리 구성 ID입니다. 이 구성은 유지 관리 업데이트가 발생하는 기간을 정의합니다.	string
maxSizeBytes	데이터베이스 탄력적 풀에 대한 스토리지 제한(바이트)입니다.	int
minCapacity	일시 중지되지 않은 경우 서버리스 풀이 아래로 축소되지 않는 최소 용량	int
perDatabaseSettings	탄력적 풀에 대한 데이터베이스별 설정입니다.	ElasticPoolPerDatabaseSettings
preferredEnclaveType	탄력적 풀에서 요청된 enclave의 유형입니다.	'Default' 'VBS'
zoneRedundant	이 탄력적 풀이 영역 중복인지 여부입니다. 즉, 이 탄력적 풀의 복제본이 여러 가용성 영역에 분산됩니다.	bool

Sku

Name	Description	Value
capacity	특정 SKU의 용량입니다.	int
family	서비스에 여러 세대의 하드웨어가 있는 경우 동일한 SKU에 대해 여기에서 캡처할 수 있습니다.	string
name	SKU의 이름(일반적으로 문자 + 숫자 코드(예: P3)입니다.	string(필수)
size	특정 SKU의 크기	string
tier	특정 SKU의 계층 또는 버전(예: Basic, Premium)입니다.	string

TrackedResourceTags

Name	Description	Value

사용 예제

Azure 빠른 시작 템플릿

다음 Azure 빠른 시작 템플릿은 이 리소스 유형을 배포할 있습니다.

Template	Description
새 SQL 탄력적 풀 배포	이 템플릿을 사용하면 새 연결된 SQL Server 및 새 SQL Database를 사용하여 새 SQL 탄력적 풀을 배포하여 할당할 수 있습니다.

Terraform(AzAPI 공급자) 리소스 정의

서버/elasticPools 리소스 종류는 다음을 대상으로 하는 작업으로 배포할 수 있습니다.

• 리소스 그룹

각 API 버전에서 변경된 속성 목록은 변경 로그참조하세요.

리소스 형식

Microsoft.Sql/servers/elasticPools 리소스를 만들려면 템플릿에 다음 Terraform을 추가합니다.

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

속성 값

Microsoft.Sql/servers/elasticPools

Name	Description	Value
location	리소스 위치입니다.	string(필수)
name	리소스 이름	string(필수)
parent_id	이 리소스의 부모인 리소스의 ID입니다.	유형의 리소스에 대한 ID: 서버
properties	리소스 속성입니다.	ElasticPoolProperties
sku	탄력적 풀 SKU입니다. SKU 목록은 지역 및 지원 제품에 따라 다를 수 있습니다. Azure 지역의 구독에 사용할 수 있는 SKU 이름, 계층/버전, 제품군 및 용량을 포함하여 SKU를 확인하려면 Capabilities_ListByLocation REST API 또는 다음 명령을 사용합니다. ```azurecli az sql elastic-pool list-editions -l <위치> -o 테이블 ````	Sku
tags	리소스 태그	태그 이름 및 값의 사전입니다.
type	리소스 종류	"Microsoft.Sql/servers/elasticPools@2024-11-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	탄력적 풀에 할당된 유지 관리 구성 ID입니다. 이 구성은 유지 관리 업데이트가 발생하는 기간을 정의합니다.	string
maxSizeBytes	데이터베이스 탄력적 풀에 대한 스토리지 제한(바이트)입니다.	int
minCapacity	일시 중지되지 않은 경우 서버리스 풀이 아래로 축소되지 않는 최소 용량	int
perDatabaseSettings	탄력적 풀에 대한 데이터베이스별 설정입니다.	ElasticPoolPerDatabaseSettings
preferredEnclaveType	탄력적 풀에서 요청된 enclave의 유형입니다.	'Default' 'VBS'
zoneRedundant	이 탄력적 풀이 영역 중복인지 여부입니다. 즉, 이 탄력적 풀의 복제본이 여러 가용성 영역에 분산됩니다.	bool

Sku

Name	Description	Value
capacity	특정 SKU의 용량입니다.	int
family	서비스에 여러 세대의 하드웨어가 있는 경우 동일한 SKU에 대해 여기에서 캡처할 수 있습니다.	string
name	SKU의 이름(일반적으로 문자 + 숫자 코드(예: P3)입니다.	string(필수)
size	특정 SKU의 크기	string
tier	특정 SKU의 계층 또는 버전(예: Basic, Premium)입니다.	string

TrackedResourceTags

Name	Description	Value

사용 예제

Terraform 샘플

Azure SQL 탄력적 풀 배포의 기본 예제입니다.

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

Azure SQL 탄력적 풀 배포의 기본 예제입니다.

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