Partager via


Clusters Microsoft.Kusto 2023-08-15

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 de l’API, consultez journal des modifications.

Format de ressource

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

resource symbolicname 'Microsoft.Kusto/clusters@2023-08-15' = {
  name: 'string'
  location: 'string'
  tags: {
    tagName1: 'tagValue1'
    tagName2: 'tagValue2'
  }
  sku: {
    capacity: int
    name: 'string'
    tier: 'string'
  }
  identity: {
    type: 'string'
    userAssignedIdentities: {
      {customized property}: {}
    }
  }
  properties: {
    acceptedAudiences: [
      {
        value: 'string'
      }
    ]
    allowedFqdnList: [
      'string'
    ]
    allowedIpRangeList: [
      'string'
    ]
    enableAutoStop: bool
    enableDiskEncryption: bool
    enableDoubleEncryption: bool
    enablePurge: bool
    enableStreamingIngest: bool
    engineType: 'string'
    keyVaultProperties: {
      keyName: 'string'
      keyVaultUri: 'string'
      keyVersion: 'string'
      userIdentity: 'string'
    }
    languageExtensions: {
      value: [
        {
          languageExtensionCustomImageName: 'string'
          languageExtensionImageName: 'string'
          languageExtensionName: 'string'
        }
      ]
      value: [
        {
          languageExtensionCustomImageName: 'string'
          languageExtensionImageName: 'string'
          languageExtensionName: 'string'
        }
      ]
    }
    optimizedAutoscale: {
      isEnabled: bool
      maximum: int
      minimum: int
      version: int
    }
    publicIPType: 'string'
    publicNetworkAccess: 'string'
    restrictOutboundNetworkAccess: 'string'
    trustedExternalTenants: [
      {
        value: 'string'
      }
    ]
    virtualClusterGraduationProperties: 'string'
    virtualNetworkConfiguration: {
      dataManagementPublicIpId: 'string'
      enginePublicIpId: 'string'
      state: 'string'
      subnetId: 'string'
    }
  }
  zones: [
    'string'
  ]
}

Valeurs de propriété

Clusters

Nom Description Valeur
nom Nom de la ressource chaîne (obligatoire)

Limite de caractères : 4-22

Caractères valides :
Lettres minuscules et chiffres.

Commencez par la lettre.

Le nom de la ressource doit être unique dans Azure.
emplacement Emplacement géographique où réside la ressource chaîne (obligatoire)
étiquettes Balises de ressource. Dictionnaire de noms et de valeurs d’étiquettes. Consultez les balises dans les modèles
Sku Référence SKU du cluster. AzureSku (obligatoire)
identité Identité du cluster, si elle est configurée. Identity
Propriétés Propriétés du cluster. clusterProperties
zones Zones de disponibilité du cluster. string[]

Identité

Nom Description Valeur
type Type d’identité managée utilisée. Le type « SystemAssigned, UserAssigned » inclut à la fois une identité créée implicitement et un ensemble d’identités affectées par l’utilisateur. Le type « None » supprime toutes les identités. 'None'
'SystemAssigned'
'SystemAssigned, UserAssigned'
'UserAssigned' (obligatoire)
userAssignedIdentities Liste des identités utilisateur associées au cluster Kusto. Les références de clé de dictionnaire d’identité utilisateur seront des ID de ressource ARM sous la forme : « /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
acceptAudiences Audiences acceptées du cluster. AcceptedAudiences[]
allowedFqdnList Liste des noms de domaine complets autorisés (nom de domaine complet) pour la sortie du cluster. string[]
allowedIpRangeList Liste des adresses IP au format CIDR autorisé à se connecter au cluster. string[]
enableAutoStop Valeur booléenne qui indique si le cluster peut être arrêté automatiquement (en raison d’un manque de données ou d’aucune activité pendant de nombreux jours). Bool
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
engineType Type de moteur 'V2'
'V3'
keyVaultProperties Propriétés KeyVault pour le chiffrement du cluster. KeyVaultProperties
languageExtensions Liste des extensions de langage du cluster. LanguageExtensionsList
optimizedAutoscale Définition de mise à l’échelle automatique optimisée. OptimizedAutoscale
publicIPType Indique le type d’adresse IP publique à créer - IPv4 (valeur par défaut) ou DualStack (IPv4 et IPv6) 'DualStack'
'IPv4'
publicNetworkAccess L’accès au réseau public au cluster est activé par défaut. En cas de désactivation, seule la connexion de point de terminaison privé au cluster est autorisée 'Désactivé'
'Activé'
restrictOutboundNetworkAccess Indique s’il faut restreindre ou non l’accès réseau sortant. La valeur est facultative, mais si elle est passée, doit être « Activé » ou « Désactivé » 'Désactivé'
'Activé'
trustedExternalTenants Locataires externes du cluster. TrustedExternalTenant[]
virtualClusterGraduationProperties Propriétés de graduation de cluster virtuel corde

Contraintes:
Valeur sensible. Passez en tant que paramètre sécurisé.
virtualNetworkConfiguration Définition de réseau virtuel. virtualNetworkConfiguration

AcceptAudiences

Nom Description Valeur
valeur GUID ou URL valide représentant un public accepté. corde

KeyVaultProperties

Nom Description Valeur
keyName Nom de la clé du coffre de clés. corde
keyVaultUri URI du coffre de clés. corde
keyVersion Version de la clé du coffre de clés. corde
userIdentity Identité affectée par l’utilisateur (ID de ressource ARM) qui a accès à la clé. corde

LanguageExtensionsList

Nom Description Valeur
valeur Liste des extensions de langage. LanguageExtension[]
valeur Liste des extensions de langage. LanguageExtension[]

LanguageExtension

Nom Description Valeur
languageExtensionCustomImageName Nom de l’image personnalisée de l’extension de langage. corde
languageExtensionImageName Nom de l’image de l’extension de langage. 'Python3_10_8'
'Python3_10_8_DL'
'Python3_6_5'
'PythonCustomImage'
'R'
languageExtensionName Nom de l’extension de langue. 'PYTHON'
'R'

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éfini, par exemple 1. int (obligatoire)

TrustedExternalTenant

Nom Description Valeur
valeur GUID représentant un locataire externe. corde

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)
état Lorsqu’il est activé, le cluster est déployé dans le sous-réseau configuré, lorsqu’il est désactivé, il est supprimé du sous-réseau. 'Désactivé'
'Activé'
subnetId ID de ressource de sous-réseau. chaîne (obligatoire)

AzureSku

Nom Description Valeur
capacité Nombre d’instances du cluster. Int
nom 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_D16d_v5'
'Standard_D32d_v4'
'Standard_D32d_v5'
'Standard_DS13_v2+1TB_PS'
'Standard_DS13_v2+2TB_PS'
'Standard_DS14_v2+3TB_PS'
'Standard_DS14_v2+4TB_PS'
'Standard_E16a_v4'
'Standard_E16ads_v5'
'Standard_E16as_v4+3TB_PS'
'Standard_E16as_v4+4TB_PS'
'Standard_E16as_v5+3TB_PS'
'Standard_E16as_v5+4TB_PS'
'Standard_E16d_v4'
'Standard_E16d_v5'
'Standard_E16s_v4+3TB_PS'
'Standard_E16s_v4+4TB_PS'
'Standard_E16s_v5+3TB_PS'
'Standard_E16s_v5+4TB_PS'
'Standard_E2a_v4'
'Standard_E2ads_v5'
'Standard_E2d_v4'
'Standard_E2d_v5'
'Standard_E4a_v4'
'Standard_E4ads_v5'
'Standard_E4d_v4'
'Standard_E4d_v5'
'Standard_E64i_v3'
'Standard_E80ids_v4'
'Standard_E8a_v4'
'Standard_E8ads_v5'
'Standard_E8as_v4+1TB_PS'
'Standard_E8as_v4+2TB_PS'
'Standard_E8as_v5+1TB_PS'
'Standard_E8as_v5+2TB_PS'
'Standard_E8d_v4'
'Standard_E8d_v5'
'Standard_E8s_v4+1TB_PS'
'Standard_E8s_v4+2TB_PS'
'Standard_E8s_v5+1TB_PS'
'Standard_E8s_v5+2TB_PS'
'Standard_EC16ads_v5'
'Standard_EC16as_v5+3TB_PS'
'Standard_EC16as_v5+4TB_PS'
'Standard_EC8ads_v5'
'Standard_EC8as_v5+1TB_PS'
'Standard_EC8as_v5+2TB_PS'
'Standard_L16as_v3'
'Standard_L16s'
'Standard_L16s_v2'
'Standard_L16s_v3'
'Standard_L32as_v3'
'Standard_L32s_v3'
'Standard_L4s'
'Standard_L8as_v3'
'Standard_L8s'
'Standard_L8s_v2'
'Standard_L8s_v3' (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
Créer un observateur de base de données

Déployer sur Azure
Cet exemple crée un observateur de base de données pour Azure SQL et configure son magasin de données, ses cibles SQL et ses points de terminaison privés managés
Azure Digital Twins avec de 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 transfère finalement les données 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 d’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 de connexion Cosmos DB

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

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

Déployer sur Azure
Déployez la base de données Azure Data Explorer avec la connexion Event Hub.
déployer un cluster Azure Data Explorer dans votre de 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 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 de ressource

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

{
  "type": "Microsoft.Kusto/clusters",
  "apiVersion": "2023-08-15",
  "name": "string",
  "location": "string",
  "tags": {
    "tagName1": "tagValue1",
    "tagName2": "tagValue2"
  },
  "sku": {
    "capacity": "int",
    "name": "string",
    "tier": "string"
  },
  "identity": {
    "type": "string",
    "userAssignedIdentities": {
      "{customized property}": {}
    }
  },
  "properties": {
    "acceptedAudiences": [
      {
        "value": "string"
      }
    ],
    "allowedFqdnList": [ "string" ],
    "allowedIpRangeList": [ "string" ],
    "enableAutoStop": "bool",
    "enableDiskEncryption": "bool",
    "enableDoubleEncryption": "bool",
    "enablePurge": "bool",
    "enableStreamingIngest": "bool",
    "engineType": "string",
    "keyVaultProperties": {
      "keyName": "string",
      "keyVaultUri": "string",
      "keyVersion": "string",
      "userIdentity": "string"
    },
    "languageExtensions": {
      "value": [
        {
          "languageExtensionCustomImageName": "string",
          "languageExtensionImageName": "string",
          "languageExtensionName": "string"
        }
      ],
      "value": [
        {
          "languageExtensionCustomImageName": "string",
          "languageExtensionImageName": "string",
          "languageExtensionName": "string"
        }
      ]
    },
    "optimizedAutoscale": {
      "isEnabled": "bool",
      "maximum": "int",
      "minimum": "int",
      "version": "int"
    },
    "publicIPType": "string",
    "publicNetworkAccess": "string",
    "restrictOutboundNetworkAccess": "string",
    "trustedExternalTenants": [
      {
        "value": "string"
      }
    ],
    "virtualClusterGraduationProperties": "string",
    "virtualNetworkConfiguration": {
      "dataManagementPublicIpId": "string",
      "enginePublicIpId": "string",
      "state": "string",
      "subnetId": "string"
    }
  },
  "zones": [ "string" ]
}

Valeurs de propriété

Clusters

Nom Description Valeur
type Type de ressource 'Microsoft.Kusto/clusters'
apiVersion Version de l’API de ressource '2023-08-15'
nom Nom de la ressource chaîne (obligatoire)

Limite de caractères : 4-22

Caractères valides :
Lettres minuscules et chiffres.

Commencez par la lettre.

Le nom de la ressource doit être unique dans Azure.
emplacement Emplacement géographique où réside la ressource chaîne (obligatoire)
étiquettes Balises de ressource. Dictionnaire de noms et de valeurs d’étiquettes. Consultez les balises dans les modèles
Sku Référence SKU du cluster. AzureSku (obligatoire)
identité Identité du cluster, si elle est configurée. Identity
Propriétés Propriétés du cluster. clusterProperties
zones Zones de disponibilité du cluster. string[]

Identité

Nom Description Valeur
type Type d’identité managée utilisée. Le type « SystemAssigned, UserAssigned » inclut à la fois une identité créée implicitement et un ensemble d’identités affectées par l’utilisateur. Le type « None » supprime toutes les identités. 'None'
'SystemAssigned'
'SystemAssigned, UserAssigned'
'UserAssigned' (obligatoire)
userAssignedIdentities Liste des identités utilisateur associées au cluster Kusto. Les références de clé de dictionnaire d’identité utilisateur seront des ID de ressource ARM sous la forme : « /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
acceptAudiences Audiences acceptées du cluster. AcceptedAudiences[]
allowedFqdnList Liste des noms de domaine complets autorisés (nom de domaine complet) pour la sortie du cluster. string[]
allowedIpRangeList Liste des adresses IP au format CIDR autorisé à se connecter au cluster. string[]
enableAutoStop Valeur booléenne qui indique si le cluster peut être arrêté automatiquement (en raison d’un manque de données ou d’aucune activité pendant de nombreux jours). Bool
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
engineType Type de moteur 'V2'
'V3'
keyVaultProperties Propriétés KeyVault pour le chiffrement du cluster. KeyVaultProperties
languageExtensions Liste des extensions de langage du cluster. LanguageExtensionsList
optimizedAutoscale Définition de mise à l’échelle automatique optimisée. OptimizedAutoscale
publicIPType Indique le type d’adresse IP publique à créer - IPv4 (valeur par défaut) ou DualStack (IPv4 et IPv6) 'DualStack'
'IPv4'
publicNetworkAccess L’accès au réseau public au cluster est activé par défaut. En cas de désactivation, seule la connexion de point de terminaison privé au cluster est autorisée 'Désactivé'
'Activé'
restrictOutboundNetworkAccess Indique s’il faut restreindre ou non l’accès réseau sortant. La valeur est facultative, mais si elle est passée, doit être « Activé » ou « Désactivé » 'Désactivé'
'Activé'
trustedExternalTenants Locataires externes du cluster. TrustedExternalTenant[]
virtualClusterGraduationProperties Propriétés de graduation de cluster virtuel corde

Contraintes:
Valeur sensible. Passez en tant que paramètre sécurisé.
virtualNetworkConfiguration Définition de réseau virtuel. virtualNetworkConfiguration

AcceptAudiences

Nom Description Valeur
valeur GUID ou URL valide représentant un public accepté. corde

KeyVaultProperties

Nom Description Valeur
keyName Nom de la clé du coffre de clés. corde
keyVaultUri URI du coffre de clés. corde
keyVersion Version de la clé du coffre de clés. corde
userIdentity Identité affectée par l’utilisateur (ID de ressource ARM) qui a accès à la clé. corde

LanguageExtensionsList

Nom Description Valeur
valeur Liste des extensions de langage. LanguageExtension[]
valeur Liste des extensions de langage. LanguageExtension[]

LanguageExtension

Nom Description Valeur
languageExtensionCustomImageName Nom de l’image personnalisée de l’extension de langage. corde
languageExtensionImageName Nom de l’image de l’extension de langage. 'Python3_10_8'
'Python3_10_8_DL'
'Python3_6_5'
'PythonCustomImage'
'R'
languageExtensionName Nom de l’extension de langue. 'PYTHON'
'R'

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éfini, par exemple 1. int (obligatoire)

TrustedExternalTenant

Nom Description Valeur
valeur GUID représentant un locataire externe. corde

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)
état Lorsqu’il est activé, le cluster est déployé dans le sous-réseau configuré, lorsqu’il est désactivé, il est supprimé du sous-réseau. 'Désactivé'
'Activé'
subnetId ID de ressource de sous-réseau. chaîne (obligatoire)

AzureSku

Nom Description Valeur
capacité Nombre d’instances du cluster. Int
nom 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_D16d_v5'
'Standard_D32d_v4'
'Standard_D32d_v5'
'Standard_DS13_v2+1TB_PS'
'Standard_DS13_v2+2TB_PS'
'Standard_DS14_v2+3TB_PS'
'Standard_DS14_v2+4TB_PS'
'Standard_E16a_v4'
'Standard_E16ads_v5'
'Standard_E16as_v4+3TB_PS'
'Standard_E16as_v4+4TB_PS'
'Standard_E16as_v5+3TB_PS'
'Standard_E16as_v5+4TB_PS'
'Standard_E16d_v4'
'Standard_E16d_v5'
'Standard_E16s_v4+3TB_PS'
'Standard_E16s_v4+4TB_PS'
'Standard_E16s_v5+3TB_PS'
'Standard_E16s_v5+4TB_PS'
'Standard_E2a_v4'
'Standard_E2ads_v5'
'Standard_E2d_v4'
'Standard_E2d_v5'
'Standard_E4a_v4'
'Standard_E4ads_v5'
'Standard_E4d_v4'
'Standard_E4d_v5'
'Standard_E64i_v3'
'Standard_E80ids_v4'
'Standard_E8a_v4'
'Standard_E8ads_v5'
'Standard_E8as_v4+1TB_PS'
'Standard_E8as_v4+2TB_PS'
'Standard_E8as_v5+1TB_PS'
'Standard_E8as_v5+2TB_PS'
'Standard_E8d_v4'
'Standard_E8d_v5'
'Standard_E8s_v4+1TB_PS'
'Standard_E8s_v4+2TB_PS'
'Standard_E8s_v5+1TB_PS'
'Standard_E8s_v5+2TB_PS'
'Standard_EC16ads_v5'
'Standard_EC16as_v5+3TB_PS'
'Standard_EC16as_v5+4TB_PS'
'Standard_EC8ads_v5'
'Standard_EC8as_v5+1TB_PS'
'Standard_EC8as_v5+2TB_PS'
'Standard_L16as_v3'
'Standard_L16s'
'Standard_L16s_v2'
'Standard_L16s_v3'
'Standard_L32as_v3'
'Standard_L32s_v3'
'Standard_L4s'
'Standard_L8as_v3'
'Standard_L8s'
'Standard_L8s_v2'
'Standard_L8s_v3' (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
Créer un observateur de base de données

Déployer sur Azure
Cet exemple crée un observateur de base de données pour Azure SQL et configure son magasin de données, ses cibles SQL et ses points de terminaison privés managés
Azure Digital Twins avec de 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 transfère finalement les données 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 d’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 de connexion Cosmos DB

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

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

Déployer sur Azure
Déployez la base de données Azure Data Explorer avec la connexion Event Hub.
déployer un cluster Azure Data Explorer dans votre de 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 de ressource

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

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.Kusto/clusters@2023-08-15"
  name = "string"
  location = "string"
  parent_id = "string"
  tags = {
    tagName1 = "tagValue1"
    tagName2 = "tagValue2"
  }
  identity {
    type = "string"
    identity_ids = []
  }
  body = jsonencode({
    properties = {
      acceptedAudiences = [
        {
          value = "string"
        }
      ]
      allowedFqdnList = [
        "string"
      ]
      allowedIpRangeList = [
        "string"
      ]
      enableAutoStop = bool
      enableDiskEncryption = bool
      enableDoubleEncryption = bool
      enablePurge = bool
      enableStreamingIngest = bool
      engineType = "string"
      keyVaultProperties = {
        keyName = "string"
        keyVaultUri = "string"
        keyVersion = "string"
        userIdentity = "string"
      }
      languageExtensions = {
        value = [
          {
            languageExtensionCustomImageName = "string"
            languageExtensionImageName = "string"
            languageExtensionName = "string"
          }
        ]
        value = [
          {
            languageExtensionCustomImageName = "string"
            languageExtensionImageName = "string"
            languageExtensionName = "string"
          }
        ]
      }
      optimizedAutoscale = {
        isEnabled = bool
        maximum = int
        minimum = int
        version = int
      }
      publicIPType = "string"
      publicNetworkAccess = "string"
      restrictOutboundNetworkAccess = "string"
      trustedExternalTenants = [
        {
          value = "string"
        }
      ]
      virtualClusterGraduationProperties = "string"
      virtualNetworkConfiguration = {
        dataManagementPublicIpId = "string"
        enginePublicIpId = "string"
        state = "string"
        subnetId = "string"
      }
    }
    zones = [
      "string"
    ]
    sku = {
      capacity = int
      name = "string"
      tier = "string"
    }
  })
}

Valeurs de propriété

Clusters

Nom Description Valeur
type Type de ressource « Microsoft.Kusto/clusters@2023-08-15 »
nom Nom de la ressource chaîne (obligatoire)

Limite de caractères : 4-22

Caractères valides :
Lettres minuscules et chiffres.

Commencez par la lettre.

Le nom de la ressource doit être unique dans Azure.
emplacement 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)
étiquettes Balises de ressource. Dictionnaire de noms et de valeurs d’étiquettes.
Sku Référence SKU du cluster. AzureSku (obligatoire)
identité Identité du cluster, si elle est configurée. Identity
Propriétés Propriétés du cluster. clusterProperties
zones Zones de disponibilité du cluster. string[]

Identité

Nom Description Valeur
type Type d’identité managée utilisée. Le type « SystemAssigned, UserAssigned » inclut à la fois une identité créée implicitement et un ensemble d’identités affectées par l’utilisateur. Le type « None » supprime toutes les identités. « SystemAssigned »
« SystemAssigned, UserAssigned »
« UserAssigned » (obligatoire)
identity_ids Liste des identités utilisateur associées au cluster Kusto. Les références de clé de dictionnaire d’identité utilisateur seront des ID de ressource ARM sous la forme : « /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
acceptAudiences Audiences acceptées du cluster. AcceptedAudiences[]
allowedFqdnList Liste des noms de domaine complets autorisés (nom de domaine complet) pour la sortie du cluster. string[]
allowedIpRangeList Liste des adresses IP au format CIDR autorisé à se connecter au cluster. string[]
enableAutoStop Valeur booléenne qui indique si le cluster peut être arrêté automatiquement (en raison d’un manque de données ou d’aucune activité pendant de nombreux jours). Bool
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
engineType Type de moteur « V2 »
« V3 »
keyVaultProperties Propriétés KeyVault pour le chiffrement du cluster. KeyVaultProperties
languageExtensions Liste des extensions de langage du cluster. LanguageExtensionsList
optimizedAutoscale Définition de mise à l’échelle automatique optimisée. OptimizedAutoscale
publicIPType Indique le type d’adresse IP publique à créer - IPv4 (valeur par défaut) ou DualStack (IPv4 et IPv6) « DualStack »
« IPv4 »
publicNetworkAccess L’accès au réseau public au cluster est activé par défaut. En cas de désactivation, seule la connexion de point de terminaison privé au cluster est autorisée « Désactivé »
« Activé »
restrictOutboundNetworkAccess Indique s’il faut restreindre ou non l’accès réseau sortant. La valeur est facultative, mais si elle est passée, doit être « Activé » ou « Désactivé » « Désactivé »
« Activé »
trustedExternalTenants Locataires externes du cluster. TrustedExternalTenant[]
virtualClusterGraduationProperties Propriétés de graduation de cluster virtuel corde

Contraintes:
Valeur sensible. Passez en tant que paramètre sécurisé.
virtualNetworkConfiguration Définition de réseau virtuel. virtualNetworkConfiguration

AcceptAudiences

Nom Description Valeur
valeur GUID ou URL valide représentant un public accepté. corde

KeyVaultProperties

Nom Description Valeur
keyName Nom de la clé du coffre de clés. corde
keyVaultUri URI du coffre de clés. corde
keyVersion Version de la clé du coffre de clés. corde
userIdentity Identité affectée par l’utilisateur (ID de ressource ARM) qui a accès à la clé. corde

LanguageExtensionsList

Nom Description Valeur
valeur Liste des extensions de langage. LanguageExtension[]
valeur Liste des extensions de langage. LanguageExtension[]

LanguageExtension

Nom Description Valeur
languageExtensionCustomImageName Nom de l’image personnalisée de l’extension de langage. corde
languageExtensionImageName Nom de l’image de l’extension de langage. « Python3_10_8 »
« Python3_10_8_DL »
« Python3_6_5 »
« PythonCustomImage »
« R »
languageExtensionName Nom de l’extension de langue. « PYTHON »
« R »

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éfini, par exemple 1. int (obligatoire)

TrustedExternalTenant

Nom Description Valeur
valeur GUID représentant un locataire externe. corde

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)
état Lorsqu’il est activé, le cluster est déployé dans le sous-réseau configuré, lorsqu’il est désactivé, il est supprimé du sous-réseau. « Désactivé »
« Activé »
subnetId ID de ressource de sous-réseau. chaîne (obligatoire)

AzureSku

Nom Description Valeur
capacité Nombre d’instances du cluster. Int
nom 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_D16d_v5 »
« Standard_D32d_v4 »
« Standard_D32d_v5 »
« Standard_DS13_v2+1TB_PS »
« Standard_DS13_v2+2TB_PS »
« Standard_DS14_v2+3TB_PS »
« Standard_DS14_v2+4TB_PS »
« Standard_E16a_v4 »
« Standard_E16ads_v5 »
« Standard_E16as_v4+3TB_PS »
« Standard_E16as_v4+4TB_PS »
« Standard_E16as_v5+3TB_PS »
« Standard_E16as_v5+4TB_PS »
« Standard_E16d_v4 »
« Standard_E16d_v5 »
« Standard_E16s_v4+3TB_PS »
« Standard_E16s_v4+4TB_PS »
« Standard_E16s_v5+3TB_PS »
« Standard_E16s_v5+4TB_PS »
« Standard_E2a_v4 »
« Standard_E2ads_v5 »
« Standard_E2d_v4 »
« Standard_E2d_v5 »
« Standard_E4a_v4 »
« Standard_E4ads_v5 »
« Standard_E4d_v4 »
« Standard_E4d_v5 »
« Standard_E64i_v3 »
« Standard_E80ids_v4 »
« Standard_E8a_v4 »
« Standard_E8ads_v5 »
« Standard_E8as_v4+1TB_PS »
« Standard_E8as_v4+2TB_PS »
« Standard_E8as_v5+1TB_PS »
« Standard_E8as_v5+2TB_PS »
« Standard_E8d_v4 »
« Standard_E8d_v5 »
« Standard_E8s_v4+1TB_PS »
« Standard_E8s_v4+2TB_PS »
« Standard_E8s_v5+1TB_PS »
« Standard_E8s_v5+2TB_PS »
« Standard_EC16ads_v5 »
« Standard_EC16as_v5+3TB_PS »
« Standard_EC16as_v5+4TB_PS »
« Standard_EC8ads_v5 »
« Standard_EC8as_v5+1TB_PS »
« Standard_EC8as_v5+2TB_PS »
« Standard_L16as_v3 »
« Standard_L16s »
« Standard_L16s_v2 »
« Standard_L16s_v3 »
« Standard_L32as_v3 »
« Standard_L32s_v3 »
« Standard_L4s »
« Standard_L8as_v3 »
« Standard_L8s »
« Standard_L8s_v2 »
« Standard_L8s_v3 » (obligatoire)
niveau Niveau de référence SKU. « De base »
« Standard » (obligatoire)