Share via


Clusters Microsoft.Kusto 2020-06-14

Définition de ressource Bicep

Le type de ressource de clusters peut être déployé avec des opérations qui ciblent :

Pour obtenir la liste des propriétés modifiées dans chaque version d’API, consultez journal des modifications.

Format des ressources

Pour créer une ressource Microsoft.Kusto/clusters, ajoutez le Bicep suivant à votre modèle.

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'
  ]
}

Valeurs de propriétés

clusters

Nom Description Valeur
name Nom de la ressource string (obligatoire)

Limite de caractères : 4-22

Caractères valides :
Lettres minuscules et chiffres.

Doit commencer par une lettre.

Le nom de la ressource doit être unique dans Azure.
location Emplacement géographique où réside la ressource string (obligatoire)
tags Balises de ressource. Dictionnaire de noms et de valeurs d’étiquettes. Voir Balises dans les modèles
sku Référence SKU du cluster. AzureSku (obligatoire)
identité Identité du cluster, si elle est configurée. Identité
properties Propriétés du cluster. ClusterProperties
zones Zones de disponibilité du cluster. string[]

Identité

Nom Description Valeur
type Type d’identité. 'None'
'SystemAssigned' (obligatoire)
userAssignedIdentities Liste des identités utilisateur associées au cluster Kusto. Les références de clé de dictionnaire d’identité utilisateur sont des ID de ressource ARM au format « /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName} ». IdentityUserAssignedIdentities

IdentityUserAssignedIdentities

Nom Description Valeur
{propriété personnalisée} ComponentsSgqdofSchemasIdentityPropertiesUserassigne...

ComponentsSgqdofSchemasIdentityPropertiesUserassigne...

Cet objet ne contient aucune propriété à définir pendant le déploiement. Toutes les propriétés sont ReadOnly.

ClusterProperties

Nom Description Valeur
enableDiskEncryption Valeur booléenne qui indique si les disques du cluster sont chiffrés. bool
enableDoubleEncryption Valeur booléenne qui indique si le double chiffrement est activé. bool
enablePurge Valeur booléenne qui indique si les opérations de vidage sont activées. bool
enableStreamingIngest Valeur booléenne qui indique si l’ingestion de streaming est activée. bool
keyVaultProperties Propriétés de KeyVault pour le chiffrement du cluster. KeyVaultProperties
optimizedAutoscale Définition de mise à l’échelle automatique optimisée. OptimizedAutoscale
trustedExternalTenants Locataires externes du cluster. TrustedExternalTenant[]
virtualNetworkConfiguration Définition de réseau virtuel. VirtualNetworkConfiguration

KeyVaultProperties

Nom Description Valeur
keyName Nom de la clé du coffre de clés. string (obligatoire)
keyVaultUri URI du coffre de clés. string (obligatoire)
keyVersion Version de la clé du coffre de clés. string (obligatoire)

OptimizedAutoscale

Nom Description Valeur
isEnabled Valeur booléenne qui indique si la fonctionnalité de mise à l’échelle automatique optimisée est activée ou non. bool (obligatoire)
maximum Nombre maximal d’instances autorisées. int (obligatoire)
minimum Nombre minimal d’instances autorisées. int (obligatoire)
version Version du modèle définie, pour instance 1. int (obligatoire)

TrustedExternalTenant

Nom Description Valeur
value GUID représentant un locataire externe. string

VirtualNetworkConfiguration

Nom Description Valeur
dataManagementPublicIpId ID de ressource d’adresse IP publique du service de gestion des données. string (obligatoire)
enginePublicIpId ID de ressource d’adresse IP publique du service moteur. string (obligatoire)
subnetId ID de ressource de sous-réseau. string (obligatoire)

AzureSku

Nom Description Valeur
capacité Nombre d’instances du cluster. int
name Nom de la référence 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' (obligatoire)
Niveau Niveau de référence SKU. 'De base'
'Standard' (obligatoire)

Modèles de démarrage rapide

Les modèles de démarrage rapide suivants déploient ce type de ressource.

Modèle Description
Azure Digital Twins avec connexion d’historique des données temporelles

Déployer sur Azure
Ce modèle crée une instance Azure Digital Twins configurée avec une connexion d’historique des données de série chronologique. Pour créer une connexion, d’autres ressources doivent être créées, telles qu’un espace de noms Event Hubs, un hub d’événements, un cluster Azure Data Explorer et une base de données. Les données sont envoyées à un hub d’événements qui les transfère finalement au cluster Azure Data Explorer. Les données sont stockées dans une table de base de données dans le cluster
Créer un cluster une base de données

Déployer sur Azure
Ce modèle vous permet de créer un cluster et une base de données.
Déployer Azure Data Explorer DB avec une connexion Cosmos DB

Déployer sur Azure
Déployez Azure Data Explorer DB avec une connexion Cosmos DB.
Déployer une base de données Azure Data Explorer avec une connexion Event Hub

Déployer sur Azure
Déployez Azure Data Explorer db avec une connexion Event Hub.
Déployer un cluster Azure Data Explorer dans votre réseau virtuel

Déployer sur Azure
Ce modèle vous permet de déployer un cluster dans votre réseau virtuel.

Définition de ressources de modèle ARM

Le type de ressource de clusters peut être déployé avec des opérations qui ciblent :

Pour obtenir la liste des propriétés modifiées dans chaque version de l’API, consultez journal des modifications.

Format des ressources

Pour créer une ressource Microsoft.Kusto/clusters, ajoutez le CODE JSON suivant à votre modèle.

{
  "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" ]
}

Valeurs de propriétés

clusters

Nom Description Valeur
type Type de ressource « Microsoft.Kusto/clusters »
apiVersion Version de l’API de ressource '2020-06-14'
name Nom de la ressource chaîne (obligatoire)

Limite de caractères : 4-22

Caractères valides :
Lettres minuscules et chiffres.

Doit commencer par une lettre.

Le nom de la ressource doit être unique dans Azure.
location Emplacement géographique où réside la ressource chaîne (obligatoire)
tags Balises de ressource. Dictionnaire de noms et de valeurs d’étiquettes. Voir Balises dans les modèles
sku Référence SKU du cluster. AzureSku (obligatoire)
identité Identité du cluster, s’il est configuré. Identité
properties Propriétés du cluster. ClusterProperties
zones Zones de disponibilité du cluster. string[]

Identité

Nom Description Valeur
type Type d’identité. 'None'
'SystemAssigned' (obligatoire)
userAssignedIdentities Liste des identités utilisateur associées au cluster Kusto. Les références de clé de dictionnaire d’identité utilisateur sont des ID de ressource ARM au format « /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName} ». IdentityUserAssignedIdentities

IdentityUserAssignedIdentities

Nom Description Valeur
{propriété personnalisée} ComponentsSgqdofSchemasIdentityPropertiesUserassigne...

ComponentsSgqdofSchemasIdentityPropertiesUserassigne...

Cet objet ne contient aucune propriété à définir pendant le déploiement. Toutes les propriétés sont ReadOnly.

ClusterProperties

Nom Description Valeur
enableDiskEncryption Valeur booléenne qui indique si les disques du cluster sont chiffrés. bool
enableDoubleEncryption Valeur booléenne qui indique si le double chiffrement est activé. bool
enablePurge Valeur booléenne qui indique si les opérations de purge sont activées. bool
enableStreamingIngIngest Valeur booléenne qui indique si l’ingestion de streaming est activée. bool
keyVaultProperties Propriétés KeyVault pour le chiffrement du cluster. KeyVaultProperties
optimizedAutoscale Définition de mise à l’échelle automatique optimisée. OptimizedAutoscale
trustedExternalTenants Locataires externes du cluster. TrustedExternalTenant[]
virtualNetworkConfiguration Définition de réseau virtuel. VirtualNetworkConfiguration

KeyVaultProperties

Nom Description Valeur
keyName Nom de la clé du coffre de clés. chaîne (obligatoire)
keyVaultUri URI du coffre de clés. chaîne (obligatoire)
keyVersion Version de la clé du coffre de clés. chaîne (obligatoire)

OptimizedAutoscale

Nom Description Valeur
isEnabled Valeur booléenne qui indique si la fonctionnalité de mise à l’échelle automatique optimisée est activée ou non. bool (obligatoire)
maximum Nombre maximal d’instances autorisées. int (obligatoire)
minimum Nombre minimal d’instances autorisées. int (obligatoire)
version Version du modèle définie pour instance 1. int (obligatoire)

TrustedExternalTenant

Nom Description Valeur
value GUID représentant un locataire externe. string

VirtualNetworkConfiguration

Nom Description Valeur
dataManagementPublicIpId ID de ressource d’adresse IP publique du service de gestion des données. chaîne (obligatoire)
enginePublicIpId ID de ressource d’adresse IP publique du service moteur. chaîne (obligatoire)
subnetId ID de ressource de sous-réseau. chaîne (obligatoire)

AzureSku

Nom Description Valeur
capacité Nombre d’instances du cluster. int
name Nom de la référence 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' (obligatoire)
Niveau Niveau de référence SKU. 'De base'
'Standard' (obligatoire)

Modèles de démarrage rapide

Les modèles de démarrage rapide suivants déploient ce type de ressource.

Modèle Description
Azure Digital Twins avec connexion d’historique des données temporelles

Déployer sur Azure
Ce modèle crée un instance Azure Digital Twins configuré avec une connexion d’historique des données de série chronologique. Pour créer une connexion, d’autres ressources doivent être créées, telles qu’un espace de noms Event Hubs, un hub d’événements, un cluster Azure Data Explorer et une base de données. Les données sont envoyées à un hub d’événements qui les transfère finalement au cluster Azure Data Explorer. Les données sont stockées dans une table de base de données dans le cluster
Créer un cluster une base de données

Déployer sur Azure
Ce modèle vous permet de créer un cluster et une base de données.
Déployer Azure Data Explorer DB avec une connexion Cosmos DB

Déployer sur Azure
Déployez Azure Data Explorer DB avec une connexion Cosmos DB.
Déployer une base de données Azure Data Explorer avec une connexion Event Hub

Déployer sur Azure
Déployez Azure Data Explorer db avec une connexion Event Hub.
Déployer un cluster Azure Data Explorer dans votre réseau virtuel

Déployer sur Azure
Ce modèle vous permet de déployer un cluster dans votre réseau virtuel.

Définition de ressource Terraform (fournisseur AzAPI)

Le type de ressource de clusters peut être déployé avec des opérations qui ciblent :

  • Groupes de ressources

Pour obtenir la liste des propriétés modifiées dans chaque version de l’API, consultez journal des modifications.

Format des ressources

Pour créer une ressource Microsoft.Kusto/clusters, ajoutez le Terraform suivant à votre modèle.

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"
    }
  })
}

Valeurs de propriétés

clusters

Nom Description Valeur
type Type de ressource « Microsoft.Kusto/clusters@2020-06-14 »
name Nom de la ressource chaîne (obligatoire)

Limite de caractères : 4-22

Caractères valides :
Lettres minuscules et chiffres.

Doit commencer par une lettre.

Le nom de la ressource doit être unique dans Azure.
location Emplacement géographique où réside la ressource chaîne (obligatoire)
parent_id Pour effectuer un déploiement sur un groupe de ressources, utilisez l’ID de ce groupe de ressources. chaîne (obligatoire)
tags Balises de ressource. Dictionnaire de noms et de valeurs d’étiquettes.
sku Référence SKU du cluster. AzureSku (obligatoire)
identité Identité du cluster, s’il est configuré. Identité
properties Propriétés du cluster. ClusterProperties
zones Zones de disponibilité du cluster. string[]

Identité

Nom Description Valeur
type Type d’identité. « SystemAssigned » (obligatoire)
identity_ids Liste des identités utilisateur associées au cluster Kusto. Les références de clé de dictionnaire d’identité utilisateur sont des ID de ressource ARM au format « /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName} ». Tableau d’ID d’identité utilisateur.

IdentityUserAssignedIdentities

Nom Description Valeur
{propriété personnalisée} ComponentsSgqdofSchemasIdentityPropertiesUserassigne...

ComponentsSgqdofSchemasIdentityPropertiesUserassigne...

Cet objet ne contient aucune propriété à définir pendant le déploiement. Toutes les propriétés sont ReadOnly.

ClusterProperties

Nom Description Valeur
enableDiskEncryption Valeur booléenne qui indique si les disques du cluster sont chiffrés. bool
enableDoubleEncryption Valeur booléenne qui indique si le double chiffrement est activé. bool
enablePurge Valeur booléenne qui indique si les opérations de purge sont activées. bool
enableStreamingIngIngest Valeur booléenne qui indique si l’ingestion de streaming est activée. bool
keyVaultProperties Propriétés KeyVault pour le chiffrement du cluster. KeyVaultProperties
optimizedAutoscale Définition de mise à l’échelle automatique optimisée. OptimizedAutoscale
trustedExternalTenants Locataires externes du cluster. TrustedExternalTenant[]
virtualNetworkConfiguration Définition de réseau virtuel. VirtualNetworkConfiguration

KeyVaultProperties

Nom Description Valeur
keyName Nom de la clé du coffre de clés. chaîne (obligatoire)
keyVaultUri URI du coffre de clés. chaîne (obligatoire)
keyVersion Version de la clé du coffre de clés. chaîne (obligatoire)

OptimizedAutoscale

Nom Description Valeur
isEnabled Valeur booléenne qui indique si la fonctionnalité de mise à l’échelle automatique optimisée est activée ou non. bool (obligatoire)
maximum Nombre maximal d’instances autorisées. int (obligatoire)
minimum Nombre minimal d’instances autorisées. int (obligatoire)
version Version du modèle définie pour instance 1. int (obligatoire)

TrustedExternalTenant

Nom Description Valeur
value GUID représentant un locataire externe. string

VirtualNetworkConfiguration

Nom Description Valeur
dataManagementPublicIpId ID de ressource d’adresse IP publique du service de gestion des données. chaîne (obligatoire)
enginePublicIpId ID de ressource d’adresse IP publique du service moteur. chaîne (obligatoire)
subnetId ID de ressource de sous-réseau. chaîne (obligatoire)

AzureSku

Nom Description Valeur
capacité Nombre d’instances du cluster. int
name Nom de la référence 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 » (obligatoire)
Niveau Niveau de référence SKU. "Basic"
« Standard » (obligatoire)