Clústeres de Microsoft.Kusto 2019-09-07

Artículo
01/14/2024

Definición de recursos de Bicep

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

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.Kusto/clusters, agregue el siguiente bicep a la plantilla.

resource symbolicname 'Microsoft.Kusto/clusters@2019-09-07' = {
  name: 'string'
  location: 'string'
  tags: {
    tagName1: 'tagValue1'
    tagName2: 'tagValue2'
  }
  sku: {
    capacity: int
    name: 'string'
    tier: 'string'
  }
  identity: {
    type: 'string'
    userAssignedIdentities: {
      {customized property}: {}
    }
  }
  properties: {
    enableDiskEncryption: bool
    enableStreamingIngest: bool
    keyVaultProperties: {
      keyName: 'string'
      keyVaultUri: 'string'
      keyVersion: 'string'
    }
    optimizedAutoscale: {
      isEnabled: bool
      maximum: int
      minimum: int
      version: int
    }
    trustedExternalTenants: [
      {
        value: 'string'
      }
    ]
    virtualNetworkConfiguration: {
      dataManagementPublicIpId: 'string'
      enginePublicIpId: 'string'
      subnetId: 'string'
    }
  }
  zones: [
    'string'
  ]
}

Valores de propiedad

clusters

Nombre	Descripción	Value
name	El nombre del recurso	string (obligatorio) Límite de caracteres: 4-22 Caracteres válidos: Letras minúsculas y números. Comience con una letra. El nombre del recurso debe ser único en Azure.
ubicación	Ubicación geográfica donde reside el recurso	string (obligatorio)
etiquetas	Etiquetas del recurso.	Diccionario de nombres y valores de etiqueta. Consulte Etiquetas en plantillas.
sku	SKU del clúster.	AzureSku (obligatorio)
identidad	Identidad del clúster, si está configurada.	Identidad
properties	Propiedades del clúster.	ClusterProperties
zones	Zonas de disponibilidad del clúster.	string[]

Identidad

Nombre	Descripción	Value
type	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 identidades de usuario serán identificadores de recurso de ARM con el formato : '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}'.	IdentityUserAssignedIdentities

IdentityUserAssignedIdentities

Nombre	Descripción	Valor
{propiedad personalizada}		ComponentsSgqdofSchemasIdentityPropertiesUserassigne...

ComponentsSgqdofSchemasIdentityPropertiesUserassigne...

Este objeto no contiene ninguna propiedad que se va a establecer durante la implementación. Todas las propiedades son ReadOnly.

ClusterProperties

Nombre	Descripción	Valor
enableDiskEncryption	Valor booleano que indica si los discos del clúster están cifrados.	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
optimizedAutoscale	Definición de escalado automático optimizada.	OptimizedAutoscale
trustedExternalTenants	Inquilinos externos del clúster.	TrustedExternalTenant[]
virtualNetworkConfiguration	Definición de red virtual.	VirtualNetworkConfiguration

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)

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)
maximum	Número máximo de instancias permitidas.	int (obligatorio)
minimum	Recuento mínimo de instancias permitidas.	int (obligatorio)
version	La versión de la plantilla definida, por ejemplo 1.	int (obligatorio)

TrustedExternalTenant

Nombre	Descripción	Valor
value	GUID que representa un inquilino externo.	string

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 dirección IP pública del servicio del motor.	string (obligatorio)
subnetId	Identificador del recurso de subred.	string (obligatorio)

AzureSku

Nombre	Descripción	Valor
capacity	Número de instancias del clúster.	int
name	Nombre de la SKU.	'Dev(No SLA)_Standard_D11_v2' '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_L16s' 'Standard_L4s' 'Standard_L8s' (obligatorio)
Nivel:	Nivel de SKU.	"Básico" 'Estándar' (obligatorio)

Plantillas de inicio rápido

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

Plantilla	Descripción
Azure Digital Twins con conexión de historial de datos de tiempo	Esta plantilla crea una instancia de Azure Digital Twins configurada con una conexión de 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
Creación de un clúster de una base de datos	Esta plantilla permite crear un clúster y una base de datos.
Implementación de Azure Data Explorer DB con conexión de Cosmos DB	Implemente Azure Data Explorer DB con la conexión de Cosmos DB.
Implementación de Azure Data Explorer db con la conexión del centro de eventos	Implemente Azure Data Explorer db con la conexión del centro de eventos.
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.

Definición de recursos de plantilla de ARM

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

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.Kusto/clusters, agregue el siguiente json a la plantilla.

{
  "type": "Microsoft.Kusto/clusters",
  "apiVersion": "2019-09-07",
  "name": "string",
  "location": "string",
  "tags": {
    "tagName1": "tagValue1",
    "tagName2": "tagValue2"
  },
  "sku": {
    "capacity": "int",
    "name": "string",
    "tier": "string"
  },
  "identity": {
    "type": "string",
    "userAssignedIdentities": {
      "{customized property}": {}
    }
  },
  "properties": {
    "enableDiskEncryption": "bool",
    "enableStreamingIngest": "bool",
    "keyVaultProperties": {
      "keyName": "string",
      "keyVaultUri": "string",
      "keyVersion": "string"
    },
    "optimizedAutoscale": {
      "isEnabled": "bool",
      "maximum": "int",
      "minimum": "int",
      "version": "int"
    },
    "trustedExternalTenants": [
      {
        "value": "string"
      }
    ],
    "virtualNetworkConfiguration": {
      "dataManagementPublicIpId": "string",
      "enginePublicIpId": "string",
      "subnetId": "string"
    }
  },
  "zones": [ "string" ]
}

Valores de propiedad

clusters

Nombre	Descripción	Value
type	Tipo de recurso	"Microsoft.Kusto/clusters"
apiVersion	La versión de la API de recursos	'2019-09-07'
name	El nombre del recurso	string (obligatorio) Límite de caracteres: 4-22 Caracteres válidos: Letras minúsculas y números. Comience con una letra. El nombre del recurso debe ser único en Azure.
ubicación	Ubicación geográfica donde reside el recurso	string (obligatorio)
etiquetas	Etiquetas del recurso.	Diccionario de nombres y valores de etiqueta. Consulte Etiquetas en plantillas.
sku	SKU del clúster.	AzureSku (obligatorio)
identidad	Identidad del clúster, si está configurada.	Identidad
properties	Propiedades del clúster.	ClusterProperties
zones	Zonas de disponibilidad del clúster.	string[]

Identidad

Nombre	Descripción	Value
type	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 identidades de usuario serán identificadores de recurso de ARM con el formato : '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}'.	IdentityUserAssignedIdentities

IdentityUserAssignedIdentities

Nombre	Descripción	Valor
{propiedad personalizada}		ComponentsSgqdofSchemasIdentityPropertiesUserassigne...

ComponentsSgqdofSchemasIdentityPropertiesUserassigne...

Este objeto no contiene ninguna propiedad que se va a establecer durante la implementación. Todas las propiedades son ReadOnly.

ClusterProperties

Nombre	Descripción	Valor
enableDiskEncryption	Valor booleano que indica si los discos del clúster están cifrados.	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
optimizedAutoscale	Definición de escalado automático optimizada.	OptimizedAutoscale
trustedExternalTenants	Inquilinos externos del clúster.	TrustedExternalTenant[]
virtualNetworkConfiguration	Definición de red virtual.	VirtualNetworkConfiguration

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)

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)
maximum	Recuento máximo de instancias permitidas.	int (obligatorio)
minimum	Recuento mínimo de instancias permitidas.	int (obligatorio)
version	Versión de la plantilla definida, por ejemplo 1.	int (obligatorio)

TrustedExternalTenant

Nombre	Descripción	Valor
value	GUID que representa un inquilino externo.	string

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 dirección IP pública del servicio del motor.	string (obligatorio)
subnetId	Identificador del recurso de subred.	string (obligatorio)

AzureSku

Nombre	Descripción	Valor
capacity	Número de instancias del clúster.	int
name	Nombre de la SKU.	'Dev(No SLA)_Standard_D11_v2' '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_L16s' 'Standard_L4s' 'Standard_L8s' (obligatorio)
Nivel:	Nivel de SKU.	'Básico' 'Standard' (obligatorio)

Plantillas de inicio rápido

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

Plantilla	Descripción
Azure Digital Twins con conexión de historial de datos temporales	Esta plantilla crea una instancia de Azure Digital Twins configurada con una conexión de 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, finalmente, 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
Creación de un clúster de una base de datos	Esta plantilla permite crear un clúster y una base de datos.
Implementación de Azure Data Explorer DB con conexión de Cosmos DB	Implemente Azure Data Explorer DB con la conexión de Cosmos DB.
Implementación de Azure Data Explorer db con conexión del centro de eventos	Implemente Azure Data Explorer db con la conexión del centro de eventos.
Implementación de un clúster de Azure Data Explorer en la red virtual	Esta plantilla le permite implementar un clúster en la red virtual.

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

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.Kusto/clusters, agregue el siguiente terraform a la plantilla.

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.Kusto/clusters@2019-09-07"
  name = "string"
  location = "string"
  parent_id = "string"
  tags = {
    tagName1 = "tagValue1"
    tagName2 = "tagValue2"
  }
  identity {
    type =  "SystemAssigned"
    identity_ids = []
  }
  body = jsonencode({
    properties = {
      enableDiskEncryption = bool
      enableStreamingIngest = bool
      keyVaultProperties = {
        keyName = "string"
        keyVaultUri = "string"
        keyVersion = "string"
      }
      optimizedAutoscale = {
        isEnabled = bool
        maximum = int
        minimum = int
        version = int
      }
      trustedExternalTenants = [
        {
          value = "string"
        }
      ]
      virtualNetworkConfiguration = {
        dataManagementPublicIpId = "string"
        enginePublicIpId = "string"
        subnetId = "string"
      }
    }
    zones = [
      "string"
    ]
    sku = {
      capacity = int
      name = "string"
      tier = "string"
    }
  })
}

Valores de propiedad

clusters

Nombre	Descripción	Value
type	Tipo de recurso	"Microsoft.Kusto/clusters@2019-09-07"
name	El nombre del recurso	string (obligatorio) Límite de caracteres: 4-22 Caracteres válidos: Letras minúsculas y números. Comience con una letra. El nombre del recurso debe ser único en Azure.
ubicación	Ubicación geográfica donde reside el 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 del clúster.	AzureSku (obligatorio)
identidad	Identidad del clúster, si está configurada.	Identidad
properties	Propiedades del clúster.	ClusterProperties
zones	Zonas de disponibilidad del clúster.	string[]

Identidad

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

IdentityUserAssignedIdentities

Nombre	Descripción	Valor
{propiedad personalizada}		ComponentsSgqdofSchemasIdentityPropertiesUserassigne...

ComponentsSgqdofSchemasIdentityPropertiesUserassigne...

Este objeto no contiene ninguna propiedad que se va a establecer durante la implementación. Todas las propiedades son ReadOnly.

ClusterProperties

Nombre	Descripción	Valor
enableDiskEncryption	Valor booleano que indica si los discos del clúster están cifrados.	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
optimizedAutoscale	Definición de escalado automático optimizada.	OptimizedAutoscale
trustedExternalTenants	Inquilinos externos del clúster.	TrustedExternalTenant[]
virtualNetworkConfiguration	Definición de red virtual.	VirtualNetworkConfiguration

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)

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)
maximum	Número máximo de instancias permitidas.	int (obligatorio)
minimum	Recuento mínimo de instancias permitidas.	int (obligatorio)
version	La versión de la plantilla definida, por ejemplo 1.	int (obligatorio)

TrustedExternalTenant

Nombre	Descripción	Valor
value	GUID que representa un inquilino externo.	string

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 dirección IP pública del servicio del motor.	string (obligatorio)
subnetId	Identificador del recurso de subred.	string (obligatorio)

AzureSku

Nombre	Descripción	Valor
capacity	Número de instancias del clúster.	int
name	Nombre de la SKU.	"Dev(No SLA)_Standard_D11_v2" "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_L16s" "Standard_L4s" "Standard_L8s" (obligatorio)
Nivel:	Nivel de SKU.	"Básica" "Estándar" (obligatorio)

Compartir a través de

Clústeres de Microsoft.Kusto 2019-09-07

Definición de recursos de Bicep

Formato de los recursos

Valores de propiedad

clusters

Identidad

IdentityUserAssignedIdentities

ComponentsSgqdofSchemasIdentityPropertiesUserassigne...

ClusterProperties

KeyVaultProperties

OptimizedAutoscale

TrustedExternalTenant

VirtualNetworkConfiguration

AzureSku

Plantillas de inicio rápido

Definición de recursos de plantilla de ARM

Formato de los recursos

Valores de propiedad

clusters

Identidad

IdentityUserAssignedIdentities

ComponentsSgqdofSchemasIdentityPropertiesUserassigne...

ClusterProperties

KeyVaultProperties

OptimizedAutoscale

TrustedExternalTenant

VirtualNetworkConfiguration

AzureSku

Plantillas de inicio rápido

Definición de recursos de Terraform (proveedor AzAPI)

Formato de los recursos

Valores de propiedad

clusters

Identidad

IdentityUserAssignedIdentities

ComponentsSgqdofSchemasIdentityPropertiesUserassigne...

ClusterProperties

KeyVaultProperties

OptimizedAutoscale

TrustedExternalTenant

VirtualNetworkConfiguration

AzureSku

Comentarios

Recursos adicionales