Clusters - Create Or Update

Служба:

Azure Kusto

Версия API:

2024-04-13

Создайте или обновите кластер Kusto.

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

Параметры URI

Имя	В	Обязательно	Тип	Описание
clusterName	path	True	string	Имя кластера Kusto. Шаблон регулярного выражения: ^.*$
resourceGroupName	path	True	string	Имя группы ресурсов. Имя не учитывает регистр.
subscriptionId	path	True	string	Идентификатор целевой подписки.
api-version	query	True	string	Версия API, используемая для этой операции.

Заголовок запроса

Имя	Обязательно	Тип	Описание
If-Match		string	ETag кластера. Опустите это значение, чтобы всегда перезаписать текущий кластер. Укажите последнее значение ETag, чтобы предотвратить случайное перезапись одновременных изменений.
If-None-Match		string	Установите значение "*", чтобы разрешить создание нового кластера, но для предотвращения обновления существующего кластера. Другие значения приводят к сбою ответа 412 pre-condition.

Текст запроса

Имя	Обязательно	Тип	Описание
location	True	string	Географическое расположение, в котором находится ресурс
sku	True	AzureSku	Номер SKU кластера.
identity		Identity	Удостоверение кластера, если настроено.
properties.acceptedAudiences		AcceptedAudiences[]	Принятые аудитории кластера.
properties.allowedFqdnList		string[]	Список разрешенных полных доменных имен (полное доменное имя) для исходящего трафика из кластера.
properties.allowedIpRangeList		string[]	Список IP-адресов в формате CIDR, разрешенных для подключения к кластеру.
properties.calloutPolicies		CalloutPolicy[]	Список политик выноски для исходящего трафика из кластера.
properties.enableAutoStop		boolean	Логическое значение, указывающее, может ли кластер быть автоматически остановлен (из-за отсутствия данных или отсутствия активности в течение многих дней).
properties.enableDiskEncryption		boolean	Логическое значение, указывающее, зашифрованы ли диски кластера.
properties.enableDoubleEncryption		boolean	Логическое значение, указывающее, включен ли двойное шифрование.
properties.enablePurge		boolean	Логическое значение, указывающее, включены ли операции очистки.
properties.enableStreamingIngest		boolean	Логическое значение, указывающее, включен ли прием потоковой передачи.
properties.engineType		EngineType	Тип обработчика
properties.keyVaultProperties		KeyVaultProperties	Свойства KeyVault для шифрования кластера.
properties.languageExtensions		LanguageExtensionsList	Список расширений языка кластера.
properties.optimizedAutoscale		OptimizedAutoscale	Оптимизированное определение автомасштабирования.
properties.publicIPType		publicIPType	Указывает, какой тип общедоступного IP-адреса нужно создать : IPv4 (по умолчанию) или DualStack (как IPv4, так и IPv6)
properties.publicNetworkAccess		PublicNetworkAccess	Доступ к общедоступной сети к кластеру включен по умолчанию. При отключении разрешено только подключение частной конечной точки к кластеру
properties.restrictOutboundNetworkAccess		ClusterNetworkAccessFlag	Независимо от того, следует ли ограничить исходящий доступ к сети. Значение является необязательным, но при передаче в нее должно быть включено или отключено.
properties.trustedExternalTenants		TrustedExternalTenant[]	Внешние клиенты кластера.
properties.virtualClusterGraduationProperties		string	Свойства выпуска виртуального кластера
properties.virtualNetworkConfiguration		VirtualNetworkConfiguration	Определение виртуальной сети.
tags		object	Теги ресурсов.
zones		string[]	Зоны доступности кластера.

Ответы

Имя	Тип	Описание
200 OK	Cluster	Успешно обновлен кластер.
201 Created	Cluster	Успешно создан кластер.
Other Status Codes	ErrorResponse	Ответ на ошибку, описывающий причину сбоя операции.

Примеры

KustoClustersCreateOrUpdate

Образец запроса

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

Пример ответа

Код состояния:

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

Код состояния:

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

Определения

Имя	Описание
AcceptedAudiences	Представляет приемлемую аудиторию, доверенную кластеру.
AzureSku	Определение SKU Azure.
AzureSkuName	Имя номера SKU.
AzureSkuTier	Уровень SKU.
CalloutPolicy	Конфигурация для внешних политик выноски, включая ШАБЛОНЫ URI, типы доступа и типы служб.
calloutType	Тип службы выноски, указывающий тип доступа к внешнему ресурсу или службе.
Cluster	Класс, представляющий кластер Kusto.
ClusterNetworkAccessFlag	Независимо от того, следует ли ограничить исходящий доступ к сети. Значение является необязательным, но при передаче в нее должно быть включено или отключено.
createdByType	Тип удостоверения, создавшего ресурс.
EngineType	Тип обработчика
ErrorAdditionalInfo	Дополнительные сведения об ошибке управления ресурсами.
ErrorDetail	Сведения об ошибке.
ErrorResponse	Ответ на ошибку
Identity	Удостоверение ресурса.
IdentityType	Тип управляемого удостоверения, используемого. Тип SystemAssigned, UserAssigned включает как неявное созданное удостоверение, так и набор удостоверений, назначенных пользователем. Тип "Нет" приведет к удалению всех удостоверений.
KeyVaultProperties	Свойства хранилища ключей.
LanguageExtension	Объект расширения языка.
languageExtensionImageName	Имя образа расширения языка.
languageExtensionName	Имя расширения языка.
LanguageExtensionsList	Список объектов расширения языка.
MigrationClusterProperties	Представляет свойства кластера, который является частью миграции.
MigrationClusterRole	Роль кластера в процессе миграции.
OptimizedAutoscale	Класс, содержащий оптимизированное определение автомасштабирования.
outboundAccess	Указывает, разрешен ли исходящий доступ для указанного шаблона URI.
PrivateEndpointConnection	Подключение к частной конечной точке
PrivateEndpointProperty	Частная конечная точка, к которой принадлежит подключение.
PrivateLinkServiceConnectionStateProperty	Состояние подключения подключения к частной конечной точке.
ProvisioningState	Подготовленное состояние ресурса.
publicIPType	Указывает, какой тип общедоступного IP-адреса нужно создать : IPv4 (по умолчанию) или DualStack (как IPv4, так и IPv6)
PublicNetworkAccess	Доступ к общедоступной сети к кластеру включен по умолчанию. При отключении разрешено только подключение частной конечной точки к кластеру
State	Состояние ресурса.
systemData	Метаданные, относящиеся к созданию и последнему изменении ресурса.
TrustedExternalTenant	Представляет идентификатор клиента, доверенный кластером.
UserAssignedIdentities	Список удостоверений пользователей, связанных с кластером Kusto. Ссылки на ключ словаря удостоверений пользователя будут идентификаторами ресурсов ARM в форме: "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}".
VirtualNetworkConfiguration	Класс, содержащий определение виртуальной сети.
VnetState	При включении кластер развертывается в настроенной подсети, если он отключен, он будет удален из подсети.
ZoneStatus	Указывает, является ли кластер зональным или не зональным.

AcceptedAudiences

Представляет приемлемую аудиторию, доверенную кластеру.

Имя	Тип	Описание
value	string	GUID или допустимый URL-адрес, представляющий приемлемую аудиторию.

AzureSku

Определение SKU Azure.

Имя	Тип	Описание
capacity	integer	Количество экземпляров кластера.
name	AzureSkuName	Имя номера SKU.
tier	AzureSkuTier	Уровень SKU.

AzureSkuName

Имя номера SKU.

Имя	Тип	Описание
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

Уровень SKU.

Имя	Тип	Описание
Basic	string
Standard	string

CalloutPolicy

Конфигурация для внешних политик выноски, включая ШАБЛОНЫ URI, типы доступа и типы служб.

Имя	Тип	Описание
calloutId	string	Уникальный идентификатор конфигурации выноски.
calloutType	calloutType	Тип службы выноски, указывающий тип доступа к внешнему ресурсу или службе.
calloutUriRegex	string	Шаблон регулярного выражения или полного доменного имени для URI выноски.
outboundAccess	outboundAccess	Указывает, разрешен ли исходящий доступ для указанного шаблона URI.

calloutType

Тип службы выноски, указывающий тип доступа к внешнему ресурсу или службе.

Имя	Тип	Описание
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

Класс, представляющий кластер Kusto.

Имя	Тип	Default value	Описание
etag	string		Уникальная строка только для чтения, которая изменяется при обновлении ресурса.
id	string		Полный идентификатор ресурса для ресурса. Ex - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}
identity	Identity		Удостоверение кластера, если настроено.
location	string		Географическое расположение, в котором находится ресурс
name	string		Имя ресурса
properties.acceptedAudiences	AcceptedAudiences[]		Принятые аудитории кластера.
properties.allowedFqdnList	string[]		Список разрешенных полных доменных имен (полное доменное имя) для исходящего трафика из кластера.
properties.allowedIpRangeList	string[]		Список IP-адресов в формате CIDR, разрешенных для подключения к кластеру.
properties.calloutPolicies	CalloutPolicy[]		Список политик выноски для исходящего трафика из кластера.
properties.dataIngestionUri	string		URI приема данных кластера.
properties.enableAutoStop	boolean	True	Логическое значение, указывающее, может ли кластер быть автоматически остановлен (из-за отсутствия данных или отсутствия активности в течение многих дней).
properties.enableDiskEncryption	boolean	False	Логическое значение, указывающее, зашифрованы ли диски кластера.
properties.enableDoubleEncryption	boolean	False	Логическое значение, указывающее, включен ли двойное шифрование.
properties.enablePurge	boolean	False	Логическое значение, указывающее, включены ли операции очистки.
properties.enableStreamingIngest	boolean	False	Логическое значение, указывающее, включен ли прием потоковой передачи.
properties.engineType	EngineType	V3	Тип обработчика
properties.keyVaultProperties	KeyVaultProperties		Свойства KeyVault для шифрования кластера.
properties.languageExtensions	LanguageExtensionsList		Список расширений языка кластера.
properties.migrationCluster	MigrationClusterProperties		Свойства однорангового кластера, связанного с миграцией в этот кластер или из этого кластера.
properties.optimizedAutoscale	OptimizedAutoscale		Оптимизированное определение автомасштабирования.
properties.privateEndpointConnections	PrivateEndpointConnection[]		Список подключений к частной конечной точке.
properties.provisioningState	ProvisioningState		Подготовленное состояние ресурса.
properties.publicIPType	publicIPType	IPv4	Указывает, какой тип общедоступного IP-адреса нужно создать : IPv4 (по умолчанию) или DualStack (как IPv4, так и IPv6)
properties.publicNetworkAccess	PublicNetworkAccess	Enabled	Доступ к общедоступной сети к кластеру включен по умолчанию. При отключении разрешено только подключение частной конечной точки к кластеру
properties.restrictOutboundNetworkAccess	ClusterNetworkAccessFlag	Disabled	Независимо от того, следует ли ограничить исходящий доступ к сети. Значение является необязательным, но при передаче в нее должно быть включено или отключено.
properties.state	State		Состояние ресурса.
properties.stateReason	string		Причина текущего состояния кластера.
properties.trustedExternalTenants	TrustedExternalTenant[]		Внешние клиенты кластера.
properties.uri	string		Универсальный код ресурса (URI) кластера.
properties.virtualClusterGraduationProperties	string		Свойства выпуска виртуального кластера
properties.virtualNetworkConfiguration	VirtualNetworkConfiguration		Определение виртуальной сети.
properties.zoneStatus	ZoneStatus		Указывает, является ли кластер зональным или не зональным.
sku	AzureSku		Номер SKU кластера.
systemData	systemData		Метаданные, относящиеся к созданию и последнему изменении ресурса.
tags	object		Теги ресурсов.
type	string		Тип ресурса. Например, "Microsoft.Compute/virtualMachines" или "Microsoft.Storage/storageAccounts"
zones	string[]		Зоны доступности кластера.

ClusterNetworkAccessFlag

Независимо от того, следует ли ограничить исходящий доступ к сети. Значение является необязательным, но при передаче в нее должно быть включено или отключено.

Имя	Тип	Описание
Disabled	string
Enabled	string

createdByType

Тип удостоверения, создавшего ресурс.

Имя	Тип	Описание
Application	string
Key	string
ManagedIdentity	string
User	string

EngineType

Тип обработчика

Имя	Тип	Описание
V2	string
V3	string

ErrorAdditionalInfo

Дополнительные сведения об ошибке управления ресурсами.

Имя	Тип	Описание
info	object	Дополнительные сведения.
type	string	Дополнительный тип сведений.

ErrorDetail

Сведения об ошибке.

Имя	Тип	Описание
additionalInfo	ErrorAdditionalInfo[]	Дополнительные сведения об ошибке.
code	string	Код ошибки.
details	ErrorDetail[]	Сведения об ошибке.
message	string	Сообщение об ошибке.
target	string	Целевой объект ошибки.

ErrorResponse

Ответ на ошибку

Имя	Тип	Описание
error	ErrorDetail	Объект ошибки.

Identity

Удостоверение ресурса.

Имя	Тип	Описание
principalId	string	Идентификатор субъекта удостоверения ресурса.
tenantId	string	Идентификатор клиента ресурса.
type	IdentityType	Тип управляемого удостоверения, используемого. Тип SystemAssigned, UserAssigned включает как неявное созданное удостоверение, так и набор удостоверений, назначенных пользователем. Тип "Нет" приведет к удалению всех удостоверений.
userAssignedIdentities	UserAssignedIdentities	Список удостоверений пользователей, связанных с кластером Kusto. Ссылки на ключ словаря удостоверений пользователя будут идентификаторами ресурсов ARM в форме: "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}".

IdentityType

Тип управляемого удостоверения, используемого. Тип SystemAssigned, UserAssigned включает как неявное созданное удостоверение, так и набор удостоверений, назначенных пользователем. Тип "Нет" приведет к удалению всех удостоверений.

Имя	Тип	Описание
None	string
SystemAssigned	string
SystemAssigned, UserAssigned	string
UserAssigned	string

KeyVaultProperties

Свойства хранилища ключей.

Имя	Тип	Описание
keyName	string	Имя ключа хранилища ключей.
keyVaultUri	string	Универсальный код ресурса (URI) хранилища ключей.
keyVersion	string	Версия ключа хранилища ключей.
userIdentity	string	Назначаемое пользователем удостоверение (идентификатор ресурса ARM), которое имеет доступ к ключу.

LanguageExtension

Объект расширения языка.

Имя	Тип	Описание
languageExtensionCustomImageName	string	Имя пользовательского образа расширения языка.
languageExtensionImageName	languageExtensionImageName	Имя образа расширения языка.
languageExtensionName	languageExtensionName	Имя расширения языка.

languageExtensionImageName

Имя образа расширения языка.

Имя	Тип	Описание
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

Имя расширения языка.

Имя	Тип	Описание
PYTHON	string
R	string

LanguageExtensionsList

Список объектов расширения языка.

Имя	Тип	Описание
value	LanguageExtension[]	Список расширений языка.

MigrationClusterProperties

Представляет свойства кластера, который является частью миграции.

Имя	Тип	Описание
dataIngestionUri	string	URL-адрес приема общедоступных данных кластера.
id	string	Идентификатор ресурса кластера.
role	MigrationClusterRole	Роль кластера в процессе миграции.
uri	string	Общедоступный URL-адрес кластера.

MigrationClusterRole

Роль кластера в процессе миграции.

Имя	Тип	Описание
Destination	string
Source	string

OptimizedAutoscale

Класс, содержащий оптимизированное определение автомасштабирования.

Имя	Тип	Описание
isEnabled	boolean	Логическое значение, указывающее, включена ли оптимизированная функция автомасштабирования.
maximum	integer	Максимально допустимое число экземпляров.
minimum	integer	Минимально допустимое число экземпляров.
version	integer	Версия определенного шаблона, например 1.

outboundAccess

Указывает, разрешен ли исходящий доступ для указанного шаблона URI.

Имя	Тип	Описание
Allow	string
Deny	string

PrivateEndpointConnection

Подключение к частной конечной точке

Имя	Тип	Описание
id	string	Полный идентификатор ресурса для ресурса. Ex - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}
name	string	Имя ресурса
properties.groupId	string	Идентификатор группы частной конечной точки.
properties.privateEndpoint	PrivateEndpointProperty	Частная конечная точка, к которой принадлежит подключение.
properties.privateLinkServiceConnectionState	PrivateLinkServiceConnectionStateProperty	Состояние подключения подключения к частной конечной точке.
properties.provisioningState	string	Состояние подготовки частной конечной точки.
systemData	systemData	Метаданные, относящиеся к созданию и последнему изменении ресурса.
type	string	Тип ресурса. Например, "Microsoft.Compute/virtualMachines" или "Microsoft.Storage/storageAccounts"

PrivateEndpointProperty

Частная конечная точка, к которой принадлежит подключение.

Имя	Тип	Описание
id	string	Идентификатор ресурса частной конечной точки.

PrivateLinkServiceConnectionStateProperty

Состояние подключения подключения к частной конечной точке.

Имя	Тип	Описание
actionsRequired	string	Любое действие, которое требуется за рамки базового рабочего процесса (утверждение/ отклонение или отключение)
description	string	Описание подключения службы приватного канала.
status	string	Состояние подключения службы приватного канала.

ProvisioningState

Подготовленное состояние ресурса.

Имя	Тип	Описание
Canceled	string
Creating	string
Deleting	string
Failed	string
Moving	string
Running	string
Succeeded	string

publicIPType

Указывает, какой тип общедоступного IP-адреса нужно создать : IPv4 (по умолчанию) или DualStack (как IPv4, так и IPv6)

Имя	Тип	Описание
DualStack	string
IPv4	string

PublicNetworkAccess

Доступ к общедоступной сети к кластеру включен по умолчанию. При отключении разрешено только подключение частной конечной точки к кластеру

Имя	Тип	Описание
Disabled	string
Enabled	string

State

Состояние ресурса.

Имя	Тип	Описание
Creating	string
Deleted	string
Deleting	string
Migrated	string
Running	string
Starting	string
Stopped	string
Stopping	string
Unavailable	string
Updating	string

systemData

Метаданные, относящиеся к созданию и последнему изменении ресурса.

Имя	Тип	Описание
createdAt	string	Метка времени создания ресурса (UTC).
createdBy	string	Удостоверение, создающее ресурс.
createdByType	createdByType	Тип удостоверения, создавшего ресурс.
lastModifiedAt	string	Метка времени последнего изменения ресурса (UTC)
lastModifiedBy	string	Идентификатор, который последний раз изменил ресурс.
lastModifiedByType	createdByType	Тип удостоверения, который последний раз изменил ресурс.

TrustedExternalTenant

Представляет идентификатор клиента, доверенный кластером.

Имя	Тип	Описание
value	string	GUID, представляющий внешний клиент.

UserAssignedIdentities

Список удостоверений пользователей, связанных с кластером Kusto. Ссылки на ключ словаря удостоверений пользователя будут идентификаторами ресурсов ARM в форме: "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}".

Имя	Тип	Описание

VirtualNetworkConfiguration

Класс, содержащий определение виртуальной сети.

Имя	Тип	Default value	Описание
dataManagementPublicIpId	string		Идентификатор ресурса общедоступного IP-адреса службы управления данными.
enginePublicIpId	string		Идентификатор ресурса общедоступного IP-адреса службы обработчика.
state	VnetState	Enabled	При включении кластер развертывается в настроенной подсети, если он отключен, он будет удален из подсети.
subnetId	string		Идентификатор ресурса подсети.

VnetState

При включении кластер развертывается в настроенной подсети, если он отключен, он будет удален из подсети.

Имя	Тип	Описание
Disabled	string
Enabled	string

ZoneStatus

Указывает, является ли кластер зональным или не зональным.

Имя	Тип	Описание
NonZonal	string
Zonal	string
ZonalInconsistency	string