Clusters - Create Or Update

服務:: Azure Kusto

API 版本:: 2025-02-14

建立或更新 Kusto 叢集。

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

URI 參數

名稱	位於	必要	類型	Description
clusterName	path	True	string pattern: ^.*$	Kusto 叢集的名稱。
resourceGroupName	path	True	string minLength: 1 maxLength: 90	資源群組的名稱。名稱不區分大小寫。
subscriptionId	path	True	string minLength: 1	目標訂用帳戶的標識碼。
api-version	query	True	string minLength: 1	用於此作業的 API 版本。

要求標頭

名稱	必要	類型	Description
If-Match		string	叢集的 ETag。省略此值，一律覆寫目前的叢集。指定最後看到的 ETag 值，以防止意外覆寫並行變更。
If-None-Match		string	設定為『*』以允許建立新的叢集，但為了避免更新現有的叢集。其他值會導致 412 前置條件失敗的回應。

要求本文

名稱	必要	類型	Description
location	True	string	資源所在的地理位置
sku	True	AzureSku	叢集的 SKU。
identity		Identity	如果已設定，則為叢集的身分識別。
properties.acceptedAudiences		AcceptedAudiences[]	叢集接受的物件。
properties.allowedFqdnList		string[]	來自叢集輸出的允許 FQDN（完整功能變數名稱）清單。
properties.allowedIpRangeList		string[]	允許連線到叢集之 CIDR 格式的IP清單。
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	是否要限制輸出網路存取。值為選擇性值，但如果傳入，則必須是 'Enabled' 或 'Disabled'
properties.trustedExternalTenants		TrustedExternalTenant[]	叢集的外部租使用者。
properties.virtualClusterGraduationProperties		string (password)	虛擬叢集畢業屬性
properties.virtualNetworkConfiguration		VirtualNetworkConfiguration	虛擬網路定義。
tags		object	資源標籤。
zones		string[]	可用性區域。

回應

名稱	類型	Description
200 OK	Cluster	資源 'Cluster' 更新作業成功
201 Created	Cluster	資源 'Cluster' 建立作業成功標題 Location: string Retry-After: integer
Other Status Codes	ErrorResponse	未預期的錯誤回應。

名稱

類型

Description

200 OK

Cluster

資源 'Cluster' 更新作業成功

201 Created

Cluster

資源 'Cluster' 建立作業成功

標題

Location: string
Retry-After: integer

Other Status Codes

ErrorResponse

未預期的錯誤回應。

安全性

azure_auth

Azure Active Directory OAuth2 Flow。

類型: oauth2
Flow: implicit
授權 URL: https://login.microsoftonline.com/common/oauth2/authorize

範圍

名稱	Description
user_impersonation	模擬您的用戶帳戶

範例

KustoClusterCreateWithCMKFederatedIdentity

KustoClusterCreateWithCMKUserAssignedIdentity

KustoClustersCreateOrUpdate

KustoClusterCreateWithCMKFederatedIdentity

範例要求

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

{
  "location": "westus",
  "sku": {
    "name": "Standard_L16as_v3",
    "capacity": 2,
    "tier": "Standard"
  },
  "identity": {
    "type": "UserAssigned",
    "userAssignedIdentities": {
      "/subscriptions/12345678-1234-1234-1234-123456789098/resourceGroups/kustoRgTest/providers/Microsoft.ManagedIdentity/userAssignedIdentities/kustoClusterIdentity": {}
    }
  },
  "properties": {
    "enableStreamingIngest": true,
    "enablePurge": true,
    "enableDoubleEncryption": false,
    "enableAutoStop": true,
    "publicIPType": "IPv4",
    "publicNetworkAccess": "Enabled",
    "restrictOutboundNetworkAccess": "Disabled",
    "keyVaultProperties": {
      "keyVaultUri": "https://myvault.vault.azure.net",
      "keyName": "myClusterCMKKey",
      "keyVersion": "12345678-1234-1234-1234-123456789098",
      "userIdentity": "/subscriptions/12345678-1234-1234-1234-123456789098/resourceGroups/kustoRgTest/providers/Microsoft.ManagedIdentity/userAssignedIdentities/kustoClusterIdentity",
      "federatedIdentityClientId": "11111111-2222-3333-4444-555555555555"
    },
    "engineType": "V3"
  }
}

from azure.identity import DefaultAzureCredential

from azure.mgmt.kusto import KustoManagementClient

"""
# PREREQUISITES
    pip install azure-identity
    pip install azure-mgmt-kusto
# USAGE
    python kusto_cluster_create_with_cmk_federated_identity.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="SUBSCRIPTION_ID",
    )

    response = client.clusters.begin_create_or_update(
        resource_group_name="kustoRgTest",
        cluster_name="kustoClusterCMK",
        parameters={
            "identity": {
                "type": "UserAssigned",
                "userAssignedIdentities": {
                    "/subscriptions/12345678-1234-1234-1234-123456789098/resourceGroups/kustoRgTest/providers/Microsoft.ManagedIdentity/userAssignedIdentities/kustoClusterIdentity": {}
                },
            },
            "location": "westus",
            "properties": {
                "enableAutoStop": True,
                "enableDoubleEncryption": False,
                "enablePurge": True,
                "enableStreamingIngest": True,
                "engineType": "V3",
                "keyVaultProperties": {
                    "federatedIdentityClientId": "11111111-2222-3333-4444-555555555555",
                    "keyName": "myClusterCMKKey",
                    "keyVaultUri": "https://myvault.vault.azure.net",
                    "keyVersion": "12345678-1234-1234-1234-123456789098",
                    "userIdentity": "/subscriptions/12345678-1234-1234-1234-123456789098/resourceGroups/kustoRgTest/providers/Microsoft.ManagedIdentity/userAssignedIdentities/kustoClusterIdentity",
                },
                "publicIPType": "IPv4",
                "publicNetworkAccess": "Enabled",
                "restrictOutboundNetworkAccess": "Disabled",
            },
            "sku": {"capacity": 2, "name": "Standard_L16as_v3", "tier": "Standard"},
        },
    ).result()
    print(response)


# x-ms-original-file: 2025-02-14/KustoClusterCreateWithCMKFederatedIdentity.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

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: 2025-02-14/KustoClusterCreateWithCMKFederatedIdentity.json
func ExampleClustersClient_BeginCreateOrUpdate_kustoClusterCreateWithCmkFederatedIdentity() {
	cred, err := azidentity.NewDefaultAzureCredential(nil)
	if err != nil {
		log.Fatalf("failed to obtain a credential: %v", err)
	}
	ctx := context.Background()
	clientFactory, err := armkusto.NewClientFactory("12345678-1234-1234-1234-123456789098", cred, nil)
	if err != nil {
		log.Fatalf("failed to create client: %v", err)
	}
	poller, err := clientFactory.NewClustersClient().BeginCreateOrUpdate(ctx, "kustoRgTest", "kustoClusterCMK", armkusto.Cluster{
		Location: to.Ptr("westus"),
		SKU: &armkusto.AzureSKU{
			Name:     to.Ptr(armkusto.AzureSKUNameStandardL16AsV3),
			Capacity: to.Ptr[int32](2),
			Tier:     to.Ptr(armkusto.AzureSKUTierStandard),
		},
		Identity: &armkusto.Identity{
			Type: to.Ptr(armkusto.IdentityTypeUserAssigned),
			UserAssignedIdentities: map[string]*armkusto.ComponentsSgqdofSchemasIdentityPropertiesUserassignedidentitiesAdditionalproperties{
				"/subscriptions/12345678-1234-1234-1234-123456789098/resourceGroups/kustoRgTest/providers/Microsoft.ManagedIdentity/userAssignedIdentities/kustoClusterIdentity": {},
			},
		},
		Properties: &armkusto.ClusterProperties{
			EnableStreamingIngest:         to.Ptr(true),
			EnablePurge:                   to.Ptr(true),
			EnableDoubleEncryption:        to.Ptr(false),
			EnableAutoStop:                to.Ptr(true),
			PublicIPType:                  to.Ptr(armkusto.PublicIPTypeIPv4),
			PublicNetworkAccess:           to.Ptr(armkusto.PublicNetworkAccessEnabled),
			RestrictOutboundNetworkAccess: to.Ptr(armkusto.ClusterNetworkAccessFlagDisabled),
			KeyVaultProperties: &armkusto.KeyVaultProperties{
				KeyVaultURI:               to.Ptr("https://myvault.vault.azure.net"),
				KeyName:                   to.Ptr("myClusterCMKKey"),
				KeyVersion:                to.Ptr("12345678-1234-1234-1234-123456789098"),
				UserIdentity:              to.Ptr("/subscriptions/12345678-1234-1234-1234-123456789098/resourceGroups/kustoRgTest/providers/Microsoft.ManagedIdentity/userAssignedIdentities/kustoClusterIdentity"),
				FederatedIdentityClientID: to.Ptr("11111111-2222-3333-4444-555555555555"),
			},
			EngineType: to.Ptr(armkusto.EngineTypeV3),
		},
	}, 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 poll 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 = armkusto.ClustersClientCreateOrUpdateResponse{
	// 	Cluster: armkusto.Cluster{
	// 		ID: to.Ptr("/subscriptions/12345678-1234-1234-1234-123456789098/resourceGroups/kustoRgTest/providers/Microsoft.Kusto/Clusters/kustoClusterCMK"),
	// 		Name: to.Ptr("kustoClusterCMK"),
	// 		Type: to.Ptr("Microsoft.Kusto/Clusters"),
	// 		Location: to.Ptr("westus"),
	// 		Properties: &armkusto.ClusterProperties{
	// 			ProvisioningState: to.Ptr(armkusto.ProvisioningStateSucceeded),
	// 			EnableDiskEncryption: to.Ptr(false),
	// 			EnableStreamingIngest: to.Ptr(true),
	// 			EnablePurge: to.Ptr(true),
	// 			EnableDoubleEncryption: to.Ptr(false),
	// 			EnableAutoStop: to.Ptr(true),
	// 			PublicIPType: to.Ptr(armkusto.PublicIPTypeIPv4),
	// 			PublicNetworkAccess: to.Ptr(armkusto.PublicNetworkAccessEnabled),
	// 			RestrictOutboundNetworkAccess: to.Ptr(armkusto.ClusterNetworkAccessFlagDisabled),
	// 			KeyVaultProperties: &armkusto.KeyVaultProperties{
	// 				KeyVaultURI: to.Ptr("https://myvault.vault.azure.net"),
	// 				KeyName: to.Ptr("myClusterCMKKey"),
	// 				KeyVersion: to.Ptr("12345678-1234-1234-1234-123456789098"),
	// 				UserIdentity: to.Ptr("/subscriptions/12345678-1234-1234-1234-123456789098/resourceGroups/kustoRgTest/providers/Microsoft.ManagedIdentity/userAssignedIdentities/kustoClusterIdentity"),
	// 				FederatedIdentityClientID: to.Ptr("11111111-2222-3333-4444-555555555555"),
	// 			},
	// 			EngineType: to.Ptr(armkusto.EngineTypeV3),
	// 		},
	// 		SKU: &armkusto.AzureSKU{
	// 			Name: to.Ptr(armkusto.AzureSKUNameStandardL16AsV3),
	// 			Tier: to.Ptr(armkusto.AzureSKUTierStandard),
	// 			Capacity: to.Ptr[int32](2),
	// 		},
	// 		Identity: &armkusto.Identity{
	// 			Type: to.Ptr(armkusto.IdentityTypeUserAssigned),
	// 			UserAssignedIdentities: map[string]*armkusto.ComponentsSgqdofSchemasIdentityPropertiesUserassignedidentitiesAdditionalproperties{
	// 				"/subscriptions/12345678-1234-1234-1234-123456789098/resourceGroups/kustoRgTest/providers/Microsoft.ManagedIdentity/userAssignedIdentities/kustoClusterIdentity": &armkusto.ComponentsSgqdofSchemasIdentityPropertiesUserassignedidentitiesAdditionalproperties{
	// 					ClientID: to.Ptr("11111111-2222-3333-4444-555555555555"),
	// 					PrincipalID: to.Ptr("66666666-7777-8888-9999-000000000000"),
	// 				},
	// 			},
	// 		},
	// 		Etag: to.Ptr("abcd1234"),
	// 	},
	// }
}

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

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

/**
 * This sample demonstrates how to create or update a Kusto cluster.
 *
 * @summary create or update a Kusto cluster.
 * x-ms-original-file: 2025-02-14/KustoClusterCreateWithCMKFederatedIdentity.json
 */
async function kustoClusterCreateWithCMKFederatedIdentity() {
  const credential = new DefaultAzureCredential();
  const subscriptionId = "12345678-1234-1234-1234-123456789098";
  const client = new KustoManagementClient(credential, subscriptionId);
  const result = await client.clusters.createOrUpdate("kustoRgTest", "kustoClusterCMK", {
    location: "westus",
    sku: { name: "Standard_L16as_v3", capacity: 2, tier: "Standard" },
    identity: {
      type: "UserAssigned",
      userAssignedIdentities: {
        "/subscriptions/12345678-1234-1234-1234-123456789098/resourceGroups/kustoRgTest/providers/Microsoft.ManagedIdentity/userAssignedIdentities/kustoClusterIdentity":
          {},
      },
    },
    enableStreamingIngest: true,
    enablePurge: true,
    enableDoubleEncryption: false,
    enableAutoStop: true,
    publicIPType: "IPv4",
    publicNetworkAccess: "Enabled",
    restrictOutboundNetworkAccess: "Disabled",
    keyVaultProperties: {
      keyVaultUri: "https://myvault.vault.azure.net",
      keyName: "myClusterCMKKey",
      keyVersion: "12345678-1234-1234-1234-123456789098",
      userIdentity:
        "/subscriptions/12345678-1234-1234-1234-123456789098/resourceGroups/kustoRgTest/providers/Microsoft.ManagedIdentity/userAssignedIdentities/kustoClusterIdentity",
      federatedIdentityClientId: "11111111-2222-3333-4444-555555555555",
    },
    engineType: "V3",
  });
  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

範例回覆

狀態碼:: 200

{
  "id": "/subscriptions/12345678-1234-1234-1234-123456789098/resourceGroups/kustoRgTest/providers/Microsoft.Kusto/Clusters/kustoClusterCMK",
  "name": "kustoClusterCMK",
  "type": "Microsoft.Kusto/Clusters",
  "location": "westus",
  "properties": {
    "provisioningState": "Succeeded",
    "enableDiskEncryption": false,
    "enableStreamingIngest": true,
    "enablePurge": true,
    "enableDoubleEncryption": false,
    "enableAutoStop": true,
    "publicIPType": "IPv4",
    "publicNetworkAccess": "Enabled",
    "restrictOutboundNetworkAccess": "Disabled",
    "keyVaultProperties": {
      "keyVaultUri": "https://myvault.vault.azure.net",
      "keyName": "myClusterCMKKey",
      "keyVersion": "12345678-1234-1234-1234-123456789098",
      "userIdentity": "/subscriptions/12345678-1234-1234-1234-123456789098/resourceGroups/kustoRgTest/providers/Microsoft.ManagedIdentity/userAssignedIdentities/kustoClusterIdentity",
      "federatedIdentityClientId": "11111111-2222-3333-4444-555555555555"
    },
    "engineType": "V3"
  },
  "sku": {
    "name": "Standard_L16as_v3",
    "tier": "Standard",
    "capacity": 2
  },
  "identity": {
    "type": "UserAssigned",
    "userAssignedIdentities": {
      "/subscriptions/12345678-1234-1234-1234-123456789098/resourceGroups/kustoRgTest/providers/Microsoft.ManagedIdentity/userAssignedIdentities/kustoClusterIdentity": {
        "clientId": "11111111-2222-3333-4444-555555555555",
        "principalId": "66666666-7777-8888-9999-000000000000"
      }
    }
  },
  "etag": "abcd1234"
}

狀態碼:: 201

Azure-AsyncOperation: https://management.azure.com/subscriptions/12345678-1234-1234-1234-123456789098/providers/Microsoft.Kusto/locations/westus/operationResults/742bef43-608b-4b58-ba96-6f7a32ec5f0f?api-version=2025-02-14

{
  "id": "/subscriptions/12345678-1234-1234-1234-123456789098/resourceGroups/kustoRgTest/providers/Microsoft.Kusto/Clusters/kustoClusterCMK",
  "name": "kustoClusterCMK",
  "type": "Microsoft.Kusto/Clusters",
  "location": "westus",
  "properties": {
    "provisioningState": "Running",
    "enableDiskEncryption": false,
    "enableStreamingIngest": true,
    "enablePurge": true,
    "enableDoubleEncryption": false,
    "enableAutoStop": true,
    "publicIPType": "IPv4",
    "publicNetworkAccess": "Enabled",
    "restrictOutboundNetworkAccess": "Disabled",
    "keyVaultProperties": {
      "keyVaultUri": "https://myvault.vault.azure.net",
      "keyName": "myClusterCMKKey",
      "keyVersion": "12345678-1234-1234-1234-123456789098",
      "userIdentity": "/subscriptions/12345678-1234-1234-1234-123456789098/resourceGroups/kustoRgTest/providers/Microsoft.ManagedIdentity/userAssignedIdentities/kustoClusterIdentity",
      "federatedIdentityClientId": "11111111-2222-3333-4444-555555555555"
    },
    "engineType": "V3"
  },
  "sku": {
    "name": "Standard_L16as_v3",
    "tier": "Standard",
    "capacity": 2
  },
  "identity": {
    "type": "UserAssigned",
    "userAssignedIdentities": {
      "/subscriptions/12345678-1234-1234-1234-123456789098/resourceGroups/kustoRgTest/providers/Microsoft.ManagedIdentity/userAssignedIdentities/kustoClusterIdentity": {
        "clientId": "11111111-2222-3333-4444-555555555555",
        "principalId": "66666666-7777-8888-9999-000000000000"
      }
    }
  },
  "etag": "abcd1234"
}

KustoClusterCreateWithCMKUserAssignedIdentity

範例要求

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

{
  "location": "westus",
  "sku": {
    "name": "Standard_L16as_v3",
    "capacity": 2,
    "tier": "Standard"
  },
  "identity": {
    "type": "UserAssigned",
    "userAssignedIdentities": {
      "/subscriptions/12345678-1234-1234-1234-123456789098/resourceGroups/kustoRgTest/providers/Microsoft.ManagedIdentity/userAssignedIdentities/kustoClusterIdentity": {}
    }
  },
  "properties": {
    "enableStreamingIngest": true,
    "enablePurge": true,
    "enableDoubleEncryption": false,
    "enableAutoStop": true,
    "publicIPType": "IPv4",
    "publicNetworkAccess": "Enabled",
    "restrictOutboundNetworkAccess": "Disabled",
    "keyVaultProperties": {
      "keyVaultUri": "https://myvault.vault.azure.net",
      "keyName": "myClusterCMKKey",
      "keyVersion": "12345678-1234-1234-1234-123456789098",
      "userIdentity": "/subscriptions/12345678-1234-1234-1234-123456789098/resourceGroups/kustoRgTest/providers/Microsoft.ManagedIdentity/userAssignedIdentities/kustoClusterIdentity"
    },
    "engineType": "V3"
  }
}

from azure.identity import DefaultAzureCredential

from azure.mgmt.kusto import KustoManagementClient

"""
# PREREQUISITES
    pip install azure-identity
    pip install azure-mgmt-kusto
# USAGE
    python kusto_cluster_create_with_cmk_user_assigned_identity.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="SUBSCRIPTION_ID",
    )

    response = client.clusters.begin_create_or_update(
        resource_group_name="kustoRgTest",
        cluster_name="kustoClusterCMK",
        parameters={
            "identity": {
                "type": "UserAssigned",
                "userAssignedIdentities": {
                    "/subscriptions/12345678-1234-1234-1234-123456789098/resourceGroups/kustoRgTest/providers/Microsoft.ManagedIdentity/userAssignedIdentities/kustoClusterIdentity": {}
                },
            },
            "location": "westus",
            "properties": {
                "enableAutoStop": True,
                "enableDoubleEncryption": False,
                "enablePurge": True,
                "enableStreamingIngest": True,
                "engineType": "V3",
                "keyVaultProperties": {
                    "keyName": "myClusterCMKKey",
                    "keyVaultUri": "https://myvault.vault.azure.net",
                    "keyVersion": "12345678-1234-1234-1234-123456789098",
                    "userIdentity": "/subscriptions/12345678-1234-1234-1234-123456789098/resourceGroups/kustoRgTest/providers/Microsoft.ManagedIdentity/userAssignedIdentities/kustoClusterIdentity",
                },
                "publicIPType": "IPv4",
                "publicNetworkAccess": "Enabled",
                "restrictOutboundNetworkAccess": "Disabled",
            },
            "sku": {"capacity": 2, "name": "Standard_L16as_v3", "tier": "Standard"},
        },
    ).result()
    print(response)


# x-ms-original-file: 2025-02-14/KustoClusterCreateWithCMKUserAssignedIdentity.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

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: 2025-02-14/KustoClusterCreateWithCMKUserAssignedIdentity.json
func ExampleClustersClient_BeginCreateOrUpdate_kustoClusterCreateWithCmkUserAssignedIdentity() {
	cred, err := azidentity.NewDefaultAzureCredential(nil)
	if err != nil {
		log.Fatalf("failed to obtain a credential: %v", err)
	}
	ctx := context.Background()
	clientFactory, err := armkusto.NewClientFactory("12345678-1234-1234-1234-123456789098", cred, nil)
	if err != nil {
		log.Fatalf("failed to create client: %v", err)
	}
	poller, err := clientFactory.NewClustersClient().BeginCreateOrUpdate(ctx, "kustoRgTest", "kustoClusterCMK", armkusto.Cluster{
		Location: to.Ptr("westus"),
		SKU: &armkusto.AzureSKU{
			Name:     to.Ptr(armkusto.AzureSKUNameStandardL16AsV3),
			Capacity: to.Ptr[int32](2),
			Tier:     to.Ptr(armkusto.AzureSKUTierStandard),
		},
		Identity: &armkusto.Identity{
			Type: to.Ptr(armkusto.IdentityTypeUserAssigned),
			UserAssignedIdentities: map[string]*armkusto.ComponentsSgqdofSchemasIdentityPropertiesUserassignedidentitiesAdditionalproperties{
				"/subscriptions/12345678-1234-1234-1234-123456789098/resourceGroups/kustoRgTest/providers/Microsoft.ManagedIdentity/userAssignedIdentities/kustoClusterIdentity": {},
			},
		},
		Properties: &armkusto.ClusterProperties{
			EnableStreamingIngest:         to.Ptr(true),
			EnablePurge:                   to.Ptr(true),
			EnableDoubleEncryption:        to.Ptr(false),
			EnableAutoStop:                to.Ptr(true),
			PublicIPType:                  to.Ptr(armkusto.PublicIPTypeIPv4),
			PublicNetworkAccess:           to.Ptr(armkusto.PublicNetworkAccessEnabled),
			RestrictOutboundNetworkAccess: to.Ptr(armkusto.ClusterNetworkAccessFlagDisabled),
			KeyVaultProperties: &armkusto.KeyVaultProperties{
				KeyVaultURI:  to.Ptr("https://myvault.vault.azure.net"),
				KeyName:      to.Ptr("myClusterCMKKey"),
				KeyVersion:   to.Ptr("12345678-1234-1234-1234-123456789098"),
				UserIdentity: to.Ptr("/subscriptions/12345678-1234-1234-1234-123456789098/resourceGroups/kustoRgTest/providers/Microsoft.ManagedIdentity/userAssignedIdentities/kustoClusterIdentity"),
			},
			EngineType: to.Ptr(armkusto.EngineTypeV3),
		},
	}, 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 poll 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 = armkusto.ClustersClientCreateOrUpdateResponse{
	// 	Cluster: armkusto.Cluster{
	// 		ID: to.Ptr("/subscriptions/12345678-1234-1234-1234-123456789098/resourceGroups/kustoRgTest/providers/Microsoft.Kusto/Clusters/kustoClusterCMK"),
	// 		Name: to.Ptr("kustoClusterCMK"),
	// 		Type: to.Ptr("Microsoft.Kusto/Clusters"),
	// 		Location: to.Ptr("westus"),
	// 		Properties: &armkusto.ClusterProperties{
	// 			ProvisioningState: to.Ptr(armkusto.ProvisioningStateSucceeded),
	// 			EnableDiskEncryption: to.Ptr(false),
	// 			EnableStreamingIngest: to.Ptr(true),
	// 			EnablePurge: to.Ptr(true),
	// 			EnableDoubleEncryption: to.Ptr(false),
	// 			EnableAutoStop: to.Ptr(true),
	// 			PublicIPType: to.Ptr(armkusto.PublicIPTypeIPv4),
	// 			PublicNetworkAccess: to.Ptr(armkusto.PublicNetworkAccessEnabled),
	// 			RestrictOutboundNetworkAccess: to.Ptr(armkusto.ClusterNetworkAccessFlagDisabled),
	// 			KeyVaultProperties: &armkusto.KeyVaultProperties{
	// 				KeyVaultURI: to.Ptr("https://myvault.vault.azure.net"),
	// 				KeyName: to.Ptr("myClusterCMKKey"),
	// 				KeyVersion: to.Ptr("12345678-1234-1234-1234-123456789098"),
	// 				UserIdentity: to.Ptr("/subscriptions/12345678-1234-1234-1234-123456789098/resourceGroups/kustoRgTest/providers/Microsoft.ManagedIdentity/userAssignedIdentities/kustoClusterIdentity"),
	// 			},
	// 			EngineType: to.Ptr(armkusto.EngineTypeV3),
	// 		},
	// 		SKU: &armkusto.AzureSKU{
	// 			Name: to.Ptr(armkusto.AzureSKUNameStandardL16AsV3),
	// 			Tier: to.Ptr(armkusto.AzureSKUTierStandard),
	// 			Capacity: to.Ptr[int32](2),
	// 		},
	// 		Identity: &armkusto.Identity{
	// 			Type: to.Ptr(armkusto.IdentityTypeUserAssigned),
	// 			UserAssignedIdentities: map[string]*armkusto.ComponentsSgqdofSchemasIdentityPropertiesUserassignedidentitiesAdditionalproperties{
	// 				"/subscriptions/12345678-1234-1234-1234-123456789098/resourceGroups/kustoRgTest/providers/Microsoft.ManagedIdentity/userAssignedIdentities/kustoClusterIdentity": &armkusto.ComponentsSgqdofSchemasIdentityPropertiesUserassignedidentitiesAdditionalproperties{
	// 					ClientID: to.Ptr("11111111-2222-3333-4444-555555555555"),
	// 					PrincipalID: to.Ptr("66666666-7777-8888-9999-000000000000"),
	// 				},
	// 			},
	// 		},
	// 		Etag: to.Ptr("abcd1234"),
	// 	},
	// }
}

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

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

/**
 * This sample demonstrates how to create or update a Kusto cluster.
 *
 * @summary create or update a Kusto cluster.
 * x-ms-original-file: 2025-02-14/KustoClusterCreateWithCMKUserAssignedIdentity.json
 */
async function kustoClusterCreateWithCMKUserAssignedIdentity() {
  const credential = new DefaultAzureCredential();
  const subscriptionId = "12345678-1234-1234-1234-123456789098";
  const client = new KustoManagementClient(credential, subscriptionId);
  const result = await client.clusters.createOrUpdate("kustoRgTest", "kustoClusterCMK", {
    location: "westus",
    sku: { name: "Standard_L16as_v3", capacity: 2, tier: "Standard" },
    identity: {
      type: "UserAssigned",
      userAssignedIdentities: {
        "/subscriptions/12345678-1234-1234-1234-123456789098/resourceGroups/kustoRgTest/providers/Microsoft.ManagedIdentity/userAssignedIdentities/kustoClusterIdentity":
          {},
      },
    },
    enableStreamingIngest: true,
    enablePurge: true,
    enableDoubleEncryption: false,
    enableAutoStop: true,
    publicIPType: "IPv4",
    publicNetworkAccess: "Enabled",
    restrictOutboundNetworkAccess: "Disabled",
    keyVaultProperties: {
      keyVaultUri: "https://myvault.vault.azure.net",
      keyName: "myClusterCMKKey",
      keyVersion: "12345678-1234-1234-1234-123456789098",
      userIdentity:
        "/subscriptions/12345678-1234-1234-1234-123456789098/resourceGroups/kustoRgTest/providers/Microsoft.ManagedIdentity/userAssignedIdentities/kustoClusterIdentity",
    },
    engineType: "V3",
  });
  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

範例回覆

狀態碼:: 200

{
  "id": "/subscriptions/12345678-1234-1234-1234-123456789098/resourceGroups/kustoRgTest/providers/Microsoft.Kusto/Clusters/kustoClusterCMK",
  "name": "kustoClusterCMK",
  "type": "Microsoft.Kusto/Clusters",
  "location": "westus",
  "properties": {
    "provisioningState": "Succeeded",
    "enableDiskEncryption": false,
    "enableStreamingIngest": true,
    "enablePurge": true,
    "enableDoubleEncryption": false,
    "enableAutoStop": true,
    "publicIPType": "IPv4",
    "publicNetworkAccess": "Enabled",
    "restrictOutboundNetworkAccess": "Disabled",
    "keyVaultProperties": {
      "keyVaultUri": "https://myvault.vault.azure.net",
      "keyName": "myClusterCMKKey",
      "keyVersion": "12345678-1234-1234-1234-123456789098",
      "userIdentity": "/subscriptions/12345678-1234-1234-1234-123456789098/resourceGroups/kustoRgTest/providers/Microsoft.ManagedIdentity/userAssignedIdentities/kustoClusterIdentity"
    },
    "engineType": "V3"
  },
  "sku": {
    "name": "Standard_L16as_v3",
    "tier": "Standard",
    "capacity": 2
  },
  "identity": {
    "type": "UserAssigned",
    "userAssignedIdentities": {
      "/subscriptions/12345678-1234-1234-1234-123456789098/resourceGroups/kustoRgTest/providers/Microsoft.ManagedIdentity/userAssignedIdentities/kustoClusterIdentity": {
        "clientId": "11111111-2222-3333-4444-555555555555",
        "principalId": "66666666-7777-8888-9999-000000000000"
      }
    }
  },
  "etag": "abcd1234"
}

狀態碼:: 201

Azure-AsyncOperation: https://management.azure.com/subscriptions/12345678-1234-1234-1234-123456789098/providers/Microsoft.Kusto/locations/westus/operationResults/742bef43-608b-4b58-ba96-6f7a32ec5f0f?api-version=2025-02-14

{
  "id": "/subscriptions/12345678-1234-1234-1234-123456789098/resourceGroups/kustoRgTest/providers/Microsoft.Kusto/Clusters/kustoClusterCMK",
  "name": "kustoClusterCMK",
  "type": "Microsoft.Kusto/Clusters",
  "location": "westus",
  "properties": {
    "provisioningState": "Running",
    "enableDiskEncryption": false,
    "enableStreamingIngest": true,
    "enablePurge": true,
    "enableDoubleEncryption": false,
    "enableAutoStop": true,
    "publicIPType": "IPv4",
    "publicNetworkAccess": "Enabled",
    "restrictOutboundNetworkAccess": "Disabled",
    "keyVaultProperties": {
      "keyVaultUri": "https://myvault.vault.azure.net",
      "keyName": "myClusterCMKKey",
      "keyVersion": "12345678-1234-1234-1234-123456789098",
      "userIdentity": "/subscriptions/12345678-1234-1234-1234-123456789098/resourceGroups/kustoRgTest/providers/Microsoft.ManagedIdentity/userAssignedIdentities/kustoClusterIdentity"
    },
    "engineType": "V3"
  },
  "sku": {
    "name": "Standard_L16as_v3",
    "tier": "Standard",
    "capacity": 2
  },
  "identity": {
    "type": "UserAssigned",
    "userAssignedIdentities": {
      "/subscriptions/12345678-1234-1234-1234-123456789098/resourceGroups/kustoRgTest/providers/Microsoft.ManagedIdentity/userAssignedIdentities/kustoClusterIdentity": {
        "clientId": "11111111-2222-3333-4444-555555555555",
        "principalId": "66666666-7777-8888-9999-000000000000"
      }
    }
  },
  "etag": "abcd1234"
}

KustoClustersCreateOrUpdate

範例要求

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

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

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="SUBSCRIPTION_ID",
    )

    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: 2025-02-14/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

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: 2025-02-14/KustoClustersCreateOrUpdate.json
func ExampleClustersClient_BeginCreateOrUpdate_kustoClustersCreateOrUpdate() {
	cred, err := azidentity.NewDefaultAzureCredential(nil)
	if err != nil {
		log.Fatalf("failed to obtain a credential: %v", err)
	}
	ctx := context.Background()
	clientFactory, err := armkusto.NewClientFactory("12345678-1234-1234-1234-123456789098", cred, nil)
	if err != nil {
		log.Fatalf("failed to create client: %v", err)
	}
	poller, err := clientFactory.NewClustersClient().BeginCreateOrUpdate(ctx, "kustorptest", "kustoCluster", armkusto.Cluster{
		Identity: &armkusto.Identity{
			Type: to.Ptr(armkusto.IdentityTypeSystemAssigned),
		},
		Location: to.Ptr("westus"),
		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),
		},
	}, 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 poll 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 = armkusto.ClustersClientCreateOrUpdateResponse{
	// 	Cluster: armkusto.Cluster{
	// 		Name: to.Ptr("kustoCluster"),
	// 		Type: to.Ptr("Microsoft.Kusto/Clusters"),
	// 		Etag: to.Ptr("abcd"),
	// 		ID: to.Ptr("/subscriptions/12345678-1234-1234-1234-123456789098/resourceGroups/kustorptest/providers/Microsoft.Kusto/Clusters/kustoCluster"),
	// 		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{
	// 			},
	// 		},
	// 		Location: to.Ptr("westus"),
	// 		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

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

/**
 * This sample demonstrates how to create or update a Kusto cluster.
 *
 * @summary create or update a Kusto cluster.
 * x-ms-original-file: 2025-02-14/KustoClustersCreateOrUpdate.json
 */
async function kustoClustersCreateOrUpdate() {
  const credential = new DefaultAzureCredential();
  const subscriptionId = "12345678-1234-1234-1234-123456789098";
  const client = new KustoManagementClient(credential, subscriptionId);
  const result = await client.clusters.createOrUpdate("kustorptest", "kustoCluster", {
    identity: { type: "SystemAssigned" },
    location: "westus",
    allowedIpRangeList: ["0.0.0.0/0"],
    enableAutoStop: true,
    enableDoubleEncryption: false,
    enablePurge: true,
    enableStreamingIngest: true,
    languageExtensions: {
      value: [
        { languageExtensionImageName: "Python3_10_8", languageExtensionName: "PYTHON" },
        { languageExtensionImageName: "R", languageExtensionName: "R" },
      ],
    },
    publicIPType: "DualStack",
    publicNetworkAccess: "Enabled",
    sku: { name: "Standard_L16as_v3", capacity: 2, tier: "Standard" },
  });
  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

範例回覆

狀態碼:: 200

{
  "name": "kustoCluster",
  "type": "Microsoft.Kusto/Clusters",
  "etag": "abcd",
  "id": "/subscriptions/12345678-1234-1234-1234-123456789098/resourceGroups/kustorptest/providers/Microsoft.Kusto/Clusters/kustoCluster",
  "identity": {
    "type": "SystemAssigned",
    "principalId": "faabad1f-4876-463c-af9d-6ba2d2d2394c",
    "tenantId": "b932977f-6277-4ab7-a2cd-5bd21f07aaf4",
    "userAssignedIdentities": {}
  },
  "location": "westus",
  "properties": {
    "allowedIpRangeList": [
      "0.0.0.0/0"
    ],
    "enableAutoStop": true,
    "enableDiskEncryption": false,
    "enableDoubleEncryption": false,
    "enablePurge": true,
    "enableStreamingIngest": true,
    "engineType": "V3",
    "keyVaultProperties": {
      "keyName": "keyName",
      "keyVaultUri": "https://dummy.keyvault.com",
      "keyVersion": "keyVersion"
    },
    "languageExtensions": {
      "value": [
        {
          "languageExtensionImageName": "Python3_10_8",
          "languageExtensionName": "PYTHON"
        },
        {
          "languageExtensionImageName": "R",
          "languageExtensionName": "R"
        }
      ]
    },
    "provisioningState": "Succeeded",
    "publicIPType": "DualStack",
    "publicNetworkAccess": "Enabled",
    "restrictOutboundNetworkAccess": "Disabled"
  },
  "sku": {
    "name": "Standard_L16as_v3",
    "capacity": 2,
    "tier": "Standard"
  }
}

狀態碼:: 201

{
  "name": "kustoCluster",
  "type": "Microsoft.Kusto/Clusters",
  "etag": "abcd123",
  "id": "/subscriptions/12345678-1234-1234-1234-123456789098/resourceGroups/kustorptest/providers/Microsoft.Kusto/Clusters/kustoCluster",
  "identity": {
    "type": "SystemAssigned",
    "principalId": "faabad1f-4876-463c-af9d-6ba2d2d2394c",
    "tenantId": "b932977f-6277-4ab7-a2cd-5bd21f07aaf4",
    "userAssignedIdentities": {}
  },
  "location": "westus",
  "properties": {
    "allowedIpRangeList": [
      "0.0.0.0/0"
    ],
    "enableAutoStop": true,
    "enableDiskEncryption": false,
    "enableDoubleEncryption": false,
    "enablePurge": true,
    "enableStreamingIngest": true,
    "engineType": "V3",
    "keyVaultProperties": {
      "keyName": "keyName",
      "keyVaultUri": "https://dummy.keyvault.com",
      "keyVersion": "keyVersion"
    },
    "languageExtensions": {
      "value": [
        {
          "languageExtensionImageName": "Python3_10_8",
          "languageExtensionName": "PYTHON"
        },
        {
          "languageExtensionImageName": "R",
          "languageExtensionName": "R"
        }
      ]
    },
    "provisioningState": "Succeeded",
    "publicIPType": "DualStack",
    "publicNetworkAccess": "Enabled",
    "restrictOutboundNetworkAccess": "Disabled"
  },
  "sku": {
    "name": "Standard_L16as_v3",
    "capacity": 2,
    "tier": "Standard"
  }
}

定義

名稱	Description
AcceptedAudiences	代表被群集信任的公認受眾。
AzureSku	Azure SKU definition.
AzureSkuName	SKU 名稱。
AzureSkuTier	SKU 層。
CalloutPolicy	外部呼叫政策的配置，包括 URI 模式、存取類型及服務類型。
CalloutType	圖說文字服務的型別，指定要存取的外部資源或服務類型。
Cluster	類別代表一個 Kusto 叢集。
ClusterNetworkAccessFlag	是否要限制輸出網路存取。值為選擇性值，但如果傳入，則必須是 'Enabled' 或 'Disabled'
ComponentsSgqdofSchemasIdentityPropertiesUserassignedidentitiesAdditionalproperties
createdByType	建立資源的身分識別類型。
EngineType	引擎類型
ErrorAdditionalInfo	資源管理錯誤其他資訊。
ErrorDetail	錯誤詳細數據。
ErrorResponse	錯誤回應
Identity	資源的身分識別。
IdentityType	所使用的受控識別類型。類型 'SystemAssigned， UserAssigned' 包含隱含建立的身分識別和一組使用者指派的身分識別。類型『None』會移除所有身分識別。
KeyVaultProperties	金鑰保存庫的屬性。
LanguageExtension	語言擴充物件。
LanguageExtensionImageName	語言擴充影像名稱。
LanguageExtensionName	可以在 KQL 查詢中執行的語言擴充。
LanguageExtensionsList	語言擴充物件的清單。
MigrationClusterProperties	代表屬於遷移的叢集屬性。
MigrationClusterRole	群聚在遷移過程中的角色。
OptimizedAutoscale	一個包含最佳化自動縮放定義的類別。
OutboundAccess	指出是否允許指定 URI 模式的輸出存取。
PrivateEndpointConnection	私人端點連線
PrivateEndpointProperty	線上所屬的私人端點。
PrivateLinkServiceConnectionStateProperty	私人端點連線的連接狀態。
ProvisioningState	資源的布建狀態。
PublicIPType	指出要建立的公用IP類型 - IPv4 （預設值），或 DualStack （IPv4 和 IPv6）
PublicNetworkAccess	默認會啟用叢集的公用網路存取。停用時，只允許與叢集的私人端點連線
State	資源的狀態。
systemData	與建立和上次修改資源相關的元數據。
TrustedExternalTenant	代表叢集信任的租戶 ID。
VirtualNetworkConfiguration	一個包含虛擬網路定義的類別。
VnetState	啟用時，叢集會部署到已設定的子網中，當停用時，叢集將會從子網中移除。
ZoneStatus	表示該星系群是帶狀還是非帶狀。

AcceptedAudiences

Object

代表被群集信任的公認受眾。

名稱	類型	Description
value	string	代表接受物件的 GUID 或有效 URL。

AzureSku

Object

Azure SKU definition.

名稱	類型	Description
capacity	integer (int32)	叢集實例的數目。
name	AzureSkuName	SKU 名稱。
tier	AzureSkuTier	SKU 層。

AzureSkuName

列舉型別

SKU 名稱。

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

AzureSkuTier

列舉型別

SKU 層。

值	Description
Basic	基本
Standard	標準

CalloutPolicy

Object

外部呼叫政策的配置，包括 URI 模式、存取類型及服務類型。

名稱	類型	Description
calloutId	string	圖說配置的唯一識別碼。
calloutType	CalloutType	圖說文字服務的型別，指定要存取的外部資源或服務類型。
calloutUriRegex	string	註標 URI 的正規表示式或 FQDN 模式。
outboundAccess	OutboundAccess	指出是否允許指定 URI 模式的輸出存取。

CalloutType

列舉型別

圖說文字服務的型別，指定要存取的外部資源或服務類型。

值	Description
kusto	Kusto
sql	sql
cosmosdb	cosmosdb
external_data	external_data
azure_digital_twins	azure_digital_twins
sandbox_artifacts	sandbox_artifacts
webapi	WebAPI 的
mysql	mysql
postgresql	postgresql
genevametrics	Genevametrics
azure_openai	azure_openai

Cluster

Object

類別代表一個 Kusto 叢集。

名稱	類型	預設值	Description
etag	string		“如果在響應本文中提供了 etag，它也可以根據正常的 etag 約定作為標頭提供。實體標籤用於比較來自相同要求資源的兩個或多個實體。 HTTP/1.1 在 etag（第 14.19 節）、If-Match（第 14.24 節）、If-None-Match（第 14.26 節）和 If-Range（第 14.27 節）標頭欄位中使用實體標籤。
id	string		資源的完整資源標識碼。例如 - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}
identity	Identity		如果已設定，則為叢集的身分識別。
location	string		資源所在的地理位置
name	string		資源的名稱
properties.acceptedAudiences	AcceptedAudiences[]		叢集接受的物件。
properties.allowedFqdnList	string[]		來自叢集輸出的允許 FQDN（完整功能變數名稱）清單。
properties.allowedIpRangeList	string[]		允許連線到叢集之 CIDR 格式的IP清單。
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	是否要限制輸出網路存取。值為選擇性值，但如果傳入，則必須是 'Enabled' 或 'Disabled'
properties.state	State		資源的狀態。
properties.stateReason	string		這就是集群目前狀態的原因。
properties.trustedExternalTenants	TrustedExternalTenant[]		叢集的外部租使用者。
properties.uri	string		上呼吸道感染群。
properties.virtualClusterGraduationProperties	string (password)		虛擬叢集畢業屬性
properties.virtualNetworkConfiguration	VirtualNetworkConfiguration		虛擬網路定義。
properties.zoneStatus	ZoneStatus		表示該星系群是帶狀還是非帶狀。
sku	AzureSku		叢集的 SKU。
systemData	systemData		包含 createdBy 和 modifiedBy 資訊的 Azure Resource Manager 元數據。
tags	object		資源標籤。
type	string		資源的類型。例如“Microsoft.Compute/virtualMachines” 或 “Microsoft.Storage/storageAccounts”
zones	string[]		可用性區域。

ClusterNetworkAccessFlag

列舉型別

是否要限制輸出網路存取。值為選擇性值，但如果傳入，則必須是 'Enabled' 或 'Disabled'

值	Description
Enabled	已啟用
Disabled	Disabled

ComponentsSgqdofSchemasIdentityPropertiesUserassignedidentitiesAdditionalproperties

Object

名稱	類型	Description
clientId	string	使用者指派身分識別的用戶端標識碼。
principalId	string	使用者指派身分識別的主體標識碼。

createdByType

列舉型別

建立資源的身分識別類型。

值	Description
User
Application
ManagedIdentity
Key

EngineType

列舉型別

引擎類型

值	Description
V2	V2
V3	V3

ErrorAdditionalInfo

Object

資源管理錯誤其他資訊。

名稱	類型	Description
info	object	其他資訊。
type	string	其他信息類型。

ErrorDetail

Object

錯誤詳細數據。

名稱	類型	Description
additionalInfo	ErrorAdditionalInfo[]	錯誤其他資訊。
code	string	錯誤碼。
details	ErrorDetail[]	錯誤詳情
message	string	錯誤訊息。
target	string	錯誤目標。

ErrorResponse

Object

錯誤回應

名稱	類型	Description
error	ErrorDetail	error 物件。

Identity

Object

資源的身分識別。

名稱	類型	Description
principalId	string	資源識別的主要標識碼。
tenantId	string	資源的租用戶標識碼。
type	IdentityType	所使用的受控識別類型。類型 'SystemAssigned， UserAssigned' 包含隱含建立的身分識別和一組使用者指派的身分識別。類型『None』會移除所有身分識別。
userAssignedIdentities	<string, ComponentsSgqdofSchemasIdentityPropertiesUserassignedidentitiesAdditionalproperties>	與 Kusto 叢集相關聯的使用者身分識別清單。使用者身分識別字典索引鍵參考的格式為 ARM 資源標識符：'/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}'。

IdentityType

列舉型別

所使用的受控識別類型。類型 'SystemAssigned， UserAssigned' 包含隱含建立的身分識別和一組使用者指派的身分識別。類型『None』會移除所有身分識別。

值	Description
None	沒有
SystemAssigned	系統分配的
UserAssigned	UserAssigned
SystemAssigned, UserAssigned	SystemAssigned、UserAssigned

KeyVaultProperties

Object

金鑰保存庫的屬性。

名稱	類型	Description
federatedIdentityClientId	string	多租戶 Microsoft Entra 應用程式的應用程式（用戶端）ID。用於跨租戶客戶管理的金鑰情境，當加密金鑰儲存在與叢集不同的租戶中。應用程式必須以使用者指派的管理身份作為聯邦身份憑證進行配置。
keyName	string	金鑰儲存庫金鑰的名稱。
keyVaultUri	string	金鑰保存庫的 URI。
keyVersion	string	金鑰儲存庫金鑰的版本。
userIdentity	string	使用者指派的身分識別（ARM 資源識別碼）可存取金鑰。該身份必須在金鑰庫金鑰上擁有「取得」、「封裝金鑰」及「展開金鑰」權限，或被指派為「金鑰庫加密服務加密使用者」角色。

LanguageExtension

Object

語言擴充物件。

名稱	類型	Description
languageExtensionCustomImageName	string	沙盒自訂映像檔名稱，應該啟用為活躍的語言擴充功能。沙盒自訂映像檔是叢集子資源。當此屬性設定完成時，LanguageExtensionImageName 應設為「PythonCustomImage」。
languageExtensionImageName	LanguageExtensionImageName	語言延伸模組映像名稱。
languageExtensionName	LanguageExtensionName	語言延伸模組名稱。

LanguageExtensionImageName

列舉型別

語言擴充影像名稱。

值	Description
R	R
Python3_6_5	Python3_6_5
Python3_10_8	Python3_10_8
Python3_10_8_DL	Python3_10_8_DL
PythonCustomImage	PythonCustomImage
Python3_11_7	Python3_11_7
Python3_11_7_DL	Python3_11_7_DL

LanguageExtensionName

列舉型別

可以在 KQL 查詢中執行的語言擴充。

值	Description
PYTHON	蟒
R	R

LanguageExtensionsList

Object

語言擴充物件的清單。

名稱	類型	Description
nextLink	string	連結到下一頁資源。
value	LanguageExtension[]	語言延伸模組的清單。

MigrationClusterProperties

Object

代表屬於遷移的叢集屬性。

名稱	類型	Description
dataIngestionUri	string	叢集的公開資料匯入網址。
id	string	叢集的資源 ID。
role	MigrationClusterRole	群聚在遷移過程中的角色。
uri	string	叢集的公開網址。

MigrationClusterRole

列舉型別

群聚在遷移過程中的角色。

值	Description
Source	來源
Destination	目的地

OptimizedAutoscale

Object

一個包含最佳化自動縮放定義的類別。

名稱	類型	Description
isEnabled	boolean	布爾值，指出優化自動調整功能是否已啟用。
maximum	integer (int32)	允許的實例計數上限。
minimum	integer (int32)	允許的實例計數下限。
version	integer (int32)	定義的範本版本，例如 1。

OutboundAccess

列舉型別

指出是否允許指定 URI 模式的輸出存取。

值	Description
Allow	允許
Deny	Deny

PrivateEndpointConnection

Object

私人端點連線

名稱	類型	Description
id	string	資源的完整資源標識碼。例如 - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}
name	string	資源的名稱
properties.groupId	string	私人端點的群組標識碼。
properties.privateEndpoint	PrivateEndpointProperty	線上所屬的私人端點。
properties.privateLinkServiceConnectionState	PrivateLinkServiceConnectionStateProperty	私人端點連線的連接狀態。
properties.provisioningState	string	布建私人端點的狀態。
systemData	systemData	包含 createdBy 和 modifiedBy 資訊的 Azure Resource Manager 元數據。
type	string	資源的類型。例如“Microsoft.Compute/virtualMachines” 或 “Microsoft.Storage/storageAccounts”

PrivateEndpointProperty

Object

線上所屬的私人端點。

名稱	類型	Description
id	string	私人端點的資源標識碼。

PrivateLinkServiceConnectionStateProperty

Object

私人端點連線的連接狀態。

名稱	類型	Description
actionsRequired	string	基本工作流程以外的任何必要動作（核准/拒絕/中斷連線）
description	string	私人鏈接服務連線描述。
status	string	私人鏈接服務連線狀態。

ProvisioningState

列舉型別

資源的布建狀態。

值	Description
Running	Running
Creating	建立中
Deleting	刪除中
Succeeded	成功
Failed	失敗
Moving	㶛
Canceled	已取消

PublicIPType

列舉型別

指出要建立的公用IP類型 - IPv4 （預設值），或 DualStack （IPv4 和 IPv6）

值	Description
IPv4	IPv4
DualStack	雙堆疊

PublicNetworkAccess

列舉型別

默認會啟用叢集的公用網路存取。停用時，只允許與叢集的私人端點連線

值	Description
Enabled	已啟用
Disabled	Disabled
SecuredByPerimeter	SecuredByPerimeter

State

列舉型別

資源的狀態。

值	Description
Creating	建立中
Unavailable	無法取得
Running	Running
Deleting	刪除中
Deleted	已刪除
Stopping	停止中
Stopped	已停止
Starting	啟動中
Updating	更新中
Migrated	已移轉

systemData

Object

與建立和上次修改資源相關的元數據。

名稱	類型	Description
createdAt	string (date-time)	資源建立的時間戳（UTC）。
createdBy	string	建立資源的身分識別。
createdByType	createdByType	建立資源的身分識別類型。
lastModifiedAt	string (date-time)	上次修改的資源時間戳（UTC）
lastModifiedBy	string	上次修改資源的身分識別。
lastModifiedByType	createdByType	上次修改資源的身分識別類型。

TrustedExternalTenant

Object

代表叢集信任的租戶 ID。

名稱	類型	Description
value	string	代表外部租使用者的 GUID。

VirtualNetworkConfiguration

Object

一個包含虛擬網路定義的類別。

名稱	類型	預設值	Description
dataManagementPublicIpId	string		數據管理的服務公用IP位址資源標識碼。
enginePublicIpId	string		引擎服務的公用IP位址資源標識碼。
state	VnetState	Enabled	啟用時，叢集會部署到已設定的子網中，當停用時，叢集將會從子網中移除。
subnetId	string		子網資源標識碼。

VnetState

列舉型別

啟用時，叢集會部署到已設定的子網中，當停用時，叢集將會從子網中移除。

值	Description
Enabled	已啟用
Disabled	Disabled

ZoneStatus

列舉型別

表示該星系群是帶狀還是非帶狀。

值	Description
NonZonal	非區域
ZonalInconsistency	區域不一致
Zonal	區域性