Clusters Microsoft.Kusto
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@2024-04-13' = {
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é
AcceptAudiences
Nom | Description | Valeur |
---|---|---|
valeur | GUID ou URL valide représentant un public accepté. | corde |
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_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) |
CalloutPolicy
Nom | Description | 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' 'genevametrics' '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 | 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[] |
calloutPolicies | Liste des stratégies de légende pour la sortie du cluster. | CalloutPolicy[] |
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 |
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. | 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 |
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_11_7' 'Python3_11_7_DL' 'Python3_6_5' 'PythonCustomImage' 'R' |
languageExtensionName | Nom de l’extension de langue. | 'PYTHON' 'R' |
LanguageExtensionsList
Nom | Description | Valeur |
---|---|---|
valeur | Liste des extensions de langage. | LanguageExtension[] |
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 | 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 |
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) |
é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 de démarrage rapide
Les exemples de démarrage rapide suivants déploient 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. |
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": "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é
AcceptAudiences
Nom | Description | Valeur |
---|---|---|
valeur | GUID ou URL valide représentant un public accepté. | corde |
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_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) |
CalloutPolicy
Nom | Description | 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' 'genevametrics' '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 | 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[] |
calloutPolicies | Liste des stratégies de légende pour la sortie du cluster. | CalloutPolicy[] |
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 |
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. | 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 |
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_11_7' 'Python3_11_7_DL' 'Python3_6_5' 'PythonCustomImage' 'R' |
languageExtensionName | Nom de l’extension de langue. | 'PYTHON' 'R' |
LanguageExtensionsList
Nom | Description | Valeur |
---|---|---|
valeur | Liste des extensions de langage. | LanguageExtension[] |
Microsoft.Kusto/clusters
Nom | Description | Valeur |
---|---|---|
apiVersion | Version de l’API | '2024-04-13' |
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 | 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. | 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) |
é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) |
Modèles de démarrage rapide
Les modèles de démarrage rapide suivants déploient ce type de ressource.
Modèle | Description |
---|---|
Azure Digital Twins avec 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. |
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@2024-04-13"
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 = {
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"
}
}
})
}
Valeurs de propriété
AcceptAudiences
Nom | Description | Valeur |
---|---|---|
valeur | GUID ou URL valide représentant un public accepté. | corde |
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_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) |
CalloutPolicy
Nom | Description | 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' 'genevametrics' '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 | 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[] |
calloutPolicies | Liste des stratégies de légende pour la sortie du cluster. | CalloutPolicy[] |
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 |
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. | 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 |
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_11_7' 'Python3_11_7_DL' 'Python3_6_5' 'PythonCustomImage' 'R' |
languageExtensionName | Nom de l’extension de langue. | 'PYTHON' 'R' |
LanguageExtensionsList
Nom | Description | Valeur |
---|---|---|
valeur | Liste des extensions de langage. | LanguageExtension[] |
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 | 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. |
type | Type de ressource | « Microsoft.Kusto/clusters@2024-04-13 » |
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) |
é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) |