Microsoft.SqlVirtualMachine sqlVirtualMachines

Artículo
02/01/2024

Definición de recursos de Bicep

El tipo de recurso sqlVirtualMachines se puede implementar en:

Grupos de recursos: consulte los comandos de implementación del grupo de recursos.

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

Formato de los recursos

Para crear un recurso Microsoft.SqlVirtualMachine/sqlVirtualMachines, agregue el siguiente bicep a la plantilla.

resource symbolicname 'Microsoft.SqlVirtualMachine/sqlVirtualMachines@2022-07-01-preview' = {
  name: 'string'
  location: 'string'
  tags: {
    tagName1: 'tagValue1'
    tagName2: 'tagValue2'
  }
  identity: {
    type: 'string'
  }
  properties: {
    assessmentSettings: {
      enable: bool
      runImmediately: bool
      schedule: {
        dayOfWeek: 'string'
        enable: bool
        monthlyOccurrence: int
        startTime: 'string'
        weeklyInterval: int
      }
    }
    autoBackupSettings: {
      backupScheduleType: 'string'
      backupSystemDbs: bool
      daysOfWeek: [
        'string'
      ]
      enable: bool
      enableEncryption: bool
      fullBackupFrequency: 'string'
      fullBackupStartTime: int
      fullBackupWindowHours: int
      logBackupFrequency: int
      password: 'string'
      retentionPeriod: int
      storageAccessKey: 'string'
      storageAccountUrl: 'string'
      storageContainerName: 'string'
    }
    autoPatchingSettings: {
      dayOfWeek: 'string'
      enable: bool
      maintenanceWindowDuration: int
      maintenanceWindowStartingHour: int
    }
    enableAutomaticUpgrade: bool
    keyVaultCredentialSettings: {
      azureKeyVaultUrl: 'string'
      credentialName: 'string'
      enable: bool
      servicePrincipalName: 'string'
      servicePrincipalSecret: 'string'
    }
    leastPrivilegeMode: 'Enabled'
    serverConfigurationsManagementSettings: {
      additionalFeaturesServerConfigurations: {
        isRServicesEnabled: bool
      }
      sqlConnectivityUpdateSettings: {
        connectivityType: 'string'
        port: int
        sqlAuthUpdatePassword: 'string'
        sqlAuthUpdateUserName: 'string'
      }
      sqlInstanceSettings: {
        collation: 'string'
        isIfiEnabled: bool
        isLpimEnabled: bool
        isOptimizeForAdHocWorkloadsEnabled: bool
        maxDop: int
        maxServerMemoryMB: int
        minServerMemoryMB: int
      }
      sqlStorageUpdateSettings: {
        diskConfigurationType: 'string'
        diskCount: int
        startingDeviceId: int
      }
      sqlWorkloadTypeUpdateSettings: {
        sqlWorkloadType: 'string'
      }
    }
    sqlImageOffer: 'string'
    sqlImageSku: 'string'
    sqlManagement: 'string'
    sqlServerLicenseType: 'string'
    sqlVirtualMachineGroupResourceId: 'string'
    storageConfigurationSettings: {
      diskConfigurationType: 'string'
      sqlDataSettings: {
        defaultFilePath: 'string'
        luns: [
          int
        ]
      }
      sqlLogSettings: {
        defaultFilePath: 'string'
        luns: [
          int
        ]
      }
      sqlSystemDbOnDataDisk: bool
      sqlTempDbSettings: {
        dataFileCount: int
        dataFileSize: int
        dataGrowth: int
        defaultFilePath: 'string'
        logFileSize: int
        logGrowth: int
        luns: [
          int
        ]
        persistFolder: bool
        persistFolderPath: 'string'
      }
      storageWorkloadType: 'string'
    }
    virtualMachineResourceId: 'string'
    wsfcDomainCredentials: {
      clusterBootstrapAccountPassword: 'string'
      clusterOperatorAccountPassword: 'string'
      sqlServiceAccountPassword: 'string'
    }
    wsfcStaticIp: 'string'
  }
}

Valores de propiedades

sqlVirtualMachines

Nombre	Descripción	Value
name	El nombre del recurso	string (obligatorio)
ubicación	Ubicación del recurso	string (obligatorio)
etiquetas	Etiquetas del recurso.	Diccionario de nombres y valores de etiqueta. Consulte Etiquetas en plantillas.
identity	Identidad de Azure Active Directory del servidor.	ResourceIdentity
properties	Propiedades de recursos.	SqlVirtualMachineProperties

ResourceIdentity

Nombre	Descripción	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.	'Ninguno' 'SystemAssigned'

SqlVirtualMachineProperties

Nombre	Descripción	Valor
assessmentSettings	Configuración de evaluación.	AssessmentSettings
autoBackupSettings	Configuración de copia de seguridad automática para SQL Server.	AutoBackupSettings
autoPatchingSettings	Configuración de aplicación automática de revisiones para aplicar actualizaciones de seguridad críticas a la máquina virtual SQL.	AutoPatchingSettings
enableAutomaticUpgrade	Habilite la actualización automática del Agente de extensión iaaS de Sql.	bool
keyVaultCredentialSettings	Configuración de credenciales del almacén de claves.	KeyVaultCredentialSettings
leastPrivilegeMode	Modo de privilegios mínimos del Agente IaaS de SQL.	'Habilitado'
serverConfigurationsManagementSettings	SQL Server opciones de administración de configuración.	ServerConfigurationsManagementSettings
sqlImageOffer	Oferta de imagen de SQL. Algunos ejemplos son SQL2016-WS2016, SQL2017-WS2016.	string
sqlImageSku	SQL Server tipo de edición.	"Desarrollador" 'Enterprise' 'Express' 'Estándar' 'Web'
sqlManagement	SQL Server Tipo de administración.	'Full' 'LightWeight' 'NoAgent'
sqlServerLicenseType	SQL Server tipo de licencia.	'AHUB' 'DR' 'PAYG'
sqlVirtualMachineGroupResourceId	Identificador de recurso de ARM del grupo de máquinas virtuales DE SQL de la que forma parte o formará parte.	string
storageConfigurationSettings	Opciones de configuración de almacenamiento.	StorageConfigurationSettings
virtualMachineResourceId	Id. de recurso de ARM de la máquina virtual subyacente creada a partir de la imagen de SQL Marketplace.	string
wsfcDomainCredentials	Credenciales de dominio para configurar el clúster de conmutación por error de Windows Server para el grupo de disponibilidad de SQL.	WsfcDomainCredentials
wsfcStaticIp	Credenciales de dominio para configurar el clúster de conmutación por error de Windows Server para el grupo de disponibilidad de SQL.	string

AssessmentSettings

Nombre	Descripción	Valor
enable	Habilite o deshabilite la característica de evaluación en la máquina virtual SQL.	bool
runImmediately	Ejecute la evaluación inmediatamente en la máquina virtual SQL.	bool
schedule	Programación para la evaluación.	Programación

Programación

Nombre	Descripción	Valor
dayOfWeek	Día de la semana para ejecutar la evaluación.	'Viernes' 'Lunes' "Sábado" 'Domingo' 'Jueves' 'Martes' 'Miércoles'
enable	Habilite o deshabilite la programación de evaluación en la máquina virtual SQL.	bool
monthlyOccurrence	Repetición del día DayOfWeek en un mes para programar la evaluación. Toma valores: 1,2,3,4 y -1. Use -1 para el último día dayOfWeek del mes.	int
startTime	Hora del día en formato HH:mm. Eg. 17:30	string
weeklyInterval	Número de semanas que se programan entre 2 ejecuciones de evaluación. Toma el valor de 1 a 6	int

AutoBackupSettings

Nombre	Descripción	Valor
backupScheduleType	Tipo de programación de copia de seguridad.	"Automatizado" 'Manual'
backupSystemDbs	Incluya o excluya las bases de datos del sistema de la copia de seguridad automática.	bool
daysOfWeek	Días de la semana para las copias de seguridad cuando FullBackupFrequency está establecido en Weekly.	Matriz de cadenas que contiene cualquiera de: 'Viernes' 'Lunes' "Sábado" 'Domingo' 'Jueves' 'Martes' 'Miércoles'
enable	Habilite o deshabilite la devolución de seguridad automática en la máquina virtual SQL.	bool
enableEncryption	Habilite o deshabilite el cifrado para la copia de seguridad en la máquina virtual SQL.	bool
fullBackupFrequency	Frecuencia de las copias de seguridad completas. En ambos casos, las copias de seguridad completas se inician durante el siguiente período de tiempo programado.	'Diario' 'Semanal'
fullBackupStartTime	Hora de inicio de un día determinado durante el cual se pueden realizar copias de seguridad completas. 0-23 horas.	int
fullBackupWindowHours	Duración del período de tiempo de un día determinado durante el cual se pueden realizar copias de seguridad completas. 1-23 horas.	int
logBackupFrequency	Frecuencia de las copias de seguridad de registros. 5-60 minutos.	int
password	Contraseña para el cifrado en la copia de seguridad.	string
retentionPeriod	Período de retención de la copia de seguridad: 1-90 días.	int
storageAccessKey	Clave de cuenta de almacenamiento en la que se realizará la copia de seguridad.	string
storageAccountUrl	Dirección URL de la cuenta de almacenamiento a la que se realizará la copia de seguridad.	string
storageContainerName	Nombre del contenedor de almacenamiento en el que se realizará la copia de seguridad.	string

AutoPatchingSettings

Nombre	Descripción	Valor
dayOfWeek	Día de la semana en el que se aplicará la revisión.	'Todos los días' 'Viernes' "Lunes" 'Sábado' 'Domingo' 'Jueves' "Martes" 'Miércoles'
enable	Habilite o deshabilite el autopatching en la máquina virtual SQL.	bool
maintenanceWindowDuration	Duración de la aplicación de revisiones.	int
maintenanceWindowStartingHour	Hora del día en que se inicia la aplicación de revisiones. Hora de la máquina virtual local.	int

KeyVaultCredentialSettings

Nombre	Descripción	Valor
azureKeyVaultUrl	Dirección URL de Azure Key Vault.	string
credentialName	Nombre de la credencial.	string
enable	Habilite o deshabilite la configuración de credenciales del almacén de claves.	bool
servicePrincipalName	Nombre de la entidad de seguridad de servicio para acceder al almacén de claves.	string
servicePrincipalSecret	Secreto de nombre de entidad de seguridad de servicio para acceder al almacén de claves.	string

ServerConfigurationsManagementSettings

Nombre	Descripción	Valor
additionalFeaturesServerConfigurations	Configuración adicional de características de SQL.	AdditionalFeaturesServerConfigurations
sqlConnectivityUpdateSettings	Configuración del tipo de conectividad de SQL.	SqlConnectivityUpdateSettings
sqlInstanceSettings	Configuración de la instancia de SQL.	SQLInstanceSettings
sqlStorageUpdateSettings	Configuración de actualización de almacenamiento de SQL.	SqlStorageUpdateSettings
sqlWorkloadTypeUpdateSettings	Configuración del tipo de carga de trabajo de SQL.	SqlWorkloadTypeUpdateSettings

AdditionalFeaturesServerConfigurations

Nombre	Descripción	Valor
isRServicesEnabled	Habilite o deshabilite los servicios de R (SQL 2016 y versiones posteriores).	bool

SqlConnectivityUpdateSettings

Nombre	Descripción	Valor
connectivityType	SQL Server opción de conectividad.	'LOCAL' "PRIVATE" 'PUBLIC'
port	SQL Server puerto.	int
sqlAuthUpdatePassword	SQL Server contraseña de inicio de sesión de sysadmin.	string
sqlAuthUpdateUserName	SQL Server inicio de sesión sysadmin que se va a crear.	string

SQLInstanceSettings

Nombre	Descripción	Valor
collation	SQL Server intercalación.	string
isIfiEnabled	SQL Server IFI.	bool
isLpimEnabled	SQL Server LPIM.	bool
isOptimizeForAdHocWorkloadsEnabled	SQL Server Optimizar para cargas de trabajo de Adhoc.	bool
maxDop	SQL Server MAXDOP.	int
maxServerMemoryMB	SQL Server memoria máxima.	int
minServerMemoryMB	SQL Server memoria mínima.	int

SqlStorageUpdateSettings

Nombre	Descripción	Valor
diskConfigurationType	Configuración de disco que se va a aplicar a SQL Server.	'ADD' 'EXTEND' 'NEW'
diskCount	Recuento de discos de máquina virtual.	int
startingDeviceId	Id. de dispositivo del primer disco que se va a actualizar.	int

SqlWorkloadTypeUpdateSettings

Nombre	Descripción	Valor
sqlWorkloadType	SQL Server tipo de carga de trabajo.	"DW" 'GENERAL' 'OLTP'

StorageConfigurationSettings

Nombre	Descripción	Valor
diskConfigurationType	Configuración de disco que se va a aplicar a SQL Server.	'ADD' 'EXTEND' 'NEW'
sqlDataSettings	SQL Server configuración de almacenamiento de datos.	SQLStorageSettings
sqlLogSettings	SQL Server configuración de almacenamiento de registros.	SQLStorageSettings
sqlSystemDbOnDataDisk	SQL Server Almacenamiento de SystemDb en DataPool si es true.	bool
sqlTempDbSettings	SQL Server configuración de almacenamiento de TempDb.	SQLTempDbSettings
storageWorkloadType	Tipo de carga de trabajo de almacenamiento.	"DW" 'GENERAL' 'OLTP'

SQLStorageSettings

Nombre	Descripción	Valor
defaultFilePath	SQL Server ruta de acceso de archivo predeterminada	string
Luns	Números de unidad lógica para los discos.	int[]

SQLTempDbSettings

Nombre	Descripción	Valor
dataFileCount	SQL Server recuento de archivos de datos tempdb	int
dataFileSize	SQL Server tamaño del archivo de datos tempdb	int
dataGrowth	SQL Server tamaño de crecimiento automático del archivo de datos tempdb	int
defaultFilePath	SQL Server ruta de acceso de archivo predeterminada	string
logFileSize	SQL Server tamaño del archivo de registro de tempdb	int
logGrowth	SQL Server tamaño de crecimiento automático del archivo de registro de tempdb	int
Luns	Números de unidad lógica para los discos.	int[]
persistFolder	SQL Server opción de carpeta persistente de tempdb	bool
persistFolderPath	SQL Server ubicación de carpeta persistente de tempdb	string

WsfcDomainCredentials

Nombre	Descripción	Valor
clusterBootstrapAccountPassword	Contraseña de la cuenta de arranque del clúster.	string
clusterOperatorAccountPassword	Contraseña de la cuenta del operador de clúster.	string
sqlServiceAccountPassword	Contraseña de la cuenta de servicio SQL.	string

Plantillas de inicio rápido

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

Plantilla	Descripción
Implementación del programa de instalación always ON de SQL con una Virtual Machines de SQL existente	Implemente el programa de instalación always ON de SQL con la Virtual Machines de SQL existente. Las máquinas virtuales ya deben estar unidas a un dominio existente y deben ejecutar la versión empresarial de SQL Server.
VM con SQL Server con la configuración de almacenamiento optimizada para rendimiento	Creación de una máquina virtual SQL Server con la configuración de almacenamiento optimizada para el rendimiento en PremiumSSD
Configuración de almacenamiento optimizada para el rendimiento de la máquina virtual de SQL en UltraSSD	Creación de una máquina virtual SQL Server con la configuración de almacenamiento optimizada para el rendimiento mediante UltraSSD para archivos de registro de SQL

Definición de recursos de plantilla de ARM

El tipo de recurso sqlVirtualMachines se puede implementar en:

Grupos de recursos: consulte los comandos de implementación del grupo de recursos.

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

Formato de los recursos

Para crear un recurso Microsoft.SqlVirtualMachine/sqlVirtualMachines, agregue el siguiente json a la plantilla.

{
  "type": "Microsoft.SqlVirtualMachine/sqlVirtualMachines",
  "apiVersion": "2022-07-01-preview",
  "name": "string",
  "location": "string",
  "tags": {
    "tagName1": "tagValue1",
    "tagName2": "tagValue2"
  },
  "identity": {
    "type": "string"
  },
  "properties": {
    "assessmentSettings": {
      "enable": "bool",
      "runImmediately": "bool",
      "schedule": {
        "dayOfWeek": "string",
        "enable": "bool",
        "monthlyOccurrence": "int",
        "startTime": "string",
        "weeklyInterval": "int"
      }
    },
    "autoBackupSettings": {
      "backupScheduleType": "string",
      "backupSystemDbs": "bool",
      "daysOfWeek": [ "string" ],
      "enable": "bool",
      "enableEncryption": "bool",
      "fullBackupFrequency": "string",
      "fullBackupStartTime": "int",
      "fullBackupWindowHours": "int",
      "logBackupFrequency": "int",
      "password": "string",
      "retentionPeriod": "int",
      "storageAccessKey": "string",
      "storageAccountUrl": "string",
      "storageContainerName": "string"
    },
    "autoPatchingSettings": {
      "dayOfWeek": "string",
      "enable": "bool",
      "maintenanceWindowDuration": "int",
      "maintenanceWindowStartingHour": "int"
    },
    "enableAutomaticUpgrade": "bool",
    "keyVaultCredentialSettings": {
      "azureKeyVaultUrl": "string",
      "credentialName": "string",
      "enable": "bool",
      "servicePrincipalName": "string",
      "servicePrincipalSecret": "string"
    },
    "leastPrivilegeMode": "Enabled",
    "serverConfigurationsManagementSettings": {
      "additionalFeaturesServerConfigurations": {
        "isRServicesEnabled": "bool"
      },
      "sqlConnectivityUpdateSettings": {
        "connectivityType": "string",
        "port": "int",
        "sqlAuthUpdatePassword": "string",
        "sqlAuthUpdateUserName": "string"
      },
      "sqlInstanceSettings": {
        "collation": "string",
        "isIfiEnabled": "bool",
        "isLpimEnabled": "bool",
        "isOptimizeForAdHocWorkloadsEnabled": "bool",
        "maxDop": "int",
        "maxServerMemoryMB": "int",
        "minServerMemoryMB": "int"
      },
      "sqlStorageUpdateSettings": {
        "diskConfigurationType": "string",
        "diskCount": "int",
        "startingDeviceId": "int"
      },
      "sqlWorkloadTypeUpdateSettings": {
        "sqlWorkloadType": "string"
      }
    },
    "sqlImageOffer": "string",
    "sqlImageSku": "string",
    "sqlManagement": "string",
    "sqlServerLicenseType": "string",
    "sqlVirtualMachineGroupResourceId": "string",
    "storageConfigurationSettings": {
      "diskConfigurationType": "string",
      "sqlDataSettings": {
        "defaultFilePath": "string",
        "luns": [ "int" ]
      },
      "sqlLogSettings": {
        "defaultFilePath": "string",
        "luns": [ "int" ]
      },
      "sqlSystemDbOnDataDisk": "bool",
      "sqlTempDbSettings": {
        "dataFileCount": "int",
        "dataFileSize": "int",
        "dataGrowth": "int",
        "defaultFilePath": "string",
        "logFileSize": "int",
        "logGrowth": "int",
        "luns": [ "int" ],
        "persistFolder": "bool",
        "persistFolderPath": "string"
      },
      "storageWorkloadType": "string"
    },
    "virtualMachineResourceId": "string",
    "wsfcDomainCredentials": {
      "clusterBootstrapAccountPassword": "string",
      "clusterOperatorAccountPassword": "string",
      "sqlServiceAccountPassword": "string"
    },
    "wsfcStaticIp": "string"
  }
}

Valores de propiedades

sqlVirtualMachines

Nombre	Descripción	Value
type	Tipo de recurso	'Microsoft.SqlVirtualMachine/sqlVirtualMachines'
apiVersion	La versión de la API de recursos	"2022-07-01-preview"
name	El nombre del recurso	string (obligatorio)
ubicación	Ubicación del recurso	string (obligatorio)
etiquetas	Etiquetas del recurso.	Diccionario de nombres y valores de etiqueta. Consulte Etiquetas en plantillas.
identity	Identidad de Azure Active Directory del servidor.	ResourceIdentity
properties	Propiedades del recurso.	SqlVirtualMachineProperties

ResourceIdentity

Nombre	Descripción	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.	'Ninguno' 'SystemAssigned'

SqlVirtualMachineProperties

Nombre	Descripción	Valor
assessmentSettings	Configuración de evaluación.	AssessmentSettings
autoBackupSettings	Configuración de copia de seguridad automática para SQL Server.	AutoBackupSettings
autoPatchingSettings	Configuración de aplicación automática de revisiones para aplicar actualizaciones de seguridad críticas a la máquina virtual de SQL.	AutoPatchingSettings
enableAutomaticUpgrade	Habilite la actualización automática del Agente de extensión iaaS de Sql.	bool
keyVaultCredentialSettings	Configuración de credenciales del almacén de claves.	KeyVaultCredentialSettings
leastPrivilegeMode	Modo de privilegios mínimos del Agente IaaS de SQL.	'Habilitado'
serverConfigurationsManagementSettings	SQL Server opciones de administración de configuración.	ServerConfigurationsManagementSettings
sqlImageOffer	Oferta de imagen de SQL. Algunos ejemplos son SQL2016-WS2016, SQL2017-WS2016.	string
sqlImageSku	SQL Server tipo de edición.	"Desarrollador" "Enterprise" 'Express' 'Estándar' 'Web'
sqlManagement	SQL Server Tipo de administración.	'Full' 'LightWeight' 'NoAgent'
sqlServerLicenseType	SQL Server tipo de licencia.	'AHUB' "DR" 'PAYG'
sqlVirtualMachineGroupResourceId	Identificador de recurso de ARM del grupo de máquinas virtuales de SQL de la que forma parte esta máquina virtual de SQL.	string
storageConfigurationSettings	Opciones de configuración de almacenamiento.	StorageConfigurationSettings
virtualMachineResourceId	Identificador de recurso de ARM de la máquina virtual subyacente creada a partir de la imagen de Marketplace de SQL.	string
wsfcDomainCredentials	Credenciales de dominio para configurar el clúster de conmutación por error de Windows Server para el grupo de disponibilidad de SQL.	WsfcDomainCredentials
wsfcStaticIp	Credenciales de dominio para configurar el clúster de conmutación por error de Windows Server para el grupo de disponibilidad de SQL.	string

AssessmentSettings

Nombre	Descripción	Valor
enable	Habilite o deshabilite la característica de evaluación en la máquina virtual SQL.	bool
runImmediately	Ejecute la evaluación inmediatamente en la máquina virtual SQL.	bool
schedule	Programación para la evaluación.	Programación

Programación

Nombre	Descripción	Valor
dayOfWeek	Día de la semana para ejecutar la evaluación.	'Viernes' "Lunes" 'Sábado' 'Domingo' 'Jueves' "Martes" 'Miércoles'
enable	Habilite o deshabilite la programación de evaluación en la máquina virtual SQL.	bool
monthlyOccurrence	Repetición del día DayOfWeek en un mes para programar la evaluación. Toma valores: 1,2,3,4 y -1. Use -1 para el último día dayOfWeek del mes.	int
startTime	Hora del día en formato HH:mm. Eg. 17:30	string
weeklyInterval	Número de semanas que se van a programar entre 2 ejecuciones de evaluación. Toma el valor de 1 a 6	int

AutoBackupSettings

Nombre	Descripción	Valor
backupScheduleType	Tipo de programación de copia de seguridad.	"Automatizado" 'Manual'
backupSystemDbs	Incluya o excluya las bases de datos del sistema de la copia de seguridad automática.	bool
daysOfWeek	Días de la semana para las copias de seguridad cuando FullBackupFrequency está establecido en Semanal.	Matriz de cadenas que contiene cualquiera de: 'Viernes' "Lunes" 'Sábado' 'Domingo' 'Jueves' "Martes" 'Miércoles'
enable	Habilite o deshabilite la devolución automática en la máquina virtual DE SQL.	bool
enableEncryption	Habilite o deshabilite el cifrado para la copia de seguridad en la máquina virtual SQL.	bool
fullBackupFrequency	Frecuencia de las copias de seguridad completas. En ambos casos, las copias de seguridad completas se inician durante el siguiente período de tiempo programado.	'Daily' "Semanal"
fullBackupStartTime	Hora de inicio de un día determinado durante el cual se pueden realizar copias de seguridad completas. De 0 a 23 horas.	int
fullBackupWindowHours	Duración del período de tiempo de un día determinado durante el cual se pueden realizar copias de seguridad completas. De 1 a 23 horas.	int
logBackupFrequency	Frecuencia de las copias de seguridad de registros. De 5 a 60 minutos.	int
password	Contraseña para el cifrado en la copia de seguridad.	string
retentionPeriod	Período de retención de la copia de seguridad: de 1 a 90 días.	int
storageAccessKey	Clave de la cuenta de almacenamiento en la que se realizará la copia de seguridad.	string
storageAccountUrl	Dirección URL de la cuenta de almacenamiento a la que se realizará la copia de seguridad.	string
storageContainerName	Nombre del contenedor de almacenamiento en el que se realizará la copia de seguridad.	string

AutoPatchingSettings

Nombre	Descripción	Valor
dayOfWeek	Día de la semana en el que se aplicará la revisión.	'Todos los días' 'Viernes' "Lunes" 'Sábado' 'Domingo' 'Jueves' "Martes" 'Miércoles'
enable	Habilite o deshabilite el autopatching en la máquina virtual SQL.	bool
maintenanceWindowDuration	Duración de la aplicación de revisiones.	int
maintenanceWindowStartingHour	Hora del día en que se inicia la aplicación de revisiones. Hora de la máquina virtual local.	int

KeyVaultCredentialSettings

Nombre	Descripción	Valor
azureKeyVaultUrl	Dirección URL de Azure Key Vault.	string
credentialName	Nombre de la credencial.	string
enable	Habilite o deshabilite la configuración de credenciales del almacén de claves.	bool
servicePrincipalName	Nombre de la entidad de seguridad de servicio para acceder al almacén de claves.	string
servicePrincipalSecret	Secreto de nombre de entidad de seguridad de servicio para acceder al almacén de claves.	string

ServerConfigurationsManagementSettings

Nombre	Descripción	Valor
additionalFeaturesServerConfigurations	Configuración adicional de características de SQL.	AdditionalFeaturesServerConfigurations
sqlConnectivityUpdateSettings	Configuración del tipo de conectividad de SQL.	SqlConnectivityUpdateSettings
sqlInstanceSettings	Configuración de la instancia de SQL.	SQLInstanceSettings
sqlStorageUpdateSettings	Configuración de actualización de almacenamiento de SQL.	SqlStorageUpdateSettings
sqlWorkloadTypeUpdateSettings	Configuración del tipo de carga de trabajo de SQL.	SqlWorkloadTypeUpdateSettings

AdditionalFeaturesServerConfigurations

Nombre	Descripción	Valor
isRServicesEnabled	Habilite o deshabilite los servicios de R (SQL 2016 y versiones posteriores).	bool

SqlConnectivityUpdateSettings

Nombre	Descripción	Valor
connectivityType	SQL Server opción de conectividad.	'LOCAL' "PRIVATE" 'PUBLIC'
port	SQL Server puerto.	int
sqlAuthUpdatePassword	SQL Server contraseña de inicio de sesión de sysadmin.	string
sqlAuthUpdateUserName	SQL Server inicio de sesión sysadmin que se va a crear.	string

SQLInstanceSettings

Nombre	Descripción	Valor
collation	SQL Server intercalación.	string
isIfiEnabled	SQL Server IFI.	bool
isLpimEnabled	SQL Server LPIM.	bool
isOptimizeForAdHocWorkloadsEnabled	SQL Server Optimizar para cargas de trabajo de Adhoc.	bool
maxDop	SQL Server MAXDOP.	int
maxServerMemoryMB	SQL Server memoria máxima.	int
minServerMemoryMB	SQL Server memoria mínima.	int

SqlStorageUpdateSettings

Nombre	Descripción	Valor
diskConfigurationType	Configuración de disco que se va a aplicar a SQL Server.	'ADD' 'EXTEND' 'NEW'
diskCount	Recuento de discos de máquina virtual.	int
startingDeviceId	Id. de dispositivo del primer disco que se va a actualizar.	int

SqlWorkloadTypeUpdateSettings

Nombre	Descripción	Valor
sqlWorkloadType	SQL Server tipo de carga de trabajo.	"DW" "GENERAL" 'OLTP'

StorageConfigurationSettings

Nombre	Descripción	Valor
diskConfigurationType	Configuración de disco que se va a aplicar a SQL Server.	'ADD' 'EXTEND' 'NEW'
sqlDataSettings	SQL Server configuración de almacenamiento de datos.	SQLStorageSettings
sqlLogSettings	SQL Server configuración de almacenamiento de registros.	SQLStorageSettings
sqlSystemDbOnDataDisk	SQL Server Almacenamiento de SystemDb en DataPool si es true.	bool
sqlTempDbSettings	SQL Server configuración de almacenamiento de TempDb.	SQLTempDbSettings
storageWorkloadType	Tipo de carga de trabajo de almacenamiento.	"DW" 'GENERAL' 'OLTP'

SQLStorageSettings

Nombre	Descripción	Valor
defaultFilePath	SQL Server ruta de acceso de archivo predeterminada	string
Luns	Números de unidad lógica para los discos.	int[]

SQLTempDbSettings

Nombre	Descripción	Valor
dataFileCount	SQL Server recuento de archivos de datos tempdb	int
dataFileSize	SQL Server tamaño del archivo de datos tempdb	int
dataGrowth	SQL Server tamaño de crecimiento automático del archivo de datos tempdb	int
defaultFilePath	SQL Server ruta de acceso de archivo predeterminada	string
logFileSize	SQL Server tamaño del archivo de registro de tempdb	int
logGrowth	SQL Server tamaño de crecimiento automático del archivo de registro de tempdb	int
Luns	Números de unidad lógica para los discos.	int[]
persistFolder	SQL Server opción de carpeta persistente de tempdb	bool
persistFolderPath	SQL Server ubicación de carpeta persistente de tempdb	string

WsfcDomainCredentials

Nombre	Descripción	Valor
clusterBootstrapAccountPassword	Contraseña de la cuenta de arranque del clúster.	string
clusterOperatorAccountPassword	Contraseña de la cuenta del operador de clúster.	string
sqlServiceAccountPassword	Contraseña de la cuenta de servicio de SQL.	string

Plantillas de inicio rápido

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

Plantilla	Descripción
Implementación del programa de instalación always ON de SQL con sql Virtual Machines existente	Implemente el programa de instalación always ON de SQL con Virtual Machines de SQL existente. Las máquinas virtuales ya deben estar unidas a un dominio existente y deben ejecutar la versión empresarial de SQL Server.
VM con SQL Server con la configuración de almacenamiento optimizada para rendimiento	Creación de una máquina virtual SQL Server con la configuración de almacenamiento optimizada para el rendimiento en PremiumSSD
Configuración de almacenamiento optimizada para el rendimiento de la máquina virtual de SQL en UltraSSD	Creación de una máquina virtual SQL Server con la configuración de almacenamiento optimizada para el rendimiento mediante UltraSSD para archivos de registro de SQL

Definición de recursos de Terraform (proveedor AzAPI)

El tipo de recurso sqlVirtualMachines se puede implementar en:

Grupos de recursos

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

Formato de los recursos

Para crear un recurso Microsoft.SqlVirtualMachine/sqlVirtualMachines, agregue el siguiente terraform a la plantilla.

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.SqlVirtualMachine/sqlVirtualMachines@2022-07-01-preview"
  name = "string"
  location = "string"
  parent_id = "string"
  tags = {
    tagName1 = "tagValue1"
    tagName2 = "tagValue2"
  }
  identity {
    type =  "SystemAssigned"
  }
  body = jsonencode({
    properties = {
      assessmentSettings = {
        enable = bool
        runImmediately = bool
        schedule = {
          dayOfWeek = "string"
          enable = bool
          monthlyOccurrence = int
          startTime = "string"
          weeklyInterval = int
        }
      }
      autoBackupSettings = {
        backupScheduleType = "string"
        backupSystemDbs = bool
        daysOfWeek = [
          "string"
        ]
        enable = bool
        enableEncryption = bool
        fullBackupFrequency = "string"
        fullBackupStartTime = int
        fullBackupWindowHours = int
        logBackupFrequency = int
        password = "string"
        retentionPeriod = int
        storageAccessKey = "string"
        storageAccountUrl = "string"
        storageContainerName = "string"
      }
      autoPatchingSettings = {
        dayOfWeek = "string"
        enable = bool
        maintenanceWindowDuration = int
        maintenanceWindowStartingHour = int
      }
      enableAutomaticUpgrade = bool
      keyVaultCredentialSettings = {
        azureKeyVaultUrl = "string"
        credentialName = "string"
        enable = bool
        servicePrincipalName = "string"
        servicePrincipalSecret = "string"
      }
      leastPrivilegeMode = "Enabled"
      serverConfigurationsManagementSettings = {
        additionalFeaturesServerConfigurations = {
          isRServicesEnabled = bool
        }
        sqlConnectivityUpdateSettings = {
          connectivityType = "string"
          port = int
          sqlAuthUpdatePassword = "string"
          sqlAuthUpdateUserName = "string"
        }
        sqlInstanceSettings = {
          collation = "string"
          isIfiEnabled = bool
          isLpimEnabled = bool
          isOptimizeForAdHocWorkloadsEnabled = bool
          maxDop = int
          maxServerMemoryMB = int
          minServerMemoryMB = int
        }
        sqlStorageUpdateSettings = {
          diskConfigurationType = "string"
          diskCount = int
          startingDeviceId = int
        }
        sqlWorkloadTypeUpdateSettings = {
          sqlWorkloadType = "string"
        }
      }
      sqlImageOffer = "string"
      sqlImageSku = "string"
      sqlManagement = "string"
      sqlServerLicenseType = "string"
      sqlVirtualMachineGroupResourceId = "string"
      storageConfigurationSettings = {
        diskConfigurationType = "string"
        sqlDataSettings = {
          defaultFilePath = "string"
          luns = [
            int
          ]
        }
        sqlLogSettings = {
          defaultFilePath = "string"
          luns = [
            int
          ]
        }
        sqlSystemDbOnDataDisk = bool
        sqlTempDbSettings = {
          dataFileCount = int
          dataFileSize = int
          dataGrowth = int
          defaultFilePath = "string"
          logFileSize = int
          logGrowth = int
          luns = [
            int
          ]
          persistFolder = bool
          persistFolderPath = "string"
        }
        storageWorkloadType = "string"
      }
      virtualMachineResourceId = "string"
      wsfcDomainCredentials = {
        clusterBootstrapAccountPassword = "string"
        clusterOperatorAccountPassword = "string"
        sqlServiceAccountPassword = "string"
      }
      wsfcStaticIp = "string"
    }
  })
}

Valores de propiedades

sqlVirtualMachines

Nombre	Descripción	Value
type	Tipo de recurso	"Microsoft.SqlVirtualMachine/sqlVirtualMachines@2022-07-01-preview"
name	El nombre del recurso	string (obligatorio)
ubicación	Ubicación del recurso	string (obligatorio)
parent_id	Para realizar la implementación en un grupo de recursos, use el identificador de ese grupo de recursos.	string (obligatorio)
etiquetas	Etiquetas del recurso.	Diccionario de nombres y valores de etiqueta.
identity	Identidad de Azure Active Directory del servidor.	ResourceIdentity
properties	Propiedades del recurso.	SqlVirtualMachineProperties

ResourceIdentity

Nombre	Descripción	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.	"SystemAssigned"

SqlVirtualMachineProperties

Nombre	Descripción	Valor
assessmentSettings	Configuración de evaluación.	AssessmentSettings
autoBackupSettings	Configuración de copia de seguridad automática para SQL Server.	AutoBackupSettings
autoPatchingSettings	Configuración de aplicación automática de revisiones para aplicar actualizaciones de seguridad críticas a la máquina virtual de SQL.	AutoPatchingSettings
enableAutomaticUpgrade	Habilite la actualización automática del Agente de extensión iaaS de Sql.	bool
keyVaultCredentialSettings	Configuración de credenciales del almacén de claves.	KeyVaultCredentialSettings
leastPrivilegeMode	Modo de privilegios mínimos del Agente IaaS de SQL.	"Habilitado"
serverConfigurationsManagementSettings	SQL Server opciones de administración de configuración.	ServerConfigurationsManagementSettings
sqlImageOffer	Oferta de imagen de SQL. Algunos ejemplos son SQL2016-WS2016, SQL2017-WS2016.	string
sqlImageSku	SQL Server tipo de edición.	"Desarrollador" "Empresa" "Express" "Estándar" "Web"
sqlManagement	SQL Server Tipo de administración.	"Full" "Peso ligero" "NoAgent"
sqlServerLicenseType	SQL Server tipo de licencia.	"AHUB" "DR" "PAYG"
sqlVirtualMachineGroupResourceId	Identificador de recurso de ARM del grupo de máquinas virtuales de SQL de la que forma parte esta máquina virtual de SQL.	string
storageConfigurationSettings	Opciones de configuración de almacenamiento.	StorageConfigurationSettings
virtualMachineResourceId	Identificador de recurso de ARM de la máquina virtual subyacente creada a partir de la imagen de Marketplace de SQL.	string
wsfcDomainCredentials	Credenciales de dominio para configurar el clúster de conmutación por error de Windows Server para el grupo de disponibilidad de SQL.	WsfcDomainCredentials
wsfcStaticIp	Credenciales de dominio para configurar el clúster de conmutación por error de Windows Server para el grupo de disponibilidad de SQL.	string

AssessmentSettings

Nombre	Descripción	Valor
enable	Habilite o deshabilite la característica de evaluación en la máquina virtual SQL.	bool
runImmediately	Ejecute la evaluación inmediatamente en la máquina virtual SQL.	bool
schedule	Programación para la evaluación.	Programación

Programación

Nombre	Descripción	Valor
dayOfWeek	Día de la semana para ejecutar la evaluación.	"Friday" "Monday" "Saturday" "Sunday" "Thursday" "Tuesday" "Wednesday"
enable	Habilite o deshabilite la programación de evaluación en la máquina virtual SQL.	bool
monthlyOccurrence	Repetición del día DayOfWeek en un mes para programar la evaluación. Toma valores: 1,2,3,4 y -1. Use -1 para el último día dayOfWeek del mes.	int
startTime	Hora del día en formato HH:mm. Eg. 17:30	string
weeklyInterval	Número de semanas que se van a programar entre 2 ejecuciones de evaluación. Toma el valor de 1 a 6	int

AutoBackupSettings

Nombre	Descripción	Valor
backupScheduleType	Tipo de programación de copia de seguridad.	"Automatizado" "Manual"
backupSystemDbs	Incluya o excluya las bases de datos del sistema de la copia de seguridad automática.	bool
daysOfWeek	Días de la semana para las copias de seguridad cuando FullBackupFrequency está establecido en Semanal.	Matriz de cadenas que contiene cualquiera de: "Friday" "Monday" "Saturday" "Sunday" "Thursday" "Tuesday" "Wednesday"
enable	Habilite o deshabilite la devolución automática en la máquina virtual DE SQL.	bool
enableEncryption	Habilite o deshabilite el cifrado para la copia de seguridad en la máquina virtual SQL.	bool
fullBackupFrequency	Frecuencia de las copias de seguridad completas. En ambos casos, las copias de seguridad completas se inician durante el siguiente período de tiempo programado.	"Diariamente" "Weekly"
fullBackupStartTime	Hora de inicio de un día determinado durante el cual se pueden realizar copias de seguridad completas. De 0 a 23 horas.	int
fullBackupWindowHours	Duración del período de tiempo de un día determinado durante el cual se pueden realizar copias de seguridad completas. De 1 a 23 horas.	int
logBackupFrequency	Frecuencia de las copias de seguridad de registros. De 5 a 60 minutos.	int
password	Contraseña para el cifrado en la copia de seguridad.	string
retentionPeriod	Período de retención de la copia de seguridad: de 1 a 90 días.	int
storageAccessKey	Clave de la cuenta de almacenamiento en la que se realizará la copia de seguridad.	string
storageAccountUrl	Dirección URL de la cuenta de almacenamiento a la que se realizará la copia de seguridad.	string
storageContainerName	Nombre del contenedor de almacenamiento en el que se realizará la copia de seguridad.	string

AutoPatchingSettings

Nombre	Descripción	Valor
dayOfWeek	Día de la semana en el que se aplicará la revisión.	"Todos los días" "Friday" "Monday" "Saturday" "Sunday" "Thursday" "Tuesday" "Wednesday"
enable	Habilite o deshabilite el autopatching en la máquina virtual SQL.	bool
maintenanceWindowDuration	Duración de la aplicación de revisiones.	int
maintenanceWindowStartingHour	Hora del día en que se inicia la aplicación de revisiones. Hora de la máquina virtual local.	int

KeyVaultCredentialSettings

Nombre	Descripción	Valor
azureKeyVaultUrl	Dirección URL de Azure Key Vault.	string
credentialName	Nombre de la credencial.	string
enable	Habilite o deshabilite la configuración de credenciales del almacén de claves.	bool
servicePrincipalName	Nombre de la entidad de seguridad de servicio para acceder al almacén de claves.	string
servicePrincipalSecret	Secreto de nombre de entidad de seguridad de servicio para acceder al almacén de claves.	string

ServerConfigurationsManagementSettings

Nombre	Descripción	Valor
additionalFeaturesServerConfigurations	Configuración adicional de características de SQL.	AdditionalFeaturesServerConfigurations
sqlConnectivityUpdateSettings	Configuración del tipo de conectividad de SQL.	SqlConnectivityUpdateSettings
sqlInstanceSettings	Configuración de la instancia de SQL.	SQLInstanceSettings
sqlStorageUpdateSettings	Configuración de actualización de almacenamiento de SQL.	SqlStorageUpdateSettings
sqlWorkloadTypeUpdateSettings	Configuración del tipo de carga de trabajo de SQL.	SqlWorkloadTypeUpdateSettings

AdditionalFeaturesServerConfigurations

Nombre	Descripción	Valor
isRServicesEnabled	Habilite o deshabilite los servicios de R (SQL 2016 y versiones posteriores).	bool

SqlConnectivityUpdateSettings

Nombre	Descripción	Valor
connectivityType	SQL Server opción de conectividad.	"LOCAL" "PRIVADO" "PUBLIC"
port	SQL Server puerto.	int
sqlAuthUpdatePassword	SQL Server contraseña de inicio de sesión de sysadmin.	string
sqlAuthUpdateUserName	SQL Server inicio de sesión sysadmin que se va a crear.	string

SQLInstanceSettings

Nombre	Descripción	Valor
collation	SQL Server intercalación.	string
isIfiEnabled	SQL Server IFI.	bool
isLpimEnabled	SQL Server LPIM.	bool
isOptimizeForAdHocWorkloadsEnabled	SQL Server Optimizar para cargas de trabajo de Adhoc.	bool
maxDop	SQL Server MAXDOP.	int
maxServerMemoryMB	SQL Server memoria máxima.	int
minServerMemoryMB	SQL Server memoria mínima.	int

SqlStorageUpdateSettings

Nombre	Descripción	Valor
diskConfigurationType	Configuración de disco que se va a aplicar a SQL Server.	"ADD" "EXTEND" "NUEVO"
diskCount	Recuento de discos de máquina virtual.	int
startingDeviceId	Id. de dispositivo del primer disco que se va a actualizar.	int

SqlWorkloadTypeUpdateSettings

Nombre	Descripción	Valor
sqlWorkloadType	SQL Server tipo de carga de trabajo.	"DW" "GENERAL" "OLTP"

StorageConfigurationSettings

Nombre	Descripción	Valor
diskConfigurationType	Configuración de disco que se va a aplicar a SQL Server.	"ADD" "EXTEND" "NUEVO"
sqlDataSettings	SQL Server configuración de almacenamiento de datos.	SQLStorageSettings
sqlLogSettings	SQL Server configuración de almacenamiento de registros.	SQLStorageSettings
sqlSystemDbOnDataDisk	SQL Server Almacenamiento de SystemDb en DataPool si es true.	bool
sqlTempDbSettings	SQL Server configuración de almacenamiento de TempDb.	SQLTempDbSettings
storageWorkloadType	Tipo de carga de trabajo de almacenamiento.	"DW" "GENERAL" "OLTP"

SQLStorageSettings

Nombre	Descripción	Valor
defaultFilePath	SQL Server ruta de acceso de archivo predeterminada	string
Luns	Números de unidad lógica para los discos.	int[]

SQLTempDbSettings

Nombre	Descripción	Valor
dataFileCount	SQL Server recuento de archivos de datos tempdb	int
dataFileSize	SQL Server tamaño del archivo de datos tempdb	int
dataGrowth	SQL Server tamaño de crecimiento automático del archivo de datos tempdb	int
defaultFilePath	SQL Server ruta de acceso de archivo predeterminada	string
logFileSize	SQL Server tamaño del archivo de registro de tempdb	int
logGrowth	SQL Server tamaño de crecimiento automático del archivo de registro de tempdb	int
Luns	Números de unidad lógica para los discos.	int[]
persistFolder	SQL Server opción de carpeta persistente de tempdb	bool
persistFolderPath	SQL Server ubicación de carpeta persistente de tempdb	string

WsfcDomainCredentials

Nombre	Descripción	Valor
clusterBootstrapAccountPassword	Contraseña de la cuenta de arranque del clúster.	string
clusterOperatorAccountPassword	Contraseña de la cuenta del operador de clúster.	string
sqlServiceAccountPassword	Contraseña de la cuenta de servicio SQL.	string

Compartir a través de

Microsoft.SqlVirtualMachine sqlVirtualMachines

Definición de recursos de Bicep

Formato de los recursos

Valores de propiedades

sqlVirtualMachines

ResourceIdentity

SqlVirtualMachineProperties

AssessmentSettings

Programación

AutoBackupSettings

AutoPatchingSettings

KeyVaultCredentialSettings

ServerConfigurationsManagementSettings

AdditionalFeaturesServerConfigurations

SqlConnectivityUpdateSettings

SQLInstanceSettings

SqlStorageUpdateSettings

SqlWorkloadTypeUpdateSettings

StorageConfigurationSettings

SQLStorageSettings

SQLTempDbSettings

WsfcDomainCredentials

Plantillas de inicio rápido

Definición de recursos de plantilla de ARM

Formato de los recursos

Valores de propiedades

sqlVirtualMachines

ResourceIdentity

SqlVirtualMachineProperties

AssessmentSettings

Programación

AutoBackupSettings

AutoPatchingSettings

KeyVaultCredentialSettings

ServerConfigurationsManagementSettings

AdditionalFeaturesServerConfigurations

SqlConnectivityUpdateSettings

SQLInstanceSettings

SqlStorageUpdateSettings

SqlWorkloadTypeUpdateSettings

StorageConfigurationSettings

SQLStorageSettings

SQLTempDbSettings

WsfcDomainCredentials

Plantillas de inicio rápido

Definición de recursos de Terraform (proveedor AzAPI)

Formato de los recursos

Valores de propiedades

sqlVirtualMachines

ResourceIdentity

SqlVirtualMachineProperties

AssessmentSettings

Programación

AutoBackupSettings

AutoPatchingSettings

KeyVaultCredentialSettings

ServerConfigurationsManagementSettings

AdditionalFeaturesServerConfigurations

SqlConnectivityUpdateSettings

SQLInstanceSettings

SqlStorageUpdateSettings

SqlWorkloadTypeUpdateSettings

StorageConfigurationSettings

SQLStorageSettings

SQLTempDbSettings

WsfcDomainCredentials

Comentarios

Comentarios

Recursos adicionales