Clusters - Create Or Update

Dienst:: Azure Kusto

API-Version:: 2025-02-14

Erstellen oder Aktualisieren eines Kusto-Clusters.

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

URI-Parameter

Name	In	Erforderlich	Typ	Beschreibung
clusterName	path	True	string pattern: ^.*$	Der Name des Kusto-Clusters.
resourceGroupName	path	True	string minLength: 1 maxLength: 90	Der Name der Ressourcengruppe. Für den Namen wird die Groß-/Kleinschreibung nicht beachtet.
subscriptionId	path	True	string minLength: 1	Hierbei handelt es sich um die ID des Zielabonnements.
api-version	query	True	string minLength: 1	Die API-Version, die für diesen Vorgang verwendet werden soll.

Anforderungsheader

Name	Erforderlich	Typ	Beschreibung
If-Match		string	Das ETag des Clusters. Lassen Sie diesen Wert aus, um den aktuellen Cluster immer zu überschreiben. Geben Sie den zuletzt gesehenen ETag-Wert an, um zu verhindern, dass gleichzeitige Änderungen versehentlich überschrieben werden.
If-None-Match		string	Legen Sie auf '*' fest, damit ein neuer Cluster erstellt werden kann, aber um zu verhindern, dass ein vorhandener Cluster aktualisiert wird. Andere Werte führen zu einer Fehlerantwort von 412 Vorbedingung.

Anforderungstext

Name	Erforderlich	Typ	Beschreibung
location	True	string	Der geografische Standort, an dem sich die Ressource befindet
sku	True	AzureSku	Die SKU des Clusters.
identity		Identity	Die Identität des Clusters, falls konfiguriert.
properties.acceptedAudiences		AcceptedAudiences[]	Die akzeptierten Zielgruppen des Clusters.
properties.allowedFqdnList		string[]	Liste der zulässigen FQDNs(Vollqualifizierter Domänenname) für den Ausgang von Cluster.
properties.allowedIpRangeList		string[]	Die Liste der IP-Adressen im Format von CIDR, die eine Verbindung mit dem Cluster herstellen dürfen.
properties.calloutPolicies		CalloutPolicy[]	Liste der Legendenrichtlinien für den Ausgang von Cluster.
properties.enableAutoStop		boolean	Ein boolescher Wert, der angibt, ob der Cluster automatisch beendet werden kann (aufgrund fehlender Daten oder einer Aktivität für viele Tage).
properties.enableDiskEncryption		boolean	Ein boolescher Wert, der angibt, ob die Datenträger des Clusters verschlüsselt sind.
properties.enableDoubleEncryption		boolean	Ein boolescher Wert, der angibt, ob die doppelte Verschlüsselung aktiviert ist.
properties.enablePurge		boolean	Ein boolescher Wert, der angibt, ob die Bereinigungsvorgänge aktiviert sind.
properties.enableStreamingIngest		boolean	Ein boolescher Wert, der angibt, ob das Streaminggest aktiviert ist.
properties.engineType		EngineType	Der Modultyp
properties.keyVaultProperties		KeyVaultProperties	KeyVault-Eigenschaften für die Clusterverschlüsselung.
properties.languageExtensions		LanguageExtensionsList	Liste der Spracherweiterungen des Clusters.
properties.optimizedAutoscale		OptimizedAutoscale	Optimierte Definition der automatischen Skalierung.
properties.publicIPType		PublicIPType	Gibt an, welcher öffentliche IP-Typ erstellt werden soll – IPv4 (Standard) oder DualStack (sowohl IPv4 als auch IPv6)
properties.publicNetworkAccess		PublicNetworkAccess	Der Zugriff auf das öffentliche Netzwerk auf den Cluster ist standardmäßig aktiviert. Wenn diese Option deaktiviert ist, ist nur eine private Endpunktverbindung mit dem Cluster zulässig.
properties.restrictOutboundNetworkAccess		ClusterNetworkAccessFlag	Gibt an, ob der ausgehende Netzwerkzugriff eingeschränkt werden soll. Der Wert ist optional, aber wenn er übergeben wird, muss 'Enabled' oder 'Disabled' sein.
properties.trustedExternalTenants		TrustedExternalTenant[]	Die externen Mandanten des Clusters.
properties.virtualClusterGraduationProperties		string (password)	Virtuelle Cluster Graduierungseigenschaften
properties.virtualNetworkConfiguration		VirtualNetworkConfiguration	Definition des virtuellen Netzwerks.
tags		object	Ressourcentags.
zones		string[]	Die Verfügbarkeitszonen.

Antworten

Name	Typ	Beschreibung
200 OK	Cluster	Der Aktualisierungsvorgang für die Ressource "Cluster" war erfolgreich
201 Created	Cluster	Der Erstellungsvorgang für die Ressource "Cluster" war erfolgreich Header Location: string Retry-After: integer
Other Status Codes	ErrorResponse	Unerwartete Fehlerantwort.

Name

Typ

Beschreibung

200 OK

Cluster

Der Aktualisierungsvorgang für die Ressource "Cluster" war erfolgreich

201 Created

Cluster

Der Erstellungsvorgang für die Ressource "Cluster" war erfolgreich

Header

Location: string
Retry-After: integer

Other Status Codes

ErrorResponse

Unerwartete Fehlerantwort.

Sicherheit

azure_auth

Azure Active Directory OAuth2 Flow.

Typ: oauth2
Ablauf: implicit
Autorisierungs-URL: https://login.microsoftonline.com/common/oauth2/authorize

Bereiche

Name	Beschreibung
user_impersonation	Identitätswechsel ihres Benutzerkontos

Beispiele

KustoClusterCreateWithCMKFederatedIdentity

KustoClusterCreateWithCMKUserAssignedIdentity

KustoClustersCreateOrUpdate

KustoClusterCreateWithCMKFederatedIdentity

Beispielanforderung

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

Beispiel für eine Antwort

Statuscode:: 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"
}

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

Beispielanforderung

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

Beispiel für eine Antwort

Statuscode:: 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"
}

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

Beispielanforderung

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

Beispiel für eine Antwort

Statuscode:: 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"
  }
}

Statuscode:: 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"
  }
}

Definitionen

Name	Beschreibung
AcceptedAudiences	Repräsentiert ein akzeptiertes Publikum, dem der Cluster vertraut.
AzureSku	Azure SKU definition.
AzureSkuName	SKU-Name.
AzureSkuTier	SKU-Ebene.
CalloutPolicy	Konfiguration für externe Callout-Richtlinien, einschließlich URI-Muster, Zugriffstypen und Servicetypen.
CalloutType	Typ des Popupdiensts, der die Art der externen Ressource oder des Diensts angibt, auf die zugegriffen wird.
Cluster	Klasse, die einen Kusto-Cluster repräsentiert.
ClusterNetworkAccessFlag	Gibt an, ob der ausgehende Netzwerkzugriff eingeschränkt werden soll. Der Wert ist optional, aber wenn er übergeben wird, muss 'Enabled' oder 'Disabled' sein.
ComponentsSgqdofSchemasIdentityPropertiesUserassignedidentitiesAdditionalproperties
createdByType	Der Identitätstyp, der die Ressource erstellt hat.
EngineType	Der Modultyp
ErrorAdditionalInfo	Der Ressourcenverwaltungsfehler zusätzliche Informationen.
ErrorDetail	Das Fehlerdetails.
ErrorResponse	Fehlerantwort
Identity	Identität für die Ressource.
IdentityType	Der Typ der verwendeten verwalteten Identität. Der Typ "SystemAssigned, UserAssigned" enthält sowohl eine implizit erstellte Identität als auch eine Reihe von vom Benutzer zugewiesenen Identitäten. Der Typ "None" entfernt alle Identitäten.
KeyVaultProperties	Eigenschaften des Schlüsseltresors.
LanguageExtension	Das Spracherweiterungsobjekt.
LanguageExtensionImageName	Name des Spracherweiterungsbildes.
LanguageExtensionName	Spracherweiterung, die innerhalb der KQL-Abfrage ausgeführt werden kann.
LanguageExtensionsList	Die Liste der Spracherweiterungsobjekte.
MigrationClusterProperties	Repräsentiert Eigenschaften eines Clusters, der Teil einer Migration ist.
MigrationClusterRole	Die Rolle des Clusters im Migrationsprozess.
OptimizedAutoscale	Eine Klasse, die die optimierte Auto-Skalierungsdefinition enthält.
OutboundAccess	Gibt an, ob ausgehender Zugriff für das angegebene URI-Muster zulässig ist.
PrivateEndpointConnection	Eine private Endpunktverbindung
PrivateEndpointProperty	Privater Endpunkt, zu dem die Verbindung gehört.
PrivateLinkServiceConnectionStateProperty	Verbindungsstatus der privaten Endpunktverbindung.
ProvisioningState	Der bereitgestellte Zustand der Ressource.
PublicIPType	Gibt an, welcher öffentliche IP-Typ erstellt werden soll – IPv4 (Standard) oder DualStack (sowohl IPv4 als auch IPv6)
PublicNetworkAccess	Der Zugriff auf das öffentliche Netzwerk auf den Cluster ist standardmäßig aktiviert. Wenn diese Option deaktiviert ist, ist nur eine private Endpunktverbindung mit dem Cluster zulässig.
State	Der Zustand der Ressource.
systemData	Metadaten zur Erstellung und letzten Änderung der Ressource.
TrustedExternalTenant	Repräsentiert eine Tenant-ID, der vom Cluster vertraut wird.
VirtualNetworkConfiguration	Eine Klasse, die eine virtuelle Netzwerkdefinition enthält.
VnetState	Wenn diese Option aktiviert ist, wird der Cluster im konfigurierten Subnetz bereitgestellt, wenn er deaktiviert wird, aus dem Subnetz entfernt.
ZoneStatus	Gibt an, ob der Cluster zonal oder nicht-zonal ist.

AcceptedAudiences

Objekt

Repräsentiert ein akzeptiertes Publikum, dem der Cluster vertraut.

Name	Typ	Beschreibung
value	string	GUID oder gültige URL, die eine akzeptierte Zielgruppe darstellt.

AzureSku

Objekt

Azure SKU definition.

Name	Typ	Beschreibung
capacity	integer (int32)	Die Anzahl der Instanzen des Clusters.
name	AzureSkuName	SKU-Name.
tier	AzureSkuTier	SKU-Ebene.

AzureSkuName

Enumeration

SKU-Name.

Wert	Beschreibung
Dev(No SLA)_Standard_D11_v2	Dev (kein SLA)_Standard_D11_v2
Dev(No SLA)_Standard_E2a_v4	Entwicklung (Kein 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

Enumeration

SKU-Ebene.

Wert	Beschreibung
Basic	Grundlegend
Standard	Standard

CalloutPolicy

Objekt

Konfiguration für externe Callout-Richtlinien, einschließlich URI-Muster, Zugriffstypen und Servicetypen.

Name	Typ	Beschreibung
calloutId	string	Eindeutiger Bezeichner für die Beschriftungskonfiguration.
calloutType	CalloutType	Typ des Popupdiensts, der die Art der externen Ressource oder des Diensts angibt, auf die zugegriffen wird.
calloutUriRegex	string	Regulärer Ausdruck oder FQDN-Muster für den Popup-URI.
outboundAccess	OutboundAccess	Gibt an, ob ausgehender Zugriff für das angegebene URI-Muster zulässig ist.

CalloutType

Enumeration

Typ des Popupdiensts, der die Art der externen Ressource oder des Diensts angibt, auf die zugegriffen wird.

Wert	Beschreibung
kusto	Kusto
sql	SQL
cosmosdb	Cosmosdb
external_data	external_data
azure_digital_twins	azure_digital_twins
sandbox_artifacts	sandbox_artifacts
webapi	Webapi (Webapi)
mysql	mysql
postgresql	postgresql
genevametrics	Genvametrie
azure_openai	azure_openai

Cluster

Objekt

Klasse, die einen Kusto-Cluster repräsentiert.

Name	Typ	Standardwert	Beschreibung
etag	string		"Wenn etag im Antworttext bereitgestellt wird, kann es auch als Header gemäß der normalen etag-Konvention bereitgestellt werden. Entitätstags werden zum Vergleichen von zwei oder mehr Entitäten aus derselben angeforderten Ressource verwendet. HTTP/1.1 verwendet Entity-Tags in den Header-Feldern etag (Abschnitt 14.19), If-Match (Abschnitt 14.24), If-None-Match (Abschnitt 14.26) und If-Range (Abschnitt 14.27).")
id	string		Vollqualifizierte Ressourcen-ID für die Ressource. Zum Beispiel - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}
identity	Identity		Die Identität des Clusters, falls konfiguriert.
location	string		Der geografische Standort, an dem sich die Ressource befindet
name	string		Der Name der Ressource
properties.acceptedAudiences	AcceptedAudiences[]		Die akzeptierten Zielgruppen des Clusters.
properties.allowedFqdnList	string[]		Liste der zulässigen FQDNs(Vollqualifizierter Domänenname) für den Ausgang von Cluster.
properties.allowedIpRangeList	string[]		Die Liste der IP-Adressen im Format von CIDR, die eine Verbindung mit dem Cluster herstellen dürfen.
properties.calloutPolicies	CalloutPolicy[]		Liste der Legendenrichtlinien für den Ausgang von Cluster.
properties.dataIngestionUri	string		Die Cluster-Datenaufnahme-URI.
properties.enableAutoStop	boolean	True	Ein boolescher Wert, der angibt, ob der Cluster automatisch beendet werden kann (aufgrund fehlender Daten oder einer Aktivität für viele Tage).
properties.enableDiskEncryption	boolean	False	Ein boolescher Wert, der angibt, ob die Datenträger des Clusters verschlüsselt sind.
properties.enableDoubleEncryption	boolean	False	Ein boolescher Wert, der angibt, ob die doppelte Verschlüsselung aktiviert ist.
properties.enablePurge	boolean	False	Ein boolescher Wert, der angibt, ob die Bereinigungsvorgänge aktiviert sind.
properties.enableStreamingIngest	boolean	False	Ein boolescher Wert, der angibt, ob das Streaminggest aktiviert ist.
properties.engineType	EngineType	V3	Der Modultyp
properties.keyVaultProperties	KeyVaultProperties		KeyVault-Eigenschaften für die Clusterverschlüsselung.
properties.languageExtensions	LanguageExtensionsList		Liste der Spracherweiterungen des Clusters.
properties.migrationCluster	MigrationClusterProperties		Eigenschaften des Peer-Clusters, der an einer Migration zu/von diesem Cluster beteiligt ist.
properties.optimizedAutoscale	OptimizedAutoscale		Optimierte Definition der automatischen Skalierung.
properties.privateEndpointConnections	PrivateEndpointConnection[]		Eine Liste der privaten Endpunktverbindungen.
properties.provisioningState	ProvisioningState		Der bereitgestellte Zustand der Ressource.
properties.publicIPType	PublicIPType	IPv4	Gibt an, welcher öffentliche IP-Typ erstellt werden soll – IPv4 (Standard) oder DualStack (sowohl IPv4 als auch IPv6)
properties.publicNetworkAccess	PublicNetworkAccess	Enabled	Der Zugriff auf das öffentliche Netzwerk auf den Cluster ist standardmäßig aktiviert. Wenn diese Option deaktiviert ist, ist nur eine private Endpunktverbindung mit dem Cluster zulässig.
properties.restrictOutboundNetworkAccess	ClusterNetworkAccessFlag	Disabled	Gibt an, ob der ausgehende Netzwerkzugriff eingeschränkt werden soll. Der Wert ist optional, aber wenn er übergeben wird, muss 'Enabled' oder 'Disabled' sein.
properties.state	State		Der Zustand der Ressource.
properties.stateReason	string		Der Grund für den aktuellen Zustand des Clusters.
properties.trustedExternalTenants	TrustedExternalTenant[]		Die externen Mandanten des Clusters.
properties.uri	string		Der Cluster-URI.
properties.virtualClusterGraduationProperties	string (password)		Virtuelle Cluster Graduierungseigenschaften
properties.virtualNetworkConfiguration	VirtualNetworkConfiguration		Definition des virtuellen Netzwerks.
properties.zoneStatus	ZoneStatus		Gibt an, ob der Cluster zonal oder nicht-zonal ist.
sku	AzureSku		Die SKU des Clusters.
systemData	systemData		Azure Resource Manager-Metadaten, die createdBy- und modifiedBy-Informationen enthalten.
tags	object		Ressourcentags.
type	string		Der Typ der Ressource. Z. B. "Microsoft.Compute/virtualMachines" oder "Microsoft.Storage/storageAccounts"
zones	string[]		Die Verfügbarkeitszonen.

ClusterNetworkAccessFlag

Enumeration

Gibt an, ob der ausgehende Netzwerkzugriff eingeschränkt werden soll. Der Wert ist optional, aber wenn er übergeben wird, muss 'Enabled' oder 'Disabled' sein.

Wert	Beschreibung
Enabled	Aktiviert
Disabled	Deaktiviert

ComponentsSgqdofSchemasIdentityPropertiesUserassignedidentitiesAdditionalproperties

Objekt

Name	Typ	Beschreibung
clientId	string	Die Client-ID der vom Benutzer zugewiesenen Identität.
principalId	string	Die Prinzipal-ID der vom Benutzer zugewiesenen Identität.

createdByType

Enumeration

Der Identitätstyp, der die Ressource erstellt hat.

Wert	Beschreibung
User
Application
ManagedIdentity
Key

EngineType

Enumeration

Der Modultyp

Wert	Beschreibung
V2	V2
V3	V3

ErrorAdditionalInfo

Objekt

Der Ressourcenverwaltungsfehler zusätzliche Informationen.

Name	Typ	Beschreibung
info	object	Die zusätzlichen Informationen.
type	string	Der zusätzliche Informationstyp.

ErrorDetail

Objekt

Das Fehlerdetails.

Name	Typ	Beschreibung
additionalInfo	ErrorAdditionalInfo[]	Die zusätzlichen Informationen des Fehlers.
code	string	Der Fehlercode.
details	ErrorDetail[]	Die Fehlerdetails.
message	string	Die Fehlermeldung.
target	string	Das Fehlerziel.

ErrorResponse

Objekt

Fehlerantwort

Name	Typ	Beschreibung
error	ErrorDetail	Das Fehlerobjekt.

Identity

Objekt

Identität für die Ressource.

Name	Typ	Beschreibung
principalId	string	Die Prinzipal-ID der Ressourcenidentität.
tenantId	string	Die Mandanten-ID der Ressource.
type	IdentityType	Der Typ der verwendeten verwalteten Identität. Der Typ "SystemAssigned, UserAssigned" enthält sowohl eine implizit erstellte Identität als auch eine Reihe von vom Benutzer zugewiesenen Identitäten. Der Typ "None" entfernt alle Identitäten.
userAssignedIdentities	<string, ComponentsSgqdofSchemasIdentityPropertiesUserassignedidentitiesAdditionalproperties>	Die Liste der Benutzeridentitäten, die dem Kusto-Cluster zugeordnet sind. Die Benutzeridentitätswörterbuchschlüsselverweise sind ARM-Ressourcen-IDs im Formular: "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}".

IdentityType

Enumeration

Der Typ der verwendeten verwalteten Identität. Der Typ "SystemAssigned, UserAssigned" enthält sowohl eine implizit erstellte Identität als auch eine Reihe von vom Benutzer zugewiesenen Identitäten. Der Typ "None" entfernt alle Identitäten.

Wert	Beschreibung
None	Nichts
SystemAssigned	SystemAssigned
UserAssigned	UserAssigned
SystemAssigned, UserAssigned	SystemZugewiesen, Benutzerzugewiesen

KeyVaultProperties

Objekt

Eigenschaften des Schlüsseltresors.

Name	Typ	Beschreibung
federatedIdentityClientId	string	Die Anwendungs-(Client-)ID der Multi-Tenant-Microsoft Entra-Anwendung. Verwendet für Szenarien mit kundenverwalteten Schlüsseln über verschiedene Mieter, bei denen der Verschlüsselungsschlüssel in einem anderen Tenant als der Cluster gespeichert wird. Die Anwendung muss mit der vom Benutzer zugewiesenen verwalteten Identität als föderierten Identitätszugangsnachweis konfiguriert sein.
keyName	string	Der Name des Schlüsseltresorschlüssels.
keyVaultUri	string	Der URI des Schlüsseltresors.
keyVersion	string	Die Version des Schlüsseltresorschlüssels.
userIdentity	string	Die vom Benutzer zugewiesene Identität (ARM-Ressourcen-ID), die Zugriff auf den Schlüssel hat. Die Identität muss die Berechtigungen 'Get', 'Wrap Key' und 'Unwrap Key' auf dem Key Vault Key Key haben oder die Rolle 'Key Vault Crypto Service Encryption User' zugewiesen werden.

LanguageExtension

Objekt

Das Spracherweiterungsobjekt.

Name	Typ	Beschreibung
languageExtensionCustomImageName	string	Der benutzerdefinierte Bildname in der Sandbox, der als aktive Spracherweiterung aktiviert sein sollte. Sandbox-benutzerdefiniertes Image ist eine Cluster-Unterressource. Wenn diese Eigenschaft gesetzt ist, sollte LanguageExtensionImageName auf 'PythonCustomImage' gesetzt werden.
languageExtensionImageName	LanguageExtensionImageName	Der Bildname der Spracherweiterung.
languageExtensionName	LanguageExtensionName	Der Name der Spracherweiterung.

LanguageExtensionImageName

Enumeration

Name des Spracherweiterungsbildes.

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

Enumeration

Spracherweiterung, die innerhalb der KQL-Abfrage ausgeführt werden kann.

Wert	Beschreibung
PYTHON	PYTHON
R	R

LanguageExtensionsList

Objekt

Die Liste der Spracherweiterungsobjekte.

Name	Typ	Beschreibung
nextLink	string	Der Link zur nächsten Seite mit Ressourcen.
value	LanguageExtension[]	Die Liste der Spracherweiterungen.

MigrationClusterProperties

Objekt

Repräsentiert Eigenschaften eines Clusters, der Teil einer Migration ist.

Name	Typ	Beschreibung
dataIngestionUri	string	Die öffentliche Datenaufnahme-URL des Clusters.
id	string	Die Ressourcen-ID des Clusters.
role	MigrationClusterRole	Die Rolle des Clusters im Migrationsprozess.
uri	string	Die öffentliche URL des Clusters.

MigrationClusterRole

Enumeration

Die Rolle des Clusters im Migrationsprozess.

Wert	Beschreibung
Source	Quelle
Destination	Bestimmungsort

OptimizedAutoscale

Objekt

Eine Klasse, die die optimierte Auto-Skalierungsdefinition enthält.

Name	Typ	Beschreibung
isEnabled	boolean	Ein boolescher Wert, der angibt, ob das optimierte Autoskalen-Feature aktiviert ist oder nicht.
maximum	integer (int32)	Maximale Anzahl zulässiger Instanzen.
minimum	integer (int32)	Anzahl der zulässigen Mindestinstanzen.
version	integer (int32)	Die Version der definierten Vorlage, z. B. 1.

OutboundAccess

Enumeration

Gibt an, ob ausgehender Zugriff für das angegebene URI-Muster zulässig ist.

Wert	Beschreibung
Allow	Erlauben
Deny	Deny

PrivateEndpointConnection

Objekt

Eine private Endpunktverbindung

Name	Typ	Beschreibung
id	string	Vollqualifizierte Ressourcen-ID für die Ressource. Zum Beispiel - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}
name	string	Der Name der Ressource
properties.groupId	string	Gruppen-ID des privaten Endpunkts.
properties.privateEndpoint	PrivateEndpointProperty	Privater Endpunkt, zu dem die Verbindung gehört.
properties.privateLinkServiceConnectionState	PrivateLinkServiceConnectionStateProperty	Verbindungsstatus der privaten Endpunktverbindung.
properties.provisioningState	string	Bereitstellungsstatus des privaten Endpunkts.
systemData	systemData	Azure Resource Manager-Metadaten, die createdBy- und modifiedBy-Informationen enthalten.
type	string	Der Typ der Ressource. Z. B. "Microsoft.Compute/virtualMachines" oder "Microsoft.Storage/storageAccounts"

PrivateEndpointProperty

Objekt

Privater Endpunkt, zu dem die Verbindung gehört.

Name	Typ	Beschreibung
id	string	Ressourcen-ID des privaten Endpunkts.

PrivateLinkServiceConnectionStateProperty

Objekt

Verbindungsstatus der privaten Endpunktverbindung.

Name	Typ	Beschreibung
actionsRequired	string	Jede Aktion, die über den grundlegenden Workflow hinaus erforderlich ist (genehmigen/ ablehnen/trennen)
description	string	Die Verbindungsbeschreibung des privaten Linksdiensts.
status	string	Der Verbindungsstatus des privaten Verknüpfungsdiensts.

ProvisioningState

Enumeration

Der bereitgestellte Zustand der Ressource.

Wert	Beschreibung
Running	Laufen
Creating	Erstellen
Deleting	Löschen
Succeeded	Erfolgreich
Failed	gescheitert
Moving	Verschieben
Canceled	Abgesagt

PublicIPType

Enumeration

Gibt an, welcher öffentliche IP-Typ erstellt werden soll – IPv4 (Standard) oder DualStack (sowohl IPv4 als auch IPv6)

Wert	Beschreibung
IPv4	IPv4
DualStack	DualStack

PublicNetworkAccess

Enumeration

Der Zugriff auf das öffentliche Netzwerk auf den Cluster ist standardmäßig aktiviert. Wenn diese Option deaktiviert ist, ist nur eine private Endpunktverbindung mit dem Cluster zulässig.

Wert	Beschreibung
Enabled	Aktiviert
Disabled	Deaktiviert
SecuredByPerimeter	Vom Perimeter gesichert

State

Enumeration

Der Zustand der Ressource.

Wert	Beschreibung
Creating	Erstellen
Unavailable	Nicht verfügbar
Running	Laufen
Deleting	Löschen
Deleted	Gelöscht
Stopping	Anhalten
Stopped	Angehalten
Starting	Wird gestartet
Updating	Aktualisieren
Migrated	Migriert

systemData

Objekt

Metadaten zur Erstellung und letzten Änderung der Ressource.

Name	Typ	Beschreibung
createdAt	string (date-time)	Der Zeitstempel der Ressourcenerstellung (UTC).
createdBy	string	Die Identität, die die Ressource erstellt hat.
createdByType	createdByType	Der Identitätstyp, der die Ressource erstellt hat.
lastModifiedAt	string (date-time)	Der Zeitstempel der letzten Änderung der Ressource (UTC)
lastModifiedBy	string	Die Identität, die die Ressource zuletzt geändert hat.
lastModifiedByType	createdByType	Der Identitätstyp, der die Ressource zuletzt geändert hat.

TrustedExternalTenant

Objekt

Repräsentiert eine Tenant-ID, der vom Cluster vertraut wird.

Name	Typ	Beschreibung
value	string	GUID, die einen externen Mandanten darstellt.

VirtualNetworkConfiguration

Objekt

Eine Klasse, die eine virtuelle Netzwerkdefinition enthält.

Name	Typ	Standardwert	Beschreibung
dataManagementPublicIpId	string		Die Dienst-ID der öffentlichen IP-Adresse der Datenverwaltung.
enginePublicIpId	string		Die öffentliche IP-Adressressourcen-ID des Moduldiensts.
state	VnetState	Enabled	Wenn diese Option aktiviert ist, wird der Cluster im konfigurierten Subnetz bereitgestellt, wenn er deaktiviert wird, aus dem Subnetz entfernt.
subnetId	string		Die Subnetzressourcen-ID.

VnetState

Enumeration

Wenn diese Option aktiviert ist, wird der Cluster im konfigurierten Subnetz bereitgestellt, wenn er deaktiviert wird, aus dem Subnetz entfernt.

Wert	Beschreibung
Enabled	Aktiviert
Disabled	Deaktiviert

ZoneStatus

Enumeration

Gibt an, ob der Cluster zonal oder nicht-zonal ist.

Wert	Beschreibung
NonZonal	NonZonal
ZonalInconsistency	ZonalInkonsistenz
Zonal	Zonal

Freigeben über

Clusters - Create Or Update

URI-Parameter

Anforderungsheader

Anforderungstext

Antworten

Sicherheit

azure_auth

Bereiche

Beispiele

KustoClusterCreateWithCMKFederatedIdentity

Beispielanforderung

Beispiel für eine Antwort

KustoClusterCreateWithCMKUserAssignedIdentity

Beispielanforderung

Beispiel für eine Antwort

KustoClustersCreateOrUpdate

Beispielanforderung

Beispiel für eine Antwort

Definitionen

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