Servidores Microsoft.Sql/elasticPools

  • Artigo

Definição de recurso do Bicep

O tipo de recurso servers/elasticPools pode ser implantado com operações direcionadas:

Para obter uma lista das propriedades alteradas em cada versão da API, consulte log de alterações.

Formato de recurso

Para criar um recurso Microsoft.Sql/servers/elasticPools, adicione o seguinte Bicep ao modelo.

resource symbolicname 'Microsoft.Sql/servers/elasticPools@2023-05-01-preview' = {
  name: 'string'
  location: 'string'
  tags: {
    tagName1: 'tagValue1'
    tagName2: 'tagValue2'
  }
  sku: {
    capacity: int
    family: 'string'
    name: 'string'
    size: 'string'
    tier: 'string'
  }
  parent: resourceSymbolicName
  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
  }
}

Valores de propriedade

servers/elasticPools

Nome Descrição Valor
name O nome do recurso

Veja como definir nomes e tipos para recursos filho no Bicep.		 cadeia de caracteres (obrigatório)

Limite de caracteres: 1-128

Caracteres válidos:
Não é possível usar:
<>*%&:\/? ou caracteres de controle

Não pode terminar com ponto ou espaço.
local Local do recurso. cadeia de caracteres (obrigatório)
marcas Marcas de recurso. Dicionário de nomes e valores de marcas. Confira Marcas em modelos
sku O SKU do pool elástico.

A lista de SKUs pode variar de acordo com a região e a oferta de suporte. Para determinar os SKUs (incluindo o nome do SKU, a camada/edição, a família e a capacidade) que estão disponíveis para sua assinatura em uma região do Azure, use a Capabilities_ListByLocation API REST ou o seguinte comando:

CLI do Azure:
az sql elastic-pool list-editions -l {location} -o table

 Sku
pai 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 o recurso do tipo: servidores
properties Propriedades do recurso. ElasticPoolProperties

ElasticPoolProperties

Nome Descrição Valor
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á desabilitada INT
availabilityZone Especifica a zona de disponibilidade à qual o réplica primário do pool está fixado. '1'
'2'
'3'
'NoPreference'
highAvailabilityReplicaCount O número de réplicas secundárias associadas ao pool elástico que são usadas para fornecer alta disponibilidade. Aplicável somente a pools elásticos de Hiperescala. INT
licenseType O tipo de licença a ser aplicado a esse pool elástico. 'BasePrice'
'LicenseIncluded'
maintenanceConfigurationId ID de configuração de manutenção atribuída ao pool elástico. Essa configuração define o período em que as atualizações de manutenção ocorrerão. string
maxSizeBytes O limite de armazenamento para o pool elástico do banco de dados em bytes. INT
minCapacity Capacidade mínima que o pool sem servidor não reduzirá abaixo, se não estiver em pausa INT
perDatabaseSettings As configurações por banco de dados para o pool elástico. ElasticPoolPerDatabaseSettings
preferredEnclaveType Tipo de enclave solicitado no pool elástico. 'Padrão'
'VBS'
zoneRedundant Se esse pool elástico tem ou não redundância de zona, o que significa que as réplicas desse pool elástico serão distribuídas entre várias zonas de disponibilidade. bool

ElasticPoolPerDatabaseSettings

Nome Descrição Valor
autoPauseDelay Pausar automaticamente o atraso para por banco de dados no pool INT
Maxcapacity A capacidade máxima que qualquer banco de dados pode consumir. INT
minCapacity A capacidade mínima de todos os bancos de dados é garantida. INT

Sku

Nome Descrição Valor
ALOCADA Capacidade do SKU específico. INT
família Se o serviço tiver diferentes gerações de hardware, para a mesma SKU, isso poderá ser capturado aqui. string
name O nome do SKU, normalmente, uma letra + Código de número, por exemplo, P3. cadeia de caracteres (obrigatório)
tamanho Tamanho do SKU específico string
Camada A camada ou edição do SKU específico, por exemplo, Básico, Premium. string

Modelos de início rápido

Os modelos de início rápido a seguir implantam esse tipo de recurso.

Modelo Descrição
Implantar um novo pool elástico do SQL

Implantar no Azure		 Esse modelo permite implantar um novo Pool Elástico do SQL com seu novo SQL Server associado e novos Bancos de Dados SQL a serem atribuídos a ele.

Definição de recurso de modelo do 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 de recurso

Para criar um recurso Microsoft.Sql/servers/elasticPools, adicione o JSON a seguir ao modelo.

{
  "type": "Microsoft.Sql/servers/elasticPools",
  "apiVersion": "2023-05-01-preview",
  "name": "string",
  "location": "string",
  "tags": {
    "tagName1": "tagValue1",
    "tagName2": "tagValue2"
  },
  "sku": {
    "capacity": "int",
    "family": "string",
    "name": "string",
    "size": "string",
    "tier": "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"
  }
}

Valores de propriedade

servers/elasticPools

Nome Descrição Valor
tipo O tipo de recurso 'Microsoft.Sql/servers/elasticPools'
apiVersion A versão da API de recursos '2023-05-01-preview'
name O nome do recurso

Veja como definir nomes e tipos para recursos filho em modelos do ARM JSON.		 cadeia de caracteres (obrigatório)

Limite de caracteres: 1 a 128

Caracteres válidos:
Não é possível usar:
<>*%&:\/? ou caracteres de controle

Não pode terminar com ponto ou espaço.
local Local do recurso. cadeia de caracteres (obrigatório)
marcas Marcas de recurso. Dicionário de nomes e valores de marcas. Consulte Marcas em modelos
sku O SKU do pool elástico.

A lista de SKUs pode variar de acordo com a região e a oferta de suporte. Para determinar os SKUs (incluindo o nome da SKU, camada/edição, família e capacidade) que estão disponíveis para sua assinatura em uma região do Azure, use a Capabilities_ListByLocation API REST ou o seguinte comando:

CLI do Azure:
az sql elastic-pool list-editions -l {location} -o table

 Sku
properties Propriedades do recurso. ElasticPoolProperties

ElasticPoolProperties

Nome Descrição Valor
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á desabilitada INT
availabilityZone Especifica a zona de disponibilidade à qual o réplica primário do pool está fixado. '1'
'2'
'3'
'NoPreference'
highAvailabilityReplicaCount O número de réplicas secundárias associadas ao pool elástico que são usadas para fornecer alta disponibilidade. Aplicável somente a pools elásticos de Hiperescala. INT
licenseType O tipo de licença a ser aplicado a esse pool elástico. 'BasePrice'
'LicenseIncluded'
maintenanceConfigurationId ID de configuração de manutenção atribuída ao pool elástico. Essa configuração define o período em que as atualizações de manutenção ocorrerão. string
maxSizeBytes O limite de armazenamento para o pool elástico do banco de dados em bytes. INT
minCapacity Capacidade mínima que o pool sem servidor não reduzirá abaixo, se não estiver em pausa INT
perDatabaseSettings As configurações por banco de dados para o pool elástico. ElasticPoolPerDatabaseSettings
preferredEnclaveType Tipo de enclave solicitado no pool elástico. 'Padrão'
'VBS'
zoneRedundant Se esse pool elástico tem ou não redundância de zona, o que significa que as réplicas desse pool elástico serão distribuídas entre várias zonas de disponibilidade. bool

ElasticPoolPerDatabaseSettings

Nome Descrição Valor
autoPauseDelay Pausar Automaticamente Atraso para 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 todos os bancos de dados é garantida. INT

Sku

Nome Descrição Valor
ALOCADA Capacidade do SKU específico. INT
família Se o serviço tiver gerações diferentes de hardware, para a mesma SKU, isso poderá ser capturado aqui. string
name O nome da SKU, normalmente, uma letra + código de número, por exemplo, P3. cadeia de caracteres (obrigatório)
tamanho Tamanho do SKU específico string
Camada A camada ou edição do SKU específico, por exemplo, Básico, Premium. string

Modelos de início rápido

Os modelos de início rápido a seguir implantam esse tipo de recurso.

Modelo Descrição
Implantar um novo pool elástico do SQL

Implantar no Azure		 Esse modelo permite que você implante um novo Pool Elástico do SQL com seu novo SQL Server associado e novos Bancos de Dados SQL a serem atribuídos a ele.

Definição de recurso do Terraform (provedor de AzAPI)

O tipo de recurso servers/elasticPools pode ser implantado com operações direcionadas:

  • Grupos de recursos

Para obter uma lista das propriedades alteradas em cada versão da API, consulte log de alterações.

Formato de recurso

Para criar um recurso Microsoft.Sql/servers/elasticPools, adicione o Terraform a seguir ao modelo.

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.Sql/servers/elasticPools@2023-05-01-preview"
  name = "string"
  location = "string"
  parent_id = "string"
  tags = {
    tagName1 = "tagValue1"
    tagName2 = "tagValue2"
  }
  body = jsonencode({
    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

servers/elasticPools

Nome Descrição Valor
tipo O tipo de recurso "Microsoft.Sql/servers/elasticPools@2023-05-01-preview"
name O nome do recurso cadeia de caracteres (obrigatório)

Limite de caracteres: 1-128

Caracteres válidos:
Não é possível usar:
<>*%&:\/? ou caracteres de controle

Não pode terminar com ponto ou espaço.
local Local do recurso. cadeia de caracteres (obrigatório)
parent_id A ID do recurso que é o pai desse recurso. ID do recurso do tipo: servidores
marcas Marcas de recurso. Dicionário de nomes e valores de marcas.
sku O SKU do pool elástico.

A lista de SKUs pode variar de acordo com a região e a oferta de suporte. Para determinar os SKUs (incluindo o nome do SKU, a camada/edição, a família e a capacidade) que estão disponíveis para sua assinatura em uma região do Azure, use a Capabilities_ListByLocation API REST ou o seguinte comando:

CLI do Azure:
az sql elastic-pool list-editions -l {location} -o table

 Sku
properties Propriedades do recurso. ElasticPoolProperties

ElasticPoolProperties

Nome Descrição Valor
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á desabilitada INT
availabilityZone Especifica a zona de disponibilidade à qual o réplica primário do pool está fixado. "1"
"2"
"3"
"NoPreference"
highAvailabilityReplicaCount O número de réplicas secundárias associadas ao pool elástico que são usadas para fornecer alta disponibilidade. Aplicável somente a pools elásticos de Hiperescala. INT
licenseType O tipo de licença a ser aplicado a esse pool elástico. "BasePrice"
"LicenseIncluded"
maintenanceConfigurationId ID de configuração de manutenção atribuída ao pool elástico. Essa configuração define o período em que as atualizações de manutenção ocorrerão. string
maxSizeBytes O limite de armazenamento para o pool elástico do banco de dados em bytes. INT
minCapacity Capacidade mínima que o pool sem servidor não reduzirá abaixo, se não estiver em pausa INT
perDatabaseSettings As configurações por banco de dados para o pool elástico. ElasticPoolPerDatabaseSettings
preferredEnclaveType Tipo de enclave solicitado no pool elástico. "Padrão"
"VBS"
zoneRedundant Se esse pool elástico tem ou não redundância de zona, o que significa que as réplicas desse pool elástico serão distribuídas entre várias zonas de disponibilidade. bool

ElasticPoolPerDatabaseSettings

Nome Descrição Valor
autoPauseDelay Pausar Automaticamente Atraso para 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 todos os bancos de dados é garantida. INT

Sku

Nome Descrição Valor
ALOCADA Capacidade do SKU específico. INT
família Se o serviço tiver gerações diferentes de hardware, para a mesma SKU, isso poderá ser capturado aqui. string
name O nome da SKU, normalmente, uma letra + código de número, por exemplo, P3. cadeia de caracteres (obrigatório)
tamanho Tamanho do SKU específico string
Camada A camada ou edição do SKU específico, por exemplo, Básico, Premium. string