Clusters - Create Or Update

Service:: Azure Kusto

Version d'API:: 2024-04-13

Créez ou mettez à jour un cluster Kusto.

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Kusto/clusters/{clusterName}?api-version=2024-04-13

Paramètres URI

Nom	Dans	Obligatoire	Type	Description
clusterName	path	True	string pattern: ^.*$	Nom du cluster Kusto.
resourceGroupName	path	True	string minLength: 1 maxLength: 90	Nom du groupe de ressources. Le nom ne respecte pas la casse.
subscriptionId	path	True	string minLength: 1	ID de l’abonnement cible.
api-version	query	True	string minLength: 1	Version de l’API à utiliser pour cette opération.

En-tête de la demande

Nom	Obligatoire	Type	Description
If-Match		string	ETag du cluster. Omettez cette valeur pour toujours remplacer le cluster actuel. Spécifiez la dernière valeur ETag vue pour empêcher le remplacement accidentel des modifications simultanées.
If-None-Match		string	Définissez sur « * » pour autoriser la création d’un nouveau cluster, mais pour empêcher la mise à jour d’un cluster existant. D’autres valeurs entraînent une réponse 412 en cas d’échec de la condition.

Corps de la demande

Nom	Obligatoire	Type	Description
location	True	string	Emplacement géographique où réside la ressource
sku	True	AzureSku	Référence SKU du cluster.
identity		Identity	Identité du cluster, si elle est configurée.
properties.acceptedAudiences		AcceptedAudiences[]	Audiences acceptées du cluster.
properties.allowedFqdnList		string[]	Liste des noms de domaine complets autorisés (nom de domaine complet) pour la sortie du cluster.
properties.allowedIpRangeList		string[]	Liste des adresses IP au format CIDR autorisé à se connecter au cluster.
properties.calloutPolicies		CalloutPolicy[]	Liste des stratégies de légende pour la sortie du cluster.
properties.enableAutoStop		boolean	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).
properties.enableDiskEncryption		boolean	Valeur booléenne qui indique si les disques du cluster sont chiffrés.
properties.enableDoubleEncryption		boolean	Valeur booléenne qui indique si le double chiffrement est activé.
properties.enablePurge		boolean	Valeur booléenne qui indique si les opérations de vidage sont activées.
properties.enableStreamingIngest		boolean	Valeur booléenne qui indique si l’ingestion de streaming est activée.
properties.engineType		EngineType	Type de moteur
properties.keyVaultProperties		KeyVaultProperties	Propriétés KeyVault pour le chiffrement du cluster.
properties.languageExtensions		LanguageExtensionsList	Liste des extensions de langage du cluster.
properties.optimizedAutoscale		OptimizedAutoscale	Définition de mise à l’échelle automatique optimisée.
properties.publicIPType		publicIPType	Indique le type d’adresse IP publique à créer - IPv4 (valeur par défaut) ou DualStack (IPv4 et IPv6)
properties.publicNetworkAccess		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
properties.restrictOutboundNetworkAccess		ClusterNetworkAccessFlag	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é »
properties.trustedExternalTenants		TrustedExternalTenant[]	Locataires externes du cluster.
properties.virtualClusterGraduationProperties		string	Propriétés de graduation de cluster virtuel
properties.virtualNetworkConfiguration		VirtualNetworkConfiguration	Définition de réseau virtuel.
tags		object	Balises de ressource.
zones		string[]	Zones de disponibilité du cluster.

Réponses

Nom	Type	Description
200 OK	Cluster	Mise à jour réussie du cluster.
201 Created	Cluster	Création réussie du cluster.
Other Status Codes	ErrorResponse	Réponse d’erreur décrivant pourquoi l’opération a échoué.

Exemples

KustoClustersCreateOrUpdate

Exemple de requête

HTTP

PUT https://management.azure.com/subscriptions/12345678-1234-1234-1234-123456789098/resourceGroups/kustorptest/providers/Microsoft.Kusto/clusters/kustoCluster?api-version=2024-04-13

{
  "location": "westus",
  "sku": {
    "name": "Standard_L16as_v3",
    "capacity": 2,
    "tier": "Standard"
  },
  "identity": {
    "type": "SystemAssigned"
  },
  "properties": {
    "enableStreamingIngest": true,
    "enablePurge": true,
    "enableDoubleEncryption": false,
    "enableAutoStop": true,
    "publicIPType": "DualStack",
    "publicNetworkAccess": "Enabled",
    "allowedIpRangeList": [
      "0.0.0.0/0"
    ],
    "languageExtensions": {
      "value": [
        {
          "languageExtensionName": "PYTHON",
          "languageExtensionImageName": "Python3_10_8"
        },
        {
          "languageExtensionName": "R",
          "languageExtensionImageName": "R"
        }
      ]
    }
  }
}

Exemple de réponse

Code d’état:: 200

{
  "id": "/subscriptions/12345678-1234-1234-1234-123456789098/resourceGroups/kustorptest/providers/Microsoft.Kusto/Clusters/kustoCluster",
  "name": "kustoCluster",
  "type": "Microsoft.Kusto/Clusters",
  "location": "westus",
  "properties": {
    "provisioningState": "Succeeded",
    "enableDiskEncryption": false,
    "enableStreamingIngest": true,
    "enablePurge": true,
    "enableDoubleEncryption": false,
    "enableAutoStop": true,
    "publicIPType": "DualStack",
    "keyVaultProperties": {
      "keyVaultUri": "https://dummy.keyvault.com",
      "keyName": "keyName",
      "keyVersion": "keyVersion"
    },
    "engineType": "V3",
    "publicNetworkAccess": "Enabled",
    "restrictOutboundNetworkAccess": "Disabled",
    "allowedIpRangeList": [
      "0.0.0.0/0"
    ],
    "languageExtensions": {
      "value": [
        {
          "languageExtensionName": "PYTHON",
          "languageExtensionImageName": "Python3_10_8"
        },
        {
          "languageExtensionName": "R",
          "languageExtensionImageName": "R"
        }
      ]
    }
  },
  "sku": {
    "name": "Standard_L16as_v3",
    "capacity": 2,
    "tier": "Standard"
  },
  "identity": {
    "type": "SystemAssigned",
    "tenantId": "b932977f-6277-4ab7-a2cd-5bd21f07aaf4",
    "principalId": "faabad1f-4876-463c-af9d-6ba2d2d2394c",
    "userAssignedIdentities": {}
  },
  "etag": "abcd"
}

Code d’état:: 201

{
  "id": "/subscriptions/12345678-1234-1234-1234-123456789098/resourceGroups/kustorptest/providers/Microsoft.Kusto/Clusters/kustoCluster",
  "name": "kustoCluster",
  "type": "Microsoft.Kusto/Clusters",
  "location": "westus",
  "properties": {
    "provisioningState": "Succeeded",
    "enableDiskEncryption": false,
    "enableStreamingIngest": true,
    "enablePurge": true,
    "enableDoubleEncryption": false,
    "enableAutoStop": true,
    "publicIPType": "DualStack",
    "keyVaultProperties": {
      "keyVaultUri": "https://dummy.keyvault.com",
      "keyName": "keyName",
      "keyVersion": "keyVersion"
    },
    "engineType": "V3",
    "publicNetworkAccess": "Enabled",
    "restrictOutboundNetworkAccess": "Disabled",
    "allowedIpRangeList": [
      "0.0.0.0/0"
    ],
    "languageExtensions": {
      "value": [
        {
          "languageExtensionName": "PYTHON",
          "languageExtensionImageName": "Python3_10_8"
        },
        {
          "languageExtensionName": "R",
          "languageExtensionImageName": "R"
        }
      ]
    }
  },
  "sku": {
    "name": "Standard_L16as_v3",
    "capacity": 2,
    "tier": "Standard"
  },
  "identity": {
    "type": "SystemAssigned",
    "tenantId": "b932977f-6277-4ab7-a2cd-5bd21f07aaf4",
    "principalId": "faabad1f-4876-463c-af9d-6ba2d2d2394c",
    "userAssignedIdentities": {}
  },
  "etag": "abcd123"
}

Définitions

Nom	Description
AcceptedAudiences	Représente un public accepté approuvé par le cluster.
AzureSku	Définition de référence SKU Azure.
AzureSkuName	Nom de la référence SKU.
AzureSkuTier	Niveau de référence SKU.
CalloutPolicy	Configuration pour les stratégies de légende externe, notamment les modèles d’URI, les types d’accès et les types de service.
calloutType	Type du service de légende, en spécifiant le type de ressource externe ou de service accessible.
Cluster	Classe représentant un cluster Kusto.
ClusterNetworkAccessFlag	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é »
createdByType	Type d’identité qui a créé la ressource.
EngineType	Type de moteur
ErrorAdditionalInfo	Informations supplémentaires sur l’erreur de gestion des ressources.
ErrorDetail	Détail de l’erreur.
ErrorResponse	Réponse d’erreur
Identity	Identité de la ressource.
IdentityType	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.
KeyVaultProperties	Propriétés du coffre de clés.
LanguageExtension	Objet d’extension de langage.
languageExtensionImageName	Nom de l’image de l’extension de langage.
languageExtensionName	Nom de l’extension de langue.
LanguageExtensionsList	Liste des objets d’extension de langage.
MigrationClusterProperties	Représente les propriétés d’un cluster qui fait partie d’une migration.
MigrationClusterRole	Rôle du cluster dans le processus de migration.
OptimizedAutoscale	Classe qui contient la définition de mise à l’échelle automatique optimisée.
outboundAccess	Indique si l’accès sortant est autorisé pour le modèle d’URI spécifié.
PrivateEndpointConnection	Une connexion de point de terminaison privé
PrivateEndpointProperty	Point de terminaison privé auquel la connexion appartient.
PrivateLinkServiceConnectionStateProperty	État de connexion de la connexion de point de terminaison privé.
ProvisioningState	État provisionné de la ressource.
publicIPType	Indique le type d’adresse IP publique à créer - IPv4 (valeur par défaut) ou DualStack (IPv4 et IPv6)
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
State	État de la ressource.
systemData	Métadonnées relatives à la création et à la dernière modification de la ressource.
TrustedExternalTenant	Représente un ID de locataire approuvé par le cluster.
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} ».
VirtualNetworkConfiguration	Classe qui contient la définition de réseau virtuel.
VnetState	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.
ZoneStatus	Indique si le cluster est zonal ou non zonal.

AcceptedAudiences

Object

Représente un public accepté approuvé par le cluster.

Nom	Type	Description
value	string	GUID ou URL valide représentant un public accepté.

AzureSku

Object

Définition de référence SKU Azure.

Nom	Type	Description
capacity	integer (int32)	Nombre d’instances du cluster.
name	AzureSkuName	Nom de la référence SKU.
tier	AzureSkuTier	Niveau de référence SKU.

AzureSkuName

Énumération

Nom de la référence SKU.

Valeur	Description
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_D32d_v4
Standard_D16d_v5
Standard_D32d_v5
Standard_DS13_v2+1TB_PS
Standard_DS13_v2+2TB_PS
Standard_DS14_v2+3TB_PS
Standard_DS14_v2+4TB_PS
Standard_L4s
Standard_L8s
Standard_L16s
Standard_L8s_v2
Standard_L16s_v2
Standard_L8s_v3
Standard_L16s_v3
Standard_L32s_v3
Standard_L8as_v3
Standard_L16as_v3
Standard_L32as_v3
Standard_E64i_v3
Standard_E80ids_v4
Standard_E2a_v4
Standard_E4a_v4
Standard_E8a_v4
Standard_E16a_v4
Standard_E8as_v4+1TB_PS
Standard_E8as_v4+2TB_PS
Standard_E16as_v4+3TB_PS
Standard_E16as_v4+4TB_PS
Standard_E8as_v5+1TB_PS
Standard_E8as_v5+2TB_PS
Standard_E16as_v5+3TB_PS
Standard_E16as_v5+4TB_PS
Standard_E2ads_v5
Standard_E4ads_v5
Standard_E8ads_v5
Standard_E16ads_v5
Standard_EC8as_v5+1TB_PS
Standard_EC8as_v5+2TB_PS
Standard_EC16as_v5+3TB_PS
Standard_EC16as_v5+4TB_PS
Standard_EC8ads_v5
Standard_EC16ads_v5
Standard_E8s_v4+1TB_PS
Standard_E8s_v4+2TB_PS
Standard_E16s_v4+3TB_PS
Standard_E16s_v4+4TB_PS
Standard_E8s_v5+1TB_PS
Standard_E8s_v5+2TB_PS
Standard_E16s_v5+3TB_PS
Standard_E16s_v5+4TB_PS
Standard_E2d_v4
Standard_E4d_v4
Standard_E8d_v4
Standard_E16d_v4
Standard_E2d_v5
Standard_E4d_v5
Standard_E8d_v5
Standard_E16d_v5

AzureSkuTier

Énumération

Niveau de référence SKU.

Valeur	Description
Basic
Standard

CalloutPolicy

Object

Configuration pour les stratégies de légende externe, notamment les modèles d’URI, les types d’accès et les types de service.

Nom	Type	Description
calloutId	string	Identificateur unique de la configuration de légende.
calloutType	calloutType	Type du service de légende, en spécifiant le type de ressource externe ou de service accessible.
calloutUriRegex	string	Expression régulière ou modèle de nom de domaine complet pour l’URI de légende.
outboundAccess	outboundAccess	Indique si l’accès sortant est autorisé pour le modèle d’URI spécifié.

calloutType

Énumération

Type du service de légende, en spécifiant le type de ressource externe ou de service accessible.

Valeur	Description
kusto
sql
cosmosdb
external_data
azure_digital_twins
sandbox_artifacts
webapi
mysql
postgresql
genevametrics
azure_openai

Cluster

Object

Classe représentant un cluster Kusto.

Nom	Type	Valeur par défaut	Description
etag	string		Chaîne en lecture seule unique qui change chaque fois que la ressource est mise à jour.
id	string		ID de ressource complet pour la ressource. ex - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}
identity	Identity		Identité du cluster, si elle est configurée.
location	string		Emplacement géographique où réside la ressource
name	string		Nom de la ressource
properties.acceptedAudiences	AcceptedAudiences[]		Audiences acceptées du cluster.
properties.allowedFqdnList	string[]		Liste des noms de domaine complets autorisés (nom de domaine complet) pour la sortie du cluster.
properties.allowedIpRangeList	string[]		Liste des adresses IP au format CIDR autorisé à se connecter au cluster.
properties.calloutPolicies	CalloutPolicy[]		Liste des stratégies de légende pour la sortie du cluster.
properties.dataIngestionUri	string		URI d’ingestion des données du cluster.
properties.enableAutoStop	boolean	True	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).
properties.enableDiskEncryption	boolean	False	Valeur booléenne qui indique si les disques du cluster sont chiffrés.
properties.enableDoubleEncryption	boolean	False	Valeur booléenne qui indique si le double chiffrement est activé.
properties.enablePurge	boolean	False	Valeur booléenne qui indique si les opérations de vidage sont activées.
properties.enableStreamingIngest	boolean	False	Valeur booléenne qui indique si l’ingestion de streaming est activée.
properties.engineType	EngineType	V3	Type de moteur
properties.keyVaultProperties	KeyVaultProperties		Propriétés KeyVault pour le chiffrement du cluster.
properties.languageExtensions	LanguageExtensionsList		Liste des extensions de langage du cluster.
properties.migrationCluster	MigrationClusterProperties		Propriétés du cluster homologue impliqué dans une migration vers/depuis ce cluster.
properties.optimizedAutoscale	OptimizedAutoscale		Définition de mise à l’échelle automatique optimisée.
properties.privateEndpointConnections	PrivateEndpointConnection[]		Liste des connexions de point de terminaison privé.
properties.provisioningState	ProvisioningState		État provisionné de la ressource.
properties.publicIPType	publicIPType	IPv4	Indique le type d’adresse IP publique à créer - IPv4 (valeur par défaut) ou DualStack (IPv4 et IPv6)
properties.publicNetworkAccess	PublicNetworkAccess	Enabled	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
properties.restrictOutboundNetworkAccess	ClusterNetworkAccessFlag	Disabled	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é »
properties.state	State		État de la ressource.
properties.stateReason	string		Raison de l’état actuel du cluster.
properties.trustedExternalTenants	TrustedExternalTenant[]		Locataires externes du cluster.
properties.uri	string		URI du cluster.
properties.virtualClusterGraduationProperties	string		Propriétés de graduation de cluster virtuel
properties.virtualNetworkConfiguration	VirtualNetworkConfiguration		Définition de réseau virtuel.
properties.zoneStatus	ZoneStatus		Indique si le cluster est zonal ou non zonal.
sku	AzureSku		Référence SKU du cluster.
systemData	systemData		Métadonnées relatives à la création et à la dernière modification de la ressource.
tags	object		Balises de ressource.
type	string		Type de la ressource. Par exemple, « Microsoft.Compute/virtualMachines » ou « Microsoft.Storage/storageAccounts »
zones	string[]		Zones de disponibilité du cluster.

ClusterNetworkAccessFlag

Énumération

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

Valeur	Description
Enabled
Disabled

createdByType

Énumération

Type d’identité qui a créé la ressource.

Valeur	Description
User
Application
ManagedIdentity
Key

EngineType

Énumération

Type de moteur

Valeur	Description
V2
V3

ErrorAdditionalInfo

Object

Informations supplémentaires sur l’erreur de gestion des ressources.

Nom	Type	Description
info	object	Informations supplémentaires.
type	string	Type d’informations supplémentaire.

ErrorDetail

Object

Détail de l’erreur.

Nom	Type	Description
additionalInfo	ErrorAdditionalInfo[]	Informations supplémentaires sur l’erreur.
code	string	Code d’erreur.
details	ErrorDetail[]	Détails de l’erreur.
message	string	Message d’erreur.
target	string	Cible d’erreur.

ErrorResponse

Object

Réponse d’erreur

Nom	Type	Description
error	ErrorDetail	Objet d’erreur.

Identity

Object

Identité de la ressource.

Nom	Type	Description
principalId	string	ID principal de l’identité de ressource.
tenantId	string	ID de locataire de la ressource.
type	IdentityType	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.
userAssignedIdentities	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} ».

IdentityType

Énumération

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.

Valeur	Description
None
SystemAssigned
UserAssigned
SystemAssigned, UserAssigned

KeyVaultProperties

Object

Propriétés du coffre de clés.

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

LanguageExtension

Object

Objet d’extension de langage.

Nom	Type	Description
languageExtensionCustomImageName	string	Nom de l’image personnalisée de l’extension de langage.
languageExtensionImageName	languageExtensionImageName	Nom de l’image de l’extension de langage.
languageExtensionName	languageExtensionName	Nom de l’extension de langue.

languageExtensionImageName

Énumération

Nom de l’image de l’extension de langage.

Valeur	Description
R
Python3_6_5
Python3_10_8
Python3_10_8_DL
PythonCustomImage
Python3_11_7
Python3_11_7_DL

languageExtensionName

Énumération

Nom de l’extension de langue.

Valeur	Description
PYTHON
R

LanguageExtensionsList

Object

Liste des objets d’extension de langage.

Nom	Type	Description
value	LanguageExtension[]	Liste des extensions de langage.

MigrationClusterProperties

Object

Représente les propriétés d’un cluster qui fait partie d’une migration.

Nom	Type	Description
dataIngestionUri	string	URL d’ingestion de données publiques du cluster.
id	string	ID de ressource du cluster.
role	MigrationClusterRole	Rôle du cluster dans le processus de migration.
uri	string	URL publique du cluster.

MigrationClusterRole

Énumération

Rôle du cluster dans le processus de migration.

Valeur	Description
Source
Destination

OptimizedAutoscale

Object

Classe qui contient la définition de mise à l’échelle automatique optimisée.

Nom	Type	Description
isEnabled	boolean	Valeur booléenne qui indique si la fonctionnalité de mise à l’échelle automatique optimisée est activée ou non.
maximum	integer (int32)	Nombre maximal d’instances autorisées.
minimum	integer (int32)	Nombre minimal d’instances autorisées.
version	integer (int32)	Version du modèle défini, par exemple 1.

outboundAccess

Énumération

Indique si l’accès sortant est autorisé pour le modèle d’URI spécifié.

Valeur	Description
Allow
Deny

PrivateEndpointConnection

Object

Une connexion de point de terminaison privé

Nom	Type	Description
id	string	ID de ressource complet pour la ressource. ex - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}
name	string	Nom de la ressource
properties.groupId	string	ID de groupe du point de terminaison privé.
properties.privateEndpoint	PrivateEndpointProperty	Point de terminaison privé auquel la connexion appartient.
properties.privateLinkServiceConnectionState	PrivateLinkServiceConnectionStateProperty	État de connexion de la connexion de point de terminaison privé.
properties.provisioningState	string	État d’approvisionnement du point de terminaison privé.
systemData	systemData	Métadonnées relatives à la création et à la dernière modification de la ressource.
type	string	Type de la ressource. Par exemple, « Microsoft.Compute/virtualMachines » ou « Microsoft.Storage/storageAccounts »

PrivateEndpointProperty

Object

Point de terminaison privé auquel la connexion appartient.

Nom	Type	Description
id	string	ID de ressource du point de terminaison privé.

PrivateLinkServiceConnectionStateProperty

Object

État de connexion de la connexion de point de terminaison privé.

Nom	Type	Description
actionsRequired	string	Toute action requise au-delà du flux de travail de base (approuver/rejeter/déconnecter)
description	string	Description de la connexion du service private link.
status	string	État de connexion du service de liaison privée.

ProvisioningState

Énumération

État provisionné de la ressource.

Valeur	Description
Running
Creating
Deleting
Succeeded
Failed
Moving
Canceled

publicIPType

Énumération

Indique le type d’adresse IP publique à créer - IPv4 (valeur par défaut) ou DualStack (IPv4 et IPv6)

Valeur	Description
IPv4
DualStack

PublicNetworkAccess

Énumération

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

Valeur	Description
Enabled
Disabled

State

Énumération

État de la ressource.

Valeur	Description
Creating
Unavailable
Running
Deleting
Deleted
Stopping
Stopped
Starting
Updating
Migrated

systemData

Object

Métadonnées relatives à la création et à la dernière modification de la ressource.

Nom	Type	Description
createdAt	string (date-time)	Horodatage de la création de ressources (UTC).
createdBy	string	Identité qui a créé la ressource.
createdByType	createdByType	Type d’identité qui a créé la ressource.
lastModifiedAt	string (date-time)	Horodatage de la dernière modification de ressource (UTC)
lastModifiedBy	string	Identité qui a modifié la ressource pour la dernière fois.
lastModifiedByType	createdByType	Type d’identité qui a modifié la ressource pour la dernière fois.

TrustedExternalTenant

Object

Représente un ID de locataire approuvé par le cluster.

Nom	Type	Description
value	string	GUID représentant un locataire externe.

UserAssignedIdentities

Object

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} ».

Nom	Type	Description

VirtualNetworkConfiguration

Object

Classe qui contient la définition de réseau virtuel.

Nom	Type	Valeur par défaut	Description
dataManagementPublicIpId	string		ID de ressource d’adresse IP publique du service de gestion des données.
enginePublicIpId	string		ID de ressource d’adresse IP publique du service moteur.
state	VnetState	Enabled	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.
subnetId	string		ID de ressource de sous-réseau.

VnetState

Énumération

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.

Valeur	Description
Enabled
Disabled

ZoneStatus

Énumération

Indique si le cluster est zonal ou non zonal.

Valeur	Description
NonZonal
ZonalInconsistency
Zonal

Partager via

Clusters - Create Or Update

Paramètres URI

En-tête de la demande

Corps de la demande

Réponses

Exemples

KustoClustersCreateOrUpdate

Exemple de requête

Exemple de réponse

Définitions

AcceptedAudiences

AzureSku

AzureSkuName

AzureSkuTier

CalloutPolicy

calloutType

Cluster

ClusterNetworkAccessFlag

createdByType

EngineType

ErrorAdditionalInfo

ErrorDetail

ErrorResponse

Identity

IdentityType

KeyVaultProperties

LanguageExtension

languageExtensionImageName

languageExtensionName

LanguageExtensionsList

MigrationClusterProperties

MigrationClusterRole

OptimizedAutoscale

outboundAccess

PrivateEndpointConnection

PrivateEndpointProperty

PrivateLinkServiceConnectionStateProperty

ProvisioningState

publicIPType

PublicNetworkAccess

State

systemData

TrustedExternalTenant

UserAssignedIdentities

VirtualNetworkConfiguration

VnetState

ZoneStatus