Clusters - Create Or Update

Služba:: Azure Kusto

Verze rozhraní API:: 2025-02-14

Vytvoření nebo aktualizace clusteru Kusto

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

Parametry identifikátoru URI

Name	V	Vyžadováno	Typ	Description
clusterName	path	True	string pattern: ^.*$	Název clusteru Kusto.
resourceGroupName	path	True	string minLength: 1 maxLength: 90	Název skupiny prostředků. Název nerozlišuje malá a velká písmena.
subscriptionId	path	True	string minLength: 1	ID cílového předplatného.
api-version	query	True	string minLength: 1	Verze rozhraní API, která se má použít pro tuto operaci.

Hlavička požadavku

Name	Vyžadováno	Typ	Description
If-Match		string	Značky ETag clusteru. Tuto hodnotu vynecháte, pokud chcete aktuální cluster vždy přepsat. Zadejte naposledy zobrazenou hodnotu značky ETag, abyste zabránili náhodnému přepsání souběžných změn.
If-None-Match		string	Pokud chcete povolit vytvoření nového clusteru, nastavte na *, ale chcete-li zabránit aktualizaci existujícího clusteru. Další hodnoty budou mít za následek odpověď 412 Před podmínkou, která selhala.

Text požadavku

Name	Vyžadováno	Typ	Description
location	True	string	Geografické umístění, ve kterém se nachází zdroj
sku	True	AzureSku	Skladová položka clusteru.
identity		Identity	Identita clusteru, pokud je nakonfigurovaná.
properties.acceptedAudiences		AcceptedAudiences[]	Cluster akceptoval cílové skupiny.
properties.allowedFqdnList		string[]	Seznam povolených plně kvalifikovaných názvů domén (plně kvalifikovaný název domény) pro výchozí přenos dat z clusteru
properties.allowedIpRangeList		string[]	Seznam IP adres ve formátu CIDR je povolený pro připojení ke clusteru.
properties.calloutPolicies		CalloutPolicy[]	Seznam zásad popisků pro výchozí přenos dat z clusteru
properties.enableAutoStop		boolean	Logická hodnota, která označuje, jestli se cluster může automaticky zastavit (kvůli nedostatku dat nebo žádné aktivitě po mnoho dní).
properties.enableDiskEncryption		boolean	Logická hodnota, která označuje, jestli jsou disky clusteru šifrované.
properties.enableDoubleEncryption		boolean	Logická hodnota, která označuje, jestli je povolené dvojité šifrování.
properties.enablePurge		boolean	Logická hodnota, která označuje, jestli jsou povolené operace vyprázdnění.
properties.enableStreamingIngest		boolean	Logická hodnota, která označuje, jestli je povolená ingestace streamování.
properties.engineType		EngineType	Typ motoru
properties.keyVaultProperties		KeyVaultProperties	Vlastnosti služby KeyVault pro šifrování clusteru
properties.languageExtensions		LanguageExtensionsList	Seznam jazykových rozšíření clusteru
properties.optimizedAutoscale		OptimizedAutoscale	Optimalizovaná definice automatického škálování
properties.publicIPType		publicIPType	Určuje, jaký typ veřejné IP adresy se má vytvořit – IPv4 (výchozí) nebo DualStack (IPv4 i IPv6).
properties.publicNetworkAccess		PublicNetworkAccess	Přístup k veřejné síti ke clusteru je ve výchozím nastavení povolený. Pokud je vypnuto, jsou povolena pouze soukromá připojení koncových bodů ke clusteru. Při 'SecuredByPerimeter' je příchozí a odchozí provoz řízen přístupovými pravidly NSP profilu.
properties.restrictOutboundNetworkAccess		ClusterNetworkAccessFlag	Určuje, jestli chcete omezit odchozí síťový přístup. Hodnota je nepovinná, ale pokud je předaná, musí být Enabled (Povoleno) nebo Disabled (Zakázáno).
properties.trustedExternalTenants		TrustedExternalTenant[]	Externí tenanti clusteru.
properties.virtualClusterGraduationProperties		string	Vlastnosti dokončení studia virtuálního clusteru
properties.virtualNetworkConfiguration		VirtualNetworkConfiguration	Definice virtuální sítě
tags		object	Značky prostředků
zones		string[]	Zóny dostupnosti clusteru.

Odpovědi

Name	Typ	Description
200 OK	Cluster	Cluster byl úspěšně aktualizován.
201 Created	Cluster	Úspěšně vytvořen cluster.
Other Status Codes	ErrorResponse	Chybová odpověď popisující, proč operace selhala.

Příklady

KustoClusterCreateWithCMKFederatedIdentity

KustoClusterCreateWithCMKUserAssignedIdentity

KustoClustersCreateOrUpdate

KustoClusterCreateWithCMKFederatedIdentity

Ukázkový požadavek

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

Ukázková odpověď

Stavový kód:: 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"
}

Stavový kód:: 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

Ukázkový požadavek

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

Ukázková odpověď

Stavový kód:: 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"
}

Stavový kód:: 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

Ukázkový požadavek

HTTP

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

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

Ukázková odpověď

Stavový kód:: 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"
}

Stavový kód:: 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"
}

Definice

Name	Description
AcceptedAudiences	Představuje uznávané publikum, kterému cluster důvěřuje.
AzureSku	Azure SKU definition.
AzureSkuName	Název skladové položky.
AzureSkuTier	Úroveň skladové položky.
CalloutPolicy	Konfigurace pro externí callout politiky, včetně URI vzorů, typů přístupů a typů služeb.
calloutType	Typ služby popisku určující typ externího prostředku nebo služby, ke které se přistupuje.
Cluster	Třída představuje Kusto cluster.
ClusterNetworkAccessFlag	Určuje, jestli chcete omezit odchozí síťový přístup. Hodnota je nepovinná, ale pokud je předaná, musí být Enabled (Povoleno) nebo Disabled (Zakázáno).
createdByType	Typ identity, která prostředek vytvořila.
EngineType	Typ motoru
ErrorAdditionalInfo	Další informace o chybě správy prostředků
ErrorDetail	Podrobnosti o chybě.
ErrorResponse	Chybová odpověď
Identity	Identita prostředku
IdentityType	Typ použité spravované identity. Typ SystemAssigned, UserAssigned zahrnuje implicitně vytvořenou identitu i sadu identit přiřazených uživatelem. Typ None odebere všechny identity.
KeyVaultProperties	Vlastnosti trezoru klíčů
LanguageExtension	Objekt rozšíření jazyka.
languageExtensionImageName	Název image rozšíření jazyka.
languageExtensionName	Název rozšíření jazyka.
LanguageExtensionsList	Seznam objektů rozšíření jazyka.
MigrationClusterProperties	Reprezentuje vlastnosti shluku, který je součástí migrace.
MigrationClusterRole	Role klastru v migračním procesu.
OptimizedAutoscale	Třída, která obsahuje optimalizovanou automatickou definici škálování.
outboundAccess	Určuje, jestli je pro zadaný vzor identifikátoru URI povolený odchozí přístup.
PrivateEndpointConnection	Připojení privátního koncového bodu
PrivateEndpointProperty	Privátní koncový bod, ke kterému připojení patří.
PrivateLinkServiceConnectionStateProperty	Stav připojení připojení privátního koncového bodu
ProvisioningState	Zřízený stav prostředku.
publicIPType	Určuje, jaký typ veřejné IP adresy se má vytvořit – IPv4 (výchozí) nebo DualStack (IPv4 i IPv6).
PublicNetworkAccess	Přístup k veřejné síti ke clusteru je ve výchozím nastavení povolený. Pokud je vypnuto, jsou povolena pouze soukromá připojení koncových bodů ke clusteru. Při 'SecuredByPerimeter' je příchozí a odchozí provoz řízen přístupovými pravidly NSP profilu.
State	Stav zdroje.
systemData	Metadata týkající se vytvoření a poslední změny prostředku.
TrustedExternalTenant	Představuje tenant ID, kterému cluster důvěřuje.
UserAssignedIdentities	Seznam identit uživatelů přidružených ke clusteru Kusto. Odkazy na klíč slovníku identit uživatele budou ID prostředků ARM ve formátu: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}.
VirtualNetworkConfiguration	Třída obsahující definici virtuální sítě.
VnetState	Pokud je tato možnost povolená, cluster se nasadí do nakonfigurované podsítě, když ho zakážete, odebere se z podsítě.
ZoneStatus	Označuje, zda je klastr zónový nebo nezónální.

AcceptedAudiences

Objekt

Představuje uznávané publikum, kterému cluster důvěřuje.

Name	Typ	Description
value	string	IDENTIFIKÁTOR GUID nebo platná adresa URL představující přijatou cílovou skupinu

AzureSku

Objekt

Azure SKU definition.

Name	Typ	Description
capacity	integer (int32)	Počet instancí clusteru.
name	AzureSkuName	Název skladové položky.
tier	AzureSkuTier	Úroveň skladové položky.

AzureSkuName

Výčet

Název skladové položky.

Hodnota	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

Výčet

Úroveň skladové položky.

Hodnota	Description
Basic
Standard

CalloutPolicy

Objekt

Konfigurace pro externí callout politiky, včetně URI vzorů, typů přístupů a typů služeb.

Name	Typ	Description
calloutId	string	Jedinečný identifikátor konfigurace popisku
calloutType	calloutType	Typ služby popisku určující typ externího prostředku nebo služby, ke které se přistupuje.
calloutUriRegex	string	Vzor regulárního výrazu nebo plně kvalifikovaného názvu domény pro identifikátor URI popisku
outboundAccess	outboundAccess	Určuje, jestli je pro zadaný vzor identifikátoru URI povolený odchozí přístup.

calloutType

Výčet

Typ služby popisku určující typ externího prostředku nebo služby, ke které se přistupuje.

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

Cluster

Objekt

Třída představuje Kusto cluster.

Name	Typ	Default value	Description
etag	string		Jedinečný řetězec jen pro čtení, který se změní při každé aktualizaci prostředku.
id	string		Plně kvalifikované ID prostředku pro prostředek. Příklad : /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}
identity	Identity		Identita clusteru, pokud je nakonfigurovaná.
location	string		Geografické umístění, ve kterém se nachází zdroj
name	string		Název prostředku
properties.acceptedAudiences	AcceptedAudiences[]		Cluster akceptoval cílové skupiny.
properties.allowedFqdnList	string[]		Seznam povolených plně kvalifikovaných názvů domén (plně kvalifikovaný název domény) pro výchozí přenos dat z clusteru
properties.allowedIpRangeList	string[]		Seznam IP adres ve formátu CIDR je povolený pro připojení ke clusteru.
properties.calloutPolicies	CalloutPolicy[]		Seznam zásad popisků pro výchozí přenos dat z clusteru
properties.dataIngestionUri	string		URI vstupu dat clusteru.
properties.enableAutoStop	boolean	True	Logická hodnota, která označuje, jestli se cluster může automaticky zastavit (kvůli nedostatku dat nebo žádné aktivitě po mnoho dní).
properties.enableDiskEncryption	boolean	False	Logická hodnota, která označuje, jestli jsou disky clusteru šifrované.
properties.enableDoubleEncryption	boolean	False	Logická hodnota, která označuje, jestli je povolené dvojité šifrování.
properties.enablePurge	boolean	False	Logická hodnota, která označuje, jestli jsou povolené operace vyprázdnění.
properties.enableStreamingIngest	boolean	False	Logická hodnota, která označuje, jestli je povolená ingestace streamování.
properties.engineType	EngineType	V3	Typ motoru
properties.keyVaultProperties	KeyVaultProperties		Vlastnosti služby KeyVault pro šifrování clusteru
properties.languageExtensions	LanguageExtensionsList		Seznam jazykových rozšíření clusteru
properties.migrationCluster	MigrationClusterProperties		Vlastnosti peer clusteru zapojeného do migrace do/z tohoto clusteru.
properties.optimizedAutoscale	OptimizedAutoscale		Optimalizovaná definice automatického škálování
properties.privateEndpointConnections	PrivateEndpointConnection[]		Seznam připojení privátních koncových bodů
properties.provisioningState	ProvisioningState		Zřízený stav prostředku.
properties.publicIPType	publicIPType	IPv4	Určuje, jaký typ veřejné IP adresy se má vytvořit – IPv4 (výchozí) nebo DualStack (IPv4 i IPv6).
properties.publicNetworkAccess	PublicNetworkAccess	Enabled	Přístup k veřejné síti ke clusteru je ve výchozím nastavení povolený. Pokud je vypnuto, jsou povolena pouze soukromá připojení koncových bodů ke clusteru. Při 'SecuredByPerimeter' je příchozí a odchozí provoz řízen přístupovými pravidly NSP profilu.
properties.restrictOutboundNetworkAccess	ClusterNetworkAccessFlag	Disabled	Určuje, jestli chcete omezit odchozí síťový přístup. Hodnota je nepovinná, ale pokud je předaná, musí být Enabled (Povoleno) nebo Disabled (Zakázáno).
properties.state	State		Stav zdroje.
properties.stateReason	string		Důvod současného stavu shluku.
properties.trustedExternalTenants	TrustedExternalTenant[]		Externí tenanti clusteru.
properties.uri	string		URI clusteru.
properties.virtualClusterGraduationProperties	string		Vlastnosti dokončení studia virtuálního clusteru
properties.virtualNetworkConfiguration	VirtualNetworkConfiguration		Definice virtuální sítě
properties.zoneStatus	ZoneStatus		Označuje, zda je klastr zónový nebo nezónální.
sku	AzureSku		Skladová položka clusteru.
systemData	systemData		Metadata týkající se vytvoření a poslední změny prostředku.
tags	object		Značky prostředků
type	string		Typ prostředku. Například Microsoft.Compute/virtualMachines nebo Microsoft.Storage/storageAccounts
zones	string[]		Zóny dostupnosti clusteru.

ClusterNetworkAccessFlag

Výčet

Určuje, jestli chcete omezit odchozí síťový přístup. Hodnota je nepovinná, ale pokud je předaná, musí být Enabled (Povoleno) nebo Disabled (Zakázáno).

Hodnota	Description
Enabled
Disabled

createdByType

Výčet

Typ identity, která prostředek vytvořila.

Hodnota	Description
User
Application
ManagedIdentity
Key

EngineType

Výčet

Typ motoru

Hodnota	Description
V2
V3

ErrorAdditionalInfo

Objekt

Další informace o chybě správy prostředků

Name	Typ	Description
info	object	Další informace.
type	string	Další typ informací.

ErrorDetail

Objekt

Podrobnosti o chybě.

Name	Typ	Description
additionalInfo	ErrorAdditionalInfo[]	Další informace o chybě.
code	string	Kód chyby.
details	ErrorDetail[]	Podrobnosti o chybě.
message	string	Chybová zpráva.
target	string	Cíl chyby.

ErrorResponse

Objekt

Chybová odpověď

Name	Typ	Description
error	ErrorDetail	Objekt chyby.

Identity

Objekt

Identita prostředku

Name	Typ	Description
principalId	string	ID objektu zabezpečení identity prostředku.
tenantId	string	ID tenanta prostředku.
type	IdentityType	Typ použité spravované identity. Typ SystemAssigned, UserAssigned zahrnuje implicitně vytvořenou identitu i sadu identit přiřazených uživatelem. Typ None odebere všechny identity.
userAssignedIdentities	UserAssignedIdentities	Seznam identit uživatelů přidružených ke clusteru Kusto. Odkazy na klíč slovníku identit uživatele budou ID prostředků ARM ve formátu: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}.

IdentityType

Výčet

Typ použité spravované identity. Typ SystemAssigned, UserAssigned zahrnuje implicitně vytvořenou identitu i sadu identit přiřazených uživatelem. Typ None odebere všechny identity.

Hodnota	Description
None
SystemAssigned
UserAssigned
SystemAssigned, UserAssigned

KeyVaultProperties

Objekt

Vlastnosti trezoru klíčů

Name	Typ	Description
federatedIdentityClientId	string	ID aplikace (klienta) vícenájemní aplikace Microsoft Entra. Používá se pro scénáře klíčů spravovaných zákazníkem mezi nájemci, kde je šifrovací klíč uložen v jiném tenantu než cluster. Aplikace musí být nakonfigurována s uživatelem přiřazenou spravovanou identitou jako federovaným přihlašovacím údajem.
keyName	string	Název klíče trezoru klíčů.
keyVaultUri	string	Identifikátor URI trezoru klíčů.
keyVersion	string	Verze klíče trezoru klíčů.
userIdentity	string	Identita přiřazená uživatelem (ID prostředku ARM), která má přístup k klíči. Identita musí mít oprávnění 'Získat', 'Wrap Key' a 'Unwrap Key' na klíči Key Vault, nebo být přiřazena role 'Key Vault Crypto Service Encryption User'.

LanguageExtension

Objekt

Objekt rozšíření jazyka.

Name	Typ	Description
languageExtensionCustomImageName	string	Název vlastní image rozšíření jazyka.
languageExtensionImageName	languageExtensionImageName	Název image rozšíření jazyka.
languageExtensionName	languageExtensionName	Název rozšíření jazyka.

languageExtensionImageName

Výčet

Název image rozšíření jazyka.

Hodnota	Description
R
Python3_6_5
Python3_10_8
Python3_10_8_DL
PythonCustomImage
Python3_11_7
Python3_11_7_DL

languageExtensionName

Výčet

Název rozšíření jazyka.

Hodnota	Description
PYTHON
R

LanguageExtensionsList

Objekt

Seznam objektů rozšíření jazyka.

Name	Typ	Description
value	LanguageExtension[]	Seznam jazykových rozšíření

MigrationClusterProperties

Objekt

Reprezentuje vlastnosti shluku, který je součástí migrace.

Name	Typ	Description
dataIngestionUri	string	Veřejná URL data clusteru.
id	string	ID zdroje clusteru.
role	MigrationClusterRole	Role klastru v migračním procesu.
uri	string	Veřejná URL adresa clusteru.

MigrationClusterRole

Výčet

Role klastru v migračním procesu.

Hodnota	Description
Source
Destination

OptimizedAutoscale

Objekt

Třída, která obsahuje optimalizovanou automatickou definici škálování.

Name	Typ	Description
isEnabled	boolean	Logická hodnota, která označuje, jestli je funkce optimalizovaného automatického škálování povolená nebo ne.
maximum	integer (int32)	Maximální povolený počet instancí
minimum	integer (int32)	Minimální povolený počet instancí.
version	integer (int32)	Verze definované šablony, například 1.

outboundAccess

Výčet

Určuje, jestli je pro zadaný vzor identifikátoru URI povolený odchozí přístup.

Hodnota	Description
Allow
Deny

PrivateEndpointConnection

Objekt

Připojení privátního koncového bodu

Name	Typ	Description
id	string	Plně kvalifikované ID prostředku pro prostředek. Příklad : /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}
name	string	Název prostředku
properties.groupId	string	ID skupiny privátního koncového bodu
properties.privateEndpoint	PrivateEndpointProperty	Privátní koncový bod, ke kterému připojení patří.
properties.privateLinkServiceConnectionState	PrivateLinkServiceConnectionStateProperty	Stav připojení připojení privátního koncového bodu
properties.provisioningState	string	Stav zřizování privátního koncového bodu
systemData	systemData	Metadata týkající se vytvoření a poslední změny prostředku.
type	string	Typ prostředku. Například Microsoft.Compute/virtualMachines nebo Microsoft.Storage/storageAccounts

PrivateEndpointProperty

Objekt

Privátní koncový bod, ke kterému připojení patří.

Name	Typ	Description
id	string	ID prostředku privátního koncového bodu

PrivateLinkServiceConnectionStateProperty

Objekt

Stav připojení připojení privátního koncového bodu

Name	Typ	Description
actionsRequired	string	Jakákoli akce, která se vyžaduje nad rámec základního pracovního postupu (schválit, odmítnout nebo odpojit)
description	string	Popis připojení služby Private Link.
status	string	Stav připojení služby Private Link.

ProvisioningState

Výčet

Zřízený stav prostředku.

Hodnota	Description
Running
Creating
Deleting
Succeeded
Failed
Moving
Canceled

publicIPType

Výčet

Určuje, jaký typ veřejné IP adresy se má vytvořit – IPv4 (výchozí) nebo DualStack (IPv4 i IPv6).

Hodnota	Description
IPv4
DualStack

PublicNetworkAccess

Výčet

Přístup k veřejné síti ke clusteru je ve výchozím nastavení povolený. Pokud je vypnuto, jsou povolena pouze soukromá připojení koncových bodů ke clusteru. Při 'SecuredByPerimeter' je příchozí a odchozí provoz řízen přístupovými pravidly NSP profilu.

Hodnota	Description
Enabled
Disabled
SecuredByPerimeter

State

Výčet

Stav zdroje.

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

systemData

Objekt

Metadata týkající se vytvoření a poslední změny prostředku.

Name	Typ	Description
createdAt	string (date-time)	Časové razítko vytvoření prostředku (UTC).
createdBy	string	Identita, která prostředek vytvořila.
createdByType	createdByType	Typ identity, která prostředek vytvořila.
lastModifiedAt	string (date-time)	Časové razítko poslední změny zdroje (UTC)
lastModifiedBy	string	Identita, která naposledy změnila prostředek.
lastModifiedByType	createdByType	Typ identity, která naposledy změnila prostředek.

TrustedExternalTenant

Objekt

Představuje tenant ID, kterému cluster důvěřuje.

Name	Typ	Description
value	string	IDENTIFIKÁTOR GUID představující externího tenanta

UserAssignedIdentities

Objekt

Seznam identit uživatelů přidružených ke clusteru Kusto. Odkazy na klíč slovníku identit uživatele budou ID prostředků ARM ve formátu: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}.

Name	Typ	Description

VirtualNetworkConfiguration

Objekt

Třída obsahující definici virtuální sítě.

Name	Typ	Default value	Description
dataManagementPublicIpId	string		ID prostředku prostředku veřejné IP adresy správy dat
enginePublicIpId	string		ID prostředku prostředku veřejné IP adresy služby stroje
state	VnetState	Enabled	Pokud je tato možnost povolená, cluster se nasadí do nakonfigurované podsítě, když ho zakážete, odebere se z podsítě.
subnetId	string		ID prostředku podsítě.

VnetState

Výčet

Pokud je tato možnost povolená, cluster se nasadí do nakonfigurované podsítě, když ho zakážete, odebere se z podsítě.

Hodnota	Description
Enabled
Disabled

ZoneStatus

Výčet

Označuje, zda je klastr zónový nebo nezónální.

Hodnota	Description
NonZonal
ZonalInconsistency
Zonal

Sdílet prostřednictvím

Clusters - Create Or Update

Parametry identifikátoru URI

Hlavička požadavku

Text požadavku

Odpovědi

Příklady

KustoClusterCreateWithCMKFederatedIdentity

Ukázkový požadavek

Ukázková odpověď

KustoClusterCreateWithCMKUserAssignedIdentity

Ukázkový požadavek

Ukázková odpověď

KustoClustersCreateOrUpdate

Ukázkový požadavek

Ukázková odpověď

Definice

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