Nota:
El acceso a esta página requiere autorización. Puede intentar iniciar sesión o cambiar directorios.
El acceso a esta página requiere autorización. Puede intentar cambiar los directorios.
Definición de recursos de Bicep
El tipo de recurso de clústeres se puede implementar con operaciones destinadas a:
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.Kusto/clusters, agregue el siguiente bicep a la plantilla.
resource symbolicname 'Microsoft.Kusto/clusters@2024-04-13' = {
scope: resourceSymbolicName or scope
identity: {
type: 'string'
userAssignedIdentities: {
{customized property}: {}
}
}
location: 'string'
name: 'string'
properties: {
acceptedAudiences: [
{
value: 'string'
}
]
allowedFqdnList: [
'string'
]
allowedIpRangeList: [
'string'
]
calloutPolicies: [
{
calloutType: 'string'
calloutUriRegex: 'string'
outboundAccess: 'string'
}
]
enableAutoStop: bool
enableDiskEncryption: bool
enableDoubleEncryption: bool
enablePurge: bool
enableStreamingIngest: bool
engineType: 'string'
keyVaultProperties: {
keyName: 'string'
keyVaultUri: 'string'
keyVersion: 'string'
userIdentity: 'string'
}
languageExtensions: {
value: [
{
languageExtensionCustomImageName: 'string'
languageExtensionImageName: 'string'
languageExtensionName: 'string'
}
]
}
optimizedAutoscale: {
isEnabled: bool
maximum: int
minimum: int
version: int
}
publicIPType: 'string'
publicNetworkAccess: 'string'
restrictOutboundNetworkAccess: 'string'
trustedExternalTenants: [
{
value: 'string'
}
]
virtualClusterGraduationProperties: 'string'
virtualNetworkConfiguration: {
dataManagementPublicIpId: 'string'
enginePublicIpId: 'string'
state: 'string'
subnetId: 'string'
}
}
sku: {
capacity: int
name: 'string'
tier: 'string'
}
tags: {
{customized property}: 'string'
}
zones: [
'string'
]
}
Valores de propiedad
Microsoft.Kusto/clusters
| Nombre | Descripción | Valor |
|---|---|---|
| identidad | Identidad del clúster, si está configurada. | Identidad |
| ubicación | Ubicación geográfica donde reside el recurso | string (obligatorio) |
| nombre | El nombre del recurso | cuerda Restricciones: Patrón = ^.*$ (obligatorio) |
| Propiedades | Propiedades del clúster. | clusterProperties de |
| 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 del clúster. | azureSku (obligatorio) |
| Etiquetas | Etiquetas de recursos | Diccionario de nombres y valores de etiqueta. Consulte etiquetas de en plantillas |
| Zonas | Zonas de disponibilidad del clúster. | cadena[] |
AcceptedAudiences
| Nombre | Descripción | Valor |
|---|---|---|
| valor | GUID o dirección URL válida que representa una audiencia aceptada. | cuerda |
AzureSku
| Nombre | Descripción | Valor |
|---|---|---|
| capacidad | Número de instancias del clúster. | Int |
| nombre | Nombre de la SKU. | 'Desarrollo (sin SLA)_Standard_D11_v2' 'Desarrollo (sin SLA)_Standard_E2a_v4' "Standard_D11_v2" "Standard_D12_v2" "Standard_D13_v2" "Standard_D14_v2" "Standard_D16d_v5" "Standard_D32d_v4" "Standard_D32d_v5" "Standard_DS13_v2+1TB_PS" "Standard_DS13_v2+2TB_PS" "Standard_DS14_v2+3TB_PS" "Standard_DS14_v2+4TB_PS" "Standard_E16ads_v5" "Standard_E16as_v4+3TB_PS" "Standard_E16as_v4+4TB_PS" "Standard_E16as_v5+3TB_PS" "Standard_E16as_v5+4TB_PS" "Standard_E16a_v4" "Standard_E16d_v4" "Standard_E16d_v5" "Standard_E16s_v4+3TB_PS" "Standard_E16s_v4+4TB_PS" "Standard_E16s_v5+3TB_PS" "Standard_E16s_v5+4TB_PS" "Standard_E2ads_v5" "Standard_E2a_v4" "Standard_E2d_v4" "Standard_E2d_v5" "Standard_E4ads_v5" "Standard_E4a_v4" "Standard_E4d_v4" "Standard_E4d_v5" "Standard_E64i_v3" "Standard_E80ids_v4" "Standard_E8ads_v5" "Standard_E8as_v4+1TB_PS" "Standard_E8as_v4+2TB_PS" "Standard_E8as_v5+1TB_PS" "Standard_E8as_v5+2TB_PS" "Standard_E8a_v4" "Standard_E8d_v4" "Standard_E8d_v5" "Standard_E8s_v4+1TB_PS" "Standard_E8s_v4+2TB_PS" "Standard_E8s_v5+1TB_PS" "Standard_E8s_v5+2TB_PS" "Standard_EC16ads_v5" "Standard_EC16as_v5+3TB_PS" "Standard_EC16as_v5+4TB_PS" "Standard_EC8ads_v5" "Standard_EC8as_v5+1TB_PS" "Standard_EC8as_v5+2TB_PS" "Standard_L16as_v3" "Standard_L16s" "Standard_L16s_v2" "Standard_L16s_v3" "Standard_L32as_v3" "Standard_L32s_v3" "Standard_L4s" "Standard_L8as_v3" "Standard_L8s" "Standard_L8s_v2" 'Standard_L8s_v3' (obligatorio) |
| nivel | Nivel de SKU. | "Básico" 'Estándar' (obligatorio) |
CalloutPolicy
| Nombre | Descripción | Valor |
|---|---|---|
| calloutType | Tipo del servicio de llamada, especificando el tipo de recurso externo o servicio al que se accede. | "azure_digital_twins" "azure_openai" 'cosmosdb' "external_data" 'Genevometría' 'Kusto' 'mysql' 'postgresql' "sandbox_artifacts" 'sql' 'WebAPI' |
| calloutUriRegex | Expresión regular o patrón FQDN para el URI de la llamada. | cuerda |
| outboundAccess | Indica si se permite el acceso saliente para el patrón de URI especificado. | 'Permitir' 'Denegar' |
ClusterProperties (Propiedades de clúster)
| Nombre | Descripción | Valor |
|---|---|---|
| acceptedAudiences | Audiencias aceptadas del clúster. | acceptedAudiences[] |
| allowedFqdnList | Lista de FQDN permitidos (nombre de dominio completo) para la salida del clúster. | cadena[] |
| allowedIpRangeList | La lista de ips con el formato CIDR permitido para conectarse al clúster. | cadena[] |
| calloutPolicies | Lista de directivas de llamada para la salida del clúster. | CalloutPolicy[] |
| enable AutoStop | Valor booleano que indica si el clúster se podría detener automáticamente (debido a la falta de datos o a ninguna actividad durante muchos días). | Bool |
| enableDiskEncryption | Valor booleano que indica si los discos del clúster están cifrados. | Bool |
| enableDoubleEncryption | Valor booleano que indica si el cifrado doble está habilitado. | Bool |
| enablePurga | Valor booleano que indica si las operaciones de purga están habilitadas. | Bool |
| enableStreamingIngEst | Valor booleano que indica si la ingesta de streaming está habilitada. | Bool |
| engineType | Tipo de motor | 'V2' 'V3' |
| keyVaultProperties | Propiedades de KeyVault para el cifrado del clúster. | KeyVaultProperties |
| languageExtensions | Lista de extensiones de lenguaje del clúster. | LanguageExtensionsList |
| optimizadoAutoscale | Definición de escalado automático optimizada. | Escalado automático optimizado |
| publicIPType | Indica qué tipo de dirección IP pública se va a crear: IPv4 (valor predeterminado) o DualStack (IPv4 e IPv6) | 'Doble pila' 'IPv4' |
| publicNetworkAccess | El acceso de red pública al clúster está habilitado de forma predeterminada. Cuando está deshabilitada, solo se permite la conexión de punto de conexión privado al clúster. | 'Deshabilitado' 'Habilitado' |
| restrictOutboundNetworkAccess | Si se va a restringir o no el acceso de red saliente. El valor es opcional, pero si se pasa, debe ser "Habilitado" o "Deshabilitado". | 'Deshabilitado' 'Habilitado' |
| trustedExternalTenants | Inquilinos externos del clúster. | trustedExternalTenant[] |
| virtualClusterGraduationProperties | Propiedades de graduación de clúster virtual | cuerda Restricciones: Valor confidencial. Pase como parámetro seguro. |
| virtualNetworkConfiguration | Definición de red virtual. | virtualNetworkConfiguration |
ComponentsSgqdofSchemasIdentityPropertiesUserassignedidentitiesAdditionalproperties
| Nombre | Descripción | Valor |
|---|
Identidad
IdentityUserAssignedIdentities
| Nombre | Descripción | Valor |
|---|
KeyVaultProperties
| Nombre | Descripción | Valor |
|---|---|---|
| keyName | Nombre de la clave del almacén de claves. | cuerda |
| keyVaultUri | Identificador URI del almacén de claves. | cuerda |
| keyVersion | Versión de la clave del almacén de claves. | cuerda |
| userIdentity | Identidad asignada por el usuario (identificador de recurso de ARM) que tiene acceso a la clave. | cuerda |
LanguageExtension
| Nombre | Descripción | Valor |
|---|---|---|
| languageExtensionCustomImageName | Nombre de la imagen personalizada de la extensión de lenguaje. | cuerda |
| languageExtensionImageName | Nombre de la imagen de la extensión de idioma. | "Python3_10_8" "Python3_10_8_DL" "Python3_11_7" "Python3_11_7_DL" "Python3_6_5" 'PythonCustomImage' 'R' |
| languageExtensionName | Nombre de la extensión de lenguaje. | 'PITÓN' 'R' |
LanguageExtensionsList
| Nombre | Descripción | Valor |
|---|---|---|
| valor | Lista de extensiones de lenguaje. | Extensión de lenguaje[] |
Escalado automático optimizado
| Nombre | Descripción | Valor |
|---|---|---|
| isEnabled | Valor booleano que indica si la característica de escalabilidad automática optimizada está habilitada o no. | bool (obligatorio) |
| máximo | Número máximo de instancias permitidas. | int (obligatorio) |
| mínimo | Número mínimo de instancias permitidas. | int (obligatorio) |
| Versión | Versión de la plantilla definida, por ejemplo 1. | int (obligatorio) |
TrackedResourceTags
| Nombre | Descripción | Valor |
|---|
TrustedExternalTenant
| Nombre | Descripción | Valor |
|---|---|---|
| valor | GUID que representa un inquilino externo. | cuerda |
VirtualNetworkConfiguration
| Nombre | Descripción | Valor |
|---|---|---|
| dataManagementPublicIpId | Identificador de recurso de la dirección IP pública del servicio de administración de datos. | string (obligatorio) |
| enginePublicIpId | Identificador de recurso de la dirección IP pública del servicio de motor. | string (obligatorio) |
| estado | Cuando se habilita, el clúster se implementa en la subred configurada, cuando se deshabilite se quitará de la subred. | 'Deshabilitado' 'Habilitado' |
| subnetId | Identificador del recurso de subred. | string (obligatorio) |
Ejemplos de uso
Módulos comprobados de Azure
Los siguientes módulos comprobados de Azure se pueden usar para implementar este tipo de recurso.
| Módulo | Descripción |
|---|---|
| de clúster de Azure Data Explorer (Kusto) | Módulo de recursos de AVM para el clúster de Azure Data Explorer (Kusto) |
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 | Descripción |
|---|---|
| Azure Digital Twins con la conexión del historial de datos de tiempo | Esta plantilla crea una instancia de Azure Digital Twins configurada con una conexión del historial de datos de serie temporal. Para crear una conexión, se deben crear otros recursos, como un espacio de nombres de Event Hubs, un centro de eventos, un clúster de Azure Data Explorer y una base de datos. Los datos se envían a un centro de eventos que eventualmente reenvía los datos al clúster de Azure Data Explorer. Los datos se almacenan en una tabla de base de datos del clúster |
| Crear un monitor de base de datos | En este ejemplo se crea un monitor de base de datos para Azure SQL y se configuran sus almacenes de datos, destinos SQL y puntos de conexión privados administrados. |
| Implementación de Azure Data Explorer DB con de conexión de Cosmos DB | Implemente Azure Data Explorer DB con conexión de Cosmos DB. |
| implementación de la base de datos de Azure Data Explorer con de conexión de Event Grid | Implemente la base de datos de Azure Data Explorer con la conexión de Event Grid. |
| Implementación de la base de datos de Azure Data Explorer con de conexión del centro de eventos | Implemente la base de datos de Azure Data Explorer con la conexión del centro de eventos. |
| del centro de FinOps de |
Esta plantilla crea una nueva instancia del centro de FinOps, incluido el Explorador de datos, el almacenamiento de Data Lake y Data Factory. |
Definición de recursos de plantilla de ARM
El tipo de recurso de clústeres se puede implementar con operaciones destinadas a:
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.Kusto/clusters, agregue el siguiente JSON a la plantilla.
{
"type": "Microsoft.Kusto/clusters",
"apiVersion": "2024-04-13",
"name": "string",
"identity": {
"type": "string",
"userAssignedIdentities": {
"{customized property}": {
}
}
},
"location": "string",
"properties": {
"acceptedAudiences": [
{
"value": "string"
}
],
"allowedFqdnList": [ "string" ],
"allowedIpRangeList": [ "string" ],
"calloutPolicies": [
{
"calloutType": "string",
"calloutUriRegex": "string",
"outboundAccess": "string"
}
],
"enableAutoStop": "bool",
"enableDiskEncryption": "bool",
"enableDoubleEncryption": "bool",
"enablePurge": "bool",
"enableStreamingIngest": "bool",
"engineType": "string",
"keyVaultProperties": {
"keyName": "string",
"keyVaultUri": "string",
"keyVersion": "string",
"userIdentity": "string"
},
"languageExtensions": {
"value": [
{
"languageExtensionCustomImageName": "string",
"languageExtensionImageName": "string",
"languageExtensionName": "string"
}
]
},
"optimizedAutoscale": {
"isEnabled": "bool",
"maximum": "int",
"minimum": "int",
"version": "int"
},
"publicIPType": "string",
"publicNetworkAccess": "string",
"restrictOutboundNetworkAccess": "string",
"trustedExternalTenants": [
{
"value": "string"
}
],
"virtualClusterGraduationProperties": "string",
"virtualNetworkConfiguration": {
"dataManagementPublicIpId": "string",
"enginePublicIpId": "string",
"state": "string",
"subnetId": "string"
}
},
"sku": {
"capacity": "int",
"name": "string",
"tier": "string"
},
"tags": {
"{customized property}": "string"
},
"zones": [ "string" ]
}
Valores de propiedad
Microsoft.Kusto/clusters
| Nombre | Descripción | Valor |
|---|---|---|
| apiVersion | La versión de api | '2024-04-13' |
| identidad | Identidad del clúster, si está configurada. | Identidad |
| ubicación | Ubicación geográfica donde reside el recurso | string (obligatorio) |
| nombre | El nombre del recurso | cuerda Restricciones: Patrón = ^.*$ (obligatorio) |
| Propiedades | Propiedades del clúster. | clusterProperties de |
| Sku | SKU del clúster. | azureSku (obligatorio) |
| Etiquetas | Etiquetas de recursos | Diccionario de nombres y valores de etiqueta. Consulte etiquetas de en plantillas |
| tipo | El tipo de recurso | "Microsoft.Kusto/clusters" |
| Zonas | Zonas de disponibilidad del clúster. | cadena[] |
AcceptedAudiences
| Nombre | Descripción | Valor |
|---|---|---|
| valor | GUID o dirección URL válida que representa una audiencia aceptada. | cuerda |
AzureSku
| Nombre | Descripción | Valor |
|---|---|---|
| capacidad | Número de instancias del clúster. | Int |
| nombre | Nombre de la SKU. | 'Desarrollo (sin SLA)_Standard_D11_v2' 'Desarrollo (sin SLA)_Standard_E2a_v4' "Standard_D11_v2" "Standard_D12_v2" "Standard_D13_v2" "Standard_D14_v2" "Standard_D16d_v5" "Standard_D32d_v4" "Standard_D32d_v5" "Standard_DS13_v2+1TB_PS" "Standard_DS13_v2+2TB_PS" "Standard_DS14_v2+3TB_PS" "Standard_DS14_v2+4TB_PS" "Standard_E16ads_v5" "Standard_E16as_v4+3TB_PS" "Standard_E16as_v4+4TB_PS" "Standard_E16as_v5+3TB_PS" "Standard_E16as_v5+4TB_PS" "Standard_E16a_v4" "Standard_E16d_v4" "Standard_E16d_v5" "Standard_E16s_v4+3TB_PS" "Standard_E16s_v4+4TB_PS" "Standard_E16s_v5+3TB_PS" "Standard_E16s_v5+4TB_PS" "Standard_E2ads_v5" "Standard_E2a_v4" "Standard_E2d_v4" "Standard_E2d_v5" "Standard_E4ads_v5" "Standard_E4a_v4" "Standard_E4d_v4" "Standard_E4d_v5" "Standard_E64i_v3" "Standard_E80ids_v4" "Standard_E8ads_v5" "Standard_E8as_v4+1TB_PS" "Standard_E8as_v4+2TB_PS" "Standard_E8as_v5+1TB_PS" "Standard_E8as_v5+2TB_PS" "Standard_E8a_v4" "Standard_E8d_v4" "Standard_E8d_v5" "Standard_E8s_v4+1TB_PS" "Standard_E8s_v4+2TB_PS" "Standard_E8s_v5+1TB_PS" "Standard_E8s_v5+2TB_PS" "Standard_EC16ads_v5" "Standard_EC16as_v5+3TB_PS" "Standard_EC16as_v5+4TB_PS" "Standard_EC8ads_v5" "Standard_EC8as_v5+1TB_PS" "Standard_EC8as_v5+2TB_PS" "Standard_L16as_v3" "Standard_L16s" "Standard_L16s_v2" "Standard_L16s_v3" "Standard_L32as_v3" "Standard_L32s_v3" "Standard_L4s" "Standard_L8as_v3" "Standard_L8s" "Standard_L8s_v2" 'Standard_L8s_v3' (obligatorio) |
| nivel | Nivel de SKU. | "Básico" 'Estándar' (obligatorio) |
CalloutPolicy
| Nombre | Descripción | Valor |
|---|---|---|
| calloutType | Tipo del servicio de llamada, especificando el tipo de recurso externo o servicio al que se accede. | "azure_digital_twins" "azure_openai" 'cosmosdb' "external_data" 'Genevometría' 'Kusto' 'mysql' 'postgresql' "sandbox_artifacts" 'sql' 'WebAPI' |
| calloutUriRegex | Expresión regular o patrón FQDN para el URI de la llamada. | cuerda |
| outboundAccess | Indica si se permite el acceso saliente para el patrón de URI especificado. | 'Permitir' 'Denegar' |
ClusterProperties (Propiedades de clúster)
| Nombre | Descripción | Valor |
|---|---|---|
| acceptedAudiences | Audiencias aceptadas del clúster. | acceptedAudiences[] |
| allowedFqdnList | Lista de FQDN permitidos (nombre de dominio completo) para la salida del clúster. | cadena[] |
| allowedIpRangeList | La lista de ips con el formato CIDR permitido para conectarse al clúster. | cadena[] |
| calloutPolicies | Lista de directivas de llamada para la salida del clúster. | CalloutPolicy[] |
| enable AutoStop | Valor booleano que indica si el clúster se podría detener automáticamente (debido a la falta de datos o a ninguna actividad durante muchos días). | Bool |
| enableDiskEncryption | Valor booleano que indica si los discos del clúster están cifrados. | Bool |
| enableDoubleEncryption | Valor booleano que indica si el cifrado doble está habilitado. | Bool |
| enablePurga | Valor booleano que indica si las operaciones de purga están habilitadas. | Bool |
| enableStreamingIngEst | Valor booleano que indica si la ingesta de streaming está habilitada. | Bool |
| engineType | Tipo de motor | 'V2' 'V3' |
| keyVaultProperties | Propiedades de KeyVault para el cifrado del clúster. | KeyVaultProperties |
| languageExtensions | Lista de extensiones de lenguaje del clúster. | LanguageExtensionsList |
| optimizadoAutoscale | Definición de escalado automático optimizada. | Escalado automático optimizado |
| publicIPType | Indica qué tipo de dirección IP pública se va a crear: IPv4 (valor predeterminado) o DualStack (IPv4 e IPv6) | 'Doble pila' 'IPv4' |
| publicNetworkAccess | El acceso de red pública al clúster está habilitado de forma predeterminada. Cuando está deshabilitada, solo se permite la conexión de punto de conexión privado al clúster. | 'Deshabilitado' 'Habilitado' |
| restrictOutboundNetworkAccess | Si se va a restringir o no el acceso de red saliente. El valor es opcional, pero si se pasa, debe ser "Habilitado" o "Deshabilitado". | 'Deshabilitado' 'Habilitado' |
| trustedExternalTenants | Inquilinos externos del clúster. | trustedExternalTenant[] |
| virtualClusterGraduationProperties | Propiedades de graduación de clúster virtual | cuerda Restricciones: Valor confidencial. Pase como parámetro seguro. |
| virtualNetworkConfiguration | Definición de red virtual. | virtualNetworkConfiguration |
ComponentsSgqdofSchemasIdentityPropertiesUserassignedidentitiesAdditionalproperties
| Nombre | Descripción | Valor |
|---|
Identidad
IdentityUserAssignedIdentities
| Nombre | Descripción | Valor |
|---|
KeyVaultProperties
| Nombre | Descripción | Valor |
|---|---|---|
| keyName | Nombre de la clave del almacén de claves. | cuerda |
| keyVaultUri | Identificador URI del almacén de claves. | cuerda |
| keyVersion | Versión de la clave del almacén de claves. | cuerda |
| userIdentity | Identidad asignada por el usuario (identificador de recurso de ARM) que tiene acceso a la clave. | cuerda |
LanguageExtension
| Nombre | Descripción | Valor |
|---|---|---|
| languageExtensionCustomImageName | Nombre de la imagen personalizada de la extensión de lenguaje. | cuerda |
| languageExtensionImageName | Nombre de la imagen de la extensión de idioma. | "Python3_10_8" "Python3_10_8_DL" "Python3_11_7" "Python3_11_7_DL" "Python3_6_5" 'PythonCustomImage' 'R' |
| languageExtensionName | Nombre de la extensión de lenguaje. | 'PITÓN' 'R' |
LanguageExtensionsList
| Nombre | Descripción | Valor |
|---|---|---|
| valor | Lista de extensiones de lenguaje. | Extensión de lenguaje[] |
Escalado automático optimizado
| Nombre | Descripción | Valor |
|---|---|---|
| isEnabled | Valor booleano que indica si la característica de escalabilidad automática optimizada está habilitada o no. | bool (obligatorio) |
| máximo | Número máximo de instancias permitidas. | int (obligatorio) |
| mínimo | Número mínimo de instancias permitidas. | int (obligatorio) |
| Versión | Versión de la plantilla definida, por ejemplo 1. | int (obligatorio) |
TrackedResourceTags
| Nombre | Descripción | Valor |
|---|
TrustedExternalTenant
| Nombre | Descripción | Valor |
|---|---|---|
| valor | GUID que representa un inquilino externo. | cuerda |
VirtualNetworkConfiguration
| Nombre | Descripción | Valor |
|---|---|---|
| dataManagementPublicIpId | Identificador de recurso de la dirección IP pública del servicio de administración de datos. | string (obligatorio) |
| enginePublicIpId | Identificador de recurso de la dirección IP pública del servicio de motor. | string (obligatorio) |
| estado | Cuando se habilita, el clúster se implementa en la subred configurada, cuando se deshabilite se quitará de la subred. | 'Deshabilitado' 'Habilitado' |
| subnetId | Identificador del recurso de subred. | string (obligatorio) |
Ejemplos de uso
Plantillas de inicio rápido de Azure
Los siguientes plantillas de inicio rápido de Azure implementar este tipo de recurso.
| Plantilla | Descripción |
|---|---|
|
Azure Digital Twins con la conexión del historial de datos de tiempo |
Esta plantilla crea una instancia de Azure Digital Twins configurada con una conexión del historial de datos de serie temporal. Para crear una conexión, se deben crear otros recursos, como un espacio de nombres de Event Hubs, un centro de eventos, un clúster de Azure Data Explorer y una base de datos. Los datos se envían a un centro de eventos que eventualmente reenvía los datos al clúster de Azure Data Explorer. Los datos se almacenan en una tabla de base de datos del clúster |
|
Crear un clúster de base de datos |
Esta plantilla permite crear un clúster y una base de datos. |
|
Crear un monitor de base de datos |
En este ejemplo se crea un monitor de base de datos para Azure SQL y se configuran sus almacenes de datos, destinos SQL y puntos de conexión privados administrados. |
|
Implementación del clúster de Azure Data Explorer en la red virtual |
Esta plantilla le permite implementar un clúster en la red virtual. |
|
Implementación de Azure Data Explorer DB con de conexión de Cosmos DB |
Implemente Azure Data Explorer DB con conexión de Cosmos DB. |
|
implementación de la base de datos de Azure Data Explorer con de conexión de Event Grid |
Implemente la base de datos de Azure Data Explorer con la conexión de Event Grid. |
|
Implementación de la base de datos de Azure Data Explorer con de conexión del centro de eventos |
Implemente la base de datos de Azure Data Explorer con la conexión del centro de eventos. |
| del centro de FinOps de |
Esta plantilla crea una nueva instancia del centro de FinOps, incluido el Explorador de datos, el almacenamiento de Data Lake y Data Factory. |
Definición de recursos de Terraform (proveedor AzAPI)
El tipo de recurso de clústeres se puede implementar con operaciones destinadas a:
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.Kusto/clusters, agregue el siguiente terraform a la plantilla.
resource "azapi_resource" "symbolicname" {
type = "Microsoft.Kusto/clusters@2024-04-13"
name = "string"
parent_id = "string"
identity {
type = "string"
identity_ids = [
"string"
]
}
location = "string"
tags = {
{customized property} = "string"
}
body = {
properties = {
acceptedAudiences = [
{
value = "string"
}
]
allowedFqdnList = [
"string"
]
allowedIpRangeList = [
"string"
]
calloutPolicies = [
{
calloutType = "string"
calloutUriRegex = "string"
outboundAccess = "string"
}
]
enableAutoStop = bool
enableDiskEncryption = bool
enableDoubleEncryption = bool
enablePurge = bool
enableStreamingIngest = bool
engineType = "string"
keyVaultProperties = {
keyName = "string"
keyVaultUri = "string"
keyVersion = "string"
userIdentity = "string"
}
languageExtensions = {
value = [
{
languageExtensionCustomImageName = "string"
languageExtensionImageName = "string"
languageExtensionName = "string"
}
]
}
optimizedAutoscale = {
isEnabled = bool
maximum = int
minimum = int
version = int
}
publicIPType = "string"
publicNetworkAccess = "string"
restrictOutboundNetworkAccess = "string"
trustedExternalTenants = [
{
value = "string"
}
]
virtualClusterGraduationProperties = "string"
virtualNetworkConfiguration = {
dataManagementPublicIpId = "string"
enginePublicIpId = "string"
state = "string"
subnetId = "string"
}
}
sku = {
capacity = int
name = "string"
tier = "string"
}
zones = [
"string"
]
}
}
Valores de propiedad
Microsoft.Kusto/clusters
| Nombre | Descripción | Valor |
|---|---|---|
| identidad | Identidad del clúster, si está configurada. | Identidad |
| ubicación | Ubicación geográfica donde reside el recurso | string (obligatorio) |
| nombre | El nombre del recurso | cuerda Restricciones: Patrón = ^.*$ (obligatorio) |
| parent_id | Identificador del recurso al que se va a aplicar este recurso de extensión. | string (obligatorio) |
| Propiedades | Propiedades del clúster. | clusterProperties de |
| Sku | SKU del clúster. | azureSku (obligatorio) |
| Etiquetas | Etiquetas de recursos | Diccionario de nombres y valores de etiqueta. |
| tipo | El tipo de recurso | "Microsoft.Kusto/clusters@2024-04-13" |
| Zonas | Zonas de disponibilidad del clúster. | cadena[] |
AcceptedAudiences
| Nombre | Descripción | Valor |
|---|---|---|
| valor | GUID o dirección URL válida que representa una audiencia aceptada. | cuerda |
AzureSku
| Nombre | Descripción | Valor |
|---|---|---|
| capacidad | Número de instancias del clúster. | Int |
| nombre | Nombre de la SKU. | 'Desarrollo (sin SLA)_Standard_D11_v2' 'Desarrollo (sin SLA)_Standard_E2a_v4' "Standard_D11_v2" "Standard_D12_v2" "Standard_D13_v2" "Standard_D14_v2" "Standard_D16d_v5" "Standard_D32d_v4" "Standard_D32d_v5" "Standard_DS13_v2+1TB_PS" "Standard_DS13_v2+2TB_PS" "Standard_DS14_v2+3TB_PS" "Standard_DS14_v2+4TB_PS" "Standard_E16ads_v5" "Standard_E16as_v4+3TB_PS" "Standard_E16as_v4+4TB_PS" "Standard_E16as_v5+3TB_PS" "Standard_E16as_v5+4TB_PS" "Standard_E16a_v4" "Standard_E16d_v4" "Standard_E16d_v5" "Standard_E16s_v4+3TB_PS" "Standard_E16s_v4+4TB_PS" "Standard_E16s_v5+3TB_PS" "Standard_E16s_v5+4TB_PS" "Standard_E2ads_v5" "Standard_E2a_v4" "Standard_E2d_v4" "Standard_E2d_v5" "Standard_E4ads_v5" "Standard_E4a_v4" "Standard_E4d_v4" "Standard_E4d_v5" "Standard_E64i_v3" "Standard_E80ids_v4" "Standard_E8ads_v5" "Standard_E8as_v4+1TB_PS" "Standard_E8as_v4+2TB_PS" "Standard_E8as_v5+1TB_PS" "Standard_E8as_v5+2TB_PS" "Standard_E8a_v4" "Standard_E8d_v4" "Standard_E8d_v5" "Standard_E8s_v4+1TB_PS" "Standard_E8s_v4+2TB_PS" "Standard_E8s_v5+1TB_PS" "Standard_E8s_v5+2TB_PS" "Standard_EC16ads_v5" "Standard_EC16as_v5+3TB_PS" "Standard_EC16as_v5+4TB_PS" "Standard_EC8ads_v5" "Standard_EC8as_v5+1TB_PS" "Standard_EC8as_v5+2TB_PS" "Standard_L16as_v3" "Standard_L16s" "Standard_L16s_v2" "Standard_L16s_v3" "Standard_L32as_v3" "Standard_L32s_v3" "Standard_L4s" "Standard_L8as_v3" "Standard_L8s" "Standard_L8s_v2" 'Standard_L8s_v3' (obligatorio) |
| nivel | Nivel de SKU. | "Básico" 'Estándar' (obligatorio) |
CalloutPolicy
| Nombre | Descripción | Valor |
|---|---|---|
| calloutType | Tipo del servicio de llamada, especificando el tipo de recurso externo o servicio al que se accede. | "azure_digital_twins" "azure_openai" 'cosmosdb' "external_data" 'Genevometría' 'Kusto' 'mysql' 'postgresql' "sandbox_artifacts" 'sql' 'WebAPI' |
| calloutUriRegex | Expresión regular o patrón FQDN para el URI de la llamada. | cuerda |
| outboundAccess | Indica si se permite el acceso saliente para el patrón de URI especificado. | 'Permitir' 'Denegar' |
ClusterProperties (Propiedades de clúster)
| Nombre | Descripción | Valor |
|---|---|---|
| acceptedAudiences | Audiencias aceptadas del clúster. | acceptedAudiences[] |
| allowedFqdnList | Lista de FQDN permitidos (nombre de dominio completo) para la salida del clúster. | cadena[] |
| allowedIpRangeList | La lista de ips con el formato CIDR permitido para conectarse al clúster. | cadena[] |
| calloutPolicies | Lista de directivas de llamada para la salida del clúster. | CalloutPolicy[] |
| enable AutoStop | Valor booleano que indica si el clúster se podría detener automáticamente (debido a la falta de datos o a ninguna actividad durante muchos días). | Bool |
| enableDiskEncryption | Valor booleano que indica si los discos del clúster están cifrados. | Bool |
| enableDoubleEncryption | Valor booleano que indica si el cifrado doble está habilitado. | Bool |
| enablePurga | Valor booleano que indica si las operaciones de purga están habilitadas. | Bool |
| enableStreamingIngEst | Valor booleano que indica si la ingesta de streaming está habilitada. | Bool |
| engineType | Tipo de motor | 'V2' 'V3' |
| keyVaultProperties | Propiedades de KeyVault para el cifrado del clúster. | KeyVaultProperties |
| languageExtensions | Lista de extensiones de lenguaje del clúster. | LanguageExtensionsList |
| optimizadoAutoscale | Definición de escalado automático optimizada. | Escalado automático optimizado |
| publicIPType | Indica qué tipo de dirección IP pública se va a crear: IPv4 (valor predeterminado) o DualStack (IPv4 e IPv6) | 'Doble pila' 'IPv4' |
| publicNetworkAccess | El acceso de red pública al clúster está habilitado de forma predeterminada. Cuando está deshabilitada, solo se permite la conexión de punto de conexión privado al clúster. | 'Deshabilitado' 'Habilitado' |
| restrictOutboundNetworkAccess | Si se va a restringir o no el acceso de red saliente. El valor es opcional, pero si se pasa, debe ser "Habilitado" o "Deshabilitado". | 'Deshabilitado' 'Habilitado' |
| trustedExternalTenants | Inquilinos externos del clúster. | trustedExternalTenant[] |
| virtualClusterGraduationProperties | Propiedades de graduación de clúster virtual | cuerda Restricciones: Valor confidencial. Pase como parámetro seguro. |
| virtualNetworkConfiguration | Definición de red virtual. | virtualNetworkConfiguration |
ComponentsSgqdofSchemasIdentityPropertiesUserassignedidentitiesAdditionalproperties
| Nombre | Descripción | Valor |
|---|
Identidad
IdentityUserAssignedIdentities
| Nombre | Descripción | Valor |
|---|
KeyVaultProperties
| Nombre | Descripción | Valor |
|---|---|---|
| keyName | Nombre de la clave del almacén de claves. | cuerda |
| keyVaultUri | Identificador URI del almacén de claves. | cuerda |
| keyVersion | Versión de la clave del almacén de claves. | cuerda |
| userIdentity | Identidad asignada por el usuario (identificador de recurso de ARM) que tiene acceso a la clave. | cuerda |
LanguageExtension
| Nombre | Descripción | Valor |
|---|---|---|
| languageExtensionCustomImageName | Nombre de la imagen personalizada de la extensión de lenguaje. | cuerda |
| languageExtensionImageName | Nombre de la imagen de la extensión de idioma. | "Python3_10_8" "Python3_10_8_DL" "Python3_11_7" "Python3_11_7_DL" "Python3_6_5" 'PythonCustomImage' 'R' |
| languageExtensionName | Nombre de la extensión de lenguaje. | 'PITÓN' 'R' |
LanguageExtensionsList
| Nombre | Descripción | Valor |
|---|---|---|
| valor | Lista de extensiones de lenguaje. | Extensión de lenguaje[] |
Escalado automático optimizado
| Nombre | Descripción | Valor |
|---|---|---|
| isEnabled | Valor booleano que indica si la característica de escalabilidad automática optimizada está habilitada o no. | bool (obligatorio) |
| máximo | Número máximo de instancias permitidas. | int (obligatorio) |
| mínimo | Número mínimo de instancias permitidas. | int (obligatorio) |
| Versión | Versión de la plantilla definida, por ejemplo 1. | int (obligatorio) |
TrackedResourceTags
| Nombre | Descripción | Valor |
|---|
TrustedExternalTenant
| Nombre | Descripción | Valor |
|---|---|---|
| valor | GUID que representa un inquilino externo. | cuerda |
VirtualNetworkConfiguration
| Nombre | Descripción | Valor |
|---|---|---|
| dataManagementPublicIpId | Identificador de recurso de la dirección IP pública del servicio de administración de datos. | string (obligatorio) |
| enginePublicIpId | Identificador de recurso de la dirección IP pública del servicio de motor. | string (obligatorio) |
| estado | Cuando se habilita, el clúster se implementa en la subred configurada, cuando se deshabilite se quitará de la subred. | 'Deshabilitado' 'Habilitado' |
| subnetId | Identificador del recurso de subred. | string (obligatorio) |
Ejemplos de uso
Ejemplos de Terraform
Un ejemplo básico de implementación del clúster Kusto (también conocido como Azure Data Explorer).
terraform {
required_providers {
azapi = {
source = "Azure/azapi"
}
}
}
provider "azapi" {
skip_provider_registration = false
}
variable "resource_name" {
type = string
default = "acctest0001"
}
variable "location" {
type = string
default = "westeurope"
}
resource "azapi_resource" "resourceGroup" {
type = "Microsoft.Resources/resourceGroups@2020-06-01"
name = var.resource_name
location = var.location
}
resource "azapi_resource" "cluster" {
type = "Microsoft.Kusto/clusters@2023-05-02"
parent_id = azapi_resource.resourceGroup.id
name = var.resource_name
location = var.location
body = {
properties = {
enableAutoStop = true
enableDiskEncryption = false
enableDoubleEncryption = false
enablePurge = false
enableStreamingIngest = false
engineType = "V2"
publicIPType = "IPv4"
publicNetworkAccess = "Enabled"
restrictOutboundNetworkAccess = "Disabled"
trustedExternalTenants = [
]
}
sku = {
capacity = 1
name = "Dev(No SLA)_Standard_D11_v2"
tier = "Basic"
}
}
schema_validation_enabled = false
response_export_values = ["*"]
}
Un ejemplo básico de implementación del clúster Kusto (también conocido como Azure Data Explorer).
terraform {
required_providers {
azapi = {
source = "Azure/azapi"
}
}
}
provider "azapi" {
skip_provider_registration = false
}
variable "resource_name" {
type = string
default = "acctest0001"
}
variable "location" {
type = string
default = "westeurope"
}
resource "azapi_resource" "resourceGroup" {
type = "Microsoft.Resources/resourceGroups@2020-06-01"
name = var.resource_name
location = var.location
}
resource "azapi_resource" "cluster" {
type = "Microsoft.Kusto/clusters@2023-05-02"
parent_id = azapi_resource.resourceGroup.id
name = var.resource_name
location = var.location
body = {
properties = {
enableAutoStop = true
enableDiskEncryption = false
enableDoubleEncryption = false
enablePurge = false
enableStreamingIngest = false
engineType = "V2"
publicIPType = "IPv4"
publicNetworkAccess = "Enabled"
restrictOutboundNetworkAccess = "Disabled"
trustedExternalTenants = [
]
}
sku = {
capacity = 1
name = "Dev(No SLA)_Standard_D11_v2"
tier = "Basic"
}
}
schema_validation_enabled = false
response_export_values = ["*"]
}
Módulos comprobados de Azure
Los siguientes módulos comprobados de Azure se pueden usar para implementar este tipo de recurso.
| Módulo | Descripción |
|---|---|
| de clústeres de Kusto de | Módulo de recursos de AVM para clústeres de Kusto |