Docs Home Pulumi IaC Pulumi ESC Pulumi Insights Pulumi Cloud Packages Tutorials
  1. Packages
  2. Azure Native v2
  3. API Docs
  4. containerservice
  5. AutoUpgradeProfile
These are the docs for Azure Native v2. We recommenend using the latest version, Azure Native v3.
Azure Native v2 v2.90.0 published on Thursday, Mar 27, 2025 by Pulumi
pulumi/pulumi-azure-native

azure-native-v2.containerservice.AutoUpgradeProfile

Explore with Pulumi AI

These are the docs for Azure Native v2. We recommenend using the latest version, Azure Native v3.
Azure Native v2 v2.90.0 published on Thursday, Mar 27, 2025 by Pulumi
pulumi/pulumi-azure-native

The AutoUpgradeProfile resource. Azure REST API version: 2024-05-02-preview.

Example Usage

Create an AutoUpgradeProfile.

using System.Collections.Generic;
using System.Linq;
using Pulumi;
using AzureNative = Pulumi.AzureNative;

return await Deployment.RunAsync(() => 
{
    var autoUpgradeProfile = new AzureNative.ContainerService.AutoUpgradeProfile("autoUpgradeProfile", new()
    {
        AutoUpgradeProfileName = "autoupgradeprofile1",
        Channel = "Stable",
        FleetName = "fleet1",
        ResourceGroupName = "rg1",
    });

});
Copy
package main

import (
	containerservice "github.com/pulumi/pulumi-azure-native-sdk/containerservice/v2"
	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)

func main() {
	pulumi.Run(func(ctx *pulumi.Context) error {
		_, err := containerservice.NewAutoUpgradeProfile(ctx, "autoUpgradeProfile", &containerservice.AutoUpgradeProfileArgs{
			AutoUpgradeProfileName: pulumi.String("autoupgradeprofile1"),
			Channel:                pulumi.String("Stable"),
			FleetName:              pulumi.String("fleet1"),
			ResourceGroupName:      pulumi.String("rg1"),
		})
		if err != nil {
			return err
		}
		return nil
	})
}
Copy
package generated_program;

import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.azurenative.containerservice.AutoUpgradeProfile;
import com.pulumi.azurenative.containerservice.AutoUpgradeProfileArgs;
import java.util.List;
import java.util.ArrayList;
import java.util.Map;
import java.io.File;
import java.nio.file.Files;
import java.nio.file.Paths;

public class App {
    public static void main(String[] args) {
        Pulumi.run(App::stack);
    }

    public static void stack(Context ctx) {
        var autoUpgradeProfile = new AutoUpgradeProfile("autoUpgradeProfile", AutoUpgradeProfileArgs.builder()
            .autoUpgradeProfileName("autoupgradeprofile1")
            .channel("Stable")
            .fleetName("fleet1")
            .resourceGroupName("rg1")
            .build());

    }
}
Copy
import * as pulumi from "@pulumi/pulumi";
import * as azure_native from "@pulumi/azure-native";

const autoUpgradeProfile = new azure_native.containerservice.AutoUpgradeProfile("autoUpgradeProfile", {
    autoUpgradeProfileName: "autoupgradeprofile1",
    channel: "Stable",
    fleetName: "fleet1",
    resourceGroupName: "rg1",
});
Copy
import pulumi
import pulumi_azure_native as azure_native

auto_upgrade_profile = azure_native.containerservice.AutoUpgradeProfile("autoUpgradeProfile",
    auto_upgrade_profile_name="autoupgradeprofile1",
    channel="Stable",
    fleet_name="fleet1",
    resource_group_name="rg1")
Copy
resources:
  autoUpgradeProfile:
    type: azure-native:containerservice:AutoUpgradeProfile
    properties:
      autoUpgradeProfileName: autoupgradeprofile1
      channel: Stable
      fleetName: fleet1
      resourceGroupName: rg1
Copy

Create AutoUpgradeProfile Resource

Resources are created with functions called constructors. To learn more about declaring and configuring resources, see Resources.

Constructor syntax

new AutoUpgradeProfile(name: string, args: AutoUpgradeProfileArgs, opts?: CustomResourceOptions);
@overload
def AutoUpgradeProfile(resource_name: str,
                       args: AutoUpgradeProfileArgs,
                       opts: Optional[ResourceOptions] = None)

@overload
def AutoUpgradeProfile(resource_name: str,
                       opts: Optional[ResourceOptions] = None,
                       channel: Optional[Union[str, UpgradeChannel]] = None,
                       fleet_name: Optional[str] = None,
                       resource_group_name: Optional[str] = None,
                       auto_upgrade_profile_name: Optional[str] = None,
                       disabled: Optional[bool] = None,
                       node_image_selection: Optional[AutoUpgradeNodeImageSelectionArgs] = None,
                       update_strategy_id: Optional[str] = None)
func NewAutoUpgradeProfile(ctx *Context, name string, args AutoUpgradeProfileArgs, opts ...ResourceOption) (*AutoUpgradeProfile, error)
public AutoUpgradeProfile(string name, AutoUpgradeProfileArgs args, CustomResourceOptions? opts = null)
public AutoUpgradeProfile(String name, AutoUpgradeProfileArgs args)
public AutoUpgradeProfile(String name, AutoUpgradeProfileArgs args, CustomResourceOptions options)

type: azure-native:containerservice:AutoUpgradeProfile
properties: # The arguments to resource properties.
options: # Bag of options to control resource's behavior.

Parameters

name This property is required. string
The unique name of the resource.
args This property is required. AutoUpgradeProfileArgs
The arguments to resource properties.
opts CustomResourceOptions
Bag of options to control resource's behavior.
resource_name This property is required. str
The unique name of the resource.
args This property is required. AutoUpgradeProfileArgs
The arguments to resource properties.
opts ResourceOptions
Bag of options to control resource's behavior.
ctx Context
Context object for the current deployment.
name This property is required. string
The unique name of the resource.
args This property is required. AutoUpgradeProfileArgs
The arguments to resource properties.
opts ResourceOption
Bag of options to control resource's behavior.
name This property is required. string
The unique name of the resource.
args This property is required. AutoUpgradeProfileArgs
The arguments to resource properties.
opts CustomResourceOptions
Bag of options to control resource's behavior.
name This property is required. String
The unique name of the resource.
args This property is required. AutoUpgradeProfileArgs
The arguments to resource properties.
options CustomResourceOptions
Bag of options to control resource's behavior.

Constructor example

The following reference example uses placeholder values for all input properties.

var autoUpgradeProfileResource = new AzureNative.Containerservice.AutoUpgradeProfile("autoUpgradeProfileResource", new()
{
    Channel = "string",
    FleetName = "string",
    ResourceGroupName = "string",
    AutoUpgradeProfileName = "string",
    Disabled = false,
    NodeImageSelection = 
    {
        { "type", "string" },
    },
    UpdateStrategyId = "string",
});
Copy
example, err := containerservice.NewAutoUpgradeProfile(ctx, "autoUpgradeProfileResource", &containerservice.AutoUpgradeProfileArgs{
	Channel:                "string",
	FleetName:              "string",
	ResourceGroupName:      "string",
	AutoUpgradeProfileName: "string",
	Disabled:               false,
	NodeImageSelection: map[string]interface{}{
		"type": "string",
	},
	UpdateStrategyId: "string",
})
Copy
var autoUpgradeProfileResource = new AutoUpgradeProfile("autoUpgradeProfileResource", AutoUpgradeProfileArgs.builder()
    .channel("string")
    .fleetName("string")
    .resourceGroupName("string")
    .autoUpgradeProfileName("string")
    .disabled(false)
    .nodeImageSelection(%!v(PANIC=Format method: runtime error: invalid memory address or nil pointer dereference))
    .updateStrategyId("string")
    .build());
Copy
auto_upgrade_profile_resource = azure_native.containerservice.AutoUpgradeProfile("autoUpgradeProfileResource",
    channel=string,
    fleet_name=string,
    resource_group_name=string,
    auto_upgrade_profile_name=string,
    disabled=False,
    node_image_selection={
        type: string,
    },
    update_strategy_id=string)
Copy
const autoUpgradeProfileResource = new azure_native.containerservice.AutoUpgradeProfile("autoUpgradeProfileResource", {
    channel: "string",
    fleetName: "string",
    resourceGroupName: "string",
    autoUpgradeProfileName: "string",
    disabled: false,
    nodeImageSelection: {
        type: "string",
    },
    updateStrategyId: "string",
});
Copy
type: azure-native:containerservice:AutoUpgradeProfile
properties:
    autoUpgradeProfileName: string
    channel: string
    disabled: false
    fleetName: string
    nodeImageSelection:
        type: string
    resourceGroupName: string
    updateStrategyId: string
Copy

AutoUpgradeProfile Resource Properties

To learn more about resource properties and how to use them, see Inputs and Outputs in the Architecture and Concepts docs.

Inputs

In Python, inputs that are objects can be passed either as argument classes or as dictionary literals.

The AutoUpgradeProfile resource accepts the following input properties:

Channel This property is required. string | Pulumi.AzureNative.ContainerService.UpgradeChannel
Configures how auto-upgrade will be run.
FleetName
This property is required.
Changes to this property will trigger replacement.
string
The name of the Fleet resource.
ResourceGroupName
This property is required.
Changes to this property will trigger replacement.
string
The name of the resource group. The name is case insensitive.
AutoUpgradeProfileName Changes to this property will trigger replacement. string
The name of the AutoUpgradeProfile resource.
Disabled bool
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.
NodeImageSelection Pulumi.AzureNative.ContainerService.Inputs.AutoUpgradeNodeImageSelection
The node image upgrade to be applied to the target clusters in auto upgrade.
UpdateStrategyId Changes to this property will trigger replacement. string
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.
Channel This property is required. string | UpgradeChannel
Configures how auto-upgrade will be run.
FleetName
This property is required.
Changes to this property will trigger replacement.
string
The name of the Fleet resource.
ResourceGroupName
This property is required.
Changes to this property will trigger replacement.
string
The name of the resource group. The name is case insensitive.
AutoUpgradeProfileName Changes to this property will trigger replacement. string
The name of the AutoUpgradeProfile resource.
Disabled bool
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.
NodeImageSelection AutoUpgradeNodeImageSelectionArgs
The node image upgrade to be applied to the target clusters in auto upgrade.
UpdateStrategyId Changes to this property will trigger replacement. string
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.
channel This property is required. String | UpgradeChannel
Configures how auto-upgrade will be run.
fleetName
This property is required.
Changes to this property will trigger replacement.
String
The name of the Fleet resource.
resourceGroupName
This property is required.
Changes to this property will trigger replacement.
String
The name of the resource group. The name is case insensitive.
autoUpgradeProfileName Changes to this property will trigger replacement. String
The name of the AutoUpgradeProfile resource.
disabled Boolean
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.
nodeImageSelection AutoUpgradeNodeImageSelection
The node image upgrade to be applied to the target clusters in auto upgrade.
updateStrategyId Changes to this property will trigger replacement. String
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.
channel This property is required. string | UpgradeChannel
Configures how auto-upgrade will be run.
fleetName
This property is required.
Changes to this property will trigger replacement.
string
The name of the Fleet resource.
resourceGroupName
This property is required.
Changes to this property will trigger replacement.
string
The name of the resource group. The name is case insensitive.
autoUpgradeProfileName Changes to this property will trigger replacement. string
The name of the AutoUpgradeProfile resource.
disabled boolean
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.
nodeImageSelection AutoUpgradeNodeImageSelection
The node image upgrade to be applied to the target clusters in auto upgrade.
updateStrategyId Changes to this property will trigger replacement. string
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.
channel This property is required. str | UpgradeChannel
Configures how auto-upgrade will be run.
fleet_name
This property is required.
Changes to this property will trigger replacement.
str
The name of the Fleet resource.
resource_group_name
This property is required.
Changes to this property will trigger replacement.
str
The name of the resource group. The name is case insensitive.
auto_upgrade_profile_name Changes to this property will trigger replacement. str
The name of the AutoUpgradeProfile resource.
disabled bool
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.
node_image_selection AutoUpgradeNodeImageSelectionArgs
The node image upgrade to be applied to the target clusters in auto upgrade.
update_strategy_id Changes to this property will trigger replacement. str
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.
channel This property is required. String | "rapid" | "stable" | "patch" | "node-image" | "none"
Configures how auto-upgrade will be run.
fleetName
This property is required.
Changes to this property will trigger replacement.
String
The name of the Fleet resource.
resourceGroupName
This property is required.
Changes to this property will trigger replacement.
String
The name of the resource group. The name is case insensitive.
autoUpgradeProfileName Changes to this property will trigger replacement. String
The name of the AutoUpgradeProfile resource.
disabled Boolean
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.
nodeImageSelection Property Map
The node image upgrade to be applied to the target clusters in auto upgrade.
updateStrategyId Changes to this property will trigger replacement. String
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.

Outputs

All input properties are implicitly available as output properties. Additionally, the AutoUpgradeProfile resource produces the following output properties:

ETag string
If eTag is provided in the response body, it may also be provided as a header per the normal etag convention. Entity tags are used for comparing two or more entities from the same requested resource. HTTP/1.1 uses entity tags in the etag (section 14.19), If-Match (section 14.24), If-None-Match (section 14.26), and If-Range (section 14.27) header fields.
Id string
The provider-assigned unique ID for this managed resource.
Name string
The name of the resource
ProvisioningState string
The provisioning state of the AutoUpgradeProfile resource.
SystemData Pulumi.AzureNative.ContainerService.Outputs.SystemDataResponse
Azure Resource Manager metadata containing createdBy and modifiedBy information.
Type string
The type of the resource. E.g. "Microsoft.Compute/virtualMachines" or "Microsoft.Storage/storageAccounts"
ETag string
If eTag is provided in the response body, it may also be provided as a header per the normal etag convention. Entity tags are used for comparing two or more entities from the same requested resource. HTTP/1.1 uses entity tags in the etag (section 14.19), If-Match (section 14.24), If-None-Match (section 14.26), and If-Range (section 14.27) header fields.
Id string
The provider-assigned unique ID for this managed resource.
Name string
The name of the resource
ProvisioningState string
The provisioning state of the AutoUpgradeProfile resource.
SystemData SystemDataResponse
Azure Resource Manager metadata containing createdBy and modifiedBy information.
Type string
The type of the resource. E.g. "Microsoft.Compute/virtualMachines" or "Microsoft.Storage/storageAccounts"
eTag String
If eTag is provided in the response body, it may also be provided as a header per the normal etag convention. Entity tags are used for comparing two or more entities from the same requested resource. HTTP/1.1 uses entity tags in the etag (section 14.19), If-Match (section 14.24), If-None-Match (section 14.26), and If-Range (section 14.27) header fields.
id String
The provider-assigned unique ID for this managed resource.
name String
The name of the resource
provisioningState String
The provisioning state of the AutoUpgradeProfile resource.
systemData SystemDataResponse
Azure Resource Manager metadata containing createdBy and modifiedBy information.
type String
The type of the resource. E.g. "Microsoft.Compute/virtualMachines" or "Microsoft.Storage/storageAccounts"
eTag string
If eTag is provided in the response body, it may also be provided as a header per the normal etag convention. Entity tags are used for comparing two or more entities from the same requested resource. HTTP/1.1 uses entity tags in the etag (section 14.19), If-Match (section 14.24), If-None-Match (section 14.26), and If-Range (section 14.27) header fields.
id string
The provider-assigned unique ID for this managed resource.
name string
The name of the resource
provisioningState string
The provisioning state of the AutoUpgradeProfile resource.
systemData SystemDataResponse
Azure Resource Manager metadata containing createdBy and modifiedBy information.
type string
The type of the resource. E.g. "Microsoft.Compute/virtualMachines" or "Microsoft.Storage/storageAccounts"
e_tag str
If eTag is provided in the response body, it may also be provided as a header per the normal etag convention. Entity tags are used for comparing two or more entities from the same requested resource. HTTP/1.1 uses entity tags in the etag (section 14.19), If-Match (section 14.24), If-None-Match (section 14.26), and If-Range (section 14.27) header fields.
id str
The provider-assigned unique ID for this managed resource.
name str
The name of the resource
provisioning_state str
The provisioning state of the AutoUpgradeProfile resource.
system_data SystemDataResponse
Azure Resource Manager metadata containing createdBy and modifiedBy information.
type str
The type of the resource. E.g. "Microsoft.Compute/virtualMachines" or "Microsoft.Storage/storageAccounts"
eTag String
If eTag is provided in the response body, it may also be provided as a header per the normal etag convention. Entity tags are used for comparing two or more entities from the same requested resource. HTTP/1.1 uses entity tags in the etag (section 14.19), If-Match (section 14.24), If-None-Match (section 14.26), and If-Range (section 14.27) header fields.
id String
The provider-assigned unique ID for this managed resource.
name String
The name of the resource
provisioningState String
The provisioning state of the AutoUpgradeProfile resource.
systemData Property Map
Azure Resource Manager metadata containing createdBy and modifiedBy information.
type String
The type of the resource. E.g. "Microsoft.Compute/virtualMachines" or "Microsoft.Storage/storageAccounts"

Supporting Types

AutoUpgradeNodeImageSelection
, AutoUpgradeNodeImageSelectionArgs

Type This property is required. string | Pulumi.AzureNative.ContainerService.AutoUpgradeNodeImageSelectionType
The node image upgrade type.
Type This property is required. string | AutoUpgradeNodeImageSelectionType
The node image upgrade type.
type This property is required. String | AutoUpgradeNodeImageSelectionType
The node image upgrade type.
type This property is required. string | AutoUpgradeNodeImageSelectionType
The node image upgrade type.
type This property is required. str | AutoUpgradeNodeImageSelectionType
The node image upgrade type.
type This property is required. String | "Latest" | "Consistent"
The node image upgrade type.

AutoUpgradeNodeImageSelectionResponse
, AutoUpgradeNodeImageSelectionResponseArgs

Type This property is required. string
The node image upgrade type.
Type This property is required. string
The node image upgrade type.
type This property is required. String
The node image upgrade type.
type This property is required. string
The node image upgrade type.
type This property is required. str
The node image upgrade type.
type This property is required. String
The node image upgrade type.

AutoUpgradeNodeImageSelectionType
, AutoUpgradeNodeImageSelectionTypeArgs

Latest
LatestUse the latest image version when upgrading nodes. Clusters may use different image versions (e.g., 'AKSUbuntu-1804gen2containerd-2021.10.12' and 'AKSUbuntu-1804gen2containerd-2021.10.19') because, for example, the latest available version is different in different regions.
Consistent
ConsistentThe image versions to upgrade nodes to are selected as described below: for each node pool in managed clusters affected by the update run, the system selects the latest image version such that it is available across all other node pools (in all other clusters) of the same image type. As a result, all node pools of the same image type will be upgraded to the same image version. For example, if the latest image version for image type 'AKSUbuntu-1804gen2containerd' is 'AKSUbuntu-1804gen2containerd-2021.10.12' for a node pool in cluster A in region X, and is 'AKSUbuntu-1804gen2containerd-2021.10.17' for a node pool in cluster B in region Y, the system will upgrade both node pools to image version 'AKSUbuntu-1804gen2containerd-2021.10.12'.
AutoUpgradeNodeImageSelectionTypeLatest
LatestUse the latest image version when upgrading nodes. Clusters may use different image versions (e.g., 'AKSUbuntu-1804gen2containerd-2021.10.12' and 'AKSUbuntu-1804gen2containerd-2021.10.19') because, for example, the latest available version is different in different regions.
AutoUpgradeNodeImageSelectionTypeConsistent
ConsistentThe image versions to upgrade nodes to are selected as described below: for each node pool in managed clusters affected by the update run, the system selects the latest image version such that it is available across all other node pools (in all other clusters) of the same image type. As a result, all node pools of the same image type will be upgraded to the same image version. For example, if the latest image version for image type 'AKSUbuntu-1804gen2containerd' is 'AKSUbuntu-1804gen2containerd-2021.10.12' for a node pool in cluster A in region X, and is 'AKSUbuntu-1804gen2containerd-2021.10.17' for a node pool in cluster B in region Y, the system will upgrade both node pools to image version 'AKSUbuntu-1804gen2containerd-2021.10.12'.
Latest
LatestUse the latest image version when upgrading nodes. Clusters may use different image versions (e.g., 'AKSUbuntu-1804gen2containerd-2021.10.12' and 'AKSUbuntu-1804gen2containerd-2021.10.19') because, for example, the latest available version is different in different regions.
Consistent
ConsistentThe image versions to upgrade nodes to are selected as described below: for each node pool in managed clusters affected by the update run, the system selects the latest image version such that it is available across all other node pools (in all other clusters) of the same image type. As a result, all node pools of the same image type will be upgraded to the same image version. For example, if the latest image version for image type 'AKSUbuntu-1804gen2containerd' is 'AKSUbuntu-1804gen2containerd-2021.10.12' for a node pool in cluster A in region X, and is 'AKSUbuntu-1804gen2containerd-2021.10.17' for a node pool in cluster B in region Y, the system will upgrade both node pools to image version 'AKSUbuntu-1804gen2containerd-2021.10.12'.
Latest
LatestUse the latest image version when upgrading nodes. Clusters may use different image versions (e.g., 'AKSUbuntu-1804gen2containerd-2021.10.12' and 'AKSUbuntu-1804gen2containerd-2021.10.19') because, for example, the latest available version is different in different regions.
Consistent
ConsistentThe image versions to upgrade nodes to are selected as described below: for each node pool in managed clusters affected by the update run, the system selects the latest image version such that it is available across all other node pools (in all other clusters) of the same image type. As a result, all node pools of the same image type will be upgraded to the same image version. For example, if the latest image version for image type 'AKSUbuntu-1804gen2containerd' is 'AKSUbuntu-1804gen2containerd-2021.10.12' for a node pool in cluster A in region X, and is 'AKSUbuntu-1804gen2containerd-2021.10.17' for a node pool in cluster B in region Y, the system will upgrade both node pools to image version 'AKSUbuntu-1804gen2containerd-2021.10.12'.
LATEST
LatestUse the latest image version when upgrading nodes. Clusters may use different image versions (e.g., 'AKSUbuntu-1804gen2containerd-2021.10.12' and 'AKSUbuntu-1804gen2containerd-2021.10.19') because, for example, the latest available version is different in different regions.
CONSISTENT
ConsistentThe image versions to upgrade nodes to are selected as described below: for each node pool in managed clusters affected by the update run, the system selects the latest image version such that it is available across all other node pools (in all other clusters) of the same image type. As a result, all node pools of the same image type will be upgraded to the same image version. For example, if the latest image version for image type 'AKSUbuntu-1804gen2containerd' is 'AKSUbuntu-1804gen2containerd-2021.10.12' for a node pool in cluster A in region X, and is 'AKSUbuntu-1804gen2containerd-2021.10.17' for a node pool in cluster B in region Y, the system will upgrade both node pools to image version 'AKSUbuntu-1804gen2containerd-2021.10.12'.
"Latest"
LatestUse the latest image version when upgrading nodes. Clusters may use different image versions (e.g., 'AKSUbuntu-1804gen2containerd-2021.10.12' and 'AKSUbuntu-1804gen2containerd-2021.10.19') because, for example, the latest available version is different in different regions.
"Consistent"
ConsistentThe image versions to upgrade nodes to are selected as described below: for each node pool in managed clusters affected by the update run, the system selects the latest image version such that it is available across all other node pools (in all other clusters) of the same image type. As a result, all node pools of the same image type will be upgraded to the same image version. For example, if the latest image version for image type 'AKSUbuntu-1804gen2containerd' is 'AKSUbuntu-1804gen2containerd-2021.10.12' for a node pool in cluster A in region X, and is 'AKSUbuntu-1804gen2containerd-2021.10.17' for a node pool in cluster B in region Y, the system will upgrade both node pools to image version 'AKSUbuntu-1804gen2containerd-2021.10.12'.

SystemDataResponse
, SystemDataResponseArgs

CreatedAt string
The timestamp of resource creation (UTC).
CreatedBy string
The identity that created the resource.
CreatedByType string
The type of identity that created the resource.
LastModifiedAt string
The timestamp of resource last modification (UTC)
LastModifiedBy string
The identity that last modified the resource.
LastModifiedByType string
The type of identity that last modified the resource.
CreatedAt string
The timestamp of resource creation (UTC).
CreatedBy string
The identity that created the resource.
CreatedByType string
The type of identity that created the resource.
LastModifiedAt string
The timestamp of resource last modification (UTC)
LastModifiedBy string
The identity that last modified the resource.
LastModifiedByType string
The type of identity that last modified the resource.
createdAt String
The timestamp of resource creation (UTC).
createdBy String
The identity that created the resource.
createdByType String
The type of identity that created the resource.
lastModifiedAt String
The timestamp of resource last modification (UTC)
lastModifiedBy String
The identity that last modified the resource.
lastModifiedByType String
The type of identity that last modified the resource.
createdAt string
The timestamp of resource creation (UTC).
createdBy string
The identity that created the resource.
createdByType string
The type of identity that created the resource.
lastModifiedAt string
The timestamp of resource last modification (UTC)
lastModifiedBy string
The identity that last modified the resource.
lastModifiedByType string
The type of identity that last modified the resource.
created_at str
The timestamp of resource creation (UTC).
created_by str
The identity that created the resource.
created_by_type str
The type of identity that created the resource.
last_modified_at str
The timestamp of resource last modification (UTC)
last_modified_by str
The identity that last modified the resource.
last_modified_by_type str
The type of identity that last modified the resource.
createdAt String
The timestamp of resource creation (UTC).
createdBy String
The identity that created the resource.
createdByType String
The type of identity that created the resource.
lastModifiedAt String
The timestamp of resource last modification (UTC)
lastModifiedBy String
The identity that last modified the resource.
lastModifiedByType String
The type of identity that last modified the resource.

UpgradeChannel
, UpgradeChannelArgs

Rapid
rapidAutomatically upgrade the cluster to the latest supported patch release on the latest supported minor version. In cases where the cluster is at a version of Kubernetes that is at an N-2 minor version where N is the latest supported minor version, the cluster first upgrades to the latest supported patch version on N-1 minor version. For example, if a cluster is running version 1.17.7 and versions 1.17.9, 1.18.4, 1.18.6, and 1.19.1 are available, your cluster first is upgraded to 1.18.6, then is upgraded to 1.19.1.
Stable
stableAutomatically upgrade the cluster to the latest supported patch release on minor version N-1, where N is the latest supported minor version. For example, if a cluster is running version 1.17.7 and versions 1.17.9, 1.18.4, 1.18.6, and 1.19.1 are available, your cluster is upgraded to 1.18.6.
Patch
patchAutomatically upgrade the cluster to the latest supported patch version when it becomes available while keeping the minor version the same. For example, if a cluster is running version 1.17.7 and versions 1.17.9, 1.18.4, 1.18.6, and 1.19.1 are available, your cluster is upgraded to 1.17.9.
Node_image
node-imageAutomatically upgrade the node image to the latest version available. Microsoft provides patches and new images for image nodes frequently (usually weekly), but your running nodes won't get the new images unless you do a node image upgrade. Turning on the node-image channel will automatically update your node images whenever a new version is available.
None
noneDisables auto-upgrades and keeps the cluster at its current version of Kubernetes.
UpgradeChannelRapid
rapidAutomatically upgrade the cluster to the latest supported patch release on the latest supported minor version. In cases where the cluster is at a version of Kubernetes that is at an N-2 minor version where N is the latest supported minor version, the cluster first upgrades to the latest supported patch version on N-1 minor version. For example, if a cluster is running version 1.17.7 and versions 1.17.9, 1.18.4, 1.18.6, and 1.19.1 are available, your cluster first is upgraded to 1.18.6, then is upgraded to 1.19.1.
UpgradeChannelStable
stableAutomatically upgrade the cluster to the latest supported patch release on minor version N-1, where N is the latest supported minor version. For example, if a cluster is running version 1.17.7 and versions 1.17.9, 1.18.4, 1.18.6, and 1.19.1 are available, your cluster is upgraded to 1.18.6.
UpgradeChannelPatch
patchAutomatically upgrade the cluster to the latest supported patch version when it becomes available while keeping the minor version the same. For example, if a cluster is running version 1.17.7 and versions 1.17.9, 1.18.4, 1.18.6, and 1.19.1 are available, your cluster is upgraded to 1.17.9.
UpgradeChannel_Node_Image
node-imageAutomatically upgrade the node image to the latest version available. Microsoft provides patches and new images for image nodes frequently (usually weekly), but your running nodes won't get the new images unless you do a node image upgrade. Turning on the node-image channel will automatically update your node images whenever a new version is available.
UpgradeChannelNone
noneDisables auto-upgrades and keeps the cluster at its current version of Kubernetes.
Rapid
rapidAutomatically upgrade the cluster to the latest supported patch release on the latest supported minor version. In cases where the cluster is at a version of Kubernetes that is at an N-2 minor version where N is the latest supported minor version, the cluster first upgrades to the latest supported patch version on N-1 minor version. For example, if a cluster is running version 1.17.7 and versions 1.17.9, 1.18.4, 1.18.6, and 1.19.1 are available, your cluster first is upgraded to 1.18.6, then is upgraded to 1.19.1.
Stable
stableAutomatically upgrade the cluster to the latest supported patch release on minor version N-1, where N is the latest supported minor version. For example, if a cluster is running version 1.17.7 and versions 1.17.9, 1.18.4, 1.18.6, and 1.19.1 are available, your cluster is upgraded to 1.18.6.
Patch
patchAutomatically upgrade the cluster to the latest supported patch version when it becomes available while keeping the minor version the same. For example, if a cluster is running version 1.17.7 and versions 1.17.9, 1.18.4, 1.18.6, and 1.19.1 are available, your cluster is upgraded to 1.17.9.
Nodeimage
node-imageAutomatically upgrade the node image to the latest version available. Microsoft provides patches and new images for image nodes frequently (usually weekly), but your running nodes won't get the new images unless you do a node image upgrade. Turning on the node-image channel will automatically update your node images whenever a new version is available.
None
noneDisables auto-upgrades and keeps the cluster at its current version of Kubernetes.
Rapid
rapidAutomatically upgrade the cluster to the latest supported patch release on the latest supported minor version. In cases where the cluster is at a version of Kubernetes that is at an N-2 minor version where N is the latest supported minor version, the cluster first upgrades to the latest supported patch version on N-1 minor version. For example, if a cluster is running version 1.17.7 and versions 1.17.9, 1.18.4, 1.18.6, and 1.19.1 are available, your cluster first is upgraded to 1.18.6, then is upgraded to 1.19.1.
Stable
stableAutomatically upgrade the cluster to the latest supported patch release on minor version N-1, where N is the latest supported minor version. For example, if a cluster is running version 1.17.7 and versions 1.17.9, 1.18.4, 1.18.6, and 1.19.1 are available, your cluster is upgraded to 1.18.6.
Patch
patchAutomatically upgrade the cluster to the latest supported patch version when it becomes available while keeping the minor version the same. For example, if a cluster is running version 1.17.7 and versions 1.17.9, 1.18.4, 1.18.6, and 1.19.1 are available, your cluster is upgraded to 1.17.9.
Node_image
node-imageAutomatically upgrade the node image to the latest version available. Microsoft provides patches and new images for image nodes frequently (usually weekly), but your running nodes won't get the new images unless you do a node image upgrade. Turning on the node-image channel will automatically update your node images whenever a new version is available.
None
noneDisables auto-upgrades and keeps the cluster at its current version of Kubernetes.
RAPID
rapidAutomatically upgrade the cluster to the latest supported patch release on the latest supported minor version. In cases where the cluster is at a version of Kubernetes that is at an N-2 minor version where N is the latest supported minor version, the cluster first upgrades to the latest supported patch version on N-1 minor version. For example, if a cluster is running version 1.17.7 and versions 1.17.9, 1.18.4, 1.18.6, and 1.19.1 are available, your cluster first is upgraded to 1.18.6, then is upgraded to 1.19.1.
STABLE
stableAutomatically upgrade the cluster to the latest supported patch release on minor version N-1, where N is the latest supported minor version. For example, if a cluster is running version 1.17.7 and versions 1.17.9, 1.18.4, 1.18.6, and 1.19.1 are available, your cluster is upgraded to 1.18.6.
PATCH
patchAutomatically upgrade the cluster to the latest supported patch version when it becomes available while keeping the minor version the same. For example, if a cluster is running version 1.17.7 and versions 1.17.9, 1.18.4, 1.18.6, and 1.19.1 are available, your cluster is upgraded to 1.17.9.
NODE_IMAGE
node-imageAutomatically upgrade the node image to the latest version available. Microsoft provides patches and new images for image nodes frequently (usually weekly), but your running nodes won't get the new images unless you do a node image upgrade. Turning on the node-image channel will automatically update your node images whenever a new version is available.
NONE
noneDisables auto-upgrades and keeps the cluster at its current version of Kubernetes.
"rapid"
rapidAutomatically upgrade the cluster to the latest supported patch release on the latest supported minor version. In cases where the cluster is at a version of Kubernetes that is at an N-2 minor version where N is the latest supported minor version, the cluster first upgrades to the latest supported patch version on N-1 minor version. For example, if a cluster is running version 1.17.7 and versions 1.17.9, 1.18.4, 1.18.6, and 1.19.1 are available, your cluster first is upgraded to 1.18.6, then is upgraded to 1.19.1.
"stable"
stableAutomatically upgrade the cluster to the latest supported patch release on minor version N-1, where N is the latest supported minor version. For example, if a cluster is running version 1.17.7 and versions 1.17.9, 1.18.4, 1.18.6, and 1.19.1 are available, your cluster is upgraded to 1.18.6.
"patch"
patchAutomatically upgrade the cluster to the latest supported patch version when it becomes available while keeping the minor version the same. For example, if a cluster is running version 1.17.7 and versions 1.17.9, 1.18.4, 1.18.6, and 1.19.1 are available, your cluster is upgraded to 1.17.9.
"node-image"
node-imageAutomatically upgrade the node image to the latest version available. Microsoft provides patches and new images for image nodes frequently (usually weekly), but your running nodes won't get the new images unless you do a node image upgrade. Turning on the node-image channel will automatically update your node images whenever a new version is available.
"none"
noneDisables auto-upgrades and keeps the cluster at its current version of Kubernetes.

Import

An existing resource can be imported using its type token, name, and identifier, e.g.

$ pulumi import azure-native:containerservice:AutoUpgradeProfile autoupgradeprofile1 /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ContainerService/fleets/{fleetName}/autoUpgradeProfiles/{autoUpgradeProfileName}
Copy

To learn more about importing existing cloud resources, see Importing resources.

Package Details

Repository
azure-native-v2 pulumi/pulumi-azure-native
License
Apache-2.0
These are the docs for Azure Native v2. We recommenend using the latest version, Azure Native v3.
Azure Native v2 v2.90.0 published on Thursday, Mar 27, 2025 by Pulumi
pulumi/pulumi-azure-native