Microsoft.Kusto/clusters 2020-02-15 - Bicep, ARM template & Terraform AzAPI reference

Definición de recursos de Bicep

El tipo de recurso de clústeres se puede implementar con operaciones destinadas a:

grupos de recursos: consulte comandos de implementación de grupos de recursos

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

Formato de recurso

Para crear un recurso Microsoft.Kusto/clusters, agregue el siguiente bicep a la plantilla.

resource symbolicname 'Microsoft.Kusto/clusters@2020-02-15' = {
  identity: {
    type: 'string'
    userAssignedIdentities: {
      {customized property}: {}
    }
  }
  location: 'string'
  name: 'string'
  properties: {
    enableDiskEncryption: bool
    enablePurge: bool
    enableStreamingIngest: bool
    keyVaultProperties: {
      keyName: 'string'
      keyVaultUri: 'string'
      keyVersion: 'string'
    }
    languageExtensions: {
      value: [
        {
          languageExtensionName: 'string'
        }
      ]
    }
    optimizedAutoscale: {
      isEnabled: bool
      maximum: int
      minimum: int
      version: int
    }
    trustedExternalTenants: [
      {
        value: 'string'
      }
    ]
    virtualNetworkConfiguration: {
      dataManagementPublicIpId: 'string'
      enginePublicIpId: 'string'
      subnetId: 'string'
    }
  }
  sku: {
    capacity: int
    name: 'string'
    tier: 'string'
  }
  tags: {
    {customized property}: 'string'
  }
  zones: [
    'string'
  ]
}

Valores de propiedad

AzureSku

Nombre	Descripción	Valor
capacidad	Número de instancias del clúster.	Int
nombre	Nombre de la SKU.	'Dev(No SLA)_Standard_D11_v2' 'Dev(No SLA)_Standard_E2a_v4' "Standard_D11_v2" "Standard_D12_v2" "Standard_D13_v2" "Standard_D14_v2" "Standard_DS13_v2+1TB_PS" "Standard_DS13_v2+2TB_PS" "Standard_DS14_v2+3TB_PS" "Standard_DS14_v2+4TB_PS" "Standard_E16as_v4+3TB_PS" "Standard_E16as_v4+4TB_PS" "Standard_E16a_v4" "Standard_E2a_v4" "Standard_E4a_v4" "Standard_E8as_v4+1TB_PS" "Standard_E8as_v4+2TB_PS" "Standard_E8a_v4" "Standard_L16s" "Standard_L4s" 'Standard_L8s' (obligatorio)
nivel	Nivel de SKU.	"Básico" 'Estándar' (obligatorio)

ClusterProperties

Nombre	Descripción	Valor
enableDiskEncryption	Valor booleano que indica si los discos del clúster están cifrados.	Bool
enablePurge	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
keyVaultProperties	Propiedades de KeyVault para el cifrado del clúster.	KeyVaultProperties
languageExtensions	Lista de extensiones de lenguaje del clúster.	LanguageExtensionsList
optimizedAutoscale	Definición de escalado automático optimizada.	OptimizedAutoscale
trustedExternalTenants	Inquilinos externos del clúster.	trustedExternalTenant[]
virtualNetworkConfiguration	Definición de red virtual.	virtualNetworkConfiguration

ComponentsSgqdofSchemasIdentityPropertiesUserassignedidentitiesAdditionalproperties

Nombre	Descripción	Valor

Identidad

Nombre	Descripción	Valor
tipo	Tipo de identidad.	'Ninguno' 'SystemAssigned' (obligatorio)
userAssignedIdentities	Lista de identidades de usuario asociadas al clúster de Kusto. Las referencias de clave de diccionario de identidad de usuario serán identificadores de recursos de ARM con el formato: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}'.	IdentityUserAssignedIdentities

IdentityUserAssignedIdentities

Nombre	Descripción	Valor

KeyVaultProperties

Nombre	Descripción	Valor
keyName	Nombre de la clave del almacén de claves.	string (obligatorio)
keyVaultUri	Identificador URI del almacén de claves.	string (obligatorio)
keyVersion	Versión de la clave del almacén de claves.	string (obligatorio)

LanguageExtension

Nombre	Descripción	Valor
languageExtensionName	Nombre de la extensión de lenguaje.	'PYTHON' 'R'

LanguageExtensionsList

Nombre	Descripción	Valor
valor	Lista de extensiones de lenguaje.	LanguageExtension[]

Microsoft.Kusto/clusters

Nombre	Descripción	Valor
identidad	Identidad del clúster, si está configurada.	Identity
ubicación	Ubicación geográfica donde reside el recurso	string (obligatorio)
nombre	El nombre del recurso	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. Consulte etiquetas de en plantillas
Zonas	Zonas de disponibilidad del clúster.	string[]

OptimizedAutoscale

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)
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:

grupos de recursos: consulte comandos de implementación de grupos de recursos

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

Formato de recurso

Para crear un recurso Microsoft.Kusto/clusters, agregue el siguiente JSON a la plantilla.

{
  "type": "Microsoft.Kusto/clusters",
  "apiVersion": "2020-02-15",
  "name": "string",
  "identity": {
    "type": "string",
    "userAssignedIdentities": {
      "{customized property}": {
      }
    }
  },
  "location": "string",
  "properties": {
    "enableDiskEncryption": "bool",
    "enablePurge": "bool",
    "enableStreamingIngest": "bool",
    "keyVaultProperties": {
      "keyName": "string",
      "keyVaultUri": "string",
      "keyVersion": "string"
    },
    "languageExtensions": {
      "value": [
        {
          "languageExtensionName": "string"
        }
      ]
    },
    "optimizedAutoscale": {
      "isEnabled": "bool",
      "maximum": "int",
      "minimum": "int",
      "version": "int"
    },
    "trustedExternalTenants": [
      {
        "value": "string"
      }
    ],
    "virtualNetworkConfiguration": {
      "dataManagementPublicIpId": "string",
      "enginePublicIpId": "string",
      "subnetId": "string"
    }
  },
  "sku": {
    "capacity": "int",
    "name": "string",
    "tier": "string"
  },
  "tags": {
    "{customized property}": "string"
  },
  "zones": [ "string" ]
}

Valores de propiedad

AzureSku

Nombre	Descripción	Valor
capacidad	Número de instancias del clúster.	Int
nombre	Nombre de la SKU.	'Dev(No SLA)_Standard_D11_v2' 'Dev(No SLA)_Standard_E2a_v4' "Standard_D11_v2" "Standard_D12_v2" "Standard_D13_v2" "Standard_D14_v2" "Standard_DS13_v2+1TB_PS" "Standard_DS13_v2+2TB_PS" "Standard_DS14_v2+3TB_PS" "Standard_DS14_v2+4TB_PS" "Standard_E16as_v4+3TB_PS" "Standard_E16as_v4+4TB_PS" "Standard_E16a_v4" "Standard_E2a_v4" "Standard_E4a_v4" "Standard_E8as_v4+1TB_PS" "Standard_E8as_v4+2TB_PS" "Standard_E8a_v4" "Standard_L16s" "Standard_L4s" 'Standard_L8s' (obligatorio)
nivel	Nivel de SKU.	"Básico" 'Estándar' (obligatorio)

ClusterProperties

Nombre	Descripción	Valor
enableDiskEncryption	Valor booleano que indica si los discos del clúster están cifrados.	Bool
enablePurge	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
keyVaultProperties	Propiedades de KeyVault para el cifrado del clúster.	KeyVaultProperties
languageExtensions	Lista de extensiones de lenguaje del clúster.	LanguageExtensionsList
optimizedAutoscale	Definición de escalado automático optimizada.	OptimizedAutoscale
trustedExternalTenants	Inquilinos externos del clúster.	trustedExternalTenant[]
virtualNetworkConfiguration	Definición de red virtual.	virtualNetworkConfiguration

ComponentsSgqdofSchemasIdentityPropertiesUserassignedidentitiesAdditionalproperties

Nombre	Descripción	Valor

Identidad

Nombre	Descripción	Valor
tipo	Tipo de identidad.	'Ninguno' 'SystemAssigned' (obligatorio)
userAssignedIdentities	Lista de identidades de usuario asociadas al clúster de Kusto. Las referencias de clave de diccionario de identidad de usuario serán identificadores de recursos de ARM con el formato: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}'.	IdentityUserAssignedIdentities

IdentityUserAssignedIdentities

Nombre	Descripción	Valor

KeyVaultProperties

Nombre	Descripción	Valor
keyName	Nombre de la clave del almacén de claves.	string (obligatorio)
keyVaultUri	Identificador URI del almacén de claves.	string (obligatorio)
keyVersion	Versión de la clave del almacén de claves.	string (obligatorio)

LanguageExtension

Nombre	Descripción	Valor
languageExtensionName	Nombre de la extensión de lenguaje.	'PYTHON' 'R'

LanguageExtensionsList

Nombre	Descripción	Valor
valor	Lista de extensiones de lenguaje.	LanguageExtension[]

Microsoft.Kusto/clusters

Nombre	Descripción	Valor
apiVersion	La versión de api	'2020-02-15'
identidad	Identidad del clúster, si está configurada.	Identity
ubicación	Ubicación geográfica donde reside el recurso	string (obligatorio)
nombre	El nombre del recurso	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. Consulte etiquetas de en plantillas
tipo	El tipo de recurso	"Microsoft.Kusto/clusters"
Zonas	Zonas de disponibilidad del clúster.	string[]

OptimizedAutoscale

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)
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:

grupos de recursos de

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@2020-02-15"
  name = "string"
  identity = {
    type = "string"
    userAssignedIdentities = {
      {customized property} = {
      }
    }
  }
  location = "string"
  sku = {
    capacity = int
    name = "string"
    tier = "string"
  }
  tags = {
    {customized property} = "string"
  }
  zones = [
    "string"
  ]
  body = jsonencode({
    properties = {
      enableDiskEncryption = bool
      enablePurge = bool
      enableStreamingIngest = bool
      keyVaultProperties = {
        keyName = "string"
        keyVaultUri = "string"
        keyVersion = "string"
      }
      languageExtensions = {
        value = [
          {
            languageExtensionName = "string"
          }
        ]
      }
      optimizedAutoscale = {
        isEnabled = bool
        maximum = int
        minimum = int
        version = int
      }
      trustedExternalTenants = [
        {
          value = "string"
        }
      ]
      virtualNetworkConfiguration = {
        dataManagementPublicIpId = "string"
        enginePublicIpId = "string"
        subnetId = "string"
      }
    }
  })
}

Valores de propiedad

AzureSku

Nombre	Descripción	Valor
capacidad	Número de instancias del clúster.	Int
nombre	Nombre de la SKU.	'Dev(No SLA)_Standard_D11_v2' 'Dev(No SLA)_Standard_E2a_v4' "Standard_D11_v2" "Standard_D12_v2" "Standard_D13_v2" "Standard_D14_v2" "Standard_DS13_v2+1TB_PS" "Standard_DS13_v2+2TB_PS" "Standard_DS14_v2+3TB_PS" "Standard_DS14_v2+4TB_PS" "Standard_E16as_v4+3TB_PS" "Standard_E16as_v4+4TB_PS" "Standard_E16a_v4" "Standard_E2a_v4" "Standard_E4a_v4" "Standard_E8as_v4+1TB_PS" "Standard_E8as_v4+2TB_PS" "Standard_E8a_v4" "Standard_L16s" "Standard_L4s" 'Standard_L8s' (obligatorio)
nivel	Nivel de SKU.	"Básico" 'Estándar' (obligatorio)

ClusterProperties

Nombre	Descripción	Valor
enableDiskEncryption	Valor booleano que indica si los discos del clúster están cifrados.	Bool
enablePurge	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
keyVaultProperties	Propiedades de KeyVault para el cifrado del clúster.	KeyVaultProperties
languageExtensions	Lista de extensiones de lenguaje del clúster.	LanguageExtensionsList
optimizedAutoscale	Definición de escalado automático optimizada.	OptimizedAutoscale
trustedExternalTenants	Inquilinos externos del clúster.	trustedExternalTenant[]
virtualNetworkConfiguration	Definición de red virtual.	virtualNetworkConfiguration

ComponentsSgqdofSchemasIdentityPropertiesUserassignedidentitiesAdditionalproperties

Nombre	Descripción	Valor

Identidad

Nombre	Descripción	Valor
tipo	Tipo de identidad.	'Ninguno' 'SystemAssigned' (obligatorio)
userAssignedIdentities	Lista de identidades de usuario asociadas al clúster de Kusto. Las referencias de clave de diccionario de identidad de usuario serán identificadores de recursos de ARM con el formato: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}'.	IdentityUserAssignedIdentities

IdentityUserAssignedIdentities

Nombre	Descripción	Valor

KeyVaultProperties

Nombre	Descripción	Valor
keyName	Nombre de la clave del almacén de claves.	string (obligatorio)
keyVaultUri	Identificador URI del almacén de claves.	string (obligatorio)
keyVersion	Versión de la clave del almacén de claves.	string (obligatorio)

LanguageExtension

Nombre	Descripción	Valor
languageExtensionName	Nombre de la extensión de lenguaje.	'PYTHON' 'R'

LanguageExtensionsList

Nombre	Descripción	Valor
valor	Lista de extensiones de lenguaje.	LanguageExtension[]

Microsoft.Kusto/clusters

Nombre	Descripción	Valor
identidad	Identidad del clúster, si está configurada.	Identity
ubicación	Ubicación geográfica donde reside el recurso	string (obligatorio)
nombre	El nombre del recurso	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@2020-02-15"
Zonas	Zonas de disponibilidad del clúster.	string[]

OptimizedAutoscale

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)
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ústeres de Kusto de	Módulo de recursos de AVM para clústeres de Kusto

Compartir a través de

Clústeres de Microsoft.Kusto 2020-02-15

Definición de recursos de Bicep

Formato de recurso

Valores de propiedad

AzureSku

ClusterProperties

ComponentsSgqdofSchemasIdentityPropertiesUserassignedidentitiesAdditionalproperties

Identidad

IdentityUserAssignedIdentities

KeyVaultProperties

LanguageExtension

LanguageExtensionsList

Microsoft.Kusto/clusters

OptimizedAutoscale

TrackedResourceTags

TrustedExternalTenant

VirtualNetworkConfiguration

Ejemplos de uso

Módulos comprobados de Azure

Ejemplos de inicio rápido de Azure

Definición de recursos de plantilla de ARM

Formato de recurso

Valores de propiedad

AzureSku

ClusterProperties

ComponentsSgqdofSchemasIdentityPropertiesUserassignedidentitiesAdditionalproperties

Identidad

IdentityUserAssignedIdentities

KeyVaultProperties

LanguageExtension

LanguageExtensionsList

Microsoft.Kusto/clusters

OptimizedAutoscale

TrackedResourceTags

TrustedExternalTenant

VirtualNetworkConfiguration

Ejemplos de uso

Plantillas de inicio rápido de Azure

Definición de recursos de Terraform (proveedor AzAPI)

Formato de recurso

Valores de propiedad

AzureSku

ClusterProperties

ComponentsSgqdofSchemasIdentityPropertiesUserassignedidentitiesAdditionalproperties

Identidad

IdentityUserAssignedIdentities

KeyVaultProperties

LanguageExtension

LanguageExtensionsList

Microsoft.Kusto/clusters

OptimizedAutoscale

TrackedResourceTags

TrustedExternalTenant

VirtualNetworkConfiguration

Ejemplos de uso

Módulos comprobados de Azure

Comentarios

Recursos adicionales