Microsoft.ContainerService fleets/autoUpgradeProfiles

Bicep resource definition

The fleets/autoUpgradeProfiles resource type can be deployed with operations that target:

For a list of changed properties in each API version, see change log.

Resource format

To create a Microsoft.ContainerService/fleets/autoUpgradeProfiles resource, add the following Bicep to your template.

resource symbolicname 'Microsoft.ContainerService/fleets/autoUpgradeProfiles@2026-06-02-preview' = {
  parent: resourceSymbolicName
  name: 'string'
  properties: {
    autoUpgradeProfileStatus: {}
    channel: 'string'
    disabled: bool
    longTermSupport: bool
    nodeImageSelection: {
      type: 'string'
    }
    targetKubernetesVersion: 'string'
    updateStrategyId: 'string'
  }
}

Property Values

Microsoft.ContainerService/fleets/autoUpgradeProfiles

Name Description Value
name The resource name string

Constraints:
Min length = 1
Max length = 50
Pattern = ^[a-z0-9]([-a-z0-9]*[a-z0-9])?$ (required)
parent In Bicep, you can specify the parent resource for a child resource. You only need to add this property when the child resource is declared outside of the parent resource.

For more information, see Child resource outside parent resource.		 Symbolic name for resource of type: fleets
properties The resource-specific properties for this resource. AutoUpgradeProfileProperties

AutoUpgradeNodeImageSelection

Name Description Value
type The node image upgrade type. 'Consistent'
'Latest' (required)

AutoUpgradeProfileProperties

Name Description Value
autoUpgradeProfileStatus The status of the auto upgrade profile. AutoUpgradeProfileStatus
channel Configures how auto-upgrade will be run. 'NodeImage'
'Rapid'
'SecurityPatch'
'Stable'
'TargetKubernetesVersion' (required)
disabled If set to False: the auto upgrade has effect - target managed clusters will be upgraded on schedule.
If set to True: the auto upgrade has no effect - no upgrade will be run on the target managed clusters.
This is a boolean and not an enum because enabled/disabled are all available states of the auto upgrade profile.
By default, this is set to False.		 bool
longTermSupport If upgrade channel is not TargetKubernetesVersion, this field must be False.
If set to True: Fleet auto upgrade will continue generate update runs for patches of minor versions earlier than N-2
(where N is the latest supported minor version) if those minor versions support Long-Term Support (LTS).
By default, this is set to False.
For more information on AKS LTS, please see /azure/aks/long-term-support		 bool
nodeImageSelection The node image upgrade to be applied to the target clusters in auto upgrade. AutoUpgradeNodeImageSelection
targetKubernetesVersion This is the target Kubernetes version for auto-upgrade. The format must be {major version}.{minor version}. For example, "1.30".
By default, this is empty.
If upgrade channel is set to TargetKubernetesVersion, this field must not be empty.
If upgrade channel is not TargetKubernetesVersion, this field must be empty.		 string
updateStrategyId The resource id of the UpdateStrategy resource to reference. If not specified, the auto upgrade will run on all clusters which are members of the fleet. string

AutoUpgradeProfileStatus

Name Description Value

ARM template resource definition

The fleets/autoUpgradeProfiles resource type can be deployed with operations that target:

Usage Examples

Resource format

To create a Microsoft.ContainerService/fleets/autoUpgradeProfiles resource, add the following JSON to your template.

{
  "type": "Microsoft.ContainerService/fleets/autoUpgradeProfiles",
  "apiVersion": "2026-06-02-preview",
  "name": "string",
  "properties": {
    "autoUpgradeProfileStatus": {
    },
    "channel": "string",
    "disabled": "bool",
    "longTermSupport": "bool",
    "nodeImageSelection": {
      "type": "string"
    },
    "targetKubernetesVersion": "string",
    "updateStrategyId": "string"
  }
}

Property Values

Microsoft.ContainerService/fleets/autoUpgradeProfiles

Name Description Value
apiVersion The api version '2026-06-02-preview'
name The resource name string

Constraints:
Min length = 1
Max length = 50
Pattern = ^[a-z0-9]([-a-z0-9]*[a-z0-9])?$ (required)
properties The resource-specific properties for this resource. AutoUpgradeProfileProperties
type The resource type 'Microsoft.ContainerService/fleets/autoUpgradeProfiles'

AutoUpgradeNodeImageSelection

Name Description Value
type The node image upgrade type. 'Consistent'
'Latest' (required)

AutoUpgradeProfileProperties

Name Description Value
autoUpgradeProfileStatus The status of the auto upgrade profile. AutoUpgradeProfileStatus
channel Configures how auto-upgrade will be run. 'NodeImage'
'Rapid'
'SecurityPatch'
'Stable'
'TargetKubernetesVersion' (required)
disabled If set to False: the auto upgrade has effect - target managed clusters will be upgraded on schedule.
If set to True: the auto upgrade has no effect - no upgrade will be run on the target managed clusters.
This is a boolean and not an enum because enabled/disabled are all available states of the auto upgrade profile.
By default, this is set to False.		 bool
longTermSupport If upgrade channel is not TargetKubernetesVersion, this field must be False.
If set to True: Fleet auto upgrade will continue generate update runs for patches of minor versions earlier than N-2
(where N is the latest supported minor version) if those minor versions support Long-Term Support (LTS).
By default, this is set to False.
For more information on AKS LTS, please see /azure/aks/long-term-support		 bool
nodeImageSelection The node image upgrade to be applied to the target clusters in auto upgrade. AutoUpgradeNodeImageSelection
targetKubernetesVersion This is the target Kubernetes version for auto-upgrade. The format must be {major version}.{minor version}. For example, "1.30".
By default, this is empty.
If upgrade channel is set to TargetKubernetesVersion, this field must not be empty.
If upgrade channel is not TargetKubernetesVersion, this field must be empty.		 string
updateStrategyId The resource id of the UpdateStrategy resource to reference. If not specified, the auto upgrade will run on all clusters which are members of the fleet. string

AutoUpgradeProfileStatus

Name Description Value

Terraform (AzAPI provider) resource definition

The fleets/autoUpgradeProfiles resource type can be deployed with operations that target:

  • Resource groups For a list of changed properties in each API version, see change log.

Resource format

To create a Microsoft.ContainerService/fleets/autoUpgradeProfiles resource, add the following Terraform to your template.

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.ContainerService/fleets/autoUpgradeProfiles@2026-06-02-preview"
  name = "string"
  parent_id = "string"
  body = {
    properties = {
      autoUpgradeProfileStatus = {
      }
      channel = "string"
      disabled = bool
      longTermSupport = bool
      nodeImageSelection = {
        type = "string"
      }
      targetKubernetesVersion = "string"
      updateStrategyId = "string"
    }
  }
}

Property Values

Microsoft.ContainerService/fleets/autoUpgradeProfiles

Name Description Value
name The resource name string

Constraints:
Min length = 1
Max length = 50
Pattern = ^[a-z0-9]([-a-z0-9]*[a-z0-9])?$ (required)
parent_id The ID of the resource that is the parent for this resource. ID for resource of type: fleets
properties The resource-specific properties for this resource. AutoUpgradeProfileProperties
type The resource type "Microsoft.ContainerService/fleets/autoUpgradeProfiles@2026-06-02-preview"

AutoUpgradeNodeImageSelection

Name Description Value
type The node image upgrade type. 'Consistent'
'Latest' (required)

AutoUpgradeProfileProperties

Name Description Value
autoUpgradeProfileStatus The status of the auto upgrade profile. AutoUpgradeProfileStatus
channel Configures how auto-upgrade will be run. 'NodeImage'
'Rapid'
'SecurityPatch'
'Stable'
'TargetKubernetesVersion' (required)
disabled If set to False: the auto upgrade has effect - target managed clusters will be upgraded on schedule.
If set to True: the auto upgrade has no effect - no upgrade will be run on the target managed clusters.
This is a boolean and not an enum because enabled/disabled are all available states of the auto upgrade profile.
By default, this is set to False.		 bool
longTermSupport If upgrade channel is not TargetKubernetesVersion, this field must be False.
If set to True: Fleet auto upgrade will continue generate update runs for patches of minor versions earlier than N-2
(where N is the latest supported minor version) if those minor versions support Long-Term Support (LTS).
By default, this is set to False.
For more information on AKS LTS, please see /azure/aks/long-term-support		 bool
nodeImageSelection The node image upgrade to be applied to the target clusters in auto upgrade. AutoUpgradeNodeImageSelection
targetKubernetesVersion This is the target Kubernetes version for auto-upgrade. The format must be {major version}.{minor version}. For example, "1.30".
By default, this is empty.
If upgrade channel is set to TargetKubernetesVersion, this field must not be empty.
If upgrade channel is not TargetKubernetesVersion, this field must be empty.		 string
updateStrategyId The resource id of the UpdateStrategy resource to reference. If not specified, the auto upgrade will run on all clusters which are members of the fleet. string

AutoUpgradeProfileStatus

Name Description Value
  • Last updated on