Compartir a través de


Microsoft.Sql servers/elasticPools 2023-05-01-preview

Definición de recursos de Bicep

El tipo de recurso servers/elasticPools se puede implementar con operaciones destinadas a:

Para obtener una lista de las propiedades modificadas en cada versión de api, consulte registro de cambios.

Formato de los recursos

Para crear un recurso Microsoft.Sql/servers/elasticPools, agregue el siguiente bicep a la plantilla.

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 propiedad

servers/elasticPools

Nombre Descripción Value
name El nombre del recurso

Vea cómo establecer nombres y tipos para recursos secundarios en Bicep.
string (obligatorio)

Límite de caracteres: 1-128

Caracteres válidos:
No puede usar:
<>*%&:\/? ni caracteres de control

No puede terminar con un punto ni un espacio.
ubicación Ubicación del recurso string (obligatorio)
etiquetas Etiquetas del recurso. Diccionario de nombres y valores de etiqueta. Consulte Etiquetas en plantillas.
sku SKU del grupo elástico.

La lista de SKU puede variar según la región y la oferta de soporte técnico. Para determinar las SKU (incluido el nombre de la SKU, la edición o la capa, la familia y la capacidad) que están disponibles para la suscripción en una región de Azure, use la Capabilities_ListByLocation API rest o el siguiente comando:

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

Sku
primario En Bicep, puede especificar el recurso primario para un recurso secundario. Solo tiene que agregar esta propiedad cuando el recurso secundario se declara fuera del recurso primario.

Para más información, consulte Recurso secundario fuera del recurso primario.
Nombre simbólico del recurso de tipo: servidores
properties Propiedades del recurso. ElasticPoolProperties

ElasticPoolProperties

Nombre Descripción Valor
autoPauseDelay Tiempo en minutos después del cual el grupo elástico se pausa automáticamente. Un valor de -1 significa que la pausa automática está deshabilitada. int
availabilityZone Especifica la zona de disponibilidad a la que está anclada la réplica principal del grupo. '1'
'2'
'3'
'NoPreference'
highAvailabilityReplicaCount Número de réplicas secundarias asociadas al grupo elástico que se usan para proporcionar alta disponibilidad. Solo se aplica a los grupos elásticos de Hiperescala. int
licenseType Tipo de licencia que se va a aplicar a este grupo elástico. 'BasePrice'
"LicenseIncluded"
maintenanceConfigurationId Identificador de configuración de mantenimiento asignado al grupo elástico. Esta configuración define el período en el que se producirán las actualizaciones de mantenimiento. string
maxSizeBytes Límite de almacenamiento para el grupo elástico de base de datos en bytes. int
minCapacity La capacidad mínima que el grupo sin servidor no se reducirá a continuación, si no está en pausa int
perDatabaseSettings La configuración por base de datos del grupo elástico. ElasticPoolPerDatabaseSettings
preferredEnclaveType Tipo de enclave solicitado en el grupo elástico. 'Default'
'VBS'
zoneRedundant Si este grupo elástico es con redundancia de zona, lo que significa que las réplicas de este grupo elástico se distribuirán entre varias zonas de disponibilidad. bool

ElasticPoolPerDatabaseSettings

Nombre Descripción Valor
autoPauseDelay Retraso de pausa automática para por base de datos dentro del grupo int
maxCapacity La capacidad máxima que pueda consumir cualquier base de datos. int
minCapacity Se garantiza la capacidad mínima de todas las bases de datos. int

SKU

Nombre Descripción Valor
capacity Capacidad de la SKU determinada. int
family Si el servicio tiene diferentes generaciones de hardware, para la misma SKU, se puede capturar aquí. string
name El nombre de la SKU, normalmente, una letra + código numérico, por ejemplo, P3. string (obligatorio)
tamaño Tamaño de la SKU determinada string
Nivel: Nivel o edición de la SKU concreta, por ejemplo, Básico, Premium. string

Plantillas de inicio rápido

Las siguientes plantillas de inicio rápido implementan este tipo de recurso.

Plantilla Descripción
Implementación de un nuevo grupo elástico de SQL

Implementación en Azure
Esta plantilla le permite implementar un nuevo grupo elástico de SQL con sus nuevos SQL Server asociados y nuevas bases de datos SQL para asignarla.

Definición de recursos de plantilla de ARM

El tipo de recurso servers/elasticPools se puede implementar con operaciones destinadas a:

Para obtener una lista de las propiedades modificadas en cada versión de API, consulte registro de cambios.

Formato de los recursos

Para crear un recurso Microsoft.Sql/servers/elasticPools, agregue el siguiente json a la plantilla.

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

servers/elasticPools

Nombre Descripción Value
type Tipo de recurso "Microsoft.Sql/servers/elasticPools"
apiVersion La versión de la API de recursos "2023-05-01-preview"
name El nombre del recurso

Vea cómo establecer nombres y tipos para recursos secundarios en plantillas de ARM JSON.
string (obligatorio)

Límite de caracteres: 1-128

Caracteres válidos:
No puede usar:
<>*%&:\/? ni caracteres de control

No puede terminar con un punto ni un espacio.
ubicación Ubicación del recurso string (obligatorio)
etiquetas Etiquetas del recurso. Diccionario de nombres y valores de etiqueta. Consulte Etiquetas en plantillas.
sku SKU del grupo elástico.

La lista de SKU puede variar según la región y la oferta de soporte técnico. Para determinar las SKU (incluido el nombre de la SKU, la edición, la familia y la capacidad) que están disponibles para la suscripción en una región de Azure, use la Capabilities_ListByLocation API REST o el siguiente comando:

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

Sku
properties Propiedades de recursos. ElasticPoolProperties

ElasticPoolProperties

Nombre Descripción Valor
autoPauseDelay Tiempo en minutos después del cual el grupo elástico se pausa automáticamente. Un valor de -1 significa que la pausa automática está deshabilitada. int
availabilityZone Especifica la zona de disponibilidad en la que está anclada la réplica principal del grupo. '1'
'2'
'3'
'NoPreference'
highAvailabilityReplicaCount Número de réplicas secundarias asociadas al grupo elástico que se usan para proporcionar alta disponibilidad. Solo se aplica a grupos elásticos de Hiperescala. int
licenseType Tipo de licencia que se va a aplicar a este grupo elástico. 'BasePrice'
'LicenseIncluded'
maintenanceConfigurationId Identificador de configuración de mantenimiento asignado al grupo elástico. Esta configuración define el período en el que se producirán las actualizaciones de mantenimiento. string
maxSizeBytes Límite de almacenamiento para el grupo elástico de base de datos en bytes. int
minCapacity La capacidad mínima que el grupo sin servidor no se reducirá por debajo, si no está en pausa int
perDatabaseSettings La configuración por base de datos del grupo elástico. ElasticPoolPerDatabaseSettings
preferredEnclaveType Tipo de enclave solicitado en el grupo elástico. 'Default'
'VBS'
zoneRedundant Si este grupo elástico es con redundancia de zona, lo que significa que las réplicas de este grupo elástico se distribuirán entre varias zonas de disponibilidad. bool

ElasticPoolPerDatabaseSettings

Nombre Descripción Valor
autoPauseDelay Retraso de pausa automática para por base de datos dentro del grupo int
maxCapacity La capacidad máxima que pueda consumir cualquier base de datos. int
minCapacity Se garantiza la capacidad mínima de todas las bases de datos. int

SKU

Nombre Descripción Valor
capacity Capacidad de la SKU determinada. int
family Si el servicio tiene diferentes generaciones de hardware, para la misma SKU, se puede capturar aquí. string
name El nombre de la SKU, normalmente, una letra + código numérico, por ejemplo, P3. string (obligatorio)
tamaño Tamaño de la SKU determinada string
Nivel: Nivel o edición de la SKU concreta, por ejemplo, Básico, Premium. string

Plantillas de inicio rápido

Las siguientes plantillas de inicio rápido implementan este tipo de recurso.

Plantilla Descripción
Implementación de un nuevo grupo elástico de SQL

Implementación en Azure
Esta plantilla le permite implementar un nuevo grupo elástico de SQL con sus nuevos SQL Server asociados y nuevas bases de datos SQL para asignarla.

Definición de recursos de Terraform (proveedor AzAPI)

El tipo de recurso servers/elasticPools se puede implementar con operaciones destinadas a:

  • Grupos de recursos

Para obtener una lista de las propiedades modificadas en cada versión de API, consulte registro de cambios.

Formato de los recursos

Para crear un recurso Microsoft.Sql/servers/elasticPools, agregue el siguiente terraform a la plantilla.

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 propiedad

servers/elasticPools

Nombre Descripción Value
type Tipo de recurso "Microsoft.Sql/servers/elasticPools@2023-05-01-preview"
name El nombre del recurso string (obligatorio)

Límite de caracteres: 1-128

Caracteres válidos:
No puede usar:
<>*%&:\/? ni caracteres de control

No puede terminar con un punto ni un espacio.
ubicación Ubicación del recurso string (obligatorio)
parent_id Identificador del recurso que es el elemento primario de este recurso. Identificador del recurso de tipo: servidores
etiquetas Etiquetas del recurso. Diccionario de nombres y valores de etiqueta.
sku SKU del grupo elástico.

La lista de SKU puede variar según la región y la oferta de soporte técnico. Para determinar las SKU (incluido el nombre de la SKU, la edición o la capa, la familia y la capacidad) que están disponibles para la suscripción en una región de Azure, use la Capabilities_ListByLocation API rest o el siguiente comando:

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

Sku
properties Propiedades del recurso. ElasticPoolProperties

ElasticPoolProperties

Nombre Descripción Valor
autoPauseDelay Tiempo en minutos después del cual el grupo elástico se pausa automáticamente. Un valor de -1 significa que la pausa automática está deshabilitada. int
availabilityZone Especifica la zona de disponibilidad a la que está anclada la réplica principal del grupo. "1"
"2"
"3"
"NoPreference"
highAvailabilityReplicaCount Número de réplicas secundarias asociadas al grupo elástico que se usan para proporcionar alta disponibilidad. Solo se aplica a los grupos elásticos de Hiperescala. int
licenseType Tipo de licencia que se va a aplicar a este grupo elástico. "BasePrice"
"LicenseIncluded"
maintenanceConfigurationId Identificador de configuración de mantenimiento asignado al grupo elástico. Esta configuración define el período en el que se producirán las actualizaciones de mantenimiento. string
maxSizeBytes Límite de almacenamiento para el grupo elástico de base de datos en bytes. int
minCapacity La capacidad mínima que el grupo sin servidor no se reducirá a continuación, si no está en pausa int
perDatabaseSettings La configuración por base de datos del grupo elástico. ElasticPoolPerDatabaseSettings
preferredEnclaveType Tipo de enclave solicitado en el grupo elástico. "Valor predeterminado"
"VBS"
zoneRedundant Si este grupo elástico tiene redundancia de zona o no, lo que significa que las réplicas de este grupo elástico se distribuirán entre varias zonas de disponibilidad. bool

ElasticPoolPerDatabaseSettings

Nombre Descripción Valor
autoPauseDelay Retraso de pausa automática para por base de datos dentro del grupo int
maxCapacity La capacidad máxima que pueda consumir cualquier base de datos. int
minCapacity Se garantiza la capacidad mínima de todas las bases de datos. int

SKU

Nombre Descripción Valor
capacity Capacidad de la SKU determinada. int
family Si el servicio tiene diferentes generaciones de hardware, para la misma SKU, se puede capturar aquí. string
name El nombre de la SKU, normalmente, una letra + código numérico, por ejemplo, P3. string (obligatorio)
tamaño Tamaño de la SKU determinada string
Nivel: El nivel o la edición de la SKU determinada, por ejemplo, Básico, Premium. string