Clusters - Create Or Update

Tjänst:

Azure Kusto

API-version:

2024-04-13

Skapa eller uppdatera ett Kusto-kluster.

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

URI-parametrar

Name	I	Obligatorisk	Typ	Description
clusterName	path	True	string	Namnet på Kusto-klustret. Reguljärt uttrycksmönster: ^.*$
resourceGroupName	path	True	string	Namnet på resursgruppen. Namnet är skiftlägesokänsligt.
subscriptionId	path	True	string	ID för målprenumerationen.
api-version	query	True	string	DEN API-version som ska användas för den här åtgärden.

Begärandehuvud

Name	Obligatorisk	Typ	Description
If-Match		string	ETag för klustret. Utelämna det här värdet för att alltid skriva över det aktuella klustret. Ange det senast synliga ETag-värdet för att förhindra att samtidiga ändringar skrivs över av misstag.
If-None-Match		string	Ange till *för att tillåta att ett nytt kluster skapas, men för att förhindra uppdatering av ett befintligt kluster. Andra värden resulterar i ett 412-förvillkor misslyckades svar.

Begärandetext

Name	Obligatorisk	Typ	Description
location	True	string	Den geo-plats där resursen finns
sku	True	AzureSku	SKU:n för klustret.
identity		Identity	Klustrets identitet, om den är konfigurerad.
properties.acceptedAudiences		AcceptedAudiences[]	Klustrets godkända målgrupper.
properties.allowedFqdnList		string[]	Lista över tillåtna FQDN(fullständigt domännamn) för utgående från kluster.
properties.allowedIpRangeList		string[]	Listan över ip-adresser i formatet CIDR som tillåts ansluta till klustret.
properties.calloutPolicies		CalloutPolicy[]	Lista över pratbubblade principer för utgående trafik från kluster.
properties.enableAutoStop		boolean	Ett booleskt värde som anger om klustret kan stoppas automatiskt (på grund av brist på data eller ingen aktivitet under många dagar).
properties.enableDiskEncryption		boolean	Ett booleskt värde som anger om klustrets diskar är krypterade.
properties.enableDoubleEncryption		boolean	Ett booleskt värde som anger om dubbel kryptering är aktiverat.
properties.enablePurge		boolean	Ett booleskt värde som anger om rensningsåtgärderna är aktiverade.
properties.enableStreamingIngest		boolean	Ett booleskt värde som anger om den strömmande inmatningen är aktiverad.
properties.engineType		EngineType	Motortypen
properties.keyVaultProperties		KeyVaultProperties	KeyVault-egenskaper för klusterkryptering.
properties.languageExtensions		LanguageExtensionsList	Lista över klustrets språktillägg.
properties.optimizedAutoscale		OptimizedAutoscale	Optimerad automatisk skalningsdefinition.
properties.publicIPType		publicIPType	Anger vilken offentlig IP-typ som ska skapas – IPv4 (standard) eller DualStack (både IPv4 och IPv6)
properties.publicNetworkAccess		PublicNetworkAccess	Offentlig nätverksåtkomst till klustret är aktiverad som standard. När det är inaktiverat tillåts endast privat slutpunktsanslutning till klustret
properties.restrictOutboundNetworkAccess		ClusterNetworkAccessFlag	Om du vill begränsa utgående nätverksåtkomst eller inte. Värdet är valfritt, men om det skickas in måste det vara "Aktiverat" eller "Inaktiverat"
properties.trustedExternalTenants		TrustedExternalTenant[]	Klustrets externa klienter.
properties.virtualClusterGraduationProperties		string	Examensegenskaper för virtuellt kluster
properties.virtualNetworkConfiguration		VirtualNetworkConfiguration	Definition av virtuellt nätverk.
tags		object	Resurstaggar.
zones		string[]	Tillgänglighetszonerna för klustret.

Svar

Name	Typ	Description
200 OK	Cluster	Klustret har uppdaterats.
201 Created	Cluster	Klustret har skapats.
Other Status Codes	ErrorResponse	Felsvar som beskriver varför åtgärden misslyckades.

Exempel

KustoClustersCreateOrUpdate

Exempelbegäran

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

Exempelsvar

Statuskod:

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

Statuskod:

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

Definitioner

Name	Description
AcceptedAudiences	Representerar en godkänd målgrupp som är betrodd av klustret.
AzureSku	Azure SKU-definition.
AzureSkuName	SKU-namn.
AzureSkuTier	SKU-nivå.
CalloutPolicy	Konfiguration för externa pratbubblans principer, inklusive URI-mönster, åtkomsttyper och tjänsttyper.
calloutType	Typ av pratbubblan, som anger vilken typ av extern resurs eller tjänst som används.
Cluster	Klass som representerar ett Kusto-kluster.
ClusterNetworkAccessFlag	Om du vill begränsa utgående nätverksåtkomst eller inte. Värdet är valfritt, men om det skickas in måste det vara "Aktiverat" eller "Inaktiverat"
createdByType	Den typ av identitet som skapade resursen.
EngineType	Motortypen
ErrorAdditionalInfo	Ytterligare information om resurshanteringsfelet.
ErrorDetail	Felinformationen.
ErrorResponse	Felsvar
Identity	Identitet för resursen.
IdentityType	Den typ av hanterad identitet som används. Typen "SystemAssigned, UserAssigned" innehåller både en implicit skapad identitet och en uppsättning användartilldelade identiteter. Typen "Ingen" tar bort alla identiteter.
KeyVaultProperties	Egenskaper för nyckelvalvet.
LanguageExtension	Språktilläggsobjektet.
languageExtensionImageName	Avbildningsnamnet för språktillägget.
languageExtensionName	Namnet på språktillägget.
LanguageExtensionsList	Listan över språktilläggsobjekt.
MigrationClusterProperties	Representerar en egenskap för ett kluster som ingår i en migrering.
MigrationClusterRole	Klustrets roll i migreringsprocessen.
OptimizedAutoscale	En klass som innehåller den optimerade definitionen för automatisk skalning.
outboundAccess	Anger om utgående åtkomst tillåts för det angivna URI-mönstret.
PrivateEndpointConnection	En privat slutpunktsanslutning
PrivateEndpointProperty	Privat slutpunkt som anslutningen tillhör.
PrivateLinkServiceConnectionStateProperty	Anslutningstillstånd för den privata slutpunktsanslutningen.
ProvisioningState	Resursens etablerade tillstånd.
publicIPType	Anger vilken offentlig IP-typ som ska skapas – IPv4 (standard) eller DualStack (både IPv4 och IPv6)
PublicNetworkAccess	Offentlig nätverksåtkomst till klustret är aktiverad som standard. När det är inaktiverat tillåts endast privat slutpunktsanslutning till klustret
State	Resursens tillstånd.
systemData	Metadata som rör skapande och senaste ändring av resursen.
TrustedExternalTenant	Representerar ett klientorganisations-ID som är betrott av klustret.
UserAssignedIdentities	Listan över användaridentiteter som är associerade med Kusto-klustret. Nyckelreferenserna för användaridentitetsordlistan är ARM-resurs-ID:er i formuläret: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}'.
VirtualNetworkConfiguration	En klass som innehåller definitionen för virtuellt nätverk.
VnetState	När det är aktiverat distribueras klustret till det konfigurerade undernätet. När det är inaktiverat tas det bort från undernätet.
ZoneStatus	Anger om klustret är zonindelad eller icke-zonindelad.

AcceptedAudiences

Representerar en godkänd målgrupp som är betrodd av klustret.

Name	Typ	Description
value	string	GUID eller giltig URL som representerar en godkänd målgrupp.

AzureSku

Azure SKU-definition.

Name	Typ	Description
capacity	integer	Antalet instanser av klustret.
name	AzureSkuName	SKU-namn.
tier	AzureSkuTier	SKU-nivå.

AzureSkuName

SKU-namn.

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

SKU-nivå.

Name	Typ	Description
Basic	string
Standard	string

CalloutPolicy

Konfiguration för externa pratbubblans principer, inklusive URI-mönster, åtkomsttyper och tjänsttyper.

Name	Typ	Description
calloutId	string	Unik identifierare för pratbubblans konfiguration.
calloutType	calloutType	Typ av pratbubblan, som anger vilken typ av extern resurs eller tjänst som används.
calloutUriRegex	string	Reguljärt uttryck eller FQDN-mönster för pratbubblans URI.
outboundAccess	outboundAccess	Anger om utgående åtkomst tillåts för det angivna URI-mönstret.

calloutType

Typ av pratbubblan, som anger vilken typ av extern resurs eller tjänst som används.

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

Klass som representerar ett Kusto-kluster.

Name	Typ	Standardvärde	Description
etag	string		En unik skrivskyddad sträng som ändras när resursen uppdateras.
id	string		Fullständigt kvalificerat resurs-ID för resursen. Ex – /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}
identity	Identity		Klustrets identitet, om den är konfigurerad.
location	string		Den geo-plats där resursen finns
name	string		Namnet på resursen
properties.acceptedAudiences	AcceptedAudiences[]		Klustrets godkända målgrupper.
properties.allowedFqdnList	string[]		Lista över tillåtna FQDN(fullständigt domännamn) för utgående från kluster.
properties.allowedIpRangeList	string[]		Listan över ip-adresser i formatet CIDR som tillåts ansluta till klustret.
properties.calloutPolicies	CalloutPolicy[]		Lista över pratbubblade principer för utgående trafik från kluster.
properties.dataIngestionUri	string		URI för klusterdatainmatning.
properties.enableAutoStop	boolean	True	Ett booleskt värde som anger om klustret kan stoppas automatiskt (på grund av brist på data eller ingen aktivitet under många dagar).
properties.enableDiskEncryption	boolean	False	Ett booleskt värde som anger om klustrets diskar är krypterade.
properties.enableDoubleEncryption	boolean	False	Ett booleskt värde som anger om dubbel kryptering är aktiverat.
properties.enablePurge	boolean	False	Ett booleskt värde som anger om rensningsåtgärderna är aktiverade.
properties.enableStreamingIngest	boolean	False	Ett booleskt värde som anger om den strömmande inmatningen är aktiverad.
properties.engineType	EngineType	V3	Motortypen
properties.keyVaultProperties	KeyVaultProperties		KeyVault-egenskaper för klusterkryptering.
properties.languageExtensions	LanguageExtensionsList		Lista över klustrets språktillägg.
properties.migrationCluster	MigrationClusterProperties		Egenskaper för peer-klustret som ingår i en migrering till/från det här klustret.
properties.optimizedAutoscale	OptimizedAutoscale		Optimerad automatisk skalningsdefinition.
properties.privateEndpointConnections	PrivateEndpointConnection[]		En lista över privata slutpunktsanslutningar.
properties.provisioningState	ProvisioningState		Resursens etablerade tillstånd.
properties.publicIPType	publicIPType	IPv4	Anger vilken offentlig IP-typ som ska skapas – IPv4 (standard) eller DualStack (både IPv4 och IPv6)
properties.publicNetworkAccess	PublicNetworkAccess	Enabled	Offentlig nätverksåtkomst till klustret är aktiverad som standard. När det är inaktiverat tillåts endast privat slutpunktsanslutning till klustret
properties.restrictOutboundNetworkAccess	ClusterNetworkAccessFlag	Disabled	Om du vill begränsa utgående nätverksåtkomst eller inte. Värdet är valfritt, men om det skickas in måste det vara "Aktiverat" eller "Inaktiverat"
properties.state	State		Resursens tillstånd.
properties.stateReason	string		Orsaken till klustrets aktuella tillstånd.
properties.trustedExternalTenants	TrustedExternalTenant[]		Klustrets externa klienter.
properties.uri	string		Klustrets URI.
properties.virtualClusterGraduationProperties	string		Examensegenskaper för virtuellt kluster
properties.virtualNetworkConfiguration	VirtualNetworkConfiguration		Definition av virtuellt nätverk.
properties.zoneStatus	ZoneStatus		Anger om klustret är zonindelad eller icke-zonindelad.
sku	AzureSku		SKU:n för klustret.
systemData	systemData		Metadata som rör skapande och senaste ändring av resursen.
tags	object		Resurstaggar.
type	string		Resurstypen. Till exempel "Microsoft.Compute/virtualMachines" eller "Microsoft.Storage/storageAccounts"
zones	string[]		Tillgänglighetszonerna för klustret.

ClusterNetworkAccessFlag

Om du vill begränsa utgående nätverksåtkomst eller inte. Värdet är valfritt, men om det skickas in måste det vara "Aktiverat" eller "Inaktiverat"

Name	Typ	Description
Disabled	string
Enabled	string

createdByType

Den typ av identitet som skapade resursen.

Name	Typ	Description
Application	string
Key	string
ManagedIdentity	string
User	string

EngineType

Motortypen

Name	Typ	Description
V2	string
V3	string

ErrorAdditionalInfo

Ytterligare information om resurshanteringsfelet.

Name	Typ	Description
info	object	Ytterligare information.
type	string	Ytterligare informationstyp.

ErrorDetail

Felinformationen.

Name	Typ	Description
additionalInfo	ErrorAdditionalInfo[]	Ytterligare information om felet.
code	string	Felkoden.
details	ErrorDetail[]	Felinformationen.
message	string	Felmeddelandet.
target	string	Felmålet.

ErrorResponse

Felsvar

Name	Typ	Description
error	ErrorDetail	Felobjektet.

Identity

Identitet för resursen.

Name	Typ	Description
principalId	string	Huvud-ID för resursidentitet.
tenantId	string	Resursens klientorganisations-ID.
type	IdentityType	Den typ av hanterad identitet som används. Typen "SystemAssigned, UserAssigned" innehåller både en implicit skapad identitet och en uppsättning användartilldelade identiteter. Typen "Ingen" tar bort alla identiteter.
userAssignedIdentities	UserAssignedIdentities	Listan över användaridentiteter som är associerade med Kusto-klustret. Nyckelreferenserna för användaridentitetsordlistan är ARM-resurs-ID:er i formuläret: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}'.

IdentityType

Den typ av hanterad identitet som används. Typen "SystemAssigned, UserAssigned" innehåller både en implicit skapad identitet och en uppsättning användartilldelade identiteter. Typen "Ingen" tar bort alla identiteter.

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

KeyVaultProperties

Egenskaper för nyckelvalvet.

Name	Typ	Description
keyName	string	Namnet på nyckelvalvnyckeln.
keyVaultUri	string	Uri för nyckelvalvet.
keyVersion	string	Versionen av nyckelvalvnyckeln.
userIdentity	string	Den användartilldelade identiteten (ARM-resurs-ID) som har åtkomst till nyckeln.

LanguageExtension

Språktilläggsobjektet.

Name	Typ	Description
languageExtensionCustomImageName	string	Namnet på den anpassade avbildningen för språktillägget.
languageExtensionImageName	languageExtensionImageName	Avbildningsnamnet för språktillägget.
languageExtensionName	languageExtensionName	Namnet på språktillägget.

languageExtensionImageName

Avbildningsnamnet för språktillägget.

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

Namnet på språktillägget.

Name	Typ	Description
PYTHON	string
R	string

LanguageExtensionsList

Listan över språktilläggsobjekt.

Name	Typ	Description
value	LanguageExtension[]	Listan över språktillägg.

MigrationClusterProperties

Representerar en egenskap för ett kluster som ingår i en migrering.

Name	Typ	Description
dataIngestionUri	string	Den offentliga datainmatnings-URL:en för klustret.
id	string	Klustrets resurs-ID.
role	MigrationClusterRole	Klustrets roll i migreringsprocessen.
uri	string	Klustrets offentliga URL.

MigrationClusterRole

Klustrets roll i migreringsprocessen.

Name	Typ	Description
Destination	string
Source	string

OptimizedAutoscale

En klass som innehåller den optimerade definitionen för automatisk skalning.

Name	Typ	Description
isEnabled	boolean	Ett booleskt värde som anger om funktionen för optimerad autoskalning är aktiverad eller inte.
maximum	integer	Maximalt antal tillåtna instanser.
minimum	integer	Minsta antal tillåtna instanser.
version	integer	Den version av mallen som definierats, till exempel 1.

outboundAccess

Anger om utgående åtkomst tillåts för det angivna URI-mönstret.

Name	Typ	Description
Allow	string
Deny	string

PrivateEndpointConnection

En privat slutpunktsanslutning

Name	Typ	Description
id	string	Fullständigt kvalificerat resurs-ID för resursen. Ex – /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}
name	string	Namnet på resursen
properties.groupId	string	Grupp-ID för den privata slutpunkten.
properties.privateEndpoint	PrivateEndpointProperty	Privat slutpunkt som anslutningen tillhör.
properties.privateLinkServiceConnectionState	PrivateLinkServiceConnectionStateProperty	Anslutningstillstånd för den privata slutpunktsanslutningen.
properties.provisioningState	string	Etableringstillstånd för den privata slutpunkten.
systemData	systemData	Metadata som rör skapande och senaste ändring av resursen.
type	string	Resurstypen. Till exempel "Microsoft.Compute/virtualMachines" eller "Microsoft.Storage/storageAccounts"

PrivateEndpointProperty

Privat slutpunkt som anslutningen tillhör.

Name	Typ	Description
id	string	Resurs-ID för den privata slutpunkten.

PrivateLinkServiceConnectionStateProperty

Anslutningstillstånd för den privata slutpunktsanslutningen.

Name	Typ	Description
actionsRequired	string	Alla åtgärder som krävs utöver grundläggande arbetsflöde (godkänna/avvisa/koppla från)
description	string	Beskrivning av tjänstanslutningen för privat länk.
status	string	Anslutningsstatus för tjänsten private link.

ProvisioningState

Resursens etablerade tillstånd.

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

publicIPType

Anger vilken offentlig IP-typ som ska skapas – IPv4 (standard) eller DualStack (både IPv4 och IPv6)

Name	Typ	Description
DualStack	string
IPv4	string

PublicNetworkAccess

Offentlig nätverksåtkomst till klustret är aktiverad som standard. När det är inaktiverat tillåts endast privat slutpunktsanslutning till klustret

Name	Typ	Description
Disabled	string
Enabled	string

State

Resursens tillstånd.

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 som rör skapande och senaste ändring av resursen.

Name	Typ	Description
createdAt	string	Tidsstämpeln för resursskapande (UTC).
createdBy	string	Identiteten som skapade resursen.
createdByType	createdByType	Den typ av identitet som skapade resursen.
lastModifiedAt	string	Tidsstämpeln för resursens senaste ändring (UTC)
lastModifiedBy	string	Identiteten som senast ändrade resursen.
lastModifiedByType	createdByType	Den typ av identitet som senast ändrade resursen.

TrustedExternalTenant

Representerar ett klientorganisations-ID som är betrott av klustret.

Name	Typ	Description
value	string	GUID som representerar en extern klientorganisation.

UserAssignedIdentities

Listan över användaridentiteter som är associerade med Kusto-klustret. Nyckelreferenserna för användaridentitetsordlistan är ARM-resurs-ID:er i formuläret: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}'.

Name	Typ	Description

VirtualNetworkConfiguration

En klass som innehåller definitionen för virtuellt nätverk.

Name	Typ	Standardvärde	Description
dataManagementPublicIpId	string		Resurs-ID för datahanteringstjänstens offentliga IP-adress.
enginePublicIpId	string		Motortjänstens offentliga IP-adressresurs-ID.
state	VnetState	Enabled	När det är aktiverat distribueras klustret till det konfigurerade undernätet. När det är inaktiverat tas det bort från undernätet.
subnetId	string		Resurs-ID för undernätet.

VnetState

När det är aktiverat distribueras klustret till det konfigurerade undernätet. När det är inaktiverat tas det bort från undernätet.

Name	Typ	Description
Disabled	string
Enabled	string

ZoneStatus

Anger om klustret är zonindelad eller icke-zonindelad.

Name	Typ	Description
NonZonal	string
Zonal	string
ZonalInconsistency	string