Microsoft.Sql managedInstances
- Más reciente
- 2023-05-01-preview
- 2023-02-01-preview
- 2022-11-01-preview
- 2022-08-01-preview
- 2022-05-01-preview
- 2022-02-01-preview
- 2021-11-01
- 2021-11-01-preview
- 2021-08-01-preview
- 2021-05-01-preview
- 2021-02-01-preview
- 2020-11-01-preview
- 2020-08-01-preview
- 2020-02-02-preview
- 2018-06-01-preview
- 2015-05-01-preview
Definición de recursos de Bicep
El tipo de recurso managedInstances se puede implementar con operaciones destinadas a:
- 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.Sql/managedInstances, agregue el siguiente bicep a la plantilla.
resource symbolicname 'Microsoft.Sql/managedInstances@2023-05-01-preview' = {
name: 'string'
location: 'string'
tags: {
tagName1: 'tagValue1'
tagName2: 'tagValue2'
}
sku: {
capacity: int
family: 'string'
name: 'string'
size: 'string'
tier: 'string'
}
identity: {
type: 'string'
userAssignedIdentities: {
{customized property}: {}
}
}
properties: {
administratorLogin: 'string'
administratorLoginPassword: 'string'
administrators: {
administratorType: 'ActiveDirectory'
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'
minimalTlsVersion: 'string'
pricingModel: 'string'
primaryUserAssignedIdentityId: 'string'
proxyOverride: 'string'
publicDataEndpointEnabled: bool
requestedBackupStorageRedundancy: 'string'
restorePointInTime: 'string'
servicePrincipal: {
type: 'string'
}
sourceManagedInstanceId: 'string'
storageIOps: int
storageSizeInGB: int
storageThroughputMBps: int
subnetId: 'string'
timezoneId: 'string'
vCores: int
zoneRedundant: bool
}
}
Valores de propiedad
managedInstances
| Nombre | Descripción | Value |
|---|---|---|
| name | El nombre del recurso | string (obligatorio) Límite de caracteres: 1-63 Caracteres válidos: Letras minúsculas, números y guiones. No puede comenzar ni terminar con un guion. El nombre del recurso debe ser único en Azure. |
| ubicación | Ubicación del recurso | string (obligatorio) |
| etiquetas | Etiquetas del recurso. | Diccionario de nombres y valores de etiqueta. Consulte Etiquetas en plantillas. |
| sku | SKU de instancia administrada. Valores permitidos para sku.name: GP_Gen5, GP_G8IM, GP_G8IH, BC_Gen5, BC_G8IM, BC_G8IH | Sku |
| identidad | Identidad de Azure Active Directory de la instancia administrada. | ResourceIdentity |
| properties | Propiedades del recurso. | ManagedInstanceProperties |
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' 'SystemAssigned,UserAssigned' "UserAssigned" |
| userAssignedIdentities | Identificadores de recurso de las identidades asignadas por el usuario que se van a usar | ResourceIdentityUserAssignedIdentities |
ResourceIdentityUserAssignedIdentities
| Nombre | Descripción | Valor |
|---|---|---|
| {propiedad personalizada} | UserIdentity |
UserIdentity
Este objeto no contiene ninguna propiedad que se va a establecer durante la implementación. Todas las propiedades son ReadOnly.
ManagedInstanceProperties
| Nombre | Descripción | Valor |
|---|---|---|
| administratorLogin | Nombre de usuario del administrador para la instancia administrada. Solo se puede especificar cuando se crea la instancia administrada (y es necesario para la creación). | string |
| administratorLoginPassword | Contraseña de inicio de sesión del administrador (necesaria para la creación de una instancia administrada). | string Restricciones: Valor confidencial. Pase como parámetro seguro. |
| administradores | Administrador de Azure Active Directory de la instancia. Esto solo se puede usar en el momento de la creación de la instancia. Si se usa para la actualización por ejemplo, se omitirá o se producirá un error. En el caso de las actualizaciones, es necesario usar las API individuales. | ManagedInstanceExternalAdministrator |
| authenticationMetadata | Modo de búsqueda de metadatos de autenticación de la instancia administrada. | "AzureAD" 'Emparejado' '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' |
| 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 base de datos secundaria como recuperación ante desastres pasiva). | 'Activo' 'Pasivo' |
| instancePoolId | El identificador del grupo de instancias al que pertenece este servidor administrado. | string |
| isGeneralPurposeV2 | Si se trata de una variante GPv2 de De uso general edición. | 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 de SQL). | 'BasePrice' "LicenseIncluded" |
| maintenanceConfigurationId | Especifica el identificador de configuración de mantenimiento que se va a 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' |
| minimalTlsVersion | Versión mínima de TLS. Valores permitidos: 'None', '1.0', '1.1', '1.2' | string |
| pricingModel | El tiempo o no Instancia administrada es freemium. | 'Freemium' "Normal" |
| primaryUserAssignedIdentityId | Identificador de recurso de una identidad asignada por el usuario que se usará de forma predeterminada. | string |
| proxyOverride | Tipo de conexión que se usa para conectarse a la instancia de . | '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 de esta instancia. Las opciones son Local (LocallyRedundantStorage), Zone (ZoneRedundantStorage), Geo (GeoRedundantStorage) y GeoZone(GeoZoneRedundantStorage) | 'Geo' 'GeoZone' 'Local' 'Zona' |
| 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 con la operación de creación de esta instancia. | string |
| storageIOps | IOps de almacenamiento. Valor mínimo: 120. Valor máximo: 120000. 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: 16384. 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 | Rendimiento de almacenamiento en MBps. Valor mínimo: 25. Valor máximo: 4000. Solo se permiten incrementos de 1 MBps. El valor máximo depende de la familia de hardware seleccionada y del número de núcleos virtuales. | 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 |
| Núcleos virtuales | Número de núcleos virtuales. Valores permitidos: 8, 16, 24, 32, 40, 64, 80. | int |
| zoneRedundant | Indica si el multi-az está habilitado o no. | bool |
ManagedInstanceExternalAdministrator
| Nombre | Descripción | Valor |
|---|---|---|
| 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 principal del administrador del servidor. | 'Aplicación' "Grupo" 'Usuario' |
| sid | SID (id. de objeto) del administrador del servidor. | string Restricciones: 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 | Id. de inquilino del administrador. | string Restricciones: 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}$ |
ServicePrincipal
| Nombre | Descripción | Value |
|---|---|---|
| type | Tipo de entidad de servicio. | 'Ninguno' 'SystemAssigned' |
SKU
| Nombre | Descripción | Valor |
|---|---|---|
| capacity | Capacidad de la SKU determinada. | int |
| family | Si el servicio tiene diferentes generaciones de hardware, para la misma SKU, se puede capturar aquí. | string |
| name | El nombre de la SKU, normalmente, una letra + código numérico, por ejemplo, P3. | string (obligatorio) |
| tamaño | Tamaño de la SKU determinada | string |
| Nivel: | Nivel o edición de la SKU concreta, por ejemplo, Básico, Premium. | string |
Plantillas de inicio rápido
Las siguientes plantillas de inicio rápido implementan este tipo de recurso.
| Plantilla | Descripción |
|---|---|
Implementación de SQL Managed Instance con redes |
Implemente UDR y NSG para admitir Azure SQL Managed Instance e implementar el Instancia administrada |
| Creación de una instancia de SQL MI dentro de la nueva red virtual |
Implemente azure Sql Database Instancia administrada (SQL MI) dentro de nuevos Virtual Network. |
| Creación de SQL MI con el envío configurado de registros y métricas |
Esta plantilla 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). |
| Creación de una instancia de SQL MI con jumpbox dentro de una nueva red virtual |
Implemente Azure Sql Database Instancia administrada (SQL MI) y JumpBox con SSMS dentro de una nueva Virtual Network. |
| Creación de una instancia de SQL MI con conexión de punto a sitio configurada |
Implemente azure Sql Database Instancia administrada (SQL MI) y puerta de enlace de red virtual configurada para la conexión de punto a sitio dentro de la nueva red virtual. |
Definición de recursos de plantilla de ARM
El tipo de recurso managedInstances se puede implementar con operaciones destinadas a:
- 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.Sql/managedInstances, agregue el siguiente código JSON a la plantilla.
{
"type": "Microsoft.Sql/managedInstances",
"apiVersion": "2023-05-01-preview",
"name": "string",
"location": "string",
"tags": {
"tagName1": "tagValue1",
"tagName2": "tagValue2"
},
"sku": {
"capacity": "int",
"family": "string",
"name": "string",
"size": "string",
"tier": "string"
},
"identity": {
"type": "string",
"userAssignedIdentities": {
"{customized property}": {}
}
},
"properties": {
"administratorLogin": "string",
"administratorLoginPassword": "string",
"administrators": {
"administratorType": "ActiveDirectory",
"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",
"minimalTlsVersion": "string",
"pricingModel": "string",
"primaryUserAssignedIdentityId": "string",
"proxyOverride": "string",
"publicDataEndpointEnabled": "bool",
"requestedBackupStorageRedundancy": "string",
"restorePointInTime": "string",
"servicePrincipal": {
"type": "string"
},
"sourceManagedInstanceId": "string",
"storageIOps": "int",
"storageSizeInGB": "int",
"storageThroughputMBps": "int",
"subnetId": "string",
"timezoneId": "string",
"vCores": "int",
"zoneRedundant": "bool"
}
}
Valores de propiedad
managedInstances
| Nombre | Descripción | Value |
|---|---|---|
| type | Tipo de recurso | 'Microsoft.Sql/managedInstances' |
| apiVersion | La versión de la API de recursos | "2023-05-01-preview" |
| name | El nombre del recurso | string (obligatorio) Límite de caracteres: 1-63 Caracteres válidos: Letras minúsculas, números y guiones. No puede comenzar ni terminar con un guion. El nombre del recurso debe ser único en Azure. |
| ubicación | Ubicación del recurso | string (obligatorio) |
| etiquetas | Etiquetas del recurso. | Diccionario de nombres y valores de etiqueta. Consulte Etiquetas en plantillas. |
| sku | SKU de instancia administrada. Valores permitidos para sku.name: GP_Gen5, GP_G8IM, GP_G8IH, BC_Gen5, BC_G8IM, BC_G8IH | Sku |
| identidad | Identidad de Azure Active Directory de la instancia administrada. | ResourceIdentity |
| properties | Propiedades de recursos. | ManagedInstanceProperties |
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' 'SystemAssigned,UserAssigned' 'UserAssigned' |
| userAssignedIdentities | Identificadores de recurso de las identidades asignadas por el usuario que se van a usar | ResourceIdentityUserAssignedIdentities |
ResourceIdentityUserAssignedIdentities
| Nombre | Descripción | Valor |
|---|---|---|
| {propiedad personalizada} | UserIdentity |
UserIdentity
Este objeto no contiene ninguna propiedad que se establezca durante la implementación. Todas las propiedades son ReadOnly.
ManagedInstanceProperties
| Nombre | Descripción | Valor |
|---|---|---|
| administratorLogin | Nombre de usuario del administrador de la instancia administrada. Solo se puede especificar cuando se crea la instancia administrada (y se requiere 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 Restricciones: Valor confidencial. Pase como parámetro seguro. |
| administradores | Administrador de Azure Active Directory de la instancia. Esto solo se puede usar en tiempo de creación de instancia. Si se usa para la actualización de instancia, se omitirá o se producirá un error. En el caso de las actualizaciones, es necesario usar las API individuales. | ManagedInstanceExternalAdministrator |
| authenticationMetadata | Modo de búsqueda de metadatos de autenticación de la instancia administrada. | "AzureAD" 'Emparejado' "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' |
| dnsZonePartner | El 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 base de datos secundaria como recuperación ante desastres pasiva). | 'Activo' 'Pasivo' |
| instancePoolId | El identificador del grupo de instancias al que pertenece este servidor administrado. | string |
| isGeneralPurposeV2 | Si se trata de una variante GPv2 de De uso general edición. | 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 de SQL). | 'BasePrice' "LicenseIncluded" |
| maintenanceConfigurationId | Especifica el identificador de configuración de mantenimiento que se va a 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' |
| minimalTlsVersion | Versión mínima de TLS. Valores permitidos: 'None', '1.0', '1.1', '1.2' | string |
| pricingModel | El tiempo o no Instancia administrada es freemium. | 'Freemium' "Normal" |
| primaryUserAssignedIdentityId | Identificador de recurso de una identidad asignada por el usuario que se usará de forma predeterminada. | string |
| proxyOverride | Tipo de conexión que se usa para conectarse a la instancia de . | '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 de esta instancia. Las opciones son Local (LocallyRedundantStorage), Zone (ZoneRedundantStorage), Geo (GeoRedundantStorage) y GeoZone(GeoZoneRedundantStorage) | 'Geo' 'GeoZone' 'Local' 'Zona' |
| 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 con la operación de creación de esta instancia. | string |
| storageIOps | IOps de almacenamiento. Valor mínimo: 120. Valor máximo: 120000. 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: 16384. 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 | Rendimiento de almacenamiento en MBps. Valor mínimo: 25. Valor máximo: 4000. Solo se permiten incrementos de 1 MBps. El valor máximo depende de la familia de hardware seleccionada y del número de núcleos virtuales. | 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. Puede obtener esos valores del Registro a través de SQL Server consultando 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 |
| Núcleos virtuales | Número de núcleos virtuales. Valores permitidos: 8, 16, 24, 32, 40, 64, 80. | int |
| zoneRedundant | Indica si el multi-az está habilitado o no. | bool |
ManagedInstanceExternalAdministrator
| Nombre | Descripción | Valor |
|---|---|---|
| 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 principal del administrador del servidor. | 'Aplicación' "Grupo" 'Usuario' |
| sid | SID (id. de objeto) del administrador del servidor. | string Restricciones: 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 | Id. de inquilino del administrador. | string Restricciones: 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}$ |
ServicePrincipal
| Nombre | Descripción | Value |
|---|---|---|
| type | Tipo de entidad de servicio. | 'Ninguno' 'SystemAssigned' |
SKU
| Nombre | Descripción | Valor |
|---|---|---|
| capacity | Capacidad de la SKU determinada. | int |
| family | Si el servicio tiene diferentes generaciones de hardware, para la misma SKU, se puede capturar aquí. | string |
| name | El nombre de la SKU, normalmente, una letra + código numérico, por ejemplo, P3. | string (obligatorio) |
| tamaño | Tamaño de la SKU determinada | string |
| Nivel: | Nivel o edición de la SKU concreta, por ejemplo, Básico, Premium. | string |
Plantillas de inicio rápido
Las siguientes plantillas de inicio rápido implementan este tipo de recurso.
| Plantilla | Descripción |
|---|---|
| Implementación de SQL Managed Instance con redes |
Implemente UDR y NSG para admitir Azure SQL Managed Instance e implementar el Instancia administrada |
| Creación de una instancia de SQL MI dentro de la nueva red virtual |
Implemente azure Sql Database Instancia administrada (SQL MI) dentro de nuevos Virtual Network. |
| Creación de SQL MI con el envío configurado de registros y métricas |
Esta plantilla 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). |
| Creación de una instancia de SQL MI con jumpbox dentro de una nueva red virtual |
Implemente Azure Sql Database Instancia administrada (SQL MI) y JumpBox con SSMS dentro de una nueva Virtual Network. |
| Creación de una instancia de SQL MI con conexión de punto a sitio configurada |
Implemente azure Sql Database Instancia administrada (SQL MI) y puerta de enlace de red virtual configurada para la conexión de punto a sitio dentro de la nueva red virtual. |
Definición de recursos de Terraform (proveedor AzAPI)
El tipo de recurso managedInstances se puede implementar con operaciones destinadas a:
- Grupos de recursos
Para obtener una lista de las propiedades modificadas en cada versión de API, consulte registro de cambios.
Formato de los recursos
Para crear un recurso Microsoft.Sql/managedInstances, agregue el siguiente terraform a la plantilla.
resource "azapi_resource" "symbolicname" {
type = "Microsoft.Sql/managedInstances@2023-05-01-preview"
name = "string"
location = "string"
parent_id = "string"
tags = {
tagName1 = "tagValue1"
tagName2 = "tagValue2"
}
identity {
type = "string"
identity_ids = []
}
body = jsonencode({
properties = {
administratorLogin = "string"
administratorLoginPassword = "string"
administrators = {
administratorType = "ActiveDirectory"
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"
minimalTlsVersion = "string"
pricingModel = "string"
primaryUserAssignedIdentityId = "string"
proxyOverride = "string"
publicDataEndpointEnabled = bool
requestedBackupStorageRedundancy = "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
managedInstances
| Nombre | Descripción | Value |
|---|---|---|
| type | Tipo de recurso | "Microsoft.Sql/managedInstances@2023-05-01-preview" |
| name | El nombre del recurso | string (obligatorio) Límite de caracteres: 1-63 Caracteres válidos: Letras minúsculas, números y guiones. No puede comenzar ni terminar con un guion. El nombre del recurso debe ser único en Azure. |
| 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. |
| sku | SKU de instancia administrada. Valores permitidos para sku.name: GP_Gen5, GP_G8IM, GP_G8IH, BC_Gen5, BC_G8IM, BC_G8IH | Sku |
| identidad | Identidad de Azure Active Directory de la instancia administrada. | ResourceIdentity |
| properties | Propiedades del recurso. | ManagedInstanceProperties |
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" "SystemAssigned,UserAssigned" "UserAssigned" |
| identity_ids | Identificadores de recurso de las identidades asignadas por el usuario que se van a usar | Matriz de identificadores de identidad de usuario. |
ResourceIdentityUserAssignedIdentities
| Nombre | Descripción | Valor |
|---|---|---|
| {propiedad personalizada} | UserIdentity |
UserIdentity
Este objeto no contiene ninguna propiedad que se va a establecer durante la implementación. Todas las propiedades son ReadOnly.
ManagedInstanceProperties
| Nombre | Descripción | Valor |
|---|---|---|
| administratorLogin | Nombre de usuario del administrador para la instancia administrada. Solo se puede especificar cuando se crea la instancia administrada (y es necesario para la creación). | string |
| administratorLoginPassword | Contraseña de inicio de sesión del administrador (necesaria para la creación de una instancia administrada). | string Restricciones: Valor confidencial. Pase como parámetro seguro. |
| administradores | Administrador de Azure Active Directory de la instancia. Esto solo se puede usar en el momento de la creación de la instancia. Si se usa para la actualización por ejemplo, se omitirá o se producirá un error. En el caso de las actualizaciones, es necesario usar las API individuales. | ManagedInstanceExternalAdministrator |
| authenticationMetadata | Modo de búsqueda de metadatos de autenticación de la instancia administrada. | "AzureAD" "Emparejado" "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" |
| 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 base de datos secundaria como recuperación ante desastres pasiva). | "Activo" "Pasivo" |
| instancePoolId | El identificador del grupo de instancias al que pertenece este servidor administrado. | string |
| isGeneralPurposeV2 | Si se trata de una variante GPv2 de De uso general edición. | 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 de SQL). | "BasePrice" "LicenseIncluded" |
| maintenanceConfigurationId | Especifica el identificador de configuración de mantenimiento que se va a 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. |
"Valor predeterminado" "PointInTimeRestore" |
| minimalTlsVersion | Versión mínima de TLS. Valores permitidos: 'None', '1.0', '1.1', '1.2' | string |
| pricingModel | El tiempo o no Instancia administrada es freemium. | "Freemium" "Normal" |
| 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. | "Valor predeterminado" "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" "Zona" |
| 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 con la operación de creación de esta instancia. | string |
| storageIOps | IOps de almacenamiento. Valor mínimo: 120. Valor máximo: 120000. 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: 16384. 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 | Rendimiento de almacenamiento en MBps. Valor mínimo: 25. Valor máximo: 4000. Solo se permiten incrementos de 1 MBps. El valor máximo depende de la familia de hardware seleccionada y del número de núcleos virtuales. | 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 |
| Núcleos virtuales | Número de núcleos virtuales. Valores permitidos: 8, 16, 24, 32, 40, 64, 80. | int |
| zoneRedundant | Indica si el multi-az está habilitado o no. | bool |
ManagedInstanceExternalAdministrator
| Nombre | Descripción | Valor |
|---|---|---|
| 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 principal del administrador del servidor. | "Aplicación" "Grupo" "User" |
| sid | SID (id. de objeto) del administrador del servidor. | string Restricciones: 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 | Id. de inquilino del administrador. | string Restricciones: 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}$ |
ServicePrincipal
| Nombre | Descripción | Value |
|---|---|---|
| type | Tipo de entidad de servicio. | "None" "SystemAssigned" |
SKU
| Nombre | Descripción | Valor |
|---|---|---|
| capacity | Capacidad de la SKU determinada. | int |
| family | Si el servicio tiene diferentes generaciones de hardware, para la misma SKU, se puede capturar aquí. | string |
| name | El nombre de la SKU, normalmente, una letra + código numérico, por ejemplo, P3. | string (obligatorio) |
| tamaño | Tamaño de la SKU determinada | string |
| Nivel: | Nivel o edición de la SKU concreta, por ejemplo, Básico, Premium. | string |