Microsoft. Instancias gestionadas de SQL

Definición de recurso Bicep

El tipo de recurso managedInstances se puede implementar con operaciones que tienen como destino:

grupos de recursos: consulte comandos de implementación de grupos de recursos

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

Formato de recurso

Para crear un Microsoft. Recurso Sql/managedInstances, añade el siguiente Bicep a tu plantilla.

resource symbolicname 'Microsoft.Sql/managedInstances@2025-02-01-preview' = {
  identity: {
    type: 'string'
    userAssignedIdentities: {
      {customized property}: {}
    }
  }
  location: 'string'
  name: 'string'
  properties: {
    administratorLogin: 'string'
    administratorLoginPassword: 'string'
    administrators: {
      administratorType: 'string'
      azureADOnlyAuthentication: bool
      login: 'string'
      principalType: 'string'
      sid: 'string'
      tenantId: 'string'
    }
    authenticationMetadata: 'string'
    collation: 'string'
    databaseFormat: 'string'
    dnsZonePartner: 'string'
    hybridSecondaryUsage: 'string'
    instancePoolId: 'string'
    isGeneralPurposeV2: bool
    keyId: 'string'
    licenseType: 'string'
    maintenanceConfigurationId: 'string'
    managedInstanceCreateMode: 'string'
    memorySizeInGB: int
    minimalTlsVersion: 'string'
    pricingModel: 'string'
    primaryUserAssignedIdentityId: 'string'
    proxyOverride: 'string'
    publicDataEndpointEnabled: bool
    requestedBackupStorageRedundancy: 'string'
    requestedLogicalAvailabilityZone: 'string'
    restorePointInTime: 'string'
    servicePrincipal: {
      type: 'string'
    }
    sourceManagedInstanceId: 'string'
    storageIOps: int
    storageSizeInGB: int
    storageThroughputMBps: int
    subnetId: 'string'
    timezoneId: 'string'
    vCores: int
    zoneRedundant: bool
  }
  sku: {
    capacity: int
    family: 'string'
    name: 'string'
    size: 'string'
    tier: 'string'
  }
  tags: {
    {customized property}: 'string'
  }
}

Valores de propiedad

Microsoft. Sql/Instancias gestionadas

Name	Description	Value
identity	La identidad de Azure Active Directory de la instancia gestionada.	ResourceIdentity
location	Ubicación geográfica donde reside el recurso	string (obligatorio)
name	El nombre del recurso	string (obligatorio)
properties	Propiedades de recursos.	ManagedInstanceProperties
sku	SKU de instancia administrada. Valores permitidos para sku.name: GP_Gen5 (uso general, serie estándar); GP_G8IM (Propósito general, serie Premium); GP_G8IH (Propósito general, memoria de la serie Premium optimizada); BC_Gen5 (Crítico para el negocio, Standard-Series); BC_G8IM (Business Critical, serie Premium); BC_G8IH (Crítico para la empresa, optimizado para la memoria de la serie Premium).	Sku
tags	Etiquetas de recursos	Diccionario de nombres y valores de etiqueta. Consulte etiquetas de en plantillas

ManagedInstanceExternalAdministrator

Name	Description	Value
administratorType	Tipo del administrador del servidor.	'ActiveDirectory'
azureADOnlyAuthentication	Solo Azure Active Directory Autenticación habilitada.	bool
login	Nombre de inicio de sesión del administrador del servidor.	string
principalType	Tipo de entidad de seguridad del administrador del servidor.	'Application' 'Group' 'User'
sid	SID (id. de objeto) del administrador del servidor.	string Constraints: Longitud mínima = 36 Longitud máxima = 36 Patrón = `^[0-9a-fA-F]{8}-([0-9a-fA-F]{4}-){3}[0-9a-fA-F]{12}$`
tenantId	Identificador de inquilino del administrador.	string Constraints: Longitud mínima = 36 Longitud máxima = 36 Patrón = `^[0-9a-fA-F]{8}-([0-9a-fA-F]{4}-){3}[0-9a-fA-F]{12}$`

ManagedInstanceProperties

Name	Description	Value
administratorLogin	Nombre de usuario del administrador para la instancia administrada. Solo se puede especificar cuando se crea la instancia administrada (y es necesaria para la creación).	string
administratorLoginPassword	La contraseña de inicio de sesión del administrador (necesaria para la creación de la instancia administrada).	string Constraints: Valor confidencial. Pase como parámetro seguro.
administrators	El administrador de Azure Active Directory puede utilizarse durante la creación de instancias y para actualizaciones de instancias, excepto la propiedad azureADOnlyAuthentication. Para actualizar la propiedad azureADOnlyAuthentication, se debe usar una API individual.	ManagedInstanceExternalAdministrator
authenticationMetadata	Modo de búsqueda de metadatos de autenticación de la instancia administrada.	'AzureAD' 'Paired' 'Windows'
collation	Intercalación de la instancia administrada.	string
databaseFormat	Especifica el formato interno de las bases de datos de instancia específicas de la versión del motor de SQL.	'AlwaysUpToDate' 'SQLServer2022' 'SQLServer2025'
dnsZonePartner	Identificador de recurso de otra instancia administrada cuya zona DNS compartirá esta instancia administrada después de la creación.	string
hybridSecondaryUsage	Uso secundario híbrido. Los valores posibles son "Activo" (valor predeterminado) y "Pasivo" (el cliente usa la secundaria como recuperación ante desastres pasivas).	'Active' 'Passive'
instancePoolId	Identificador del grupo de instancias al que pertenece este servidor administrado.	string
isGeneralPurposeV2	Indica si se trata de una variante GPv2 de la edición De uso general.	bool
keyId	URI de CMK de la clave que se va a usar para el cifrado.	string
licenseType	Tipo de licencia. Los valores posibles son "LicenseIncluded" (precio normal incluido de una nueva licencia de SQL) y "BasePrice" (precio de AHB con descuento para traer sus propias licencias sql).	'BasePrice' 'LicenseIncluded'
maintenanceConfigurationId	Especifica el identificador de configuración de mantenimiento que se aplicará a esta instancia administrada.	string
managedInstanceCreateMode	Especifica el modo de creación de la base de datos. Valor predeterminado: creación de instancias normales. Restaurar: crea una instancia restaurando un conjunto de copias de seguridad a un momento dado específico. Se debe especificar RestorePointInTime y SourceManagedInstanceId.	'Default' 'PointInTimeRestore'
memorySizeInGB	Tamaño de la memoria en GB. Valor mínimo: 28. Valor máximo: 870. El valor mínimo y máximo depende del número de núcleos virtuales y del nivel de servicio. Lea más sobre los límites de recursos: https://aka.ms/mi-resource-limits-api.	int
minimalTlsVersion	Versión mínima de TLS. Valores permitidos: 'None', '1.0', '1.1', '1.2'	string
pricingModel	Modelo de precios de Managed Instance.	'Freemium' 'Regular'
primaryUserAssignedIdentityId	Identificador de recurso de una identidad asignada por el usuario que se va a usar de forma predeterminada.	string
proxyOverride	Tipo de conexión que se usa para conectarse a la instancia.	'Default' 'Proxy' 'Redirect'
publicDataEndpointEnabled	Si el punto de conexión de datos público está habilitado o no.	bool
requestedBackupStorageRedundancy	Tipo de cuenta de almacenamiento que se va a usar para almacenar copias de seguridad para esta instancia. Las opciones son Local (LocallyRedundantStorage), Zone (ZoneRedundantStorage), Geo (GeoRedundantStorage) y GeoZone(GeoZoneRedundantStorage)	'Geo' 'GeoZone' 'Local' 'Zone'
requestedLogicalAvailabilityZone	Especifica la zona de disponibilidad lógica a la que está fijada Managed Instance.	'1' '2' '3' 'NoPreference'
restorePointInTime	Especifica el momento dado (ISO8601 formato) de la base de datos de origen que se restaurará para crear la nueva base de datos.	string
servicePrincipal	La entidad de servicio de la instancia administrada.	ServicePrincipal
sourceManagedInstanceId	Identificador de recurso de la instancia administrada de origen asociada a la operación de creación de esta instancia.	string
storageIOps	IOps de almacenamiento. Valor mínimo: 300. Valor máximo: 80000. Solo se permiten incrementos de 1 IOps. El valor máximo depende de la familia de hardware seleccionada y del número de núcleos virtuales.	int
storageSizeInGB	Tamaño de almacenamiento en GB. Valor mínimo: 32. Valor máximo: 32768. Solo se permiten incrementos de 32 GB. El valor máximo depende de la familia de hardware seleccionada y del número de núcleos virtuales.	int
storageThroughputMBps	El parámetro MBps de rendimiento de almacenamiento no se admite en la operación de creación o actualización de la instancia.	int
subnetId	Identificador de recurso de subred para la instancia administrada.	string
timezoneId	Id. de la zona horaria. Los valores permitidos son zonas horarias soportadas por Windows. Windows guarda los detalles de las zonas horarias soportadas, incluido el id, en el registro bajo KEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows NT\CurrentVersion\Time Zones. Puedes obtener esos valores de registro a través de SQL Server consultando el nombre SELECT COMO timezone_id DESDE sys.time_zone_info. También se puede obtener la lista de identificadores ejecutando [System.TimeZoneInfo]::GetSystemTimeZones() en PowerShell. Un ejemplo de identificador de zona horaria válido es "Hora estándar del Pacífico" o "W. Hora estándar de Europa".	string
vCores	Número de núcleos virtuales. Valores permitidos: 4, 6, 8, 10, 12, 16, 20, 24, 32, 40, 48, 56, 64, 80, 96, 128. Los núcleos virtuales admitidos dependen de la familia de hardware y el nivel de servicio seleccionados.	int
zoneRedundant	Si la redundancia de zona está habilitada o no.	bool

ResourceIdentity

Name	Description	Value
type	Tipo de identidad. Configura esto en 'SystemAssigned' para crear y asignar automáticamente un principal de Azure Active Directory para el recurso.	'None' 'SystemAssigned' 'SystemAssigned,UserAssigned' 'UserAssigned'
userAssignedIdentities	Identificadores de recursos de las identidades asignadas por el usuario que se van a usar	ResourceIdentityUserAssignedIdentities

ResourceIdentityUserAssignedIdentities

Name	Description	Value

ServicePrincipal

Name	Description	Value
type	Tipo de entidad de servicio.	'None' 'SystemAssigned'

Sku

Name	Description	Value
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 de número, por ejemplo, P3.	string (obligatorio)
size	Tamaño de la SKU determinada	string
tier	Nivel o edición de la SKU concreta, por ejemplo, Básico, Premium.	string

TrackedResourceTags

Name	Description	Value

UserIdentity

Name	Description	Value

Ejemplos de uso

Módulos comprobados de Azure

Los siguientes módulos verificados Azure pueden usarse para desplegar este tipo de recurso.

Module	Description
Instancia gestionada de SQL	Módulo de Recursos AVM para SQL Managed Instance

Azure Quickstart Samples

Las siguientes plantillas de inicio rápido Azure contienen Bicep ejemplos para desplegar este tipo de recurso.

Archivo Bicep	Description
Crea SQL MI dentro de la nueva red virtual	Despliega Azure SQL Database Managed Instance (SQL MI) dentro de la nueva Virtual Network.

Definición de recursos de plantilla de ARM

El tipo de recurso managedInstances se puede implementar con operaciones que tienen como destino:

grupos de recursos: consulte comandos de implementación de grupos de recursos

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

Formato de recurso

Para crear un Microsoft. Recurso Sql/managedInstances, añade el siguiente JSON a tu plantilla.

{
  "type": "Microsoft.Sql/managedInstances",
  "apiVersion": "2025-02-01-preview",
  "name": "string",
  "identity": {
    "type": "string",
    "userAssignedIdentities": {
      "{customized property}": {
      }
    }
  },
  "location": "string",
  "properties": {
    "administratorLogin": "string",
    "administratorLoginPassword": "string",
    "administrators": {
      "administratorType": "string",
      "azureADOnlyAuthentication": "bool",
      "login": "string",
      "principalType": "string",
      "sid": "string",
      "tenantId": "string"
    },
    "authenticationMetadata": "string",
    "collation": "string",
    "databaseFormat": "string",
    "dnsZonePartner": "string",
    "hybridSecondaryUsage": "string",
    "instancePoolId": "string",
    "isGeneralPurposeV2": "bool",
    "keyId": "string",
    "licenseType": "string",
    "maintenanceConfigurationId": "string",
    "managedInstanceCreateMode": "string",
    "memorySizeInGB": "int",
    "minimalTlsVersion": "string",
    "pricingModel": "string",
    "primaryUserAssignedIdentityId": "string",
    "proxyOverride": "string",
    "publicDataEndpointEnabled": "bool",
    "requestedBackupStorageRedundancy": "string",
    "requestedLogicalAvailabilityZone": "string",
    "restorePointInTime": "string",
    "servicePrincipal": {
      "type": "string"
    },
    "sourceManagedInstanceId": "string",
    "storageIOps": "int",
    "storageSizeInGB": "int",
    "storageThroughputMBps": "int",
    "subnetId": "string",
    "timezoneId": "string",
    "vCores": "int",
    "zoneRedundant": "bool"
  },
  "sku": {
    "capacity": "int",
    "family": "string",
    "name": "string",
    "size": "string",
    "tier": "string"
  },
  "tags": {
    "{customized property}": "string"
  }
}

Valores de propiedad

Microsoft. Sql/Instancias gestionadas

Name	Description	Value
apiVersion	La versión de api	'2025-02-01-preestreno'
identity	La identidad de Azure Active Directory de la instancia gestionada.	ResourceIdentity
location	Ubicación geográfica donde reside el recurso	string (obligatorio)
name	El nombre del recurso	string (obligatorio)
properties	Propiedades de recursos.	ManagedInstanceProperties
sku	SKU de instancia administrada. Valores permitidos para sku.name: GP_Gen5 (uso general, serie estándar); GP_G8IM (Propósito general, serie Premium); GP_G8IH (Propósito general, memoria de la serie Premium optimizada); BC_Gen5 (Crítico para el negocio, Standard-Series); BC_G8IM (Business Critical, serie Premium); BC_G8IH (Crítico para la empresa, optimizado para la memoria de la serie Premium).	Sku
tags	Etiquetas de recursos	Diccionario de nombres y valores de etiqueta. Consulte etiquetas de en plantillas
type	El tipo de recurso	'Microsoft. Sql/gestionadoInstants

ManagedInstanceExternalAdministrator

Name	Description	Value
administratorType	Tipo del administrador del servidor.	'ActiveDirectory'
azureADOnlyAuthentication	Solo Azure Active Directory Autenticación habilitada.	bool
login	Nombre de inicio de sesión del administrador del servidor.	string
principalType	Tipo de entidad de seguridad del administrador del servidor.	'Application' 'Group' 'User'
sid	SID (id. de objeto) del administrador del servidor.	string Constraints: Longitud mínima = 36 Longitud máxima = 36 Patrón = `^[0-9a-fA-F]{8}-([0-9a-fA-F]{4}-){3}[0-9a-fA-F]{12}$`
tenantId	Identificador de inquilino del administrador.	string Constraints: Longitud mínima = 36 Longitud máxima = 36 Patrón = `^[0-9a-fA-F]{8}-([0-9a-fA-F]{4}-){3}[0-9a-fA-F]{12}$`

ManagedInstanceProperties

Name	Description	Value
administratorLogin	Nombre de usuario del administrador para la instancia administrada. Solo se puede especificar cuando se crea la instancia administrada (y es necesaria para la creación).	string
administratorLoginPassword	La contraseña de inicio de sesión del administrador (necesaria para la creación de la instancia administrada).	string Constraints: Valor confidencial. Pase como parámetro seguro.
administrators	El administrador de Azure Active Directory puede utilizarse durante la creación de instancias y para actualizaciones de instancias, excepto la propiedad azureADOnlyAuthentication. Para actualizar la propiedad azureADOnlyAuthentication, se debe usar una API individual.	ManagedInstanceExternalAdministrator
authenticationMetadata	Modo de búsqueda de metadatos de autenticación de la instancia administrada.	'AzureAD' 'Paired' 'Windows'
collation	Intercalación de la instancia administrada.	string
databaseFormat	Especifica el formato interno de las bases de datos de instancia específicas de la versión del motor de SQL.	'AlwaysUpToDate' 'SQLServer2022' 'SQLServer2025'
dnsZonePartner	Identificador de recurso de otra instancia administrada cuya zona DNS compartirá esta instancia administrada después de la creación.	string
hybridSecondaryUsage	Uso secundario híbrido. Los valores posibles son "Activo" (valor predeterminado) y "Pasivo" (el cliente usa la secundaria como recuperación ante desastres pasivas).	'Active' 'Passive'
instancePoolId	Identificador del grupo de instancias al que pertenece este servidor administrado.	string
isGeneralPurposeV2	Indica si se trata de una variante GPv2 de la edición De uso general.	bool
keyId	URI de CMK de la clave que se va a usar para el cifrado.	string
licenseType	Tipo de licencia. Los valores posibles son "LicenseIncluded" (precio normal incluido de una nueva licencia de SQL) y "BasePrice" (precio de AHB con descuento para traer sus propias licencias sql).	'BasePrice' 'LicenseIncluded'
maintenanceConfigurationId	Especifica el identificador de configuración de mantenimiento que se aplicará a esta instancia administrada.	string
managedInstanceCreateMode	Especifica el modo de creación de la base de datos. Valor predeterminado: creación de instancias normales. Restaurar: crea una instancia restaurando un conjunto de copias de seguridad a un momento dado específico. Se debe especificar RestorePointInTime y SourceManagedInstanceId.	'Default' 'PointInTimeRestore'
memorySizeInGB	Tamaño de la memoria en GB. Valor mínimo: 28. Valor máximo: 870. El valor mínimo y máximo depende del número de núcleos virtuales y del nivel de servicio. Lea más sobre los límites de recursos: https://aka.ms/mi-resource-limits-api.	int
minimalTlsVersion	Versión mínima de TLS. Valores permitidos: 'None', '1.0', '1.1', '1.2'	string
pricingModel	Modelo de precios de Managed Instance.	'Freemium' 'Regular'
primaryUserAssignedIdentityId	Identificador de recurso de una identidad asignada por el usuario que se va a usar de forma predeterminada.	string
proxyOverride	Tipo de conexión que se usa para conectarse a la instancia.	'Default' 'Proxy' 'Redirect'
publicDataEndpointEnabled	Si el punto de conexión de datos público está habilitado o no.	bool
requestedBackupStorageRedundancy	Tipo de cuenta de almacenamiento que se va a usar para almacenar copias de seguridad para esta instancia. Las opciones son Local (LocallyRedundantStorage), Zone (ZoneRedundantStorage), Geo (GeoRedundantStorage) y GeoZone(GeoZoneRedundantStorage)	'Geo' 'GeoZone' 'Local' 'Zone'
requestedLogicalAvailabilityZone	Especifica la zona de disponibilidad lógica a la que está fijada Managed Instance.	'1' '2' '3' 'NoPreference'
restorePointInTime	Especifica el momento dado (ISO8601 formato) de la base de datos de origen que se restaurará para crear la nueva base de datos.	string
servicePrincipal	La entidad de servicio de la instancia administrada.	ServicePrincipal
sourceManagedInstanceId	Identificador de recurso de la instancia administrada de origen asociada a la operación de creación de esta instancia.	string
storageIOps	IOps de almacenamiento. Valor mínimo: 300. Valor máximo: 80000. Solo se permiten incrementos de 1 IOps. El valor máximo depende de la familia de hardware seleccionada y del número de núcleos virtuales.	int
storageSizeInGB	Tamaño de almacenamiento en GB. Valor mínimo: 32. Valor máximo: 32768. Solo se permiten incrementos de 32 GB. El valor máximo depende de la familia de hardware seleccionada y del número de núcleos virtuales.	int
storageThroughputMBps	El parámetro MBps de rendimiento de almacenamiento no se admite en la operación de creación o actualización de la instancia.	int
subnetId	Identificador de recurso de subred para la instancia administrada.	string
timezoneId	Id. de la zona horaria. Los valores permitidos son zonas horarias soportadas por Windows. Windows guarda los detalles de las zonas horarias soportadas, incluido el id, en el registro bajo KEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows NT\CurrentVersion\Time Zones. Puedes obtener esos valores de registro a través de SQL Server consultando el nombre SELECT COMO timezone_id DESDE sys.time_zone_info. También se puede obtener la lista de identificadores ejecutando [System.TimeZoneInfo]::GetSystemTimeZones() en PowerShell. Un ejemplo de identificador de zona horaria válido es "Hora estándar del Pacífico" o "W. Hora estándar de Europa".	string
vCores	Número de núcleos virtuales. Valores permitidos: 4, 6, 8, 10, 12, 16, 20, 24, 32, 40, 48, 56, 64, 80, 96, 128. Los núcleos virtuales admitidos dependen de la familia de hardware y el nivel de servicio seleccionados.	int
zoneRedundant	Si la redundancia de zona está habilitada o no.	bool

ResourceIdentity

Name	Description	Value
type	Tipo de identidad. Configura esto en 'SystemAssigned' para crear y asignar automáticamente un principal de Azure Active Directory para el recurso.	'None' 'SystemAssigned' 'SystemAssigned,UserAssigned' 'UserAssigned'
userAssignedIdentities	Identificadores de recursos de las identidades asignadas por el usuario que se van a usar	ResourceIdentityUserAssignedIdentities

ResourceIdentityUserAssignedIdentities

Name	Description	Value

ServicePrincipal

Name	Description	Value
type	Tipo de entidad de servicio.	'None' 'SystemAssigned'

Sku

Name	Description	Value
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 de número, por ejemplo, P3.	string (obligatorio)
size	Tamaño de la SKU determinada	string
tier	Nivel o edición de la SKU concreta, por ejemplo, Básico, Premium.	string

TrackedResourceTags

Name	Description	Value

UserIdentity

Name	Description	Value

Ejemplos de uso

Plantillas de inicio rápido de Azure

Las siguientes plantillas Azure Quickstart despliegan este tipo de recurso.

Template	Description
Crea SQL MI dentro de la nueva red virtual	Despliega Azure SQL Database Managed Instance (SQL MI) dentro de la nueva Virtual Network.
Create SQL MI con envío configurado de logs y métricas	Esta plantilla le permite implementar SQL MI y recursos adicionales que se usan para almacenar registros y métricas (área de trabajo de diagnóstico, cuenta de almacenamiento, centro de eventos).
Crea SQL MI con jumpbox dentro de una nueva red virtual	Despliega Azure SQL Database Managed Instance (SQL MI) y JumpBox con SSMS dentro de la nueva Virtual Network.
Create SQL MI con conexión punto a sitio configurada	Despliega Azure SQL Database Managed Instance (SQL MI) y la pasarela de red virtual configurada para conexión punto a sitio dentro de la nueva red virtual.
Despliega SQL Managed Instance con redes	Despliega UDR y NSG para soportar Azure SQL Managed Instance y despliega la Managed Instance

Definición de recursos de Terraform (proveedor AzAPI)

El tipo de recurso managedInstances se puede implementar con operaciones que tienen como destino:

Grupos de recursos

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

Formato de recurso

Para crear un Microsoft. Recurso Sql/managedInstances, añade el siguiente Terraform a tu plantilla.

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.Sql/managedInstances@2025-02-01-preview"
  name = "string"
  parent_id = "string"
  identity {
    type = "string"
    identity_ids = [
      "string"
    ]
  }
  location = "string"
  tags = {
    {customized property} = "string"
  }
  body = {
    properties = {
      administratorLogin = "string"
      administratorLoginPassword = "string"
      administrators = {
        administratorType = "string"
        azureADOnlyAuthentication = bool
        login = "string"
        principalType = "string"
        sid = "string"
        tenantId = "string"
      }
      authenticationMetadata = "string"
      collation = "string"
      databaseFormat = "string"
      dnsZonePartner = "string"
      hybridSecondaryUsage = "string"
      instancePoolId = "string"
      isGeneralPurposeV2 = bool
      keyId = "string"
      licenseType = "string"
      maintenanceConfigurationId = "string"
      managedInstanceCreateMode = "string"
      memorySizeInGB = int
      minimalTlsVersion = "string"
      pricingModel = "string"
      primaryUserAssignedIdentityId = "string"
      proxyOverride = "string"
      publicDataEndpointEnabled = bool
      requestedBackupStorageRedundancy = "string"
      requestedLogicalAvailabilityZone = "string"
      restorePointInTime = "string"
      servicePrincipal = {
        type = "string"
      }
      sourceManagedInstanceId = "string"
      storageIOps = int
      storageSizeInGB = int
      storageThroughputMBps = int
      subnetId = "string"
      timezoneId = "string"
      vCores = int
      zoneRedundant = bool
    }
    sku = {
      capacity = int
      family = "string"
      name = "string"
      size = "string"
      tier = "string"
    }
  }
}

Valores de propiedad

Microsoft. Sql/Instancias gestionadas

Name	Description	Value
identity	La identidad de Azure Active Directory de la instancia gestionada.	ResourceIdentity
location	Ubicación geográfica donde reside el recurso	string (obligatorio)
name	El nombre del recurso	string (obligatorio)
properties	Propiedades de recursos.	ManagedInstanceProperties
sku	SKU de instancia administrada. Valores permitidos para sku.name: GP_Gen5 (uso general, serie estándar); GP_G8IM (Propósito general, serie Premium); GP_G8IH (Propósito general, memoria de la serie Premium optimizada); BC_Gen5 (Crítico para el negocio, Standard-Series); BC_G8IM (Business Critical, serie Premium); BC_G8IH (Crítico para la empresa, optimizado para la memoria de la serie Premium).	Sku
tags	Etiquetas de recursos	Diccionario de nombres y valores de etiqueta.
type	El tipo de recurso	"Microsoft. Vista previa sql/managedInstances@2025-02-01"

ManagedInstanceExternalAdministrator

Name	Description	Value
administratorType	Tipo del administrador del servidor.	'ActiveDirectory'
azureADOnlyAuthentication	Solo Azure Active Directory Autenticación habilitada.	bool
login	Nombre de inicio de sesión del administrador del servidor.	string
principalType	Tipo de entidad de seguridad del administrador del servidor.	'Application' 'Group' 'User'
sid	SID (id. de objeto) del administrador del servidor.	string Constraints: Longitud mínima = 36 Longitud máxima = 36 Patrón = `^[0-9a-fA-F]{8}-([0-9a-fA-F]{4}-){3}[0-9a-fA-F]{12}$`
tenantId	Identificador de inquilino del administrador.	string Constraints: Longitud mínima = 36 Longitud máxima = 36 Patrón = `^[0-9a-fA-F]{8}-([0-9a-fA-F]{4}-){3}[0-9a-fA-F]{12}$`

ManagedInstanceProperties

Name	Description	Value
administratorLogin	Nombre de usuario del administrador para la instancia administrada. Solo se puede especificar cuando se crea la instancia administrada (y es necesaria para la creación).	string
administratorLoginPassword	La contraseña de inicio de sesión del administrador (necesaria para la creación de la instancia administrada).	string Constraints: Valor confidencial. Pase como parámetro seguro.
administrators	El administrador de Azure Active Directory puede utilizarse durante la creación de instancias y para actualizaciones de instancias, excepto la propiedad azureADOnlyAuthentication. Para actualizar la propiedad azureADOnlyAuthentication, se debe usar una API individual.	ManagedInstanceExternalAdministrator
authenticationMetadata	Modo de búsqueda de metadatos de autenticación de la instancia administrada.	'AzureAD' 'Paired' 'Windows'
collation	Intercalación de la instancia administrada.	string
databaseFormat	Especifica el formato interno de las bases de datos de instancia específicas de la versión del motor de SQL.	'AlwaysUpToDate' 'SQLServer2022' 'SQLServer2025'
dnsZonePartner	Identificador de recurso de otra instancia administrada cuya zona DNS compartirá esta instancia administrada después de la creación.	string
hybridSecondaryUsage	Uso secundario híbrido. Los valores posibles son "Activo" (valor predeterminado) y "Pasivo" (el cliente usa la secundaria como recuperación ante desastres pasivas).	'Active' 'Passive'
instancePoolId	Identificador del grupo de instancias al que pertenece este servidor administrado.	string
isGeneralPurposeV2	Indica si se trata de una variante GPv2 de la edición De uso general.	bool
keyId	URI de CMK de la clave que se va a usar para el cifrado.	string
licenseType	Tipo de licencia. Los valores posibles son "LicenseIncluded" (precio normal incluido de una nueva licencia de SQL) y "BasePrice" (precio de AHB con descuento para traer sus propias licencias sql).	'BasePrice' 'LicenseIncluded'
maintenanceConfigurationId	Especifica el identificador de configuración de mantenimiento que se aplicará a esta instancia administrada.	string
managedInstanceCreateMode	Especifica el modo de creación de la base de datos. Valor predeterminado: creación de instancias normales. Restaurar: crea una instancia restaurando un conjunto de copias de seguridad a un momento dado específico. Se debe especificar RestorePointInTime y SourceManagedInstanceId.	'Default' 'PointInTimeRestore'
memorySizeInGB	Tamaño de la memoria en GB. Valor mínimo: 28. Valor máximo: 870. El valor mínimo y máximo depende del número de núcleos virtuales y del nivel de servicio. Lea más sobre los límites de recursos: https://aka.ms/mi-resource-limits-api.	int
minimalTlsVersion	Versión mínima de TLS. Valores permitidos: 'None', '1.0', '1.1', '1.2'	string
pricingModel	Modelo de precios de Managed Instance.	'Freemium' 'Regular'
primaryUserAssignedIdentityId	Identificador de recurso de una identidad asignada por el usuario que se va a usar de forma predeterminada.	string
proxyOverride	Tipo de conexión que se usa para conectarse a la instancia.	'Default' 'Proxy' 'Redirect'
publicDataEndpointEnabled	Si el punto de conexión de datos público está habilitado o no.	bool
requestedBackupStorageRedundancy	Tipo de cuenta de almacenamiento que se va a usar para almacenar copias de seguridad para esta instancia. Las opciones son Local (LocallyRedundantStorage), Zone (ZoneRedundantStorage), Geo (GeoRedundantStorage) y GeoZone(GeoZoneRedundantStorage)	'Geo' 'GeoZone' 'Local' 'Zone'
requestedLogicalAvailabilityZone	Especifica la zona de disponibilidad lógica a la que está fijada Managed Instance.	'1' '2' '3' 'NoPreference'
restorePointInTime	Especifica el momento dado (ISO8601 formato) de la base de datos de origen que se restaurará para crear la nueva base de datos.	string
servicePrincipal	La entidad de servicio de la instancia administrada.	ServicePrincipal
sourceManagedInstanceId	Identificador de recurso de la instancia administrada de origen asociada a la operación de creación de esta instancia.	string
storageIOps	IOps de almacenamiento. Valor mínimo: 300. Valor máximo: 80000. Solo se permiten incrementos de 1 IOps. El valor máximo depende de la familia de hardware seleccionada y del número de núcleos virtuales.	int
storageSizeInGB	Tamaño de almacenamiento en GB. Valor mínimo: 32. Valor máximo: 32768. Solo se permiten incrementos de 32 GB. El valor máximo depende de la familia de hardware seleccionada y del número de núcleos virtuales.	int
storageThroughputMBps	El parámetro MBps de rendimiento de almacenamiento no se admite en la operación de creación o actualización de la instancia.	int
subnetId	Identificador de recurso de subred para la instancia administrada.	string
timezoneId	Id. de la zona horaria. Los valores permitidos son zonas horarias soportadas por Windows. Windows guarda los detalles de las zonas horarias soportadas, incluido el id, en el registro bajo KEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows NT\CurrentVersion\Time Zones. Puedes obtener esos valores de registro a través de SQL Server consultando el nombre SELECT COMO timezone_id DESDE sys.time_zone_info. También se puede obtener la lista de identificadores ejecutando [System.TimeZoneInfo]::GetSystemTimeZones() en PowerShell. Un ejemplo de identificador de zona horaria válido es "Hora estándar del Pacífico" o "W. Hora estándar de Europa".	string
vCores	Número de núcleos virtuales. Valores permitidos: 4, 6, 8, 10, 12, 16, 20, 24, 32, 40, 48, 56, 64, 80, 96, 128. Los núcleos virtuales admitidos dependen de la familia de hardware y el nivel de servicio seleccionados.	int
zoneRedundant	Si la redundancia de zona está habilitada o no.	bool

ResourceIdentity

Name	Description	Value
type	Tipo de identidad. Configura esto en 'SystemAssigned' para crear y asignar automáticamente un principal de Azure Active Directory para el recurso.	'None' 'SystemAssigned' 'SystemAssigned,UserAssigned' 'UserAssigned'
userAssignedIdentities	Identificadores de recursos de las identidades asignadas por el usuario que se van a usar	ResourceIdentityUserAssignedIdentities

ResourceIdentityUserAssignedIdentities

Name	Description	Value

ServicePrincipal

Name	Description	Value
type	Tipo de entidad de servicio.	'None' 'SystemAssigned'

Sku

Name	Description	Value
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 de número, por ejemplo, P3.	string (obligatorio)
size	Tamaño de la SKU determinada	string
tier	Nivel o edición de la SKU concreta, por ejemplo, Básico, Premium.	string

TrackedResourceTags

Name	Description	Value

UserIdentity

Name	Description	Value

Ejemplos de uso

Módulos comprobados de Azure

Los siguientes módulos verificados Azure pueden usarse para desplegar este tipo de recurso.

Module	Description
Instancia gestionada de SQL	Módulo de Recursos AVM para SQL Managed Instance

Comentarios

¿Le ha resultado útil esta página?

Last updated on 2026-04-14

Microsoft. Instancias gestionadas de SQL

Definición de recurso Bicep

Formato de recurso

Valores de propiedad

Microsoft. Sql/Instancias gestionadas

ManagedInstanceExternalAdministrator

ManagedInstanceProperties

ResourceIdentity

ResourceIdentityUserAssignedIdentities

ServicePrincipal

Sku

TrackedResourceTags

UserIdentity

Ejemplos de uso

Módulos comprobados de Azure

Azure Quickstart Samples

Definición de recursos de plantilla de ARM

Formato de recurso

Valores de propiedad

Microsoft. Sql/Instancias gestionadas

ManagedInstanceExternalAdministrator

ManagedInstanceProperties

ResourceIdentity

ResourceIdentityUserAssignedIdentities

ServicePrincipal

Sku

TrackedResourceTags

UserIdentity

Ejemplos de uso

Plantillas de inicio rápido de Azure

Definición de recursos de Terraform (proveedor AzAPI)

Formato de recurso

Valores de propiedad

Microsoft. Sql/Instancias gestionadas

ManagedInstanceExternalAdministrator

ManagedInstanceProperties

ResourceIdentity

ResourceIdentityUserAssignedIdentities

ServicePrincipal

Sku

TrackedResourceTags

UserIdentity

Ejemplos de uso

Módulos comprobados de Azure

Comentarios

Recursos adicionales