Compartir a través de


Clústeres de Microsoft.Kusto 2020-06-14

Definición de recursos de Bicep

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

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@2020-06-14' = {
  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
    enableDoubleEncryption: bool
    enablePurge: 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
enableDoubleEncryption Valor booleano que indica si está habilitado el cifrado doble. 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
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 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'
'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_E16a_v4'
'Standard_E16as_v4+3TB_PS'
'Standard_E16as_v4+4TB_PS'
'Standard_E2a_v4'
'Standard_E4a_v4'
'Standard_E8a_v4'
'Standard_E8as_v4+1TB_PS'
'Standard_E8as_v4+2TB_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

Implementación en Azure
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

Implementación en Azure
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

Implementación en Azure
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

Implementación en Azure
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

Implementación en Azure
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:

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": "2020-06-14",
  "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",
    "enableDoubleEncryption": "bool",
    "enablePurge": "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 '2020-06-14'
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
enableDoubleEncryption Valor booleano que indica si está habilitado el cifrado doble. 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
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'
'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_E16a_v4'
'Standard_E16as_v4+3TB_PS'
'Standard_E16as_v4+4TB_PS'
'Standard_E2a_v4'
'Standard_E4a_v4'
'Standard_E8a_v4'
'Standard_E8as_v4+1TB_PS'
'Standard_E8as_v4+2TB_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

Implementación en Azure
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

Implementación en Azure
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

Implementación en Azure
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

Implementación en Azure
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

Implementación en Azure
Esta plantilla le permite implementar un clúster en la red virtual.

Definición de recursos de Terraform (proveedor AzAPI)

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

  • 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@2020-06-14"
  name = "string"
  location = "string"
  parent_id = "string"
  tags = {
    tagName1 = "tagValue1"
    tagName2 = "tagValue2"
  }
  identity {
    type =  "SystemAssigned"
    identity_ids = []
  }
  body = jsonencode({
    properties = {
      enableDiskEncryption = bool
      enableDoubleEncryption = bool
      enablePurge = 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@2020-06-14"
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
enableDoubleEncryption Valor booleano que indica si está habilitado el cifrado doble. 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
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"
"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_E16a_v4"
"Standard_E16as_v4+3TB_PS"
"Standard_E16as_v4+4TB_PS"
"Standard_E2a_v4"
"Standard_E4a_v4"
"Standard_E8a_v4"
"Standard_E8as_v4+1TB_PS"
"Standard_E8as_v4+2TB_PS"
"Standard_L16s"
"Standard_L4s"
"Standard_L8s" (obligatorio)
Nivel: Nivel de SKU. "Básica"
"Estándar" (obligatorio)