Microsoft.Kusto/clusters 2021-01-01 - 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@2021-01-01' = {
  name: 'string'
  location: 'string'
  tags: {
    tagName1: 'tagValue1'
    tagName2: 'tagValue2'
  }
  sku: {
    capacity: int
    name: 'string'
    tier: 'string'
  }
  identity: {
    type: 'string'
    userAssignedIdentities: {
      {customized property}: {}
    }
  }
  properties: {
    enableDiskEncryption: bool
    enableDoubleEncryption: bool
    enablePurge: bool
    enableStreamingIngest: bool
    engineType: 'string'
    keyVaultProperties: {
      keyName: 'string'
      keyVaultUri: 'string'
      keyVersion: 'string'
      userIdentity: 'string'
    }
    optimizedAutoscale: {
      isEnabled: bool
      maximum: int
      minimum: int
      version: int
    }
    trustedExternalTenants: [
      {
        value: 'string'
      }
    ]
    virtualNetworkConfiguration: {
      dataManagementPublicIpId: 'string'
      enginePublicIpId: 'string'
      subnetId: 'string'
    }
  }
  zones: [
    'string'
  ]
}

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

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

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)
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_DS13_v2+1TB_PS' 'Standard_DS13_v2+2TB_PS' 'Standard_DS14_v2+3TB_PS' 'Standard_DS14_v2+4TB_PS' 'Standard_E16a_v4' 'Standard_E16as_v4+3TB_PS' 'Standard_E16as_v4+4TB_PS' 'Standard_E2a_v4' 'Standard_E4a_v4' 'Standard_E64i_v3' 'Standard_E80ids_v4' 'Standard_E8a_v4' 'Standard_E8as_v4+1TB_PS' 'Standard_E8as_v4+2TB_PS' 'Standard_L16s' 'Standard_L16s_v2' 'Standard_L4s' 'Standard_L8s' 'Standard_L8s_v2' (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	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	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.
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.
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é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": "2021-01-01",
  "name": "string",
  "location": "string",
  "tags": {
    "tagName1": "tagValue1",
    "tagName2": "tagValue2"
  },
  "sku": {
    "capacity": "int",
    "name": "string",
    "tier": "string"
  },
  "identity": {
    "type": "string",
    "userAssignedIdentities": {
      "{customized property}": {}
    }
  },
  "properties": {
    "enableDiskEncryption": "bool",
    "enableDoubleEncryption": "bool",
    "enablePurge": "bool",
    "enableStreamingIngest": "bool",
    "engineType": "string",
    "keyVaultProperties": {
      "keyName": "string",
      "keyVaultUri": "string",
      "keyVersion": "string",
      "userIdentity": "string"
    },
    "optimizedAutoscale": {
      "isEnabled": "bool",
      "maximum": "int",
      "minimum": "int",
      "version": "int"
    },
    "trustedExternalTenants": [
      {
        "value": "string"
      }
    ],
    "virtualNetworkConfiguration": {
      "dataManagementPublicIpId": "string",
      "enginePublicIpId": "string",
      "subnetId": "string"
    }
  },
  "zones": [ "string" ]
}

Valeurs de propriété

Clusters

Nom	Description	Valeur
type	Type de ressource	'Microsoft.Kusto/clusters'
apiVersion	Version de l’API de ressource	'2021-01-01'
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
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

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

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)
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_DS13_v2+1TB_PS' 'Standard_DS13_v2+2TB_PS' 'Standard_DS14_v2+3TB_PS' 'Standard_DS14_v2+4TB_PS' 'Standard_E16a_v4' 'Standard_E16as_v4+3TB_PS' 'Standard_E16as_v4+4TB_PS' 'Standard_E2a_v4' 'Standard_E4a_v4' 'Standard_E64i_v3' 'Standard_E80ids_v4' 'Standard_E8a_v4' 'Standard_E8as_v4+1TB_PS' 'Standard_E8as_v4+2TB_PS' 'Standard_L16s' 'Standard_L16s_v2' 'Standard_L4s' 'Standard_L8s' 'Standard_L8s_v2' (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	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	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.
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.
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é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@2021-01-01"
  name = "string"
  location = "string"
  parent_id = "string"
  tags = {
    tagName1 = "tagValue1"
    tagName2 = "tagValue2"
  }
  identity {
    type = "string"
    identity_ids = []
  }
  body = jsonencode({
    properties = {
      enableDiskEncryption = bool
      enableDoubleEncryption = bool
      enablePurge = bool
      enableStreamingIngest = bool
      engineType = "string"
      keyVaultProperties = {
        keyName = "string"
        keyVaultUri = "string"
        keyVersion = "string"
        userIdentity = "string"
      }
      optimizedAutoscale = {
        isEnabled = bool
        maximum = int
        minimum = int
        version = int
      }
      trustedExternalTenants = [
        {
          value = "string"
        }
      ]
      virtualNetworkConfiguration = {
        dataManagementPublicIpId = "string"
        enginePublicIpId = "string"
        subnetId = "string"
      }
    }
    zones = [
      "string"
    ]
    sku = {
      capacity = int
      name = "string"
      tier = "string"
    }
  })
}

Valeurs de propriété

Clusters

Nom	Description	Valeur
type	Type de ressource	« Microsoft.Kusto/clusters@2021-01-01 »
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
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

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

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

Partager via

Clusters Microsoft.Kusto 2021-01-01

Définition de ressource Bicep

Format de ressource

Valeurs de propriété

Clusters

Identité

IdentityUserAssignedIdentities

ComponentsSgqdofSchemasIdentityPropertiesUserassigne...

ClusterProperties

KeyVaultProperties

OptimizedAutoscale

TrustedExternalTenant

VirtualNetworkConfiguration

AzureSku

Modèles de démarrage rapide

Définition de ressource de modèle ARM

Format de ressource

Valeurs de propriété

Clusters

Identité

IdentityUserAssignedIdentities

ComponentsSgqdofSchemasIdentityPropertiesUserassigne...

ClusterProperties

KeyVaultProperties

OptimizedAutoscale

TrustedExternalTenant

VirtualNetworkConfiguration

AzureSku

Modèles de démarrage rapide

Définition de ressource Terraform (fournisseur AzAPI)

Format de ressource

Valeurs de propriété

Clusters

Identité

IdentityUserAssignedIdentities

ComponentsSgqdofSchemasIdentityPropertiesUserassigne...

ClusterProperties

KeyVaultProperties

OptimizedAutoscale

TrustedExternalTenant

VirtualNetworkConfiguration

AzureSku

Commentaires

Ressources supplémentaires