Clusters - Create Or Update

Služba:

Azure Kusto

Verze rozhraní API:

2024-04-13

Vytvoření nebo aktualizace clusteru Kusto

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

Parametry identifikátoru URI

Name	V	Vyžadováno	Typ	Description
clusterName	path	True	string	Název clusteru Kusto. Vzor regulárního výrazu: ^.*$
resourceGroupName	path	True	string	Název skupiny prostředků. Název nerozlišuje malá a velká písmena.
subscriptionId	path	True	string	ID cílového předplatného.
api-version	query	True	string	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 zakázané, je povolené pouze připojení privátního koncového bodu ke clusteru.
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	Cluster se úspěšně vytvořil.
Other Status Codes	ErrorResponse	Chybová odpověď popisující, proč operace selhala.

Příklady

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=2024-04-13

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

Java

import com.azure.resourcemanager.kusto.fluent.models.LanguageExtensionInner;
import com.azure.resourcemanager.kusto.models.AzureSku;
import com.azure.resourcemanager.kusto.models.AzureSkuName;
import com.azure.resourcemanager.kusto.models.AzureSkuTier;
import com.azure.resourcemanager.kusto.models.Identity;
import com.azure.resourcemanager.kusto.models.IdentityType;
import com.azure.resourcemanager.kusto.models.LanguageExtensionImageName;
import com.azure.resourcemanager.kusto.models.LanguageExtensionName;
import com.azure.resourcemanager.kusto.models.LanguageExtensionsList;
import com.azure.resourcemanager.kusto.models.PublicIpType;
import com.azure.resourcemanager.kusto.models.PublicNetworkAccess;
import java.util.Arrays;

/**
 * Samples for Clusters CreateOrUpdate.
 */
public final class Main {
    /*
     * x-ms-original-file:
     * specification/azure-kusto/resource-manager/Microsoft.Kusto/stable/2024-04-13/examples/KustoClustersCreateOrUpdate
     * .json
     */
    /**
     * Sample code: KustoClustersCreateOrUpdate.
     * 
     * @param manager Entry point to KustoManager.
     */
    public static void kustoClustersCreateOrUpdate(com.azure.resourcemanager.kusto.KustoManager manager) {
        manager.clusters().define("kustoCluster").withRegion("westus").withExistingResourceGroup("kustorptest")
            .withSku(
                new AzureSku().withName(AzureSkuName.STANDARD_L16AS_V3).withCapacity(2).withTier(AzureSkuTier.STANDARD))
            .withIdentity(new Identity().withType(IdentityType.SYSTEM_ASSIGNED)).withEnableStreamingIngest(true)
            .withEnablePurge(true)
            .withLanguageExtensions(new LanguageExtensionsList().withValue(Arrays.asList(
                new LanguageExtensionInner().withLanguageExtensionName(LanguageExtensionName.PYTHON)
                    .withLanguageExtensionImageName(LanguageExtensionImageName.PYTHON3_10_8),
                new LanguageExtensionInner().withLanguageExtensionName(LanguageExtensionName.R)
                    .withLanguageExtensionImageName(LanguageExtensionImageName.R))))
            .withEnableDoubleEncryption(false).withPublicNetworkAccess(PublicNetworkAccess.ENABLED)
            .withAllowedIpRangeList(Arrays.asList("0.0.0.0/0")).withEnableAutoStop(true)
            .withPublicIpType(PublicIpType.DUAL_STACK).create();
    }
}

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

Python

from azure.identity import DefaultAzureCredential

from azure.mgmt.kusto import KustoManagementClient

"""
# PREREQUISITES
    pip install azure-identity
    pip install azure-mgmt-kusto
# USAGE
    python kusto_clusters_create_or_update.py

    Before run the sample, please set the values of the client ID, tenant ID and client secret
    of the AAD application as environment variables: AZURE_CLIENT_ID, AZURE_TENANT_ID,
    AZURE_CLIENT_SECRET. For more info about how to get the value, please see:
    https://docs.microsoft.com/azure/active-directory/develop/howto-create-service-principal-portal
"""


def main():
    client = KustoManagementClient(
        credential=DefaultAzureCredential(),
        subscription_id="12345678-1234-1234-1234-123456789098",
    )

    response = client.clusters.begin_create_or_update(
        resource_group_name="kustorptest",
        cluster_name="kustoCluster",
        parameters={
            "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": {"capacity": 2, "name": "Standard_L16as_v3", "tier": "Standard"},
        },
    ).result()
    print(response)


# x-ms-original-file: specification/azure-kusto/resource-manager/Microsoft.Kusto/stable/2024-04-13/examples/KustoClustersCreateOrUpdate.json
if __name__ == "__main__":
    main()

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

Go

package armkusto_test

import (
	"context"
	"log"

	"github.com/Azure/azure-sdk-for-go/sdk/azcore/to"
	"github.com/Azure/azure-sdk-for-go/sdk/azidentity"
	"github.com/Azure/azure-sdk-for-go/sdk/resourcemanager/kusto/armkusto/v2"
)

// Generated from example definition: https://github.com/Azure/azure-rest-api-specs/blob/b8adce17dc500f338f86f18af30aac61dcb71c5f/specification/azure-kusto/resource-manager/Microsoft.Kusto/stable/2024-04-13/examples/KustoClustersCreateOrUpdate.json
func ExampleClustersClient_BeginCreateOrUpdate() {
	cred, err := azidentity.NewDefaultAzureCredential(nil)
	if err != nil {
		log.Fatalf("failed to obtain a credential: %v", err)
	}
	ctx := context.Background()
	clientFactory, err := armkusto.NewClientFactory("<subscription-id>", cred, nil)
	if err != nil {
		log.Fatalf("failed to create client: %v", err)
	}
	poller, err := clientFactory.NewClustersClient().BeginCreateOrUpdate(ctx, "kustorptest", "kustoCluster", armkusto.Cluster{
		Location: to.Ptr("westus"),
		Identity: &armkusto.Identity{
			Type: to.Ptr(armkusto.IdentityTypeSystemAssigned),
		},
		Properties: &armkusto.ClusterProperties{
			AllowedIPRangeList: []*string{
				to.Ptr("0.0.0.0/0")},
			EnableAutoStop:         to.Ptr(true),
			EnableDoubleEncryption: to.Ptr(false),
			EnablePurge:            to.Ptr(true),
			EnableStreamingIngest:  to.Ptr(true),
			LanguageExtensions: &armkusto.LanguageExtensionsList{
				Value: []*armkusto.LanguageExtension{
					{
						LanguageExtensionImageName: to.Ptr(armkusto.LanguageExtensionImageNamePython3108),
						LanguageExtensionName:      to.Ptr(armkusto.LanguageExtensionNamePYTHON),
					},
					{
						LanguageExtensionImageName: to.Ptr(armkusto.LanguageExtensionImageNameR),
						LanguageExtensionName:      to.Ptr(armkusto.LanguageExtensionNameR),
					}},
			},
			PublicIPType:        to.Ptr(armkusto.PublicIPTypeDualStack),
			PublicNetworkAccess: to.Ptr(armkusto.PublicNetworkAccessEnabled),
		},
		SKU: &armkusto.AzureSKU{
			Name:     to.Ptr(armkusto.AzureSKUNameStandardL16AsV3),
			Capacity: to.Ptr[int32](2),
			Tier:     to.Ptr(armkusto.AzureSKUTierStandard),
		},
	}, &armkusto.ClustersClientBeginCreateOrUpdateOptions{IfMatch: nil,
		IfNoneMatch: nil,
	})
	if err != nil {
		log.Fatalf("failed to finish the request: %v", err)
	}
	res, err := poller.PollUntilDone(ctx, nil)
	if err != nil {
		log.Fatalf("failed to pull the result: %v", err)
	}
	// You could use response here. We use blank identifier for just demo purposes.
	_ = res
	// If the HTTP response code is 200 as defined in example definition, your response structure would look as follows. Please pay attention that all the values in the output are fake values for just demo purposes.
	// res.Cluster = armkusto.Cluster{
	// 	Name: to.Ptr("kustoCluster"),
	// 	Type: to.Ptr("Microsoft.Kusto/Clusters"),
	// 	ID: to.Ptr("/subscriptions/12345678-1234-1234-1234-123456789098/resourceGroups/kustorptest/providers/Microsoft.Kusto/Clusters/kustoCluster"),
	// 	Location: to.Ptr("westus"),
	// 	Etag: to.Ptr("abcd"),
	// 	Identity: &armkusto.Identity{
	// 		Type: to.Ptr(armkusto.IdentityTypeSystemAssigned),
	// 		PrincipalID: to.Ptr("faabad1f-4876-463c-af9d-6ba2d2d2394c"),
	// 		TenantID: to.Ptr("b932977f-6277-4ab7-a2cd-5bd21f07aaf4"),
	// 		UserAssignedIdentities: map[string]*armkusto.ComponentsSgqdofSchemasIdentityPropertiesUserassignedidentitiesAdditionalproperties{
	// 		},
	// 	},
	// 	Properties: &armkusto.ClusterProperties{
	// 		AllowedIPRangeList: []*string{
	// 			to.Ptr("0.0.0.0/0")},
	// 			EnableAutoStop: to.Ptr(true),
	// 			EnableDiskEncryption: to.Ptr(false),
	// 			EnableDoubleEncryption: to.Ptr(false),
	// 			EnablePurge: to.Ptr(true),
	// 			EnableStreamingIngest: to.Ptr(true),
	// 			EngineType: to.Ptr(armkusto.EngineTypeV3),
	// 			KeyVaultProperties: &armkusto.KeyVaultProperties{
	// 				KeyName: to.Ptr("keyName"),
	// 				KeyVaultURI: to.Ptr("https://dummy.keyvault.com"),
	// 				KeyVersion: to.Ptr("keyVersion"),
	// 			},
	// 			LanguageExtensions: &armkusto.LanguageExtensionsList{
	// 				Value: []*armkusto.LanguageExtension{
	// 					{
	// 						LanguageExtensionImageName: to.Ptr(armkusto.LanguageExtensionImageNamePython3108),
	// 						LanguageExtensionName: to.Ptr(armkusto.LanguageExtensionNamePYTHON),
	// 					},
	// 					{
	// 						LanguageExtensionImageName: to.Ptr(armkusto.LanguageExtensionImageNameR),
	// 						LanguageExtensionName: to.Ptr(armkusto.LanguageExtensionNameR),
	// 				}},
	// 			},
	// 			ProvisioningState: to.Ptr(armkusto.ProvisioningStateSucceeded),
	// 			PublicIPType: to.Ptr(armkusto.PublicIPTypeDualStack),
	// 			PublicNetworkAccess: to.Ptr(armkusto.PublicNetworkAccessEnabled),
	// 			RestrictOutboundNetworkAccess: to.Ptr(armkusto.ClusterNetworkAccessFlagDisabled),
	// 		},
	// 		SKU: &armkusto.AzureSKU{
	// 			Name: to.Ptr(armkusto.AzureSKUNameStandardL16AsV3),
	// 			Capacity: to.Ptr[int32](2),
	// 			Tier: to.Ptr(armkusto.AzureSKUTierStandard),
	// 		},
	// 	}
}

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

JavaScript

const { KustoManagementClient } = require("@azure/arm-kusto");
const { DefaultAzureCredential } = require("@azure/identity");
require("dotenv/config");

/**
 * This sample demonstrates how to Create or update a Kusto cluster.
 *
 * @summary Create or update a Kusto cluster.
 * x-ms-original-file: specification/azure-kusto/resource-manager/Microsoft.Kusto/stable/2024-04-13/examples/KustoClustersCreateOrUpdate.json
 */
async function kustoClustersCreateOrUpdate() {
  const subscriptionId =
    process.env["KUSTO_SUBSCRIPTION_ID"] || "12345678-1234-1234-1234-123456789098";
  const resourceGroupName = process.env["KUSTO_RESOURCE_GROUP"] || "kustorptest";
  const clusterName = "kustoCluster";
  const parameters = {
    allowedIpRangeList: ["0.0.0.0/0"],
    enableAutoStop: true,
    enableDoubleEncryption: false,
    enablePurge: true,
    enableStreamingIngest: true,
    identity: { type: "SystemAssigned" },
    languageExtensions: {
      value: [
        {
          languageExtensionImageName: "Python3_10_8",
          languageExtensionName: "PYTHON",
        },
        { languageExtensionImageName: "R", languageExtensionName: "R" },
      ],
    },
    location: "westus",
    publicIPType: "DualStack",
    publicNetworkAccess: "Enabled",
    sku: { name: "Standard_L16as_v3", capacity: 2, tier: "Standard" },
  };
  const credential = new DefaultAzureCredential();
  const client = new KustoManagementClient(credential, subscriptionId);
  const result = await client.clusters.beginCreateOrUpdateAndWait(
    resourceGroupName,
    clusterName,
    parameters,
  );
  console.log(result);
}

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

dotnet

using Azure;
using Azure.ResourceManager;
using System;
using System.Threading.Tasks;
using Azure.Core;
using Azure.Identity;
using Azure.ResourceManager.Kusto.Models;
using Azure.ResourceManager.Models;
using Azure.ResourceManager.Resources;
using Azure.ResourceManager.Kusto;

// Generated from example definition: specification/azure-kusto/resource-manager/Microsoft.Kusto/stable/2024-04-13/examples/KustoClustersCreateOrUpdate.json
// this example is just showing the usage of "Clusters_CreateOrUpdate" operation, for the dependent resources, they will have to be created separately.

// get your azure access token, for more details of how Azure SDK get your access token, please refer to https://learn.microsoft.com/en-us/dotnet/azure/sdk/authentication?tabs=command-line
TokenCredential cred = new DefaultAzureCredential();
// authenticate your client
ArmClient client = new ArmClient(cred);

// this example assumes you already have this ResourceGroupResource created on azure
// for more information of creating ResourceGroupResource, please refer to the document of ResourceGroupResource
string subscriptionId = "12345678-1234-1234-1234-123456789098";
string resourceGroupName = "kustorptest";
ResourceIdentifier resourceGroupResourceId = ResourceGroupResource.CreateResourceIdentifier(subscriptionId, resourceGroupName);
ResourceGroupResource resourceGroupResource = client.GetResourceGroupResource(resourceGroupResourceId);

// get the collection of this KustoClusterResource
KustoClusterCollection collection = resourceGroupResource.GetKustoClusters();

// invoke the operation
string clusterName = "kustoCluster";
KustoClusterData data = new KustoClusterData(new AzureLocation("westus"), new KustoSku(KustoSkuName.StandardL16asV3, KustoSkuTier.Standard)
{
    Capacity = 2,
})
{
    Identity = new ManagedServiceIdentity("SystemAssigned"),
    IsStreamingIngestEnabled = true,
    IsPurgeEnabled = true,
    LanguageExtensionsValue = {new KustoLanguageExtension
    {
    LanguageExtensionName = KustoLanguageExtensionName.Python,
    LanguageExtensionImageName = KustoLanguageExtensionImageName.Python3_10_8,
    }, new KustoLanguageExtension
    {
    LanguageExtensionName = KustoLanguageExtensionName.R,
    LanguageExtensionImageName = KustoLanguageExtensionImageName.R,
    }},
    IsDoubleEncryptionEnabled = false,
    PublicNetworkAccess = KustoClusterPublicNetworkAccess.Enabled,
    AllowedIPRangeList = { "0.0.0.0/0" },
    IsAutoStopEnabled = true,
    PublicIPType = KustoClusterPublicIPType.DualStack,
};
ArmOperation<KustoClusterResource> lro = await collection.CreateOrUpdateAsync(WaitUntil.Completed, clusterName, data);
KustoClusterResource result = lro.Value;

// the variable result is a resource, you could call other operations on this instance as well
// but just for demo, we get its data from this resource instance
KustoClusterData resourceData = result.Data;
// for demo we just print out the id
Console.WriteLine($"Succeeded on id: {resourceData.Id}");

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

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 přijatou cílovou skupinu důvěryhodnou clusterem.
AzureSku	Definice skladové položky Azure
AzureSkuName	Název skladové položky.
AzureSkuTier	Úroveň skladové položky.
CalloutPolicy	Konfigurace pro externí zásady popisků, včetně vzorů identifikátorů URI, typů přístupu 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ředstavující cluster Kusto
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	Představuje vlastnosti clusteru, který je součástí migrace.
MigrationClusterRole	Role clusteru v procesu migrace.
OptimizedAutoscale	Třída, která obsahuje optimalizovanou definici automatického š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 zakázané, je povolené pouze připojení privátního koncového bodu ke clusteru.
State	Stav prostředku.
systemData	Metadata týkající se vytvoření a poslední změny prostředku.
TrustedExternalTenant	Představuje ID tenanta, 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, která obsahuje 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	Určuje, jestli je cluster zónový nebo neonální.

AcceptedAudiences

Představuje přijatou cílovou skupinu důvěryhodnou clusterem.

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

AzureSku

Definice skladové položky Azure

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

AzureSkuName

Název skladové položky.

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

AzureSkuTier

Úroveň skladové položky.

Name	Typ	Description
Basic	string
Standard	string

CalloutPolicy

Konfigurace pro externí zásady popisků, včetně vzorů identifikátorů URI, typů přístupu 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

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

Name	Typ	Description
azure_digital_twins	string
azure_openai	string
cosmosdb	string
external_data	string
genevametrics	string
kusto	string
mysql	string
postgresql	string
sandbox_artifacts	string
sql	string
webapi	string

Cluster

Třída představující cluster Kusto

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		Identifikátor URI příjmu 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 partnerského clusteru zapojeného do nebo 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 zakázané, je povolené pouze připojení privátního koncového bodu ke clusteru.
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 prostředku.
properties.stateReason	string		Důvod aktuálního stavu clusteru.
properties.trustedExternalTenants	TrustedExternalTenant[]		Externí tenanti clusteru.
properties.uri	string		Identifikátor URI clusteru.
properties.virtualClusterGraduationProperties	string		Vlastnosti dokončení studia virtuálního clusteru
properties.virtualNetworkConfiguration	VirtualNetworkConfiguration		Definice virtuální sítě
properties.zoneStatus	ZoneStatus		Určuje, jestli je cluster zónový nebo neoná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

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).

Name	Typ	Description
Disabled	string
Enabled	string

createdByType

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

Name	Typ	Description
Application	string
Key	string
ManagedIdentity	string
User	string

EngineType

Typ motoru

Name	Typ	Description
V2	string
V3	string

ErrorAdditionalInfo

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

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

ErrorDetail

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

Chybová odpověď

Name	Typ	Description
error	ErrorDetail	Objekt chyby.

Identity

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

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.

Name	Typ	Description
None	string
SystemAssigned	string
SystemAssigned, UserAssigned	string
UserAssigned	string

KeyVaultProperties

Vlastnosti trezoru klíčů

Name	Typ	Description
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.

LanguageExtension

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

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

Name	Typ	Description
Python3_10_8	string
Python3_10_8_DL	string
Python3_11_7	string
Python3_11_7_DL	string
Python3_6_5	string
PythonCustomImage	string
R	string

languageExtensionName

Název rozšíření jazyka.

Name	Typ	Description
PYTHON	string
R	string

LanguageExtensionsList

Seznam objektů rozšíření jazyka.

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

MigrationClusterProperties

Představuje vlastnosti clusteru, který je součástí migrace.

Name	Typ	Description
dataIngestionUri	string	Adresa URL pro příjem veřejných dat clusteru.
id	string	ID prostředku clusteru.
role	MigrationClusterRole	Role clusteru v procesu migrace.
uri	string	Veřejná adresa URL clusteru.

MigrationClusterRole

Role clusteru v procesu migrace.

Name	Typ	Description
Destination	string
Source	string

OptimizedAutoscale

Třída, která obsahuje optimalizovanou definici automatického š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	Maximální povolený počet instancí
minimum	integer	Minimální povolený počet instancí.
version	integer	Verze definované šablony, například 1.

outboundAccess

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

Name	Typ	Description
Allow	string
Deny	string

PrivateEndpointConnection

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

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

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

Zřízený stav prostředku.

Name	Typ	Description
Canceled	string
Creating	string
Deleting	string
Failed	string
Moving	string
Running	string
Succeeded	string

publicIPType

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

Name	Typ	Description
DualStack	string
IPv4	string

PublicNetworkAccess

Přístup k veřejné síti ke clusteru je ve výchozím nastavení povolený. Pokud je zakázané, je povolené pouze připojení privátního koncového bodu ke clusteru.

Name	Typ	Description
Disabled	string
Enabled	string

State

Stav prostředku.

Name	Typ	Description
Creating	string
Deleted	string
Deleting	string
Migrated	string
Running	string
Starting	string
Stopped	string
Stopping	string
Unavailable	string
Updating	string

systemData

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

Name	Typ	Description
createdAt	string	Č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	Č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

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

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

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

Name	Typ	Description

VirtualNetworkConfiguration

Třída, která obsahuje 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

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

Name	Typ	Description
Disabled	string
Enabled	string

ZoneStatus

Určuje, jestli je cluster zónový nebo neonální.

Name	Typ	Description
NonZonal	string
Zonal	string
ZonalInconsistency	string