Microsoft.Kusto/clusters 2020-09-18 - 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-09-18' = {
  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
    engineType: 'string'
    keyVaultProperties: {
      keyName: 'string'
      keyVaultUri: 'string'
      keyVersion: 'string'
      userIdentity: '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

Racimos

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

Identidad

Nombre	Descripción	Valor
tipo	Tipo de identidad administrada usada. El tipo "SystemAssigned, UserAssigned" incluye una identidad creada implícitamente y un conjunto de identidades asignadas por el usuario. El tipo "None" quitará todas las identidades.	'Ninguno' 'SystemAssigned' 'SystemAssigned, UserAssigned' 'UserAssigned' (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
{propiedad personalizada}		componentes de SgqdofSchemasIdentityPropertiesUserassigne...

ComponentsSgqdofSchemasIdentityPropertiesUserassigne...

Este objeto no contiene ninguna propiedad que se establezca 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 el cifrado doble está habilitado.	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
engineType	Tipo de motor	'V2' 'V3'
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.	cuerda
userIdentity	Identidad asignada por el usuario (identificador de recurso de ARM) que tiene acceso a la clave.	cuerda

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)

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)

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_E16a_v4" "Standard_E16as_v4+3TB_PS" "Standard_E16as_v4+4TB_PS" "Standard_E2a_v4" "Standard_E4a_v4" "Standard_E64i_v3" "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
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.
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.
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.
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 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-09-18",
  "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",
    "engineType": "string",
    "keyVaultProperties": {
      "keyName": "string",
      "keyVaultUri": "string",
      "keyVersion": "string",
      "userIdentity": "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

Racimos

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

Identidad

Nombre	Descripción	Valor
tipo	Tipo de identidad administrada usada. El tipo "SystemAssigned, UserAssigned" incluye una identidad creada implícitamente y un conjunto de identidades asignadas por el usuario. El tipo "None" quitará todas las identidades.	'Ninguno' 'SystemAssigned' 'SystemAssigned, UserAssigned' 'UserAssigned' (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
{propiedad personalizada}		componentes de SgqdofSchemasIdentityPropertiesUserassigne...

ComponentsSgqdofSchemasIdentityPropertiesUserassigne...

Este objeto no contiene ninguna propiedad que se establezca 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 el cifrado doble está habilitado.	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
engineType	Tipo de motor	'V2' 'V3'
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.	cuerda
userIdentity	Identidad asignada por el usuario (identificador de recurso de ARM) que tiene acceso a la clave.	cuerda

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)

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)

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_E16a_v4" "Standard_E16as_v4+3TB_PS" "Standard_E16as_v4+4TB_PS" "Standard_E2a_v4" "Standard_E4a_v4" "Standard_E64i_v3" "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
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.
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.
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.
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 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-09-18"
  name = "string"
  location = "string"
  parent_id = "string"
  tags = {
    tagName1 = "tagValue1"
    tagName2 = "tagValue2"
  }
  identity {
    type = "string"
    identity_ids = []
  }
  body = jsonencode({
    properties = {
      enableDiskEncryption = bool
      enableDoubleEncryption = bool
      enablePurge = bool
      enableStreamingIngest = bool
      engineType = "string"
      keyVaultProperties = {
        keyName = "string"
        keyVaultUri = "string"
        keyVersion = "string"
        userIdentity = "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

Racimos

Nombre	Descripción	Valor
tipo	El tipo de recurso	"Microsoft.Kusto/clusters@2020-09-18"
nombre	El nombre del recurso	string (obligatorio) Límite de caracteres: 4-22 Caracteres válidos: Letras minúsculas y números. Comience con la 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 de recursos.	Diccionario de nombres y valores de etiqueta.
Sku	SKU del clúster.	azureSku (obligatorio)
identidad	Identidad del clúster, si está configurada.	Identity
Propiedades	Propiedades del clúster.	clusterProperties de
Zonas	Zonas de disponibilidad del clúster.	string[]

Identidad

Nombre	Descripción	Valor
tipo	Tipo de identidad administrada usada. El tipo "SystemAssigned, UserAssigned" incluye una identidad creada implícitamente y un conjunto de identidades asignadas por el usuario. El tipo "None" quitará todas las identidades.	"SystemAssigned" "SystemAssigned, UserAssigned" "UserAssigned" (obligatorio)
identity_ids	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}'.	Matriz de identificadores de identidad de usuario.

IdentityUserAssignedIdentities

Nombre	Descripción	Valor
{propiedad personalizada}		componentes de SgqdofSchemasIdentityPropertiesUserassigne...

ComponentsSgqdofSchemasIdentityPropertiesUserassigne...

Este objeto no contiene ninguna propiedad que se establezca 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 el cifrado doble está habilitado.	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
engineType	Tipo de motor	"V2" "V3"
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.	cuerda
userIdentity	Identidad asignada por el usuario (identificador de recurso de ARM) que tiene acceso a la clave.	cuerda

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)

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)

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_E16a_v4" "Standard_E16as_v4+3TB_PS" "Standard_E16as_v4+4TB_PS" "Standard_E2a_v4" "Standard_E4a_v4" "Standard_E64i_v3" "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)

Compartir a través de

Clústeres de Microsoft.Kusto 2020-09-18

Definición de recursos de Bicep

Formato de recurso

Valores de propiedad

Racimos

Identidad

IdentityUserAssignedIdentities

ComponentsSgqdofSchemasIdentityPropertiesUserassigne...

ClusterProperties

KeyVaultProperties

OptimizedAutoscale

TrustedExternalTenant

VirtualNetworkConfiguration

AzureSku

Plantillas de inicio rápido

Definición de recursos de plantilla de ARM

Formato de recurso

Valores de propiedad

Racimos

Identidad

IdentityUserAssignedIdentities

ComponentsSgqdofSchemasIdentityPropertiesUserassigne...

ClusterProperties

KeyVaultProperties

OptimizedAutoscale

TrustedExternalTenant

VirtualNetworkConfiguration

AzureSku

Plantillas de inicio rápido

Definición de recursos de Terraform (proveedor AzAPI)

Formato de recurso

Valores de propiedad

Racimos

Identidad

IdentityUserAssignedIdentities

ComponentsSgqdofSchemasIdentityPropertiesUserassigne...

ClusterProperties

KeyVaultProperties

OptimizedAutoscale

TrustedExternalTenant

VirtualNetworkConfiguration

AzureSku

Comentarios

Recursos adicionales