Clusters - Create Or Update

Servizio:: Azure Kusto

Versione API:: 2025-02-14

Creare o aggiornare un cluster Kusto.

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

Parametri dell'URI

Nome	In	Necessario	Tipo	Descrizione
clusterName	path	True	string pattern: ^.*$	Nome del cluster Kusto.
resourceGroupName	path	True	string minLength: 1 maxLength: 90	Nome del gruppo di risorse. Il nome è insensibile alle maiuscole e minuscole.
subscriptionId	path	True	string minLength: 1	ID della sottoscrizione di destinazione.
api-version	query	True	string minLength: 1	Versione dell'API da usare per questa operazione.

Intestazione della richiesta

Nome	Necessario	Tipo	Descrizione
If-Match		string	ETag del cluster. Omettere questo valore per sovrascrivere sempre il cluster corrente. Specificare l'ultimo valore ETag visualizzato per impedire la sovrascrittura accidentale delle modifiche simultanee.
If-None-Match		string	Impostare su "*" per consentire la creazione di un nuovo cluster, ma per impedire l'aggiornamento di un cluster esistente. Gli altri valori generano una risposta 412 Pre-condition Failed.

Corpo della richiesta

Nome	Necessario	Tipo	Descrizione
location	True	string	Posizione geografica in cui risiede la risorsa
sku	True	AzureSku	SKU del cluster.
identity		Identity	Identità del cluster, se configurata.
properties.acceptedAudiences		AcceptedAudiences[]	Destinatari accettati dal cluster.
properties.allowedFqdnList		string[]	Elenco di nomi di dominio completi consentiti (nome di dominio completo) per l'uscita dal cluster.
properties.allowedIpRangeList		string[]	Elenco di indirizzi IP nel formato CIDR consentito per la connessione al cluster.
properties.calloutPolicies		CalloutPolicy[]	Elenco dei criteri di callout per l'uscita dal cluster.
properties.enableAutoStop		boolean	Valore booleano che indica se il cluster potrebbe essere arrestato automaticamente (a causa della mancanza di dati o di nessuna attività per molti giorni).
properties.enableDiskEncryption		boolean	Valore booleano che indica se i dischi del cluster sono crittografati.
properties.enableDoubleEncryption		boolean	Valore booleano che indica se la crittografia doppia è abilitata.
properties.enablePurge		boolean	Valore booleano che indica se le operazioni di eliminazione sono abilitate.
properties.enableStreamingIngest		boolean	Valore booleano che indica se l'inserimento di streaming è abilitato.
properties.engineType		EngineType	Tipo di motore
properties.keyVaultProperties		KeyVaultProperties	Proprietà dell'insieme di credenziali delle chiavi per la crittografia del cluster.
properties.languageExtensions		LanguageExtensionsList	Elenco delle estensioni del linguaggio del cluster.
properties.optimizedAutoscale		OptimizedAutoscale	Definizione di scalabilità automatica ottimizzata.
properties.publicIPType		PublicIPType	Indica il tipo di IP pubblico da creare: IPv4 (impostazione predefinita) o DualStack (IPv4 e IPv6)
properties.publicNetworkAccess		PublicNetworkAccess	L'accesso alla rete pubblica al cluster è abilitato per impostazione predefinita. Se disabilitata, è consentita solo la connessione all'endpoint privato al cluster
properties.restrictOutboundNetworkAccess		ClusterNetworkAccessFlag	Indica se limitare o meno l'accesso alla rete in uscita. Il valore è facoltativo, ma se passato, deve essere 'Enabled' o 'Disabled'
properties.trustedExternalTenants		TrustedExternalTenant[]	Tenant esterni del cluster.
properties.virtualClusterGraduationProperties		string (password)	Proprietà di laurea del cluster virtuale
properties.virtualNetworkConfiguration		VirtualNetworkConfiguration	Definizione della rete virtuale.
tags		object	Tag di risorsa.
zones		string[]	Zone di disponibilità.

Risposte

Nome	Tipo	Descrizione
200 OK	Cluster	Operazione di aggiornamento della risorsa 'Cluster' riuscita
201 Created	Cluster	Operazione di creazione della risorsa 'Cluster' riuscita Intestazioni Location: string Retry-After: integer
Other Status Codes	ErrorResponse	Risposta di errore imprevista.

Nome

Tipo

Descrizione

200 OK

Cluster

Operazione di aggiornamento della risorsa 'Cluster' riuscita

201 Created

Cluster

Operazione di creazione della risorsa 'Cluster' riuscita

Intestazioni

Location: string
Retry-After: integer

Other Status Codes

ErrorResponse

Risposta di errore imprevista.

Sicurezza

azure_auth

Azure Active Directory OAuth2 Flow.

Tipo: oauth2
Flow: implicit
URL di autorizzazione: https://login.microsoftonline.com/common/oauth2/authorize

Ambiti

Nome	Descrizione
user_impersonation	rappresentare l'account utente

Esempio

KustoClusterCreateWithCMKFederatedIdentity

KustoClusterCreateWithCMKUserAssignedIdentity

KustoClustersCreateOrUpdate

KustoClusterCreateWithCMKFederatedIdentity

Esempio di richiesta

HTTP

PUT https://management.azure.com/subscriptions/12345678-1234-1234-1234-123456789098/resourceGroups/kustoRgTest/providers/Microsoft.Kusto/clusters/kustoClusterCMK?api-version=2025-02-14

{
  "location": "westus",
  "sku": {
    "name": "Standard_L16as_v3",
    "capacity": 2,
    "tier": "Standard"
  },
  "identity": {
    "type": "UserAssigned",
    "userAssignedIdentities": {
      "/subscriptions/12345678-1234-1234-1234-123456789098/resourceGroups/kustoRgTest/providers/Microsoft.ManagedIdentity/userAssignedIdentities/kustoClusterIdentity": {}
    }
  },
  "properties": {
    "enableStreamingIngest": true,
    "enablePurge": true,
    "enableDoubleEncryption": false,
    "enableAutoStop": true,
    "publicIPType": "IPv4",
    "publicNetworkAccess": "Enabled",
    "restrictOutboundNetworkAccess": "Disabled",
    "keyVaultProperties": {
      "keyVaultUri": "https://myvault.vault.azure.net",
      "keyName": "myClusterCMKKey",
      "keyVersion": "12345678-1234-1234-1234-123456789098",
      "userIdentity": "/subscriptions/12345678-1234-1234-1234-123456789098/resourceGroups/kustoRgTest/providers/Microsoft.ManagedIdentity/userAssignedIdentities/kustoClusterIdentity",
      "federatedIdentityClientId": "11111111-2222-3333-4444-555555555555"
    },
    "engineType": "V3"
  }
}

Risposta di esempio

Codice di stato:: 200

{
  "id": "/subscriptions/12345678-1234-1234-1234-123456789098/resourceGroups/kustoRgTest/providers/Microsoft.Kusto/Clusters/kustoClusterCMK",
  "name": "kustoClusterCMK",
  "type": "Microsoft.Kusto/Clusters",
  "location": "westus",
  "properties": {
    "provisioningState": "Succeeded",
    "enableDiskEncryption": false,
    "enableStreamingIngest": true,
    "enablePurge": true,
    "enableDoubleEncryption": false,
    "enableAutoStop": true,
    "publicIPType": "IPv4",
    "publicNetworkAccess": "Enabled",
    "restrictOutboundNetworkAccess": "Disabled",
    "keyVaultProperties": {
      "keyVaultUri": "https://myvault.vault.azure.net",
      "keyName": "myClusterCMKKey",
      "keyVersion": "12345678-1234-1234-1234-123456789098",
      "userIdentity": "/subscriptions/12345678-1234-1234-1234-123456789098/resourceGroups/kustoRgTest/providers/Microsoft.ManagedIdentity/userAssignedIdentities/kustoClusterIdentity",
      "federatedIdentityClientId": "11111111-2222-3333-4444-555555555555"
    },
    "engineType": "V3"
  },
  "sku": {
    "name": "Standard_L16as_v3",
    "tier": "Standard",
    "capacity": 2
  },
  "identity": {
    "type": "UserAssigned",
    "userAssignedIdentities": {
      "/subscriptions/12345678-1234-1234-1234-123456789098/resourceGroups/kustoRgTest/providers/Microsoft.ManagedIdentity/userAssignedIdentities/kustoClusterIdentity": {
        "clientId": "11111111-2222-3333-4444-555555555555",
        "principalId": "66666666-7777-8888-9999-000000000000"
      }
    }
  },
  "etag": "abcd1234"
}

Codice di stato:: 201

Azure-AsyncOperation: https://management.azure.com/subscriptions/12345678-1234-1234-1234-123456789098/providers/Microsoft.Kusto/locations/westus/operationResults/742bef43-608b-4b58-ba96-6f7a32ec5f0f?api-version=2025-02-14

{
  "id": "/subscriptions/12345678-1234-1234-1234-123456789098/resourceGroups/kustoRgTest/providers/Microsoft.Kusto/Clusters/kustoClusterCMK",
  "name": "kustoClusterCMK",
  "type": "Microsoft.Kusto/Clusters",
  "location": "westus",
  "properties": {
    "provisioningState": "Running",
    "enableDiskEncryption": false,
    "enableStreamingIngest": true,
    "enablePurge": true,
    "enableDoubleEncryption": false,
    "enableAutoStop": true,
    "publicIPType": "IPv4",
    "publicNetworkAccess": "Enabled",
    "restrictOutboundNetworkAccess": "Disabled",
    "keyVaultProperties": {
      "keyVaultUri": "https://myvault.vault.azure.net",
      "keyName": "myClusterCMKKey",
      "keyVersion": "12345678-1234-1234-1234-123456789098",
      "userIdentity": "/subscriptions/12345678-1234-1234-1234-123456789098/resourceGroups/kustoRgTest/providers/Microsoft.ManagedIdentity/userAssignedIdentities/kustoClusterIdentity",
      "federatedIdentityClientId": "11111111-2222-3333-4444-555555555555"
    },
    "engineType": "V3"
  },
  "sku": {
    "name": "Standard_L16as_v3",
    "tier": "Standard",
    "capacity": 2
  },
  "identity": {
    "type": "UserAssigned",
    "userAssignedIdentities": {
      "/subscriptions/12345678-1234-1234-1234-123456789098/resourceGroups/kustoRgTest/providers/Microsoft.ManagedIdentity/userAssignedIdentities/kustoClusterIdentity": {
        "clientId": "11111111-2222-3333-4444-555555555555",
        "principalId": "66666666-7777-8888-9999-000000000000"
      }
    }
  },
  "etag": "abcd1234"
}

KustoClusterCreateWithCMKUserAssignedIdentity

Esempio di richiesta

HTTP

PUT https://management.azure.com/subscriptions/12345678-1234-1234-1234-123456789098/resourceGroups/kustoRgTest/providers/Microsoft.Kusto/clusters/kustoClusterCMK?api-version=2025-02-14

{
  "location": "westus",
  "sku": {
    "name": "Standard_L16as_v3",
    "capacity": 2,
    "tier": "Standard"
  },
  "identity": {
    "type": "UserAssigned",
    "userAssignedIdentities": {
      "/subscriptions/12345678-1234-1234-1234-123456789098/resourceGroups/kustoRgTest/providers/Microsoft.ManagedIdentity/userAssignedIdentities/kustoClusterIdentity": {}
    }
  },
  "properties": {
    "enableStreamingIngest": true,
    "enablePurge": true,
    "enableDoubleEncryption": false,
    "enableAutoStop": true,
    "publicIPType": "IPv4",
    "publicNetworkAccess": "Enabled",
    "restrictOutboundNetworkAccess": "Disabled",
    "keyVaultProperties": {
      "keyVaultUri": "https://myvault.vault.azure.net",
      "keyName": "myClusterCMKKey",
      "keyVersion": "12345678-1234-1234-1234-123456789098",
      "userIdentity": "/subscriptions/12345678-1234-1234-1234-123456789098/resourceGroups/kustoRgTest/providers/Microsoft.ManagedIdentity/userAssignedIdentities/kustoClusterIdentity"
    },
    "engineType": "V3"
  }
}

Risposta di esempio

Codice di stato:: 200

{
  "id": "/subscriptions/12345678-1234-1234-1234-123456789098/resourceGroups/kustoRgTest/providers/Microsoft.Kusto/Clusters/kustoClusterCMK",
  "name": "kustoClusterCMK",
  "type": "Microsoft.Kusto/Clusters",
  "location": "westus",
  "properties": {
    "provisioningState": "Succeeded",
    "enableDiskEncryption": false,
    "enableStreamingIngest": true,
    "enablePurge": true,
    "enableDoubleEncryption": false,
    "enableAutoStop": true,
    "publicIPType": "IPv4",
    "publicNetworkAccess": "Enabled",
    "restrictOutboundNetworkAccess": "Disabled",
    "keyVaultProperties": {
      "keyVaultUri": "https://myvault.vault.azure.net",
      "keyName": "myClusterCMKKey",
      "keyVersion": "12345678-1234-1234-1234-123456789098",
      "userIdentity": "/subscriptions/12345678-1234-1234-1234-123456789098/resourceGroups/kustoRgTest/providers/Microsoft.ManagedIdentity/userAssignedIdentities/kustoClusterIdentity"
    },
    "engineType": "V3"
  },
  "sku": {
    "name": "Standard_L16as_v3",
    "tier": "Standard",
    "capacity": 2
  },
  "identity": {
    "type": "UserAssigned",
    "userAssignedIdentities": {
      "/subscriptions/12345678-1234-1234-1234-123456789098/resourceGroups/kustoRgTest/providers/Microsoft.ManagedIdentity/userAssignedIdentities/kustoClusterIdentity": {
        "clientId": "11111111-2222-3333-4444-555555555555",
        "principalId": "66666666-7777-8888-9999-000000000000"
      }
    }
  },
  "etag": "abcd1234"
}

Codice di stato:: 201

Azure-AsyncOperation: https://management.azure.com/subscriptions/12345678-1234-1234-1234-123456789098/providers/Microsoft.Kusto/locations/westus/operationResults/742bef43-608b-4b58-ba96-6f7a32ec5f0f?api-version=2025-02-14

{
  "id": "/subscriptions/12345678-1234-1234-1234-123456789098/resourceGroups/kustoRgTest/providers/Microsoft.Kusto/Clusters/kustoClusterCMK",
  "name": "kustoClusterCMK",
  "type": "Microsoft.Kusto/Clusters",
  "location": "westus",
  "properties": {
    "provisioningState": "Running",
    "enableDiskEncryption": false,
    "enableStreamingIngest": true,
    "enablePurge": true,
    "enableDoubleEncryption": false,
    "enableAutoStop": true,
    "publicIPType": "IPv4",
    "publicNetworkAccess": "Enabled",
    "restrictOutboundNetworkAccess": "Disabled",
    "keyVaultProperties": {
      "keyVaultUri": "https://myvault.vault.azure.net",
      "keyName": "myClusterCMKKey",
      "keyVersion": "12345678-1234-1234-1234-123456789098",
      "userIdentity": "/subscriptions/12345678-1234-1234-1234-123456789098/resourceGroups/kustoRgTest/providers/Microsoft.ManagedIdentity/userAssignedIdentities/kustoClusterIdentity"
    },
    "engineType": "V3"
  },
  "sku": {
    "name": "Standard_L16as_v3",
    "tier": "Standard",
    "capacity": 2
  },
  "identity": {
    "type": "UserAssigned",
    "userAssignedIdentities": {
      "/subscriptions/12345678-1234-1234-1234-123456789098/resourceGroups/kustoRgTest/providers/Microsoft.ManagedIdentity/userAssignedIdentities/kustoClusterIdentity": {
        "clientId": "11111111-2222-3333-4444-555555555555",
        "principalId": "66666666-7777-8888-9999-000000000000"
      }
    }
  },
  "etag": "abcd1234"
}

KustoClustersCreateOrUpdate

Esempio di richiesta

HTTP

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

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

Risposta di esempio

Codice di stato:: 200

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

Codice di stato:: 201

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

Definizioni

Nome	Descrizione
AcceptedAudiences	Rappresenta un pubblico accettato di cui il cluster si fida.
AzureSku	Azure SKU definition.
AzureSkuName	Nome SKU.
AzureSkuTier	Livello SKU.
CalloutPolicy	Configurazione per policy di callout esterne, inclusi pattern URI, tipi di accesso e tipi di servizio.
CalloutType	Tipo del servizio callout, specificando il tipo di risorsa esterna o servizio a cui si accede.
Cluster	La classe rappresenta un cluster Kusto.
ClusterNetworkAccessFlag	Indica se limitare o meno l'accesso alla rete in uscita. Il valore è facoltativo, ma se passato, deve essere 'Enabled' o 'Disabled'
ComponentsSgqdofSchemasIdentityPropertiesUserassignedidentitiesAdditionalproperties
createdByType	Tipo di identità che ha creato la risorsa.
EngineType	Tipo di motore
ErrorAdditionalInfo	Informazioni aggiuntive sull'errore di gestione delle risorse.
ErrorDetail	Dettagli dell'errore.
ErrorResponse	Risposta di errore
Identity	Identità per la risorsa.
IdentityType	Tipo di identità gestita usata. Il tipo 'SystemAssigned, UserAssigned' include sia un'identità creata in modo implicito che un set di identità assegnate dall'utente. Il tipo 'None' rimuoverà tutte le identità.
KeyVaultProperties	Proprietà dell'insieme di credenziali delle chiavi.
LanguageExtension	L'oggetto di estensione del linguaggio.
LanguageExtensionImageName	Nome immagine dell'estensione linguistica.
LanguageExtensionName	Estensione del linguaggio che può essere eseguita all'interno della query KQL.
LanguageExtensionsList	L'elenco degli oggetti di estensione linguistica.
MigrationClusterProperties	Rappresenta le proprietà di un cluster che fa parte di una migrazione.
MigrationClusterRole	Il ruolo del cluster nel processo di migrazione.
OptimizedAutoscale	Una classe che contiene la definizione ottimizzata di scala automatica.
OutboundAccess	Indica se l'accesso in uscita è consentito per il modello URI specificato.
PrivateEndpointConnection	Una connessione endpoint privato
PrivateEndpointProperty	Endpoint privato a cui appartiene la connessione.
PrivateLinkServiceConnectionStateProperty	Stato della connessione dell'endpoint privato.
ProvisioningState	Stato di provisioning della risorsa.
PublicIPType	Indica il tipo di IP pubblico da creare: IPv4 (impostazione predefinita) o DualStack (IPv4 e IPv6)
PublicNetworkAccess	L'accesso alla rete pubblica al cluster è abilitato per impostazione predefinita. Se disabilitata, è consentita solo la connessione all'endpoint privato al cluster
State	Lo stato della risorsa.
systemData	Metadati relativi alla creazione e all'ultima modifica della risorsa.
TrustedExternalTenant	Rappresenta un ID tenant affidabile dal cluster.
VirtualNetworkConfiguration	Una classe che contiene la definizione di rete virtuale.
VnetState	Se abilitato, il cluster viene distribuito nella subnet configurata, quando disabilitato verrà rimosso dalla subnet.
ZoneStatus	Indica se il cluster è zonale o non zonale.

AcceptedAudiences

Oggetto

Rappresenta un pubblico accettato di cui il cluster si fida.

Nome	Tipo	Descrizione
value	string	GUID o URL valido che rappresenta un gruppo di destinatari accettato.

AzureSku

Oggetto

Azure SKU definition.

Nome	Tipo	Descrizione
capacity	integer (int32)	Numero di istanze del cluster.
name	AzureSkuName	Nome SKU.
tier	AzureSkuTier	Livello SKU.

AzureSkuName

Enumerazione

Nome SKU.

Valore	Descrizione
Dev(No SLA)_Standard_D11_v2	Dev(Nessuno SLA)_Standard_D11_v2
Dev(No SLA)_Standard_E2a_v4	Dev (Nessuno SLA)_Standard_E2a_v4
Standard_D11_v2	Standard_D11_v2
Standard_D12_v2	Standard_D12_v2
Standard_D13_v2	Standard_D13_v2
Standard_D14_v2	Standard_D14_v2
Standard_D32d_v4	Standard_D32d_v4
Standard_D16d_v5	Standard_D16d_v5
Standard_D32d_v5	Standard_D32d_v5
Standard_DS13_v2+1TB_PS	Standard_DS13_v2+1TB_PS
Standard_DS13_v2+2TB_PS	Standard_DS13_v2+2TB_PS
Standard_DS14_v2+3TB_PS	Standard_DS14_v2+3TB_PS
Standard_DS14_v2+4TB_PS	Standard_DS14_v2+4TB_PS
Standard_L4s	Standard_L4s
Standard_L8s	Standard_L8s
Standard_L16s	Standard_L16s
Standard_L8s_v2	Standard_L8s_v2
Standard_L16s_v2	Standard_L16s_v2
Standard_L8s_v3	Standard_L8s_v3
Standard_L16s_v3	Standard_L16s_v3
Standard_L32s_v3	Standard_L32s_v3
Standard_L8as_v3	Standard_L8as_v3
Standard_L16as_v3	Standard_L16as_v3
Standard_L32as_v3	Standard_L32as_v3
Standard_E64i_v3	Standard_E64i_v3
Standard_E80ids_v4	Standard_E80ids_v4
Standard_E2a_v4	Standard_E2a_v4
Standard_E4a_v4	Standard_E4a_v4
Standard_E8a_v4	Standard_E8a_v4
Standard_E16a_v4	Standard_E16a_v4
Standard_E8as_v4+1TB_PS	Standard_E8as_v4+1TB_PS
Standard_E8as_v4+2TB_PS	Standard_E8as_v4+2TB_PS
Standard_E16as_v4+3TB_PS	Standard_E16as_v4+3TB_PS
Standard_E16as_v4+4TB_PS	Standard_E16as_v4+4TB_PS
Standard_E8as_v5+1TB_PS	Standard_E8as_v5+1TB_PS
Standard_E8as_v5+2TB_PS	Standard_E8as_v5+2TB_PS
Standard_E16as_v5+3TB_PS	Standard_E16as_v5+3TB_PS
Standard_E16as_v5+4TB_PS	Standard_E16as_v5+4TB_PS
Standard_E2ads_v5	Standard_E2ads_v5
Standard_E4ads_v5	Standard_E4ads_v5
Standard_E8ads_v5	Standard_E8ads_v5
Standard_E16ads_v5	Standard_E16ads_v5
Standard_EC8as_v5+1TB_PS	Standard_EC8as_v5+1TB_PS
Standard_EC8as_v5+2TB_PS	Standard_EC8as_v5+2TB_PS
Standard_EC16as_v5+3TB_PS	Standard_EC16as_v5+3TB_PS
Standard_EC16as_v5+4TB_PS	Standard_EC16as_v5+4TB_PS
Standard_EC8ads_v5	Standard_EC8ads_v5
Standard_EC16ads_v5	Standard_EC16ads_v5
Standard_E8s_v4+1TB_PS	Standard_E8s_v4+1TB_PS
Standard_E8s_v4+2TB_PS	Standard_E8s_v4+2TB_PS
Standard_E16s_v4+3TB_PS	Standard_E16s_v4+3TB_PS
Standard_E16s_v4+4TB_PS	Standard_E16s_v4+4TB_PS
Standard_E8s_v5+1TB_PS	Standard_E8s_v5+1TB_PS
Standard_E8s_v5+2TB_PS	Standard_E8s_v5+2TB_PS
Standard_E16s_v5+3TB_PS	Standard_E16s_v5+3TB_PS
Standard_E16s_v5+4TB_PS	Standard_E16s_v5+4TB_PS
Standard_E2d_v4	Standard_E2d_v4
Standard_E4d_v4	Standard_E4d_v4
Standard_E8d_v4	Standard_E8d_v4
Standard_E16d_v4	Standard_E16d_v4
Standard_E2d_v5	Standard_E2d_v5
Standard_E4d_v5	Standard_E4d_v5
Standard_E8d_v5	Standard_E8d_v5
Standard_E16d_v5	Standard_E16d_v5

AzureSkuTier

Enumerazione

Livello SKU.

Valore	Descrizione
Basic	Basic
Standard	Standard

CalloutPolicy

Oggetto

Configurazione per policy di callout esterne, inclusi pattern URI, tipi di accesso e tipi di servizio.

Nome	Tipo	Descrizione
calloutId	string	Identificatore univoco per la configurazione del callout.
calloutType	CalloutType	Tipo del servizio callout, specificando il tipo di risorsa esterna o servizio a cui si accede.
calloutUriRegex	string	Espressione regolare o modello FQDN per l'URI del callout.
outboundAccess	OutboundAccess	Indica se l'accesso in uscita è consentito per il modello URI specificato.

CalloutType

Enumerazione

Tipo del servizio callout, specificando il tipo di risorsa esterna o servizio a cui si accede.

Valore	Descrizione
kusto	Kusto
sql	sql
cosmosdb	cosmosdb
external_data	external_data
azure_digital_twins	azure_digital_twins
sandbox_artifacts	sandbox_artifacts
webapi	webapi
mysql	mysql
postgresql	postgresql
genevametrics	Genevametrics
azure_openai	azure_openai

Cluster

Oggetto

La classe rappresenta un cluster Kusto.

Nome	Tipo	Valore predefinito	Descrizione
etag	string		"Se l'etag viene fornito nel corpo della risposta, può anche essere fornito come intestazione secondo la normale convenzione dell'etag. I tag di entità vengono usati per confrontare due o più entità dalla stessa risorsa richiesta. HTTP/1.1 utilizza i tag di entità nei campi di intestazione etag (sezione 14.19), If-Match (sezione 14.24), If-None-Match (sezione 14.26) e If-Range (sezione 14.27).")
id	string		ID risorsa completo per la risorsa. Ad esempio: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}
identity	Identity		Identità del cluster, se configurata.
location	string		Posizione geografica in cui risiede la risorsa
name	string		Nome della risorsa
properties.acceptedAudiences	AcceptedAudiences[]		Destinatari accettati dal cluster.
properties.allowedFqdnList	string[]		Elenco di nomi di dominio completi consentiti (nome di dominio completo) per l'uscita dal cluster.
properties.allowedIpRangeList	string[]		Elenco di indirizzi IP nel formato CIDR consentito per la connessione al cluster.
properties.calloutPolicies	CalloutPolicy[]		Elenco dei criteri di callout per l'uscita dal cluster.
properties.dataIngestionUri	string		L'URI di ingestione dati del cluster.
properties.enableAutoStop	boolean	True	Valore booleano che indica se il cluster potrebbe essere arrestato automaticamente (a causa della mancanza di dati o di nessuna attività per molti giorni).
properties.enableDiskEncryption	boolean	False	Valore booleano che indica se i dischi del cluster sono crittografati.
properties.enableDoubleEncryption	boolean	False	Valore booleano che indica se la crittografia doppia è abilitata.
properties.enablePurge	boolean	False	Valore booleano che indica se le operazioni di eliminazione sono abilitate.
properties.enableStreamingIngest	boolean	False	Valore booleano che indica se l'inserimento di streaming è abilitato.
properties.engineType	EngineType	V3	Tipo di motore
properties.keyVaultProperties	KeyVaultProperties		Proprietà dell'insieme di credenziali delle chiavi per la crittografia del cluster.
properties.languageExtensions	LanguageExtensionsList		Elenco delle estensioni del linguaggio del cluster.
properties.migrationCluster	MigrationClusterProperties		Proprietà del gruppo peer coinvolto in una migrazione da/verso questo cluster.
properties.optimizedAutoscale	OptimizedAutoscale		Definizione di scalabilità automatica ottimizzata.
properties.privateEndpointConnections	PrivateEndpointConnection[]		Elenco di connessioni endpoint private.
properties.provisioningState	ProvisioningState		Stato di provisioning della risorsa.
properties.publicIPType	PublicIPType	IPv4	Indica il tipo di IP pubblico da creare: IPv4 (impostazione predefinita) o DualStack (IPv4 e IPv6)
properties.publicNetworkAccess	PublicNetworkAccess	Enabled	L'accesso alla rete pubblica al cluster è abilitato per impostazione predefinita. Se disabilitata, è consentita solo la connessione all'endpoint privato al cluster
properties.restrictOutboundNetworkAccess	ClusterNetworkAccessFlag	Disabled	Indica se limitare o meno l'accesso alla rete in uscita. Il valore è facoltativo, ma se passato, deve essere 'Enabled' o 'Disabled'
properties.state	State		Lo stato della risorsa.
properties.stateReason	string		La ragione dello stato attuale dell'ammasso.
properties.trustedExternalTenants	TrustedExternalTenant[]		Tenant esterni del cluster.
properties.uri	string		L'URI del cluster.
properties.virtualClusterGraduationProperties	string (password)		Proprietà di laurea del cluster virtuale
properties.virtualNetworkConfiguration	VirtualNetworkConfiguration		Definizione della rete virtuale.
properties.zoneStatus	ZoneStatus		Indica se il cluster è zonale o non zonale.
sku	AzureSku		SKU del cluster.
systemData	systemData		Metadati di Azure Resource Manager contenenti le informazioni createdBy e modifiedBy.
tags	object		Tag di risorsa.
type	string		Tipo di risorsa. Ad esempio, "Microsoft.Compute/virtualMachines" o "Microsoft.Storage/storageAccounts"
zones	string[]		Zone di disponibilità.

ClusterNetworkAccessFlag

Enumerazione

Indica se limitare o meno l'accesso alla rete in uscita. Il valore è facoltativo, ma se passato, deve essere 'Enabled' o 'Disabled'

Valore	Descrizione
Enabled	Enabled
Disabled	Disattivato

ComponentsSgqdofSchemasIdentityPropertiesUserassignedidentitiesAdditionalproperties

Oggetto

Nome	Tipo	Descrizione
clientId	string	ID client dell'identità assegnata dall'utente.
principalId	string	ID principale dell'identità assegnata dall'utente.

createdByType

Enumerazione

Tipo di identità che ha creato la risorsa.

Valore	Descrizione
User
Application
ManagedIdentity
Key

EngineType

Enumerazione

Tipo di motore

Valore	Descrizione
V2	V2
V3	V3

ErrorAdditionalInfo

Oggetto

Informazioni aggiuntive sull'errore di gestione delle risorse.

Nome	Tipo	Descrizione
info	object	Informazioni aggiuntive.
type	string	Tipo di informazioni aggiuntive.

ErrorDetail

Oggetto

Dettagli dell'errore.

Nome	Tipo	Descrizione
additionalInfo	ErrorAdditionalInfo[]	Informazioni aggiuntive sull'errore.
code	string	Codice di errore.
details	ErrorDetail[]	Dettagli dell'errore.
message	string	Messaggio di errore.
target	string	Destinazione dell'errore.

ErrorResponse

Oggetto

Risposta di errore

Nome	Tipo	Descrizione
error	ErrorDetail	Oggetto error.

Identity

Oggetto

Identità per la risorsa.

Nome	Tipo	Descrizione
principalId	string	ID principale dell'identità della risorsa.
tenantId	string	ID tenant della risorsa.
type	IdentityType	Tipo di identità gestita usata. Il tipo 'SystemAssigned, UserAssigned' include sia un'identità creata in modo implicito che un set di identità assegnate dall'utente. Il tipo 'None' rimuoverà tutte le identità.
userAssignedIdentities	<string, ComponentsSgqdofSchemasIdentityPropertiesUserassignedidentitiesAdditionalproperties>	Elenco delle identità utente associate al cluster Kusto. I riferimenti alla chiave del dizionario delle identità utente saranno id risorsa ARM nel formato :'/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}'.

IdentityType

Enumerazione

Tipo di identità gestita usata. Il tipo 'SystemAssigned, UserAssigned' include sia un'identità creata in modo implicito che un set di identità assegnate dall'utente. Il tipo 'None' rimuoverà tutte le identità.

Valore	Descrizione
None	Nessuno
SystemAssigned	Assegnato dal sistema
UserAssigned	UserAssigned
SystemAssigned, UserAssigned	SystemAssigned, UserAssigned

KeyVaultProperties

Oggetto

Proprietà dell'insieme di credenziali delle chiavi.

Nome	Tipo	Descrizione
federatedIdentityClientId	string	L'ID dell'applicazione (client) dell'applicazione multi-tenant Microsoft Entra. Utilizzato per scenari di chiave gestite dal cliente cross-tenant in cui la chiave di crittografia è memorizzata in un tenant diverso rispetto al cluster. L'applicazione deve essere configurata con l'identità gestita assegnata dall'utente come credenziale di identità federata.
keyName	string	Nome della chiave dell'insieme di credenziali delle chiavi.
keyVaultUri	string	URI dell'insieme di credenziali delle chiavi.
keyVersion	string	Versione della chiave dell'insieme di credenziali delle chiavi.
userIdentity	string	Identità assegnata dall'utente (ID risorsa ARM) che ha accesso alla chiave. L'identità deve avere i permessi 'Get', 'Wrap Key' e 'Unwrap Key' sulla chiave di Key Vault, oppure deve essere assegnata al ruolo 'Key Vault Crypto Service Encryption User'.

LanguageExtension

Oggetto

L'oggetto di estensione del linguaggio.

Nome	Tipo	Descrizione
languageExtensionCustomImageName	string	Il nome dell'immagine personalizzata del sandbox dovrebbe essere abilitato come estensione linguistica attiva. L'immagine personalizzata sandbox è una risorsa di cluster sub. Quando questa proprietà è impostata, LanguageExtensionImageName dovrebbe essere impostato su 'PythonCustomImage'.
languageExtensionImageName	LanguageExtensionImageName	Nome dell'immagine dell'estensione del linguaggio.
languageExtensionName	LanguageExtensionName	Nome dell'estensione del linguaggio.

LanguageExtensionImageName

Enumerazione

Nome immagine dell'estensione linguistica.

Valore	Descrizione
R	R
Python3_6_5	Python3_6_5
Python3_10_8	Python3_10_8
Python3_10_8_DL	Python3_10_8_DL
PythonCustomImage	PythonCustomImage
Python3_11_7	Python3_11_7
Python3_11_7_DL	Python3_11_7_DL

LanguageExtensionName

Enumerazione

Estensione del linguaggio che può essere eseguita all'interno della query KQL.

Valore	Descrizione
PYTHON	PITONE
R	R

LanguageExtensionsList

Oggetto

L'elenco degli oggetti di estensione linguistica.

Nome	Tipo	Descrizione
nextLink	string	Il link alla pagina successiva di risorse.
value	LanguageExtension[]	Elenco di estensioni del linguaggio.

MigrationClusterProperties

Oggetto

Rappresenta le proprietà di un cluster che fa parte di una migrazione.

Nome	Tipo	Descrizione
dataIngestionUri	string	L'URL di ingestione dei dati pubblici del cluster.
id	string	L'ID della risorsa del cluster.
role	MigrationClusterRole	Il ruolo del cluster nel processo di migrazione.
uri	string	L'URL pubblico del cluster.

MigrationClusterRole

Enumerazione

Il ruolo del cluster nel processo di migrazione.

Valore	Descrizione
Source	origine
Destination	Destinazione

OptimizedAutoscale

Oggetto

Una classe che contiene la definizione ottimizzata di scala automatica.

Nome	Tipo	Descrizione
isEnabled	boolean	Valore booleano che indica se la funzionalità di scalabilità automatica ottimizzata è abilitata o meno.
maximum	integer (int32)	Numero massimo di istanze consentite.
minimum	integer (int32)	Numero minimo di istanze consentite.
version	integer (int32)	Versione del modello definita, ad esempio 1.

OutboundAccess

Enumerazione

Indica se l'accesso in uscita è consentito per il modello URI specificato.

Valore	Descrizione
Allow	Permetti
Deny	Deny

PrivateEndpointConnection

Oggetto

Una connessione endpoint privato

Nome	Tipo	Descrizione
id	string	ID risorsa completo per la risorsa. Ad esempio: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}
name	string	Nome della risorsa
properties.groupId	string	ID gruppo dell'endpoint privato.
properties.privateEndpoint	PrivateEndpointProperty	Endpoint privato a cui appartiene la connessione.
properties.privateLinkServiceConnectionState	PrivateLinkServiceConnectionStateProperty	Stato della connessione dell'endpoint privato.
properties.provisioningState	string	Stato di provisioning dell'endpoint privato.
systemData	systemData	Metadati di Azure Resource Manager contenenti le informazioni createdBy e modifiedBy.
type	string	Tipo di risorsa. Ad esempio, "Microsoft.Compute/virtualMachines" o "Microsoft.Storage/storageAccounts"

PrivateEndpointProperty

Oggetto

Endpoint privato a cui appartiene la connessione.

Nome	Tipo	Descrizione
id	string	ID risorsa dell'endpoint privato.

PrivateLinkServiceConnectionStateProperty

Oggetto

Stato della connessione dell'endpoint privato.

Nome	Tipo	Descrizione
actionsRequired	string	Qualsiasi azione necessaria oltre il flusso di lavoro di base (approvazione/rifiuto/disconnessione)
description	string	Descrizione della connessione al servizio di collegamento privato.
status	string	Stato della connessione al servizio collegamento privato.

ProvisioningState

Enumerazione

Stato di provisioning della risorsa.

Valore	Descrizione
Running	In esecuzione
Creating	Creazione
Deleting	Deleting
Succeeded	Succeeded
Failed	Non riuscito
Moving	Spostarsi
Canceled	Operazione annullata

PublicIPType

Enumerazione

Indica il tipo di IP pubblico da creare: IPv4 (impostazione predefinita) o DualStack (IPv4 e IPv6)

Valore	Descrizione
IPv4	IPv4
DualStack	DualStack

PublicNetworkAccess

Enumerazione

L'accesso alla rete pubblica al cluster è abilitato per impostazione predefinita. Se disabilitata, è consentita solo la connessione all'endpoint privato al cluster

Valore	Descrizione
Enabled	Enabled
Disabled	Disattivato
SecuredByPerimeter	Assicurato da Perimeter

State

Enumerazione

Lo stato della risorsa.

Valore	Descrizione
Creating	Creazione
Unavailable	Indisponibile
Running	In esecuzione
Deleting	Deleting
Deleted	Eliminato
Stopping	Arresto in corso
Stopped	Fermato
Starting	Inizio
Updating	Aggiornamento
Migrated	Migrati

systemData

Oggetto

Metadati relativi alla creazione e all'ultima modifica della risorsa.

Nome	Tipo	Descrizione
createdAt	string (date-time)	Timestamp della creazione della risorsa (UTC).
createdBy	string	Identità che ha creato la risorsa.
createdByType	createdByType	Tipo di identità che ha creato la risorsa.
lastModifiedAt	string (date-time)	Timestamp dell'ultima modifica della risorsa (UTC)
lastModifiedBy	string	Identità che ha modificato l'ultima volta la risorsa.
lastModifiedByType	createdByType	Tipo di identità che ha modificato l'ultima volta la risorsa.

TrustedExternalTenant

Oggetto

Rappresenta un ID tenant affidabile dal cluster.

Nome	Tipo	Descrizione
value	string	GUID che rappresenta un tenant esterno.

VirtualNetworkConfiguration

Oggetto

Una classe che contiene la definizione di rete virtuale.

Nome	Tipo	Valore predefinito	Descrizione
dataManagementPublicIpId	string		ID risorsa indirizzo IP pubblico del servizio di gestione dei dati.
enginePublicIpId	string		ID risorsa indirizzo IP pubblico del servizio motore.
state	VnetState	Enabled	Se abilitato, il cluster viene distribuito nella subnet configurata, quando disabilitato verrà rimosso dalla subnet.
subnetId	string		ID risorsa subnet.

VnetState

Enumerazione

Se abilitato, il cluster viene distribuito nella subnet configurata, quando disabilitato verrà rimosso dalla subnet.

Valore	Descrizione
Enabled	Enabled
Disabled	Disattivato

ZoneStatus

Enumerazione

Indica se il cluster è zonale o non zonale.

Valore	Descrizione
NonZonal	NonZonal
ZonalInconsistency	Incoerenza Zonale
Zonal	A livello di zona

Condividi tramite

Clusters - Create Or Update

Parametri dell'URI

Intestazione della richiesta

Corpo della richiesta

Risposte

Sicurezza

azure_auth

Ambiti

Esempio

KustoClusterCreateWithCMKFederatedIdentity

Esempio di richiesta

Risposta di esempio

KustoClusterCreateWithCMKUserAssignedIdentity

Esempio di richiesta

Risposta di esempio

KustoClustersCreateOrUpdate

Esempio di richiesta

Risposta di esempio

Definizioni

AcceptedAudiences

AzureSku

AzureSkuName

AzureSkuTier

CalloutPolicy

CalloutType

Cluster

ClusterNetworkAccessFlag

ComponentsSgqdofSchemasIdentityPropertiesUserassignedidentitiesAdditionalproperties

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

VirtualNetworkConfiguration

VnetState

ZoneStatus