Containers np

AKS user node pool naming convention

The CAF abbreviation for AKS user node pool is np. Names can be 1 to 12 characters long and allow lowercase alphanumerics only. The name must be unique within the parent resource.

Naming rules

CAF abbreviation	np
Length	1 to 12 characters
Allowed characters	Lowercase letters and numbers
Scope of uniqueness	Unique within the parent resource
CAF pattern	np{workload}{environment}{region}{instance}

Worth knowing: Can't start with a number. 1-6 for Windows.

Rules follow Microsoft's resource naming rules and CAF abbreviations. Some resource types have extra start/end character restrictions, so verify against the official docs before locking in a convention.

Naming Containers resources

Container Registry is globally unique and already has its own guide. AKS node pools are the sharp edge in this category, the system node pool name is capped at 12 characters (6 on Windows), far tighter than almost anything else in Azure, so short, functional names matter more here than anywhere else in the naming scheme.

A Container Apps environment groups multiple container apps the way a Service Bus namespace groups queues, name the environment for the shared platform boundary and the individual container app for the workload it runs. The common mistake is giving node pools descriptive names and hitting the character ceiling immediately, plan for the 12 character limit before you need it.

Example names

Generated by the same engine as the name generator, so length and character rules are already applied.

Scenario	Generated name	Length
Payments API, production	`nppayprod001` Dropped region and shortened workload to fit 12 chars.	12/12
Web app, development	`npwebadev002` Dropped region and shortened workload to fit 12 chars.	12/12
Analytics with company prefix	`npanstage001` Dropped company, region and shortened workload to fit 12 chars.	12/12

Naming in Terraform and Bicep

Build the name from variables so one module produces the right name in every environment. The 12-character limit is enforced in the expression.

Terraform

locals {
  aks_user_nodepool_name = substr(lower("np${var.workload}${var.environment}${var.region}001"), 0, 12)
}

Bicep

var aksUserNodepoolName = take(toLower('np${workload}${environment}${region}001'), 12)

Generate AKS user node pool names for your workload

Free, no login. Validation and Terraform, Bicep, or CSV export included.

Open in the generator →

Related Containers resources

aks AKS cluster npsystem AKS system node pool ca Container app cae Container apps environment caj Container apps job cr Container registry ci Container instance sf Service Fabric cluster

See the full list of Azure resource naming rules or read the complete CAF naming guide.