Microsoft. Sql gestionadoInstancias 2025-01-01

Definición de recurso Bicep

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

Grupos de recursos - Véase grupos de recursos c1

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-01-01' = {
  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

Nombre	Descripción	Importancia
identity	La identidad de Azure Active Directory de la instancia gestionada.	resourceIdentity
location	Ubicación geográfica donde reside el recurso	string (obligatorio)
nombre	El nombre del recurso	string (obligatorio)
Propiedades	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
etiquetas	Etiquetas de recursos	Diccionario de nombres y valores de etiqueta. Consulta c0 en las plantillas

ManagedInstanceExternalAdministrator

Nombre	Descripción	Importancia
administratorType	Tipo del administrador del servidor.	'ActiveDirectory'
azureADOnlyAuthentication	Solo Azure Active Directory Autenticación habilitada.	bool
Iniciar sesión	Nombre de inicio de sesión del administrador del servidor.	cuerda / cadena
tipoPrincipal	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

Nombre	Descripción	Importancia
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).	cuerda / cadena
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.	cuerda / cadena
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.	cuerda / cadena
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.	cuerda / cadena
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.	cuerda / cadena
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.	cuerda / cadena
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'	cuerda / cadena
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.	cuerda / cadena
proxyOverride	Tipo de conexión que se usa para conectarse a la instancia.	'Default' 'Proxy' "Redireccionamiento"
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.	cuerda / cadena
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.	cuerda / cadena
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.	cuerda / cadena
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".	cuerda / cadena
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
zoneRedundante	Si la redundancia de zona está habilitada o no.	bool

ResourceIdentity

Nombre	Descripción	Importancia
tipo	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' 'Asignado por el usuario'
userAssignedIdentities	Identificadores de recursos de las identidades asignadas por el usuario que se van a usar	ResourceIdentityUserAssignedIdentities

ResourceIdentityUserAssignedIdentities

Nombre	Descripción	Importancia

ServicePrincipal

Nombre	Descripción	Importancia
tipo	Tipo de entidad de servicio.	'None' 'SystemAssigned'

Sku

Nombre	Descripción	Importancia
capacidad	Capacidad de la SKU determinada.	int
family	Si el servicio tiene diferentes generaciones de hardware, para la misma SKU, se puede capturar aquí.	cuerda / cadena
nombre	El nombre de la SKU, normalmente, una letra + código de número, por ejemplo, P3.	string (obligatorio)
tamaño	Tamaño de la SKU determinada	cuerda / cadena
nivel	Nivel o edición de la SKU concreta, por ejemplo, Básico, Premium.	cuerda / cadena

TrackedResourceTags

Nombre	Descripción	Importancia

UserIdentity

Nombre	Descripción	Importancia

Ejemplos de uso

Módulos comprobados de Azure

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

Módulo	Descripción
Instancia gestionada de SQL	Módulo de Recursos AVM para SQL Managed Instance

Ejemplos de inicio rápido de Azure

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

Archivo Bicep	Descripción
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 - Véase grupos de recursos c1

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-01-01",
  "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

Nombre	Descripción	Importancia
apiVersion	La versión de api	'2025-01-01'
identity	La identidad de Azure Active Directory de la instancia gestionada.	resourceIdentity
location	Ubicación geográfica donde reside el recurso	string (obligatorio)
nombre	El nombre del recurso	string (obligatorio)
Propiedades	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
etiquetas	Etiquetas de recursos	Diccionario de nombres y valores de etiqueta. Consulta c0 en las plantillas
tipo	El tipo de recurso	'Microsoft. Sql/gestionadoInstants

ManagedInstanceExternalAdministrator

Nombre	Descripción	Importancia
administratorType	Tipo del administrador del servidor.	'ActiveDirectory'
azureADOnlyAuthentication	Solo Azure Active Directory Autenticación habilitada.	bool
Iniciar sesión	Nombre de inicio de sesión del administrador del servidor.	cuerda / cadena
tipoPrincipal	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

Nombre	Descripción	Importancia
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).	cuerda / cadena
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.	cuerda / cadena
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.	cuerda / cadena
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.	cuerda / cadena
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.	cuerda / cadena
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.	cuerda / cadena
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'	cuerda / cadena
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.	cuerda / cadena
proxyOverride	Tipo de conexión que se usa para conectarse a la instancia.	'Default' 'Proxy' "Redireccionamiento"
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.	cuerda / cadena
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.	cuerda / cadena
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.	cuerda / cadena
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".	cuerda / cadena
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
zoneRedundante	Si la redundancia de zona está habilitada o no.	bool

ResourceIdentity

Nombre	Descripción	Importancia
tipo	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' 'Asignado por el usuario'
userAssignedIdentities	Identificadores de recursos de las identidades asignadas por el usuario que se van a usar	ResourceIdentityUserAssignedIdentities

ResourceIdentityUserAssignedIdentities

Nombre	Descripción	Importancia

ServicePrincipal

Nombre	Descripción	Importancia
tipo	Tipo de entidad de servicio.	'None' 'SystemAssigned'

Sku

Nombre	Descripción	Importancia
capacidad	Capacidad de la SKU determinada.	int
family	Si el servicio tiene diferentes generaciones de hardware, para la misma SKU, se puede capturar aquí.	cuerda / cadena
nombre	El nombre de la SKU, normalmente, una letra + código de número, por ejemplo, P3.	string (obligatorio)
tamaño	Tamaño de la SKU determinada	cuerda / cadena
nivel	Nivel o edición de la SKU concreta, por ejemplo, Básico, Premium.	cuerda / cadena

TrackedResourceTags

Nombre	Descripción	Importancia

UserIdentity

Nombre	Descripción	Importancia

Ejemplos de uso

Plantillas de inicio rápido de Azure

Las siguientes plantillas Azure Quickstart despliegan este tipo de recurso.

Plantilla	Descripción
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-01-01"
  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

Nombre	Descripción	Importancia
identity	La identidad de Azure Active Directory de la instancia gestionada.	resourceIdentity
location	Ubicación geográfica donde reside el recurso	string (obligatorio)
nombre	El nombre del recurso	string (obligatorio)
Propiedades	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
etiquetas	Etiquetas de recursos	Diccionario de nombres y valores de etiqueta.
tipo	El tipo de recurso	"Microsoft. Sql/managedInstances@2025-01-01"

ManagedInstanceExternalAdministrator

Nombre	Descripción	Importancia
administratorType	Tipo del administrador del servidor.	'ActiveDirectory'
azureADOnlyAuthentication	Solo Azure Active Directory Autenticación habilitada.	bool
Iniciar sesión	Nombre de inicio de sesión del administrador del servidor.	cuerda / cadena
tipoPrincipal	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

Nombre	Descripción	Importancia
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).	cuerda / cadena
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.	cuerda / cadena
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.	cuerda / cadena
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.	cuerda / cadena
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.	cuerda / cadena
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.	cuerda / cadena
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'	cuerda / cadena
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.	cuerda / cadena
proxyOverride	Tipo de conexión que se usa para conectarse a la instancia.	'Default' 'Proxy' "Redireccionamiento"
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.	cuerda / cadena
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.	cuerda / cadena
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.	cuerda / cadena
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".	cuerda / cadena
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
zoneRedundante	Si la redundancia de zona está habilitada o no.	bool

ResourceIdentity

Nombre	Descripción	Importancia
tipo	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' 'Asignado por el usuario'
userAssignedIdentities	Identificadores de recursos de las identidades asignadas por el usuario que se van a usar	ResourceIdentityUserAssignedIdentities

ResourceIdentityUserAssignedIdentities

Nombre	Descripción	Importancia

ServicePrincipal

Nombre	Descripción	Importancia
tipo	Tipo de entidad de servicio.	'None' 'SystemAssigned'

Sku

Nombre	Descripción	Importancia
capacidad	Capacidad de la SKU determinada.	int
family	Si el servicio tiene diferentes generaciones de hardware, para la misma SKU, se puede capturar aquí.	cuerda / cadena
nombre	El nombre de la SKU, normalmente, una letra + código de número, por ejemplo, P3.	string (obligatorio)
tamaño	Tamaño de la SKU determinada	cuerda / cadena
nivel	Nivel o edición de la SKU concreta, por ejemplo, Básico, Premium.	cuerda / cadena

TrackedResourceTags

Nombre	Descripción	Importancia

UserIdentity

Nombre	Descripción	Importancia

Ejemplos de uso

Módulos comprobados de Azure

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

Módulo	Descripción
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-13

Microsoft. Sql gestionadoInstancias 2025-01-01

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

Ejemplos de inicio rápido de Azure

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