Microsoft.Kusto/clusters 2020-09-18 - Bicep, ARM template & Terraform AzAPI reference

Définition de ressource Bicep

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

groupes de ressources - Consultez commandes de déploiement de 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 le bicep suivant à votre modèle.

resource symbolicname 'Microsoft.Kusto/clusters@2020-09-18' = {
  identity: {
    type: 'string'
    userAssignedIdentities: {
      {customized property}: {}
    }
  }
  location: 'string'
  name: 'string'
  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'
    }
  }
  sku: {
    capacity: int
    name: 'string'
    tier: 'string'
  }
  tags: {
    {customized property}: 'string'
  }
  zones: [
    'string'
  ]
}

Valeurs de propriété

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_DS13_v2+1TB_PS' 'Standard_DS13_v2+2TB_PS' 'Standard_DS14_v2+3TB_PS' 'Standard_DS14_v2+4TB_PS' 'Standard_E16as_v4+3TB_PS' 'Standard_E16as_v4+4TB_PS' 'Standard_E16a_v4' 'Standard_E2a_v4' 'Standard_E4a_v4' 'Standard_E64i_v3' 'Standard_E8as_v4+1TB_PS' 'Standard_E8as_v4+2TB_PS' 'Standard_E8a_v4' 'Standard_L16s' 'Standard_L4s' 'Standard_L8s' (obligatoire)
niveau	Niveau de référence SKU.	'De base' 'Standard' (obligatoire)

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
engineType	Type de moteur	'V2' 'V3'
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

ComponentsSgqdofSchemasIdentityPropertiesUserassignedidentitiesAdditionalproperties

Nom	Description	Valeur

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

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.	corde
userIdentity	Identité affectée par l’utilisateur (ID de ressource ARM) qui a accès à la clé.	corde

Microsoft.Kusto/clusters

Nom	Description	Valeur
identité	Identité du cluster, si elle est configurée.	Identity
emplacement	Emplacement géographique où réside la ressource	chaîne (obligatoire)
nom	Nom de la ressource	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. Consultez les balises dans les modèles
zones	Zones de disponibilité du cluster.	string[]

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)

TrackedResourceTags

Nom	Description	Valeur

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)
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	Description
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	Description
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 :

groupes de ressources - Consultez commandes de déploiement de 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 le code JSON suivant à votre modèle.

{
  "type": "Microsoft.Kusto/clusters",
  "apiVersion": "2020-09-18",
  "name": "string",
  "identity": {
    "type": "string",
    "userAssignedIdentities": {
      "{customized property}": {
      }
    }
  },
  "location": "string",
  "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"
    }
  },
  "sku": {
    "capacity": "int",
    "name": "string",
    "tier": "string"
  },
  "tags": {
    "{customized property}": "string"
  },
  "zones": [ "string" ]
}

Valeurs de propriété

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_DS13_v2+1TB_PS' 'Standard_DS13_v2+2TB_PS' 'Standard_DS14_v2+3TB_PS' 'Standard_DS14_v2+4TB_PS' 'Standard_E16as_v4+3TB_PS' 'Standard_E16as_v4+4TB_PS' 'Standard_E16a_v4' 'Standard_E2a_v4' 'Standard_E4a_v4' 'Standard_E64i_v3' 'Standard_E8as_v4+1TB_PS' 'Standard_E8as_v4+2TB_PS' 'Standard_E8a_v4' 'Standard_L16s' 'Standard_L4s' 'Standard_L8s' (obligatoire)
niveau	Niveau de référence SKU.	'De base' 'Standard' (obligatoire)

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
engineType	Type de moteur	'V2' 'V3'
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

ComponentsSgqdofSchemasIdentityPropertiesUserassignedidentitiesAdditionalproperties

Nom	Description	Valeur

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

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.	corde
userIdentity	Identité affectée par l’utilisateur (ID de ressource ARM) qui a accès à la clé.	corde

Microsoft.Kusto/clusters

Nom	Description	Valeur
apiVersion	Version de l’API	'2020-09-18'
identité	Identité du cluster, si elle est configurée.	Identity
emplacement	Emplacement géographique où réside la ressource	chaîne (obligatoire)
nom	Nom de la ressource	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. Consultez les balises dans les modèles
type	Type de ressource	'Microsoft.Kusto/clusters'
zones	Zones de disponibilité du cluster.	string[]

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)

TrackedResourceTags

Nom	Description	Valeur

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)
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	Description
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 cluster d’une base de données	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	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	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é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 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@2020-09-18"
  name = "string"
  identity = {
    type = "string"
    userAssignedIdentities = {
      {customized property} = {
      }
    }
  }
  location = "string"
  sku = {
    capacity = int
    name = "string"
    tier = "string"
  }
  tags = {
    {customized property} = "string"
  }
  zones = [
    "string"
  ]
  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"
      }
    }
  })
}

Valeurs de propriété

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_DS13_v2+1TB_PS' 'Standard_DS13_v2+2TB_PS' 'Standard_DS14_v2+3TB_PS' 'Standard_DS14_v2+4TB_PS' 'Standard_E16as_v4+3TB_PS' 'Standard_E16as_v4+4TB_PS' 'Standard_E16a_v4' 'Standard_E2a_v4' 'Standard_E4a_v4' 'Standard_E64i_v3' 'Standard_E8as_v4+1TB_PS' 'Standard_E8as_v4+2TB_PS' 'Standard_E8a_v4' 'Standard_L16s' 'Standard_L4s' 'Standard_L8s' (obligatoire)
niveau	Niveau de référence SKU.	'De base' 'Standard' (obligatoire)

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
engineType	Type de moteur	'V2' 'V3'
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

ComponentsSgqdofSchemasIdentityPropertiesUserassignedidentitiesAdditionalproperties

Nom	Description	Valeur

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

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.	corde
userIdentity	Identité affectée par l’utilisateur (ID de ressource ARM) qui a accès à la clé.	corde

Microsoft.Kusto/clusters

Nom	Description	Valeur
identité	Identité du cluster, si elle est configurée.	Identity
emplacement	Emplacement géographique où réside la ressource	chaîne (obligatoire)
nom	Nom de la ressource	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@2020-09-18 »
zones	Zones de disponibilité du cluster.	string[]

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)

TrackedResourceTags

Nom	Description	Valeur

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)
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	Description
clusters Kusto	Module de ressources AVM pour les clusters Kusto

Partager via

Clusters Microsoft.Kusto 2020-09-18

Définition de ressource Bicep

Format de ressource

Valeurs de propriété

AzureSku

ClusterProperties

ComponentsSgqdofSchemasIdentityPropertiesUserassignedidentitiesAdditionalproperties

Identité

IdentityUserAssignedIdentities

KeyVaultProperties

Microsoft.Kusto/clusters

OptimizedAutoscale

TrackedResourceTags

TrustedExternalTenant

VirtualNetworkConfiguration

Exemples d’utilisation

Modules vérifiés Azure

Exemples de démarrage rapide Azure

Définition de ressource de modèle ARM

Format de ressource

Valeurs de propriété

AzureSku

ClusterProperties

ComponentsSgqdofSchemasIdentityPropertiesUserassignedidentitiesAdditionalproperties

Identité

IdentityUserAssignedIdentities

KeyVaultProperties

Microsoft.Kusto/clusters

OptimizedAutoscale

TrackedResourceTags

TrustedExternalTenant

VirtualNetworkConfiguration

Exemples d’utilisation

Modèles de démarrage rapide Microsoft Azure

Définition de ressource Terraform (fournisseur AzAPI)

Format de ressource

Valeurs de propriété

AzureSku

ClusterProperties

ComponentsSgqdofSchemasIdentityPropertiesUserassignedidentitiesAdditionalproperties

Identité

IdentityUserAssignedIdentities

KeyVaultProperties

Microsoft.Kusto/clusters

OptimizedAutoscale

TrackedResourceTags

TrustedExternalTenant

VirtualNetworkConfiguration

Exemples d’utilisation

Modules vérifiés Azure

Commentaires

Ressources supplémentaires