Partager via


Clusters Microsoft.Kusto

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@2024-04-13' = {
  scope: resourceSymbolicName or scope
  identity: {
    type: 'string'
    userAssignedIdentities: {
      {customized property}: {}
    }
  }
  location: 'string'
  name: 'string'
  properties: {
    acceptedAudiences: [
      {
        value: 'string'
      }
    ]
    allowedFqdnList: [
      'string'
    ]
    allowedIpRangeList: [
      'string'
    ]
    calloutPolicies: [
      {
        calloutType: 'string'
        calloutUriRegex: 'string'
        outboundAccess: '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'
        }
      ]
    }
    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'
    }
  }
  sku: {
    capacity: int
    name: 'string'
    tier: 'string'
  }
  tags: {
    {customized property}: 'string'
  }
  zones: [
    'string'
  ]
}

Valeurs de propriété

Microsoft.Kusto/clusters

Nom Descriptif Valeur
identité Identité du cluster, si elle est configurée. Identité
emplacement Emplacement géographique où réside la ressource chaîne (obligatoire)
nom Nom de la ressource corde

Contraintes:
Modèle = ^.*$ (obligatoire)
Propriétés Propriétés du cluster. clusterProperties
portée Utilisez-la lors de la création d’une ressource dans une étendue différente de l’étendue de déploiement. Définissez cette propriété sur le nom symbolique d’une ressource pour appliquer la ressource d’extension .
Sku Référence SKU du cluster. AzureSku (obligatoire)
étiquettes Balises de ressource Dictionnaire de noms et de valeurs d’étiquettes. Consultez les balises dans les modèles
Zones Zones de disponibilité du cluster. chaîne de caractères[]

AcceptAudiences

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

AzureSku

Nom Descriptif Valeur
capacité Nombre d’instances du cluster. Int
nom Nom de la référence SKU. 'Dev (pas de SLA)_Standard_D11_v2'
'Dev (pas de 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_E16ads_v5'
'Standard_E16as_v4+3TB_PS'
'Standard_E16as_v4+4TB_PS'
'Standard_E16as_v5+3TB_PS'
'Standard_E16as_v5+4TB_PS'
'Standard_E16a_v4'
'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_E2ads_v5'
'Standard_E2a_v4'
'Standard_E2d_v4'
'Standard_E2d_v5'
'Standard_E4ads_v5'
'Standard_E4a_v4'
'Standard_E4d_v4'
'Standard_E4d_v5'
'Standard_E64i_v3'
'Standard_E80ids_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_E8a_v4'
'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)

LégendePolitique

Nom Descriptif Valeur
calloutType Type du service de légende, en spécifiant le type de ressource externe ou de service accessible. 'azure_digital_twins'
'azure_openai'
'cosmosdb'
'external_data'
« Genevamétrie »
'Kusto'
'mysql'
'PostgreSQL'
'sandbox_artifacts'
'sql'
'WebAPI'
calloutUriRegex Expression régulière ou modèle de nom de domaine complet pour l’URI de légende. corde
outboundAccess Indique si l’accès sortant est autorisé pour le modèle d’URI spécifié. 'Autoriser'
'Refuser'

ClusterProperties

Nom Descriptif Valeur
acceptAudiences Audiences acceptées du cluster. AudiencesAcceptées[]
allowedFqdnList Liste des noms de domaine complets autorisés (nom de domaine complet) pour la sortie du cluster. chaîne de caractères[]
allowedIpRangeList Liste des adresses IP au format CIDR autorisé à se connecter au cluster. chaîne de caractères[]
calloutPolicies Liste des stratégies de légende pour la sortie du cluster. CalloutPolicy[]
activerAutoStop 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
enableStreamingIngestion Valeur booléenne qui indique si l’ingestion de streaming est activée. Bool
moteurType 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
optimiséMise à l’échelle automatique 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

ComponentsSgqdofSchemasIdentityPropertiesUserassignedidentitiesAdditionalproperties

Nom Descriptif Valeur

Identité

Nom Descriptif 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. « Aucun »
'SystemAssigned'
'SystemAssigned, UserAssigned'
'UserAssigned' (obligatoire)
Identités attribuées par l'utilisateur 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 Descriptif Valeur

KeyVaultProperties

Nom Descriptif 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

ExtensionLangue

Nom Descriptif 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_11_7'
'Python3_11_7_DL'
'Python3_6_5'
'PythonCustomImage'
'R'
languageExtensionName Nom de l’extension de langue. 'PYTHON'
'R'

LanguageExtensionsList

Nom Descriptif Valeur
valeur Liste des extensions de langage. ExtensionLangue[]

OptimiséMise à l’échelle automatique

Nom Descriptif 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)

TrackedResourceTags

Nom Descriptif Valeur

TrustedExternalTenant

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

VirtualNetworkConfiguration

Nom Descriptif 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)

Exemples d’utilisation

Modules vérifiés Azure

Les modules vérifiés Azure suivants peuvent être utilisés pour déployer ce type de ressource.

Module Descriptif
cluster Azure Data Explorer (Kusto) Module de ressources AVM pour le cluster Azure Data Explorer (Kusto)

Exemples de démarrage rapide Azure

Les modèles de démarrage rapide Azure suivants contiennent des exemples Bicep pour le déploiement de ce type de ressource.

Fichier Bicep Descriptif
Azure Digital Twins avec de connexion d’historique des données temporelles 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 observateur de base de données 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
Déployer Azure Data Explorer DB avec de connexion Cosmos DB 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é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éployez la base de données Azure Data Explorer avec la connexion Event Hub.
hub FinOps Ce modèle crée une instance de hub FinOps, notamment Data Explorer, Data Lake Storage et Data Factory.

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": "2024-04-13",
  "name": "string",
  "identity": {
    "type": "string",
    "userAssignedIdentities": {
      "{customized property}": {
      }
    }
  },
  "location": "string",
  "properties": {
    "acceptedAudiences": [
      {
        "value": "string"
      }
    ],
    "allowedFqdnList": [ "string" ],
    "allowedIpRangeList": [ "string" ],
    "calloutPolicies": [
      {
        "calloutType": "string",
        "calloutUriRegex": "string",
        "outboundAccess": "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"
        }
      ]
    },
    "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"
    }
  },
  "sku": {
    "capacity": "int",
    "name": "string",
    "tier": "string"
  },
  "tags": {
    "{customized property}": "string"
  },
  "zones": [ "string" ]
}

Valeurs de propriété

Microsoft.Kusto/clusters

Nom Descriptif Valeur
apiVersion Version de l’API '2024-04-13'
identité Identité du cluster, si elle est configurée. Identité
emplacement Emplacement géographique où réside la ressource chaîne (obligatoire)
nom Nom de la ressource corde

Contraintes:
Modèle = ^.*$ (obligatoire)
Propriétés Propriétés du cluster. clusterProperties
Sku Référence SKU du cluster. AzureSku (obligatoire)
étiquettes Balises de ressource Dictionnaire de noms et de valeurs d’étiquettes. Consultez les balises dans les modèles
type Type de ressource 'Microsoft.Kusto/clusters'
Zones Zones de disponibilité du cluster. chaîne de caractères[]

AcceptAudiences

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

AzureSku

Nom Descriptif Valeur
capacité Nombre d’instances du cluster. Int
nom Nom de la référence SKU. 'Dev (pas de SLA)_Standard_D11_v2'
'Dev (pas de 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_E16ads_v5'
'Standard_E16as_v4+3TB_PS'
'Standard_E16as_v4+4TB_PS'
'Standard_E16as_v5+3TB_PS'
'Standard_E16as_v5+4TB_PS'
'Standard_E16a_v4'
'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_E2ads_v5'
'Standard_E2a_v4'
'Standard_E2d_v4'
'Standard_E2d_v5'
'Standard_E4ads_v5'
'Standard_E4a_v4'
'Standard_E4d_v4'
'Standard_E4d_v5'
'Standard_E64i_v3'
'Standard_E80ids_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_E8a_v4'
'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)

LégendePolitique

Nom Descriptif Valeur
calloutType Type du service de légende, en spécifiant le type de ressource externe ou de service accessible. 'azure_digital_twins'
'azure_openai'
'cosmosdb'
'external_data'
« Genevamétrie »
'Kusto'
'mysql'
'PostgreSQL'
'sandbox_artifacts'
'sql'
'WebAPI'
calloutUriRegex Expression régulière ou modèle de nom de domaine complet pour l’URI de légende. corde
outboundAccess Indique si l’accès sortant est autorisé pour le modèle d’URI spécifié. 'Autoriser'
'Refuser'

ClusterProperties

Nom Descriptif Valeur
acceptAudiences Audiences acceptées du cluster. AudiencesAcceptées[]
allowedFqdnList Liste des noms de domaine complets autorisés (nom de domaine complet) pour la sortie du cluster. chaîne de caractères[]
allowedIpRangeList Liste des adresses IP au format CIDR autorisé à se connecter au cluster. chaîne de caractères[]
calloutPolicies Liste des stratégies de légende pour la sortie du cluster. CalloutPolicy[]
activerAutoStop 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
enableStreamingIngestion Valeur booléenne qui indique si l’ingestion de streaming est activée. Bool
moteurType 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
optimiséMise à l’échelle automatique 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

ComponentsSgqdofSchemasIdentityPropertiesUserassignedidentitiesAdditionalproperties

Nom Descriptif Valeur

Identité

Nom Descriptif 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. « Aucun »
'SystemAssigned'
'SystemAssigned, UserAssigned'
'UserAssigned' (obligatoire)
Identités attribuées par l'utilisateur 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 Descriptif Valeur

KeyVaultProperties

Nom Descriptif 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

ExtensionLangue

Nom Descriptif 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_11_7'
'Python3_11_7_DL'
'Python3_6_5'
'PythonCustomImage'
'R'
languageExtensionName Nom de l’extension de langue. 'PYTHON'
'R'

LanguageExtensionsList

Nom Descriptif Valeur
valeur Liste des extensions de langage. ExtensionLangue[]

OptimiséMise à l’échelle automatique

Nom Descriptif 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)

TrackedResourceTags

Nom Descriptif Valeur

TrustedExternalTenant

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

VirtualNetworkConfiguration

Nom Descriptif 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)

Exemples d’utilisation

Modèles de démarrage rapide Microsoft Azure

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

Modèle Descriptif
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.
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
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é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.
hub FinOps

Déployer sur Azure
Ce modèle crée une instance de hub FinOps, notamment Data Explorer, Data Lake Storage et Data Factory.

Définition de ressource Terraform (fournisseur AzAPI)

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 terraform suivant à votre modèle.

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.Kusto/clusters@2024-04-13"
  name = "string"
  parent_id = "string"
  identity {
    type = "string"
    identity_ids = [
      "string"
    ]
  }
  location = "string"
  tags = {
    {customized property} = "string"
  }
  body = {
    properties = {
      acceptedAudiences = [
        {
          value = "string"
        }
      ]
      allowedFqdnList = [
        "string"
      ]
      allowedIpRangeList = [
        "string"
      ]
      calloutPolicies = [
        {
          calloutType = "string"
          calloutUriRegex = "string"
          outboundAccess = "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"
          }
        ]
      }
      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"
      }
    }
    sku = {
      capacity = int
      name = "string"
      tier = "string"
    }
    zones = [
      "string"
    ]
  }
}

Valeurs de propriété

Microsoft.Kusto/clusters

Nom Descriptif Valeur
identité Identité du cluster, si elle est configurée. Identité
emplacement Emplacement géographique où réside la ressource chaîne (obligatoire)
nom Nom de la ressource corde

Contraintes:
Modèle = ^.*$ (obligatoire)
parent_id ID de la ressource à laquelle appliquer cette ressource d’extension. chaîne (obligatoire)
Propriétés Propriétés du cluster. clusterProperties
Sku Référence SKU du cluster. AzureSku (obligatoire)
étiquettes Balises de ressource Dictionnaire de noms et de valeurs d’étiquettes.
type Type de ressource « Microsoft.Kusto/clusters@2024-04-13 »
Zones Zones de disponibilité du cluster. chaîne de caractères[]

AcceptAudiences

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

AzureSku

Nom Descriptif Valeur
capacité Nombre d’instances du cluster. Int
nom Nom de la référence SKU. 'Dev (pas de SLA)_Standard_D11_v2'
'Dev (pas de 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_E16ads_v5'
'Standard_E16as_v4+3TB_PS'
'Standard_E16as_v4+4TB_PS'
'Standard_E16as_v5+3TB_PS'
'Standard_E16as_v5+4TB_PS'
'Standard_E16a_v4'
'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_E2ads_v5'
'Standard_E2a_v4'
'Standard_E2d_v4'
'Standard_E2d_v5'
'Standard_E4ads_v5'
'Standard_E4a_v4'
'Standard_E4d_v4'
'Standard_E4d_v5'
'Standard_E64i_v3'
'Standard_E80ids_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_E8a_v4'
'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)

LégendePolitique

Nom Descriptif Valeur
calloutType Type du service de légende, en spécifiant le type de ressource externe ou de service accessible. 'azure_digital_twins'
'azure_openai'
'cosmosdb'
'external_data'
« Genevamétrie »
'Kusto'
'mysql'
'PostgreSQL'
'sandbox_artifacts'
'sql'
'WebAPI'
calloutUriRegex Expression régulière ou modèle de nom de domaine complet pour l’URI de légende. corde
outboundAccess Indique si l’accès sortant est autorisé pour le modèle d’URI spécifié. 'Autoriser'
'Refuser'

ClusterProperties

Nom Descriptif Valeur
acceptAudiences Audiences acceptées du cluster. AudiencesAcceptées[]
allowedFqdnList Liste des noms de domaine complets autorisés (nom de domaine complet) pour la sortie du cluster. chaîne de caractères[]
allowedIpRangeList Liste des adresses IP au format CIDR autorisé à se connecter au cluster. chaîne de caractères[]
calloutPolicies Liste des stratégies de légende pour la sortie du cluster. CalloutPolicy[]
activerAutoStop 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
enableStreamingIngestion Valeur booléenne qui indique si l’ingestion de streaming est activée. Bool
moteurType 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
optimiséMise à l’échelle automatique 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

ComponentsSgqdofSchemasIdentityPropertiesUserassignedidentitiesAdditionalproperties

Nom Descriptif Valeur

Identité

Nom Descriptif 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. « Aucun »
'SystemAssigned'
'SystemAssigned, UserAssigned'
'UserAssigned' (obligatoire)
Identités attribuées par l'utilisateur 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 Descriptif Valeur

KeyVaultProperties

Nom Descriptif 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

ExtensionLangue

Nom Descriptif 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_11_7'
'Python3_11_7_DL'
'Python3_6_5'
'PythonCustomImage'
'R'
languageExtensionName Nom de l’extension de langue. 'PYTHON'
'R'

LanguageExtensionsList

Nom Descriptif Valeur
valeur Liste des extensions de langage. ExtensionLangue[]

OptimiséMise à l’échelle automatique

Nom Descriptif 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)

TrackedResourceTags

Nom Descriptif Valeur

TrustedExternalTenant

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

VirtualNetworkConfiguration

Nom Descriptif 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)

Exemples d’utilisation

Échantillons Terraform

Exemple de base de déploiement du cluster Kusto (également connu sous le nom d’Azure Data Explorer).

terraform {
  required_providers {
    azapi = {
      source = "Azure/azapi"
    }
  }
}

provider "azapi" {
  skip_provider_registration = false
}

variable "resource_name" {
  type    = string
  default = "acctest0001"
}

variable "location" {
  type    = string
  default = "westeurope"
}

resource "azapi_resource" "resourceGroup" {
  type     = "Microsoft.Resources/resourceGroups@2020-06-01"
  name     = var.resource_name
  location = var.location
}

resource "azapi_resource" "cluster" {
  type      = "Microsoft.Kusto/clusters@2023-05-02"
  parent_id = azapi_resource.resourceGroup.id
  name      = var.resource_name
  location  = var.location
  body = {
    properties = {
      enableAutoStop                = true
      enableDiskEncryption          = false
      enableDoubleEncryption        = false
      enablePurge                   = false
      enableStreamingIngest         = false
      engineType                    = "V2"
      publicIPType                  = "IPv4"
      publicNetworkAccess           = "Enabled"
      restrictOutboundNetworkAccess = "Disabled"
      trustedExternalTenants = [
      ]
    }
    sku = {
      capacity = 1
      name     = "Dev(No SLA)_Standard_D11_v2"
      tier     = "Basic"
    }
  }
  schema_validation_enabled = false
  response_export_values    = ["*"]
}

Exemple de base de déploiement du cluster Kusto (également connu sous le nom d’Azure Data Explorer).

terraform {
  required_providers {
    azapi = {
      source = "Azure/azapi"
    }
  }
}

provider "azapi" {
  skip_provider_registration = false
}

variable "resource_name" {
  type    = string
  default = "acctest0001"
}

variable "location" {
  type    = string
  default = "westeurope"
}

resource "azapi_resource" "resourceGroup" {
  type     = "Microsoft.Resources/resourceGroups@2020-06-01"
  name     = var.resource_name
  location = var.location
}

resource "azapi_resource" "cluster" {
  type      = "Microsoft.Kusto/clusters@2023-05-02"
  parent_id = azapi_resource.resourceGroup.id
  name      = var.resource_name
  location  = var.location
  body = {
    properties = {
      enableAutoStop                = true
      enableDiskEncryption          = false
      enableDoubleEncryption        = false
      enablePurge                   = false
      enableStreamingIngest         = false
      engineType                    = "V2"
      publicIPType                  = "IPv4"
      publicNetworkAccess           = "Enabled"
      restrictOutboundNetworkAccess = "Disabled"
      trustedExternalTenants = [
      ]
    }
    sku = {
      capacity = 1
      name     = "Dev(No SLA)_Standard_D11_v2"
      tier     = "Basic"
    }
  }
  schema_validation_enabled = false
  response_export_values    = ["*"]
}

Modules vérifiés Azure

Les modules vérifiés Azure suivants peuvent être utilisés pour déployer ce type de ressource.

Module Descriptif
clusters Kusto Module de ressources AVM pour les clusters Kusto