Azure Kubernetes Service (AKS) Uptime SLA

Uptime SLA is a tier to enable a financially backed, higher SLA for an AKS cluster. Clusters with Uptime SLA, also referred to as Paid SKU tier in AKS REST APIs, come with greater amount of control plane resources and automatically scale to meet the load of your cluster. Uptime SLA guarantees 99.95% availability of the Kubernetes API server endpoint for clusters that use Availability Zones, and 99.9% of availability for clusters that don't use Availability Zones. AKS uses master node replicas across update and fault domains to ensure SLA requirements are met.

AKS recommends use of Uptime SLA in production workloads to ensure availability of control plane components. By contrast, clusters on the Free SKU tier support fewer replicas and limited resources for the control plane and are not suitable for production workloads.

You can still create unlimited number of free clusters with a service level objective (SLO) of 99.5% and opt for the preferred SLO.

Important

For clusters with egress lockdown, see limit egress traffic to open appropriate ports.

Region availability

SLA terms and conditions

Uptime SLA is a paid feature and is enabled per cluster. Uptime SLA pricing is determined by the number of discrete clusters, and not by the size of the individual clusters. You can view Uptime SLA pricing details for more information.

Before you begin

Azure CLI version 2.8.0 or later and configured. Run az --version to find the version. If you need to install or upgrade, see Install Azure CLI.

Creating a new cluster with Uptime SLA

To create a new cluster with the Uptime SLA, you use the Azure CLI. Create a new cluster in an existing resource group or create a new one. To learn more about resource groups and working with them, see managing resource groups using the Azure CLI.

Use the az aks create command to create an AKS cluster. The following example creates a cluster named myAKSCluster with one node enables the Uptime SLA. This operation takes several minutes to complete:

az aks create --resource-group myResourceGroup --name myAKSCluster --uptime-sla --node-count 1

After a few minutes, the command completes and returns JSON-formatted information about the cluster. The following example output of the JSON snippet shows the paid tier for the SKU, indicating your cluster is enabled with Uptime SLA:

  },
  "sku": {
    "name": "Basic",
    "tier": "Paid"
  },

Modify an existing cluster to use Uptime SLA

You can update your existing clusters to use Uptime SLA.

Note

Updating your cluster to enable the Uptime SLA does not disrupt its normal operation or impact its availability.

The following command uses the az aks update command to update the existing cluster:

# Update an existing cluster to use Uptime SLA
az aks update --resource-group myResourceGroup --name myAKSCluster --uptime-sla

This process takes several minutes to complete. When finished, the following example JSON snippet shows the paid tier for the SKU, indicating your cluster is enabled with Uptime SLA:

  },
  "sku": {
    "name": "Basic",
    "tier": "Paid"
  },

Opt out of Uptime SLA

At any time you can opt out of using the Uptime SLA by updating your cluster to change it back to the free tier.

Note

Updating your cluster to stop using the Uptime SLA does not disrupt its normal operation or impact its availability.

The following command uses the az aks update command to update the existing cluster:

 az aks update --resource-group myResourceGroup --name myAKSCluster --no-uptime-sla

This process takes several minutes to complete.

Next steps