Microsoft.Sql managedInstances

Definición de recursos de Bicep

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

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

Formato de recurso

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

resource symbolicname 'Microsoft.Sql/managedInstances@2024-11-01-preview' = {
  scope: resourceSymbolicName or scope
  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/managedInstances

Name	Description	Value
identity	Identidad de Azure Active Directory de la instancia administrada.	ResourceIdentity
location	Ubicación del recurso.	string (obligatorio)
name	El nombre del recurso	string (obligatorio)
properties	Propiedades de recursos.	ManagedInstanceProperties
scope	Use al crear un recurso en un ámbito diferente del ámbito de implementación.	Establezca esta propiedad en el nombre simbólico de un recurso para aplicar el recurso de extensión .
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	Autenticación solo de Azure Active Directory 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 se puede utilizar durante la creación de instancias y para las actualizaciones de instancias, excepto para 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 Instancia administrada.	'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á anclada Instancia administrada.	'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 compatibles con Windows. Windows mantiene detalles sobre las zonas horarias admitidas, incluido el identificador, en el registro en KEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows NT\CurrentVersion\Time Zones. Para obtener esos valores del Registro a través de SQL Server, consulte SELECT name AS timezone_id FROM 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. Establézcalo en "SystemAssigned" para crear y asignar automáticamente una entidad de seguridad 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 comprobados de Azure se pueden usar para implementar este tipo de recurso.

Module	Description
Instancia administrada de SQL	Módulo de recursos de AVM para SQL Managed Instance

Ejemplos de inicio rápido de Azure

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

Archivo de Bicep	Description
Crear MI de SQL dentro de la nueva red virtual	Implemente Instancia administrada de Azure Sql Database (SQL MI) dentro de una nueva red virtual.

Definición de recursos de plantilla de ARM

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

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

Formato de recurso

Para crear un recurso Microsoft.Sql/managedInstances, agregue el siguiente JSON a la plantilla.

{
  "type": "Microsoft.Sql/managedInstances",
  "apiVersion": "2024-11-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/managedInstances

Name	Description	Value
apiVersion	La versión de api	'2024-11-01-preview'
identity	Identidad de Azure Active Directory de la instancia administrada.	ResourceIdentity
location	Ubicación del 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/managedInstances'

ManagedInstanceExternalAdministrator

Name	Description	Value
administratorType	Tipo del administrador del servidor.	'ActiveDirectory'
azureADOnlyAuthentication	Autenticación solo de Azure Active Directory 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 se puede utilizar durante la creación de instancias y para las actualizaciones de instancias, excepto para 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 Instancia administrada.	'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á anclada Instancia administrada.	'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 compatibles con Windows. Windows mantiene detalles sobre las zonas horarias admitidas, incluido el identificador, en el registro en KEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows NT\CurrentVersion\Time Zones. Para obtener esos valores del Registro a través de SQL Server, consulte SELECT name AS timezone_id FROM 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. Establézcalo en "SystemAssigned" para crear y asignar automáticamente una entidad de seguridad 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

Los siguientes plantillas de inicio rápido de Azure implementar este tipo de recurso.

Template	Description
Crear MI de SQL dentro de la nueva red virtual	Implemente Instancia administrada de Azure Sql Database (SQL MI) dentro de una nueva red virtual.
Crear MI de SQL con el envío configurado de registros 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).
Crear MI de SQL con jumpbox dentro de una nueva red virtual	Implemente Instancia administrada de Azure Sql Database (SQL MI) y JumpBox con SSMS dentro de una nueva red virtual.
Crear MI de SQL con conexión de punto a sitio configurada	Implemente Instancia administrada de Azure Sql Database (SQL MI) y puerta de enlace de red virtual configurada para la conexión de punto a sitio dentro de la nueva red virtual.
Implementación de SQL Managed Instance con redes	Implementación de UDR y NSG para admitir Azure SQL Managed Instance e implementar la instancia administrada

Definición de recursos de Terraform (proveedor AzAPI)

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

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

Formato de recurso

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

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.Sql/managedInstances@2024-11-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/managedInstances

Name	Description	Value
identity	Identidad de Azure Active Directory de la instancia administrada.	ResourceIdentity
location	Ubicación del recurso.	string (obligatorio)
name	El nombre del recurso	string (obligatorio)
parent_id	Identificador del recurso al que se va a aplicar este recurso de extensión.	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.Sql/managedInstances@2024-11-01-preview"

ManagedInstanceExternalAdministrator

Name	Description	Value
administratorType	Tipo del administrador del servidor.	'ActiveDirectory'
azureADOnlyAuthentication	Autenticación solo de Azure Active Directory 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 se puede utilizar durante la creación de instancias y para las actualizaciones de instancias, excepto para 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 Instancia administrada.	'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á anclada Instancia administrada.	'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 compatibles con Windows. Windows mantiene detalles sobre las zonas horarias admitidas, incluido el identificador, en el registro en KEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows NT\CurrentVersion\Time Zones. Para obtener esos valores del Registro a través de SQL Server, consulte SELECT name AS timezone_id FROM 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. Establézcalo en "SystemAssigned" para crear y asignar automáticamente una entidad de seguridad 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 comprobados de Azure se pueden usar para implementar este tipo de recurso.

Module	Description
Instancia administrada de SQL	Módulo de recursos de AVM para SQL Managed Instance

Comentarios

¿Le ha resultado útil esta página?

Last updated on 2025-07-29

Compartir a través de

Microsoft.Sql managedInstances

Definición de recursos de Bicep

Formato de recurso

Valores de propiedad

Microsoft.Sql/managedInstances

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/managedInstances

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/managedInstances

ManagedInstanceExternalAdministrator

ManagedInstanceProperties

ResourceIdentity

ResourceIdentityUserAssignedIdentities

ServicePrincipal

Sku

TrackedResourceTags

UserIdentity

Ejemplos de uso

Módulos comprobados de Azure

Comentarios

Recursos adicionales