Migrate your cluster to support multiple availability zones (Preview)

1. In the Azure portal, go to your cluster's Overview page.

2. Under Settings, select Scale up.

3. In the row for your cluster, the availability zones are listed in the Availability zones column.

   

Before you start, make sure you have az.Kusto cmdlets installed and signed in, and then run the following command to get the list of availability zones for your cluster's region:

1. Set the resource ID of your cluster. You can get your cluster's resource ID from the Azure portal from your cluster's Properties page.

   $resource_id = "<ClusterResourceID>"
   

2. Get your cluster's details.

   $mycluster = Get-AzKustoCluster -InputObject $resource_id
   

3. Get the location of your cluster.

   Important

   Get-AzLocation requires the Az.Resources module. If you don't have it installed, run Install-Module Az.Resources.

   $location = (Get-AzLocation | where DisplayName -EQ $mycluster.Location).location
   

4. Get your cluster's ID.

   $mycluster.Id  -match "/subscriptions/(.*?)/" | Out-Null; $subscription = $Matches[1]
   

5. Get the list of availability zones for your cluster's region.

   $bearer = (Get-AzAccessToken).Token
   $rest_result = (Invoke-RestMethod -Uri https://management.chinacloudapi.cn/subscriptions/$subscription/providers/Microsoft.Kusto/locations/${location}/skus?api-version=2022-11-11 -Headers @{Authorization="Bearer $bearer"})
   $zones = $rest_result | select -ExpandProperty Value | where name -eq $mycluster.SkuName | select -ExpandProperty locationInfo | select zones
   $zones
   

Follow the instructions on how to deploy a template.

1. Make the REST API call to the following endpoint where you replace the parameters with your values:

   PUT https://management.chinacloudapi.cn/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Kusto/clusters/{clusterName}?api-version={apiVersion}
   

2. Specify your availability zones in the request body. For example, to configure the cluster to use availability zones 1, 2, and 3, set the body as follows:

   { "zones": [ "{zone1}", "{zone2}", "{zone3}" ] }
   

1. If you don't have the Azure.Identity and Azure.ResourceManager.Kusto libraries installed, use the following commands to install them:

   dotnet add package Azure.Identity
   dotnet add package Azure.ResourceManager.Kusto
   

2. In your application, add the following code:

   "zones": [ "{zone1}", "{zone2}", "{zone3}" ]
   

   For example, to set your zones to 1, 2, and 3, in the North Europe region, use the following code:

   using Azure.Core;
   using Azure.ResourceManager.Kusto;
   using Azure.ResourceManager.Kusto.Models;
   using ArmClient = Azure.ResourceManager.ArmClient;
   using ClientSecretCredential = Azure.Identity.ClientSecretCredential;
   using WaitUntil = Azure.WaitUntil;
   
   var tenantId = "{tenantId}";
   var clientId = "{clientId}";
   var clientSecret = "{clientSecret}";
   var subscriptionId = "{subscriptionId}";
   var resourceGroupName = "{resourceGroupName}";
   var clusterName = "{clusterName}";
   
   var credentials = new ClientSecretCredential(tenantId, clientId, clientSecret);
   var resourceManagementClient = new ArmClient(credentials, subscriptionId);
   var resourceIdentifier = new ResourceIdentifier($"/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Kusto/Clusters/{clusterName}");
   var cluster = resourceManagementClient.GetKustoClusterResource(resourceIdentifier);
   
   var kustoClusterPatch = new KustoClusterPatch(AzureLocation.NorthEurope);
   kustoClusterPatch.Zones.Clear();
   kustoClusterPatch.Zones.Add("1");
   kustoClusterPatch.Zones.Add("2");
   kustoClusterPatch.Zones.Add("3");
   
   var armOperation = await cluster.UpdateAsync(WaitUntil.Started, kustoClusterPatch).ConfigureAwait(false);
   
   var response = armOperation.UpdateStatus();
   Console.WriteLine($"ClientRequestId: {response.ClientRequestId}");
   
   while (true)
   {
   Console.WriteLine($"{DateTime.UtcNow:o} {response.Status, -5} {response.ReasonPhrase}");
   if (armOperation.HasCompleted)
       break;
   
   await Task.Delay(60000).ConfigureAwait(false);
   response = await armOperation.UpdateStatusAsync().ConfigureAwait(false);
   }
   

3. Run your application.

1. In your application, add the following code:

   "zones": [ "{zone1}", "{zone2}", "{zone3}" ]
   

   For example, to set your zones to 1, 2, and 3, in the North Europe region, use the following code:

   from azure.identity import DefaultAzureCredential
   from azure.mgmt.kusto import KustoManagementClient
   from azure.mgmt.kusto import models
   import time
   from azure.core.exceptions import HttpResponseError 
   
   subscription_id = "{subscriptionId}"
   resource_group_name = "{resourceGroupName}"
   cluster_name = "{clusterName}"
   
   client = KustoManagementClient(DefaultAzureCredential(), subscription_id)
   lro_poller = client.clusters.begin_update(resource_group_name, cluster_name, models.ClusterUpdate.from_dict({"zones": ["1", "2", "3"]}))
   
   while (not(lro_poller.done())):
       time.sleep(60)
   
   print (f"status: {lro_poller.status()}")
   
   try:
       lro_poller.result()
   except HttpResponseError as e:
       print (f"Exception: {e}")
   

2. Run your application.

You can use the following PowerShell command to configure your cluster to use availability zones. Make sure the Kusto tools libraries is installed and replace the parameters with your values.

Update-AzKustoCluster -SubscriptionId {subscriptionId} -ResourceGroupName {resourceGroupName} -Name {clusterName} -Zone "{zone1}", "{zone2}", "{zone3}"

1. In your ARM template, add the following property to the Microsoft.Kusto/clusters resource:

   "zones": [ "{zone1}", "{zone2}", "{zone3}" ]
   

   For example, to set your zones to 1, 2, and 3, in the North Europe region, use the following template:

   {
   "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
   "contentVersion": "1.0.0.0",
   "parameters": {
       "clusters_clusterName_name": {
           "defaultValue": "clusterName",
           "type": "string"
       }
   },
   "variables": {},
   "resources": [
       {
           "type": "Microsoft.Kusto/clusters",
           "apiVersion": "2023-05-02",
           "name": "[parameters('clusters_clusterName_name')]",
           "location": "North Europe",
           "sku": {
               "name": "{skuName}",
               "tier": "Basic",
               "capacity": 1
           },
           "zones": ["1","2","3"],
           "identity": {
               "type": "SystemAssigned"
           },
           "properties": {
               "trustedExternalTenants": [],
               "enableDiskEncryption": false,
               "enableStreamingIngest": false,
               "languageExtensions": {
                   "value": []
               },
               "enablePurge": false,
               "enableDoubleEncryption": false,
               "engineType": "V3",
               "acceptedAudiences": [],
               "restrictOutboundNetworkAccess": "Disabled",
               "allowedFqdnList": [],
               "publicNetworkAccess": "Enabled",
               "allowedIpRangeList": [],
               "enableAutoStop": true,
               "publicIPType": "IPv4"
           }
       }
   ]
   }
   

2. Deploy the ARM template. For more information, see Deploy resources with ARM templates and Azure CLI.