Docs Home Pulumi IaC Pulumi ESC Pulumi Insights Pulumi Cloud Packages Tutorials
  1. Packages
  2. Azure Native
  3. API Docs
  4. containerservice
  5. UpdateRun
This is the latest version of Azure Native. Use the Azure Native v2 docs if using the v2 version of this package.
Azure Native v3.1.0 published on Tuesday, Apr 8, 2025 by Pulumi
pulumi/pulumi-azure-native

azure-native.containerservice.UpdateRun

Explore with Pulumi AI

This is the latest version of Azure Native. Use the Azure Native v2 docs if using the v2 version of this package.
Azure Native v3.1.0 published on Tuesday, Apr 8, 2025 by Pulumi
pulumi/pulumi-azure-native

A multi-stage process to perform update operations across members of a Fleet.

Uses Azure REST API version 2024-05-02-preview. In version 2.x of the Azure Native provider, it used API version 2023-03-15-preview.

Other available API versions: 2023-03-15-preview, 2023-06-15-preview, 2023-08-15-preview, 2023-10-15, 2024-02-02-preview, 2024-04-01. These can be accessed by generating a local SDK package using the CLI command pulumi package add azure-native containerservice [ApiVersion]. See the version guide for details.

Example Usage

Create an UpdateRun.

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

return await Deployment.RunAsync(() => 
{
    var updateRun = new AzureNative.ContainerService.UpdateRun("updateRun", new()
    {
        FleetName = "fleet1",
        ManagedClusterUpdate = new AzureNative.ContainerService.Inputs.ManagedClusterUpdateArgs
        {
            NodeImageSelection = new AzureNative.ContainerService.Inputs.NodeImageSelectionArgs
            {
                Type = AzureNative.ContainerService.NodeImageSelectionType.Latest,
            },
            Upgrade = new AzureNative.ContainerService.Inputs.ManagedClusterUpgradeSpecArgs
            {
                KubernetesVersion = "1.26.1",
                Type = AzureNative.ContainerService.ManagedClusterUpgradeType.Full,
            },
        },
        ResourceGroupName = "rg1",
        Strategy = new AzureNative.ContainerService.Inputs.UpdateRunStrategyArgs
        {
            Stages = new[]
            {
                new AzureNative.ContainerService.Inputs.UpdateStageArgs
                {
                    AfterStageWaitInSeconds = 3600,
                    Groups = new[]
                    {
                        new AzureNative.ContainerService.Inputs.UpdateGroupArgs
                        {
                            Name = "group-a",
                        },
                    },
                    Name = "stage1",
                },
            },
        },
        UpdateRunName = "run1",
        UpdateStrategyId = "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.ContainerService/fleets/myFleet/updateStrategies/strategy1",
    });

});
Copy
package main

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

func main() {
	pulumi.Run(func(ctx *pulumi.Context) error {
		_, err := containerservice.NewUpdateRun(ctx, "updateRun", &containerservice.UpdateRunArgs{
			FleetName: pulumi.String("fleet1"),
			ManagedClusterUpdate: &containerservice.ManagedClusterUpdateArgs{
				NodeImageSelection: &containerservice.NodeImageSelectionArgs{
					Type: pulumi.String(containerservice.NodeImageSelectionTypeLatest),
				},
				Upgrade: &containerservice.ManagedClusterUpgradeSpecArgs{
					KubernetesVersion: pulumi.String("1.26.1"),
					Type:              pulumi.String(containerservice.ManagedClusterUpgradeTypeFull),
				},
			},
			ResourceGroupName: pulumi.String("rg1"),
			Strategy: &containerservice.UpdateRunStrategyArgs{
				Stages: containerservice.UpdateStageArray{
					&containerservice.UpdateStageArgs{
						AfterStageWaitInSeconds: pulumi.Int(3600),
						Groups: containerservice.UpdateGroupArray{
							&containerservice.UpdateGroupArgs{
								Name: pulumi.String("group-a"),
							},
						},
						Name: pulumi.String("stage1"),
					},
				},
			},
			UpdateRunName:    pulumi.String("run1"),
			UpdateStrategyId: pulumi.String("/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.ContainerService/fleets/myFleet/updateStrategies/strategy1"),
		})
		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.UpdateRun;
import com.pulumi.azurenative.containerservice.UpdateRunArgs;
import com.pulumi.azurenative.containerservice.inputs.ManagedClusterUpdateArgs;
import com.pulumi.azurenative.containerservice.inputs.NodeImageSelectionArgs;
import com.pulumi.azurenative.containerservice.inputs.ManagedClusterUpgradeSpecArgs;
import com.pulumi.azurenative.containerservice.inputs.UpdateRunStrategyArgs;
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 updateRun = new UpdateRun("updateRun", UpdateRunArgs.builder()
            .fleetName("fleet1")
            .managedClusterUpdate(ManagedClusterUpdateArgs.builder()
                .nodeImageSelection(NodeImageSelectionArgs.builder()
                    .type("Latest")
                    .build())
                .upgrade(ManagedClusterUpgradeSpecArgs.builder()
                    .kubernetesVersion("1.26.1")
                    .type("Full")
                    .build())
                .build())
            .resourceGroupName("rg1")
            .strategy(UpdateRunStrategyArgs.builder()
                .stages(UpdateStageArgs.builder()
                    .afterStageWaitInSeconds(3600)
                    .groups(UpdateGroupArgs.builder()
                        .name("group-a")
                        .build())
                    .name("stage1")
                    .build())
                .build())
            .updateRunName("run1")
            .updateStrategyId("/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.ContainerService/fleets/myFleet/updateStrategies/strategy1")
            .build());

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

const updateRun = new azure_native.containerservice.UpdateRun("updateRun", {
    fleetName: "fleet1",
    managedClusterUpdate: {
        nodeImageSelection: {
            type: azure_native.containerservice.NodeImageSelectionType.Latest,
        },
        upgrade: {
            kubernetesVersion: "1.26.1",
            type: azure_native.containerservice.ManagedClusterUpgradeType.Full,
        },
    },
    resourceGroupName: "rg1",
    strategy: {
        stages: [{
            afterStageWaitInSeconds: 3600,
            groups: [{
                name: "group-a",
            }],
            name: "stage1",
        }],
    },
    updateRunName: "run1",
    updateStrategyId: "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.ContainerService/fleets/myFleet/updateStrategies/strategy1",
});
Copy
import pulumi
import pulumi_azure_native as azure_native

update_run = azure_native.containerservice.UpdateRun("updateRun",
    fleet_name="fleet1",
    managed_cluster_update={
        "node_image_selection": {
            "type": azure_native.containerservice.NodeImageSelectionType.LATEST,
        },
        "upgrade": {
            "kubernetes_version": "1.26.1",
            "type": azure_native.containerservice.ManagedClusterUpgradeType.FULL,
        },
    },
    resource_group_name="rg1",
    strategy={
        "stages": [{
            "after_stage_wait_in_seconds": 3600,
            "groups": [{
                "name": "group-a",
            }],
            "name": "stage1",
        }],
    },
    update_run_name="run1",
    update_strategy_id="/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.ContainerService/fleets/myFleet/updateStrategies/strategy1")
Copy
resources:
  updateRun:
    type: azure-native:containerservice:UpdateRun
    properties:
      fleetName: fleet1
      managedClusterUpdate:
        nodeImageSelection:
          type: Latest
        upgrade:
          kubernetesVersion: 1.26.1
          type: Full
      resourceGroupName: rg1
      strategy:
        stages:
          - afterStageWaitInSeconds: 3600
            groups:
              - name: group-a
            name: stage1
      updateRunName: run1
      updateStrategyId: /subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.ContainerService/fleets/myFleet/updateStrategies/strategy1
Copy

Create UpdateRun Resource

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

Constructor syntax

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

@overload
def UpdateRun(resource_name: str,
              opts: Optional[ResourceOptions] = None,
              fleet_name: Optional[str] = None,
              managed_cluster_update: Optional[ManagedClusterUpdateArgs] = None,
              resource_group_name: Optional[str] = None,
              strategy: Optional[UpdateRunStrategyArgs] = None,
              update_run_name: Optional[str] = None,
              update_strategy_id: Optional[str] = None)
func NewUpdateRun(ctx *Context, name string, args UpdateRunArgs, opts ...ResourceOption) (*UpdateRun, error)
public UpdateRun(string name, UpdateRunArgs args, CustomResourceOptions? opts = null)
public UpdateRun(String name, UpdateRunArgs args)
public UpdateRun(String name, UpdateRunArgs args, CustomResourceOptions options)

type: azure-native:containerservice:UpdateRun
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. UpdateRunArgs
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. UpdateRunArgs
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. UpdateRunArgs
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. UpdateRunArgs
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. UpdateRunArgs
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 azure_nativeUpdateRunResource = new AzureNative.ContainerService.UpdateRun("azure-nativeUpdateRunResource", new()
{
    FleetName = "string",
    ManagedClusterUpdate = new AzureNative.ContainerService.Inputs.ManagedClusterUpdateArgs
    {
        Upgrade = new AzureNative.ContainerService.Inputs.ManagedClusterUpgradeSpecArgs
        {
            Type = "string",
            KubernetesVersion = "string",
        },
        NodeImageSelection = new AzureNative.ContainerService.Inputs.NodeImageSelectionArgs
        {
            Type = "string",
        },
    },
    ResourceGroupName = "string",
    Strategy = new AzureNative.ContainerService.Inputs.UpdateRunStrategyArgs
    {
        Stages = new[]
        {
            new AzureNative.ContainerService.Inputs.UpdateStageArgs
            {
                Name = "string",
                AfterStageWaitInSeconds = 0,
                Groups = new[]
                {
                    new AzureNative.ContainerService.Inputs.UpdateGroupArgs
                    {
                        Name = "string",
                    },
                },
            },
        },
    },
    UpdateRunName = "string",
    UpdateStrategyId = "string",
});
Copy
example, err := containerservice.NewUpdateRun(ctx, "azure-nativeUpdateRunResource", &containerservice.UpdateRunArgs{
	FleetName: pulumi.String("string"),
	ManagedClusterUpdate: &containerservice.ManagedClusterUpdateArgs{
		Upgrade: &containerservice.ManagedClusterUpgradeSpecArgs{
			Type:              pulumi.String("string"),
			KubernetesVersion: pulumi.String("string"),
		},
		NodeImageSelection: &containerservice.NodeImageSelectionArgs{
			Type: pulumi.String("string"),
		},
	},
	ResourceGroupName: pulumi.String("string"),
	Strategy: &containerservice.UpdateRunStrategyArgs{
		Stages: containerservice.UpdateStageArray{
			&containerservice.UpdateStageArgs{
				Name:                    pulumi.String("string"),
				AfterStageWaitInSeconds: pulumi.Int(0),
				Groups: containerservice.UpdateGroupArray{
					&containerservice.UpdateGroupArgs{
						Name: pulumi.String("string"),
					},
				},
			},
		},
	},
	UpdateRunName:    pulumi.String("string"),
	UpdateStrategyId: pulumi.String("string"),
})
Copy
var azure_nativeUpdateRunResource = new UpdateRun("azure-nativeUpdateRunResource", UpdateRunArgs.builder()
    .fleetName("string")
    .managedClusterUpdate(ManagedClusterUpdateArgs.builder()
        .upgrade(ManagedClusterUpgradeSpecArgs.builder()
            .type("string")
            .kubernetesVersion("string")
            .build())
        .nodeImageSelection(NodeImageSelectionArgs.builder()
            .type("string")
            .build())
        .build())
    .resourceGroupName("string")
    .strategy(UpdateRunStrategyArgs.builder()
        .stages(UpdateStageArgs.builder()
            .name("string")
            .afterStageWaitInSeconds(0)
            .groups(UpdateGroupArgs.builder()
                .name("string")
                .build())
            .build())
        .build())
    .updateRunName("string")
    .updateStrategyId("string")
    .build());
Copy
azure_native_update_run_resource = azure_native.containerservice.UpdateRun("azure-nativeUpdateRunResource",
    fleet_name="string",
    managed_cluster_update={
        "upgrade": {
            "type": "string",
            "kubernetes_version": "string",
        },
        "node_image_selection": {
            "type": "string",
        },
    },
    resource_group_name="string",
    strategy={
        "stages": [{
            "name": "string",
            "after_stage_wait_in_seconds": 0,
            "groups": [{
                "name": "string",
            }],
        }],
    },
    update_run_name="string",
    update_strategy_id="string")
Copy
const azure_nativeUpdateRunResource = new azure_native.containerservice.UpdateRun("azure-nativeUpdateRunResource", {
    fleetName: "string",
    managedClusterUpdate: {
        upgrade: {
            type: "string",
            kubernetesVersion: "string",
        },
        nodeImageSelection: {
            type: "string",
        },
    },
    resourceGroupName: "string",
    strategy: {
        stages: [{
            name: "string",
            afterStageWaitInSeconds: 0,
            groups: [{
                name: "string",
            }],
        }],
    },
    updateRunName: "string",
    updateStrategyId: "string",
});
Copy
type: azure-native:containerservice:UpdateRun
properties:
    fleetName: string
    managedClusterUpdate:
        nodeImageSelection:
            type: string
        upgrade:
            kubernetesVersion: string
            type: string
    resourceGroupName: string
    strategy:
        stages:
            - afterStageWaitInSeconds: 0
              groups:
                - name: string
              name: string
    updateRunName: string
    updateStrategyId: string
Copy

UpdateRun 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 UpdateRun resource accepts the following input properties:

FleetName
This property is required.
Changes to this property will trigger replacement.
string
The name of the Fleet resource.
ManagedClusterUpdate This property is required. Pulumi.AzureNative.ContainerService.Inputs.ManagedClusterUpdate
The update to be applied to all clusters in the UpdateRun. The managedClusterUpdate can be modified until the run is started.
ResourceGroupName
This property is required.
Changes to this property will trigger replacement.
string
The name of the resource group. The name is case insensitive.
Strategy Pulumi.AzureNative.ContainerService.Inputs.UpdateRunStrategy
The strategy defines the order in which the clusters will be updated. If not set, all members will be updated sequentially. The UpdateRun status will show a single UpdateStage and a single UpdateGroup targeting all members. The strategy of the UpdateRun can be modified until the run is started.
UpdateRunName Changes to this property will trigger replacement. string
The name of the UpdateRun resource.
UpdateStrategyId Changes to this property will trigger replacement. string

The resource id of the FleetUpdateStrategy resource to reference.

When creating a new run, there are three ways to define a strategy for the run:

  1. Define a new strategy in place: Set the "strategy" field.
  2. Use an existing strategy: Set the "updateStrategyId" field. (since 2023-08-15-preview)
  3. Use the default strategy to update all the members one by one: Leave both "updateStrategyId" and "strategy" unset. (since 2023-08-15-preview)

Setting both "updateStrategyId" and "strategy" is invalid.

UpdateRuns created by "updateStrategyId" snapshot the referenced UpdateStrategy at the time of creation and store it in the "strategy" field. Subsequent changes to the referenced FleetUpdateStrategy resource do not propagate. UpdateRunStrategy changes can be made directly on the "strategy" field before launching the UpdateRun.

FleetName
This property is required.
Changes to this property will trigger replacement.
string
The name of the Fleet resource.
ManagedClusterUpdate This property is required. ManagedClusterUpdateArgs
The update to be applied to all clusters in the UpdateRun. The managedClusterUpdate can be modified until the run is started.
ResourceGroupName
This property is required.
Changes to this property will trigger replacement.
string
The name of the resource group. The name is case insensitive.
Strategy UpdateRunStrategyArgs
The strategy defines the order in which the clusters will be updated. If not set, all members will be updated sequentially. The UpdateRun status will show a single UpdateStage and a single UpdateGroup targeting all members. The strategy of the UpdateRun can be modified until the run is started.
UpdateRunName Changes to this property will trigger replacement. string
The name of the UpdateRun resource.
UpdateStrategyId Changes to this property will trigger replacement. string

The resource id of the FleetUpdateStrategy resource to reference.

When creating a new run, there are three ways to define a strategy for the run:

  1. Define a new strategy in place: Set the "strategy" field.
  2. Use an existing strategy: Set the "updateStrategyId" field. (since 2023-08-15-preview)
  3. Use the default strategy to update all the members one by one: Leave both "updateStrategyId" and "strategy" unset. (since 2023-08-15-preview)

Setting both "updateStrategyId" and "strategy" is invalid.

UpdateRuns created by "updateStrategyId" snapshot the referenced UpdateStrategy at the time of creation and store it in the "strategy" field. Subsequent changes to the referenced FleetUpdateStrategy resource do not propagate. UpdateRunStrategy changes can be made directly on the "strategy" field before launching the UpdateRun.

fleetName
This property is required.
Changes to this property will trigger replacement.
String
The name of the Fleet resource.
managedClusterUpdate This property is required. ManagedClusterUpdate
The update to be applied to all clusters in the UpdateRun. The managedClusterUpdate can be modified until the run is started.
resourceGroupName
This property is required.
Changes to this property will trigger replacement.
String
The name of the resource group. The name is case insensitive.
strategy UpdateRunStrategy
The strategy defines the order in which the clusters will be updated. If not set, all members will be updated sequentially. The UpdateRun status will show a single UpdateStage and a single UpdateGroup targeting all members. The strategy of the UpdateRun can be modified until the run is started.
updateRunName Changes to this property will trigger replacement. String
The name of the UpdateRun resource.
updateStrategyId Changes to this property will trigger replacement. String

The resource id of the FleetUpdateStrategy resource to reference.

When creating a new run, there are three ways to define a strategy for the run:

  1. Define a new strategy in place: Set the "strategy" field.
  2. Use an existing strategy: Set the "updateStrategyId" field. (since 2023-08-15-preview)
  3. Use the default strategy to update all the members one by one: Leave both "updateStrategyId" and "strategy" unset. (since 2023-08-15-preview)

Setting both "updateStrategyId" and "strategy" is invalid.

UpdateRuns created by "updateStrategyId" snapshot the referenced UpdateStrategy at the time of creation and store it in the "strategy" field. Subsequent changes to the referenced FleetUpdateStrategy resource do not propagate. UpdateRunStrategy changes can be made directly on the "strategy" field before launching the UpdateRun.

fleetName
This property is required.
Changes to this property will trigger replacement.
string
The name of the Fleet resource.
managedClusterUpdate This property is required. ManagedClusterUpdate
The update to be applied to all clusters in the UpdateRun. The managedClusterUpdate can be modified until the run is started.
resourceGroupName
This property is required.
Changes to this property will trigger replacement.
string
The name of the resource group. The name is case insensitive.
strategy UpdateRunStrategy
The strategy defines the order in which the clusters will be updated. If not set, all members will be updated sequentially. The UpdateRun status will show a single UpdateStage and a single UpdateGroup targeting all members. The strategy of the UpdateRun can be modified until the run is started.
updateRunName Changes to this property will trigger replacement. string
The name of the UpdateRun resource.
updateStrategyId Changes to this property will trigger replacement. string

The resource id of the FleetUpdateStrategy resource to reference.

When creating a new run, there are three ways to define a strategy for the run:

  1. Define a new strategy in place: Set the "strategy" field.
  2. Use an existing strategy: Set the "updateStrategyId" field. (since 2023-08-15-preview)
  3. Use the default strategy to update all the members one by one: Leave both "updateStrategyId" and "strategy" unset. (since 2023-08-15-preview)

Setting both "updateStrategyId" and "strategy" is invalid.

UpdateRuns created by "updateStrategyId" snapshot the referenced UpdateStrategy at the time of creation and store it in the "strategy" field. Subsequent changes to the referenced FleetUpdateStrategy resource do not propagate. UpdateRunStrategy changes can be made directly on the "strategy" field before launching the UpdateRun.

fleet_name
This property is required.
Changes to this property will trigger replacement.
str
The name of the Fleet resource.
managed_cluster_update This property is required. ManagedClusterUpdateArgs
The update to be applied to all clusters in the UpdateRun. The managedClusterUpdate can be modified until the run is started.
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.
strategy UpdateRunStrategyArgs
The strategy defines the order in which the clusters will be updated. If not set, all members will be updated sequentially. The UpdateRun status will show a single UpdateStage and a single UpdateGroup targeting all members. The strategy of the UpdateRun can be modified until the run is started.
update_run_name Changes to this property will trigger replacement. str
The name of the UpdateRun resource.
update_strategy_id Changes to this property will trigger replacement. str

The resource id of the FleetUpdateStrategy resource to reference.

When creating a new run, there are three ways to define a strategy for the run:

  1. Define a new strategy in place: Set the "strategy" field.
  2. Use an existing strategy: Set the "updateStrategyId" field. (since 2023-08-15-preview)
  3. Use the default strategy to update all the members one by one: Leave both "updateStrategyId" and "strategy" unset. (since 2023-08-15-preview)

Setting both "updateStrategyId" and "strategy" is invalid.

UpdateRuns created by "updateStrategyId" snapshot the referenced UpdateStrategy at the time of creation and store it in the "strategy" field. Subsequent changes to the referenced FleetUpdateStrategy resource do not propagate. UpdateRunStrategy changes can be made directly on the "strategy" field before launching the UpdateRun.

fleetName
This property is required.
Changes to this property will trigger replacement.
String
The name of the Fleet resource.
managedClusterUpdate This property is required. Property Map
The update to be applied to all clusters in the UpdateRun. The managedClusterUpdate can be modified until the run is started.
resourceGroupName
This property is required.
Changes to this property will trigger replacement.
String
The name of the resource group. The name is case insensitive.
strategy Property Map
The strategy defines the order in which the clusters will be updated. If not set, all members will be updated sequentially. The UpdateRun status will show a single UpdateStage and a single UpdateGroup targeting all members. The strategy of the UpdateRun can be modified until the run is started.
updateRunName Changes to this property will trigger replacement. String
The name of the UpdateRun resource.
updateStrategyId Changes to this property will trigger replacement. String

The resource id of the FleetUpdateStrategy resource to reference.

When creating a new run, there are three ways to define a strategy for the run:

  1. Define a new strategy in place: Set the "strategy" field.
  2. Use an existing strategy: Set the "updateStrategyId" field. (since 2023-08-15-preview)
  3. Use the default strategy to update all the members one by one: Leave both "updateStrategyId" and "strategy" unset. (since 2023-08-15-preview)

Setting both "updateStrategyId" and "strategy" is invalid.

UpdateRuns created by "updateStrategyId" snapshot the referenced UpdateStrategy at the time of creation and store it in the "strategy" field. Subsequent changes to the referenced FleetUpdateStrategy resource do not propagate. UpdateRunStrategy changes can be made directly on the "strategy" field before launching the UpdateRun.

Outputs

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

AzureApiVersion string
The Azure API version of the resource.
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 UpdateRun resource.
Status Pulumi.AzureNative.ContainerService.Outputs.UpdateRunStatusResponse
The status of the UpdateRun.
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"
AzureApiVersion string
The Azure API version of the resource.
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 UpdateRun resource.
Status UpdateRunStatusResponse
The status of the UpdateRun.
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"
azureApiVersion String
The Azure API version of the resource.
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 UpdateRun resource.
status UpdateRunStatusResponse
The status of the UpdateRun.
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"
azureApiVersion string
The Azure API version of the resource.
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 UpdateRun resource.
status UpdateRunStatusResponse
The status of the UpdateRun.
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"
azure_api_version str
The Azure API version of the resource.
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 UpdateRun resource.
status UpdateRunStatusResponse
The status of the UpdateRun.
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"
azureApiVersion String
The Azure API version of the resource.
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 UpdateRun resource.
status Property Map
The status of the UpdateRun.
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

ErrorAdditionalInfoResponse
, ErrorAdditionalInfoResponseArgs

Info This property is required. object
The additional info.
Type This property is required. string
The additional info type.
Info This property is required. interface{}
The additional info.
Type This property is required. string
The additional info type.
info This property is required. Object
The additional info.
type This property is required. String
The additional info type.
info This property is required. any
The additional info.
type This property is required. string
The additional info type.
info This property is required. Any
The additional info.
type This property is required. str
The additional info type.
info This property is required. Any
The additional info.
type This property is required. String
The additional info type.

ErrorDetailResponse
, ErrorDetailResponseArgs

AdditionalInfo This property is required. List<Pulumi.AzureNative.ContainerService.Inputs.ErrorAdditionalInfoResponse>
The error additional info.
Code This property is required. string
The error code.
Details This property is required. List<Pulumi.AzureNative.ContainerService.Inputs.ErrorDetailResponse>
The error details.
Message This property is required. string
The error message.
Target This property is required. string
The error target.
AdditionalInfo This property is required. []ErrorAdditionalInfoResponse
The error additional info.
Code This property is required. string
The error code.
Details This property is required. []ErrorDetailResponse
The error details.
Message This property is required. string
The error message.
Target This property is required. string
The error target.
additionalInfo This property is required. List<ErrorAdditionalInfoResponse>
The error additional info.
code This property is required. String
The error code.
details This property is required. List<ErrorDetailResponse>
The error details.
message This property is required. String
The error message.
target This property is required. String
The error target.
additionalInfo This property is required. ErrorAdditionalInfoResponse[]
The error additional info.
code This property is required. string
The error code.
details This property is required. ErrorDetailResponse[]
The error details.
message This property is required. string
The error message.
target This property is required. string
The error target.
additional_info This property is required. Sequence[ErrorAdditionalInfoResponse]
The error additional info.
code This property is required. str
The error code.
details This property is required. Sequence[ErrorDetailResponse]
The error details.
message This property is required. str
The error message.
target This property is required. str
The error target.
additionalInfo This property is required. List<Property Map>
The error additional info.
code This property is required. String
The error code.
details This property is required. List<Property Map>
The error details.
message This property is required. String
The error message.
target This property is required. String
The error target.

ManagedClusterUpdate
, ManagedClusterUpdateArgs

Upgrade This property is required. Pulumi.AzureNative.ContainerService.Inputs.ManagedClusterUpgradeSpec
The upgrade to apply to the ManagedClusters.
NodeImageSelection Pulumi.AzureNative.ContainerService.Inputs.NodeImageSelection
The node image upgrade to be applied to the target nodes in update run.
Upgrade This property is required. ManagedClusterUpgradeSpec
The upgrade to apply to the ManagedClusters.
NodeImageSelection NodeImageSelection
The node image upgrade to be applied to the target nodes in update run.
upgrade This property is required. ManagedClusterUpgradeSpec
The upgrade to apply to the ManagedClusters.
nodeImageSelection NodeImageSelection
The node image upgrade to be applied to the target nodes in update run.
upgrade This property is required. ManagedClusterUpgradeSpec
The upgrade to apply to the ManagedClusters.
nodeImageSelection NodeImageSelection
The node image upgrade to be applied to the target nodes in update run.
upgrade This property is required. ManagedClusterUpgradeSpec
The upgrade to apply to the ManagedClusters.
node_image_selection NodeImageSelection
The node image upgrade to be applied to the target nodes in update run.
upgrade This property is required. Property Map
The upgrade to apply to the ManagedClusters.
nodeImageSelection Property Map
The node image upgrade to be applied to the target nodes in update run.

ManagedClusterUpdateResponse
, ManagedClusterUpdateResponseArgs

Upgrade This property is required. Pulumi.AzureNative.ContainerService.Inputs.ManagedClusterUpgradeSpecResponse
The upgrade to apply to the ManagedClusters.
NodeImageSelection Pulumi.AzureNative.ContainerService.Inputs.NodeImageSelectionResponse
The node image upgrade to be applied to the target nodes in update run.
Upgrade This property is required. ManagedClusterUpgradeSpecResponse
The upgrade to apply to the ManagedClusters.
NodeImageSelection NodeImageSelectionResponse
The node image upgrade to be applied to the target nodes in update run.
upgrade This property is required. ManagedClusterUpgradeSpecResponse
The upgrade to apply to the ManagedClusters.
nodeImageSelection NodeImageSelectionResponse
The node image upgrade to be applied to the target nodes in update run.
upgrade This property is required. ManagedClusterUpgradeSpecResponse
The upgrade to apply to the ManagedClusters.
nodeImageSelection NodeImageSelectionResponse
The node image upgrade to be applied to the target nodes in update run.
upgrade This property is required. ManagedClusterUpgradeSpecResponse
The upgrade to apply to the ManagedClusters.
node_image_selection NodeImageSelectionResponse
The node image upgrade to be applied to the target nodes in update run.
upgrade This property is required. Property Map
The upgrade to apply to the ManagedClusters.
nodeImageSelection Property Map
The node image upgrade to be applied to the target nodes in update run.

ManagedClusterUpgradeSpec
, ManagedClusterUpgradeSpecArgs

Type This property is required. string | Pulumi.AzureNative.ContainerService.ManagedClusterUpgradeType
ManagedClusterUpgradeType is the type of upgrade to be applied.
KubernetesVersion string
The Kubernetes version to upgrade the member clusters to.
Type This property is required. string | ManagedClusterUpgradeType
ManagedClusterUpgradeType is the type of upgrade to be applied.
KubernetesVersion string
The Kubernetes version to upgrade the member clusters to.
type This property is required. String | ManagedClusterUpgradeType
ManagedClusterUpgradeType is the type of upgrade to be applied.
kubernetesVersion String
The Kubernetes version to upgrade the member clusters to.
type This property is required. string | ManagedClusterUpgradeType
ManagedClusterUpgradeType is the type of upgrade to be applied.
kubernetesVersion string
The Kubernetes version to upgrade the member clusters to.
type This property is required. str | ManagedClusterUpgradeType
ManagedClusterUpgradeType is the type of upgrade to be applied.
kubernetes_version str
The Kubernetes version to upgrade the member clusters to.
type This property is required. String | "Full" | "NodeImageOnly" | "ControlPlaneOnly"
ManagedClusterUpgradeType is the type of upgrade to be applied.
kubernetesVersion String
The Kubernetes version to upgrade the member clusters to.

ManagedClusterUpgradeSpecResponse
, ManagedClusterUpgradeSpecResponseArgs

Type This property is required. string
ManagedClusterUpgradeType is the type of upgrade to be applied.
KubernetesVersion string
The Kubernetes version to upgrade the member clusters to.
Type This property is required. string
ManagedClusterUpgradeType is the type of upgrade to be applied.
KubernetesVersion string
The Kubernetes version to upgrade the member clusters to.
type This property is required. String
ManagedClusterUpgradeType is the type of upgrade to be applied.
kubernetesVersion String
The Kubernetes version to upgrade the member clusters to.
type This property is required. string
ManagedClusterUpgradeType is the type of upgrade to be applied.
kubernetesVersion string
The Kubernetes version to upgrade the member clusters to.
type This property is required. str
ManagedClusterUpgradeType is the type of upgrade to be applied.
kubernetes_version str
The Kubernetes version to upgrade the member clusters to.
type This property is required. String
ManagedClusterUpgradeType is the type of upgrade to be applied.
kubernetesVersion String
The Kubernetes version to upgrade the member clusters to.

ManagedClusterUpgradeType
, ManagedClusterUpgradeTypeArgs

Full
FullFull upgrades the control plane and all agent pools of the target ManagedClusters. Requires the ManagedClusterUpgradeSpec.KubernetesVersion property to be set.
NodeImageOnly
NodeImageOnlyNodeImageOnly upgrades only the node images of the target ManagedClusters. Requires the ManagedClusterUpgradeSpec.KubernetesVersion property to NOT be set.
ControlPlaneOnly
ControlPlaneOnlyControlPlaneOnly upgrades only targets the KubernetesVersion of the ManagedClusters and will not be applied to the AgentPool. Requires the ManagedClusterUpgradeSpec.KubernetesVersion property to be set.
ManagedClusterUpgradeTypeFull
FullFull upgrades the control plane and all agent pools of the target ManagedClusters. Requires the ManagedClusterUpgradeSpec.KubernetesVersion property to be set.
ManagedClusterUpgradeTypeNodeImageOnly
NodeImageOnlyNodeImageOnly upgrades only the node images of the target ManagedClusters. Requires the ManagedClusterUpgradeSpec.KubernetesVersion property to NOT be set.
ManagedClusterUpgradeTypeControlPlaneOnly
ControlPlaneOnlyControlPlaneOnly upgrades only targets the KubernetesVersion of the ManagedClusters and will not be applied to the AgentPool. Requires the ManagedClusterUpgradeSpec.KubernetesVersion property to be set.
Full
FullFull upgrades the control plane and all agent pools of the target ManagedClusters. Requires the ManagedClusterUpgradeSpec.KubernetesVersion property to be set.
NodeImageOnly
NodeImageOnlyNodeImageOnly upgrades only the node images of the target ManagedClusters. Requires the ManagedClusterUpgradeSpec.KubernetesVersion property to NOT be set.
ControlPlaneOnly
ControlPlaneOnlyControlPlaneOnly upgrades only targets the KubernetesVersion of the ManagedClusters and will not be applied to the AgentPool. Requires the ManagedClusterUpgradeSpec.KubernetesVersion property to be set.
Full
FullFull upgrades the control plane and all agent pools of the target ManagedClusters. Requires the ManagedClusterUpgradeSpec.KubernetesVersion property to be set.
NodeImageOnly
NodeImageOnlyNodeImageOnly upgrades only the node images of the target ManagedClusters. Requires the ManagedClusterUpgradeSpec.KubernetesVersion property to NOT be set.
ControlPlaneOnly
ControlPlaneOnlyControlPlaneOnly upgrades only targets the KubernetesVersion of the ManagedClusters and will not be applied to the AgentPool. Requires the ManagedClusterUpgradeSpec.KubernetesVersion property to be set.
FULL
FullFull upgrades the control plane and all agent pools of the target ManagedClusters. Requires the ManagedClusterUpgradeSpec.KubernetesVersion property to be set.
NODE_IMAGE_ONLY
NodeImageOnlyNodeImageOnly upgrades only the node images of the target ManagedClusters. Requires the ManagedClusterUpgradeSpec.KubernetesVersion property to NOT be set.
CONTROL_PLANE_ONLY
ControlPlaneOnlyControlPlaneOnly upgrades only targets the KubernetesVersion of the ManagedClusters and will not be applied to the AgentPool. Requires the ManagedClusterUpgradeSpec.KubernetesVersion property to be set.
"Full"
FullFull upgrades the control plane and all agent pools of the target ManagedClusters. Requires the ManagedClusterUpgradeSpec.KubernetesVersion property to be set.
"NodeImageOnly"
NodeImageOnlyNodeImageOnly upgrades only the node images of the target ManagedClusters. Requires the ManagedClusterUpgradeSpec.KubernetesVersion property to NOT be set.
"ControlPlaneOnly"
ControlPlaneOnlyControlPlaneOnly upgrades only targets the KubernetesVersion of the ManagedClusters and will not be applied to the AgentPool. Requires the ManagedClusterUpgradeSpec.KubernetesVersion property to be set.

MemberUpdateStatusResponse
, MemberUpdateStatusResponseArgs

ClusterResourceId This property is required. string
The Azure resource id of the target Kubernetes cluster.
Message This property is required. string
The status message after processing the member update operation.
Name This property is required. string
The name of the FleetMember.
OperationId This property is required. string
The operation resource id of the latest attempt to perform the operation.
Status This property is required. Pulumi.AzureNative.ContainerService.Inputs.UpdateStatusResponse
The status of the MemberUpdate operation.
ClusterResourceId This property is required. string
The Azure resource id of the target Kubernetes cluster.
Message This property is required. string
The status message after processing the member update operation.
Name This property is required. string
The name of the FleetMember.
OperationId This property is required. string
The operation resource id of the latest attempt to perform the operation.
Status This property is required. UpdateStatusResponse
The status of the MemberUpdate operation.
clusterResourceId This property is required. String
The Azure resource id of the target Kubernetes cluster.
message This property is required. String
The status message after processing the member update operation.
name This property is required. String
The name of the FleetMember.
operationId This property is required. String
The operation resource id of the latest attempt to perform the operation.
status This property is required. UpdateStatusResponse
The status of the MemberUpdate operation.
clusterResourceId This property is required. string
The Azure resource id of the target Kubernetes cluster.
message This property is required. string
The status message after processing the member update operation.
name This property is required. string
The name of the FleetMember.
operationId This property is required. string
The operation resource id of the latest attempt to perform the operation.
status This property is required. UpdateStatusResponse
The status of the MemberUpdate operation.
cluster_resource_id This property is required. str
The Azure resource id of the target Kubernetes cluster.
message This property is required. str
The status message after processing the member update operation.
name This property is required. str
The name of the FleetMember.
operation_id This property is required. str
The operation resource id of the latest attempt to perform the operation.
status This property is required. UpdateStatusResponse
The status of the MemberUpdate operation.
clusterResourceId This property is required. String
The Azure resource id of the target Kubernetes cluster.
message This property is required. String
The status message after processing the member update operation.
name This property is required. String
The name of the FleetMember.
operationId This property is required. String
The operation resource id of the latest attempt to perform the operation.
status This property is required. Property Map
The status of the MemberUpdate operation.

NodeImageSelection
, NodeImageSelectionArgs

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

NodeImageSelectionResponse
, NodeImageSelectionResponseArgs

Type This property is required. string
The node image upgrade type.
CustomNodeImageVersions List<Pulumi.AzureNative.ContainerService.Inputs.NodeImageVersionResponse>
Custom node image versions to upgrade the nodes to. This field is required if node image selection type is Custom. Otherwise, it must be empty. For each node image family (e.g., 'AKSUbuntu-1804gen2containerd'), this field can contain at most one version (e.g., only one of 'AKSUbuntu-1804gen2containerd-2023.01.12' or 'AKSUbuntu-1804gen2containerd-2023.02.12', not both). If the nodes belong to a family without a matching image version in this field, they are not upgraded.
Type This property is required. string
The node image upgrade type.
CustomNodeImageVersions []NodeImageVersionResponse
Custom node image versions to upgrade the nodes to. This field is required if node image selection type is Custom. Otherwise, it must be empty. For each node image family (e.g., 'AKSUbuntu-1804gen2containerd'), this field can contain at most one version (e.g., only one of 'AKSUbuntu-1804gen2containerd-2023.01.12' or 'AKSUbuntu-1804gen2containerd-2023.02.12', not both). If the nodes belong to a family without a matching image version in this field, they are not upgraded.
type This property is required. String
The node image upgrade type.
customNodeImageVersions List<NodeImageVersionResponse>
Custom node image versions to upgrade the nodes to. This field is required if node image selection type is Custom. Otherwise, it must be empty. For each node image family (e.g., 'AKSUbuntu-1804gen2containerd'), this field can contain at most one version (e.g., only one of 'AKSUbuntu-1804gen2containerd-2023.01.12' or 'AKSUbuntu-1804gen2containerd-2023.02.12', not both). If the nodes belong to a family without a matching image version in this field, they are not upgraded.
type This property is required. string
The node image upgrade type.
customNodeImageVersions NodeImageVersionResponse[]
Custom node image versions to upgrade the nodes to. This field is required if node image selection type is Custom. Otherwise, it must be empty. For each node image family (e.g., 'AKSUbuntu-1804gen2containerd'), this field can contain at most one version (e.g., only one of 'AKSUbuntu-1804gen2containerd-2023.01.12' or 'AKSUbuntu-1804gen2containerd-2023.02.12', not both). If the nodes belong to a family without a matching image version in this field, they are not upgraded.
type This property is required. str
The node image upgrade type.
custom_node_image_versions Sequence[NodeImageVersionResponse]
Custom node image versions to upgrade the nodes to. This field is required if node image selection type is Custom. Otherwise, it must be empty. For each node image family (e.g., 'AKSUbuntu-1804gen2containerd'), this field can contain at most one version (e.g., only one of 'AKSUbuntu-1804gen2containerd-2023.01.12' or 'AKSUbuntu-1804gen2containerd-2023.02.12', not both). If the nodes belong to a family without a matching image version in this field, they are not upgraded.
type This property is required. String
The node image upgrade type.
customNodeImageVersions List<Property Map>
Custom node image versions to upgrade the nodes to. This field is required if node image selection type is Custom. Otherwise, it must be empty. For each node image family (e.g., 'AKSUbuntu-1804gen2containerd'), this field can contain at most one version (e.g., only one of 'AKSUbuntu-1804gen2containerd-2023.01.12' or 'AKSUbuntu-1804gen2containerd-2023.02.12', not both). If the nodes belong to a family without a matching image version in this field, they are not upgraded.

NodeImageSelectionStatusResponse
, NodeImageSelectionStatusResponseArgs

SelectedNodeImageVersions This property is required. List<Pulumi.AzureNative.ContainerService.Inputs.NodeImageVersionResponse>
The image versions to upgrade the nodes to.
SelectedNodeImageVersions This property is required. []NodeImageVersionResponse
The image versions to upgrade the nodes to.
selectedNodeImageVersions This property is required. List<NodeImageVersionResponse>
The image versions to upgrade the nodes to.
selectedNodeImageVersions This property is required. NodeImageVersionResponse[]
The image versions to upgrade the nodes to.
selected_node_image_versions This property is required. Sequence[NodeImageVersionResponse]
The image versions to upgrade the nodes to.
selectedNodeImageVersions This property is required. List<Property Map>
The image versions to upgrade the nodes to.

NodeImageSelectionType
, NodeImageSelectionTypeArgs

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'.
Custom
CustomUpgrade the nodes to the custom image versions. When set, update run will use node image versions provided in customNodeImageVersions to upgrade the nodes. If set, customNodeImageVersions must not be empty.
NodeImageSelectionTypeLatest
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.
NodeImageSelectionTypeConsistent
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'.
NodeImageSelectionTypeCustom
CustomUpgrade the nodes to the custom image versions. When set, update run will use node image versions provided in customNodeImageVersions to upgrade the nodes. If set, customNodeImageVersions must not be empty.
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'.
Custom
CustomUpgrade the nodes to the custom image versions. When set, update run will use node image versions provided in customNodeImageVersions to upgrade the nodes. If set, customNodeImageVersions must not be empty.
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'.
Custom
CustomUpgrade the nodes to the custom image versions. When set, update run will use node image versions provided in customNodeImageVersions to upgrade the nodes. If set, customNodeImageVersions must not be empty.
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'.
CUSTOM
CustomUpgrade the nodes to the custom image versions. When set, update run will use node image versions provided in customNodeImageVersions to upgrade the nodes. If set, customNodeImageVersions must not be empty.
"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'.
"Custom"
CustomUpgrade the nodes to the custom image versions. When set, update run will use node image versions provided in customNodeImageVersions to upgrade the nodes. If set, customNodeImageVersions must not be empty.

NodeImageVersionResponse
, NodeImageVersionResponseArgs

Version This property is required. string
The image version to upgrade the nodes to (e.g., 'AKSUbuntu-1804gen2containerd-2022.12.13').
Version This property is required. string
The image version to upgrade the nodes to (e.g., 'AKSUbuntu-1804gen2containerd-2022.12.13').
version This property is required. String
The image version to upgrade the nodes to (e.g., 'AKSUbuntu-1804gen2containerd-2022.12.13').
version This property is required. string
The image version to upgrade the nodes to (e.g., 'AKSUbuntu-1804gen2containerd-2022.12.13').
version This property is required. str
The image version to upgrade the nodes to (e.g., 'AKSUbuntu-1804gen2containerd-2022.12.13').
version This property is required. String
The image version to upgrade the nodes to (e.g., 'AKSUbuntu-1804gen2containerd-2022.12.13').

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.

UpdateGroup
, UpdateGroupArgs

Name This property is required. string
Name of the group. It must match a group name of an existing fleet member.
Name This property is required. string
Name of the group. It must match a group name of an existing fleet member.
name This property is required. String
Name of the group. It must match a group name of an existing fleet member.
name This property is required. string
Name of the group. It must match a group name of an existing fleet member.
name This property is required. str
Name of the group. It must match a group name of an existing fleet member.
name This property is required. String
Name of the group. It must match a group name of an existing fleet member.

UpdateGroupResponse
, UpdateGroupResponseArgs

Name This property is required. string
Name of the group. It must match a group name of an existing fleet member.
Name This property is required. string
Name of the group. It must match a group name of an existing fleet member.
name This property is required. String
Name of the group. It must match a group name of an existing fleet member.
name This property is required. string
Name of the group. It must match a group name of an existing fleet member.
name This property is required. str
Name of the group. It must match a group name of an existing fleet member.
name This property is required. String
Name of the group. It must match a group name of an existing fleet member.

UpdateGroupStatusResponse
, UpdateGroupStatusResponseArgs

Members This property is required. List<Pulumi.AzureNative.ContainerService.Inputs.MemberUpdateStatusResponse>
The list of member this UpdateGroup updates.
Name This property is required. string
The name of the UpdateGroup.
Status This property is required. Pulumi.AzureNative.ContainerService.Inputs.UpdateStatusResponse
The status of the UpdateGroup.
Members This property is required. []MemberUpdateStatusResponse
The list of member this UpdateGroup updates.
Name This property is required. string
The name of the UpdateGroup.
Status This property is required. UpdateStatusResponse
The status of the UpdateGroup.
members This property is required. List<MemberUpdateStatusResponse>
The list of member this UpdateGroup updates.
name This property is required. String
The name of the UpdateGroup.
status This property is required. UpdateStatusResponse
The status of the UpdateGroup.
members This property is required. MemberUpdateStatusResponse[]
The list of member this UpdateGroup updates.
name This property is required. string
The name of the UpdateGroup.
status This property is required. UpdateStatusResponse
The status of the UpdateGroup.
members This property is required. Sequence[MemberUpdateStatusResponse]
The list of member this UpdateGroup updates.
name This property is required. str
The name of the UpdateGroup.
status This property is required. UpdateStatusResponse
The status of the UpdateGroup.
members This property is required. List<Property Map>
The list of member this UpdateGroup updates.
name This property is required. String
The name of the UpdateGroup.
status This property is required. Property Map
The status of the UpdateGroup.

UpdateRunStatusResponse
, UpdateRunStatusResponseArgs

NodeImageSelection This property is required. Pulumi.AzureNative.ContainerService.Inputs.NodeImageSelectionStatusResponse
The node image upgrade specs for the update run. It is only set in update run when NodeImageSelection.type is Consistent.
Stages This property is required. List<Pulumi.AzureNative.ContainerService.Inputs.UpdateStageStatusResponse>
The stages composing an update run. Stages are run sequentially withing an UpdateRun.
Status This property is required. Pulumi.AzureNative.ContainerService.Inputs.UpdateStatusResponse
The status of the UpdateRun.
NodeImageSelection This property is required. NodeImageSelectionStatusResponse
The node image upgrade specs for the update run. It is only set in update run when NodeImageSelection.type is Consistent.
Stages This property is required. []UpdateStageStatusResponse
The stages composing an update run. Stages are run sequentially withing an UpdateRun.
Status This property is required. UpdateStatusResponse
The status of the UpdateRun.
nodeImageSelection This property is required. NodeImageSelectionStatusResponse
The node image upgrade specs for the update run. It is only set in update run when NodeImageSelection.type is Consistent.
stages This property is required. List<UpdateStageStatusResponse>
The stages composing an update run. Stages are run sequentially withing an UpdateRun.
status This property is required. UpdateStatusResponse
The status of the UpdateRun.
nodeImageSelection This property is required. NodeImageSelectionStatusResponse
The node image upgrade specs for the update run. It is only set in update run when NodeImageSelection.type is Consistent.
stages This property is required. UpdateStageStatusResponse[]
The stages composing an update run. Stages are run sequentially withing an UpdateRun.
status This property is required. UpdateStatusResponse
The status of the UpdateRun.
node_image_selection This property is required. NodeImageSelectionStatusResponse
The node image upgrade specs for the update run. It is only set in update run when NodeImageSelection.type is Consistent.
stages This property is required. Sequence[UpdateStageStatusResponse]
The stages composing an update run. Stages are run sequentially withing an UpdateRun.
status This property is required. UpdateStatusResponse
The status of the UpdateRun.
nodeImageSelection This property is required. Property Map
The node image upgrade specs for the update run. It is only set in update run when NodeImageSelection.type is Consistent.
stages This property is required. List<Property Map>
The stages composing an update run. Stages are run sequentially withing an UpdateRun.
status This property is required. Property Map
The status of the UpdateRun.

UpdateRunStrategy
, UpdateRunStrategyArgs

Stages This property is required. List<Pulumi.AzureNative.ContainerService.Inputs.UpdateStage>
The list of stages that compose this update run. Min size: 1.
Stages This property is required. []UpdateStage
The list of stages that compose this update run. Min size: 1.
stages This property is required. List<UpdateStage>
The list of stages that compose this update run. Min size: 1.
stages This property is required. UpdateStage[]
The list of stages that compose this update run. Min size: 1.
stages This property is required. Sequence[UpdateStage]
The list of stages that compose this update run. Min size: 1.
stages This property is required. List<Property Map>
The list of stages that compose this update run. Min size: 1.

UpdateRunStrategyResponse
, UpdateRunStrategyResponseArgs

Stages This property is required. List<Pulumi.AzureNative.ContainerService.Inputs.UpdateStageResponse>
The list of stages that compose this update run. Min size: 1.
Stages This property is required. []UpdateStageResponse
The list of stages that compose this update run. Min size: 1.
stages This property is required. List<UpdateStageResponse>
The list of stages that compose this update run. Min size: 1.
stages This property is required. UpdateStageResponse[]
The list of stages that compose this update run. Min size: 1.
stages This property is required. Sequence[UpdateStageResponse]
The list of stages that compose this update run. Min size: 1.
stages This property is required. List<Property Map>
The list of stages that compose this update run. Min size: 1.

UpdateStage
, UpdateStageArgs

Name This property is required. string
The name of the stage. Must be unique within the UpdateRun.
AfterStageWaitInSeconds int
The time in seconds to wait at the end of this stage before starting the next one. Defaults to 0 seconds if unspecified.
Groups List<Pulumi.AzureNative.ContainerService.Inputs.UpdateGroup>
Defines the groups to be executed in parallel in this stage. Duplicate groups are not allowed. Min size: 1.
Name This property is required. string
The name of the stage. Must be unique within the UpdateRun.
AfterStageWaitInSeconds int
The time in seconds to wait at the end of this stage before starting the next one. Defaults to 0 seconds if unspecified.
Groups []UpdateGroup
Defines the groups to be executed in parallel in this stage. Duplicate groups are not allowed. Min size: 1.
name This property is required. String
The name of the stage. Must be unique within the UpdateRun.
afterStageWaitInSeconds Integer
The time in seconds to wait at the end of this stage before starting the next one. Defaults to 0 seconds if unspecified.
groups List<UpdateGroup>
Defines the groups to be executed in parallel in this stage. Duplicate groups are not allowed. Min size: 1.
name This property is required. string
The name of the stage. Must be unique within the UpdateRun.
afterStageWaitInSeconds number
The time in seconds to wait at the end of this stage before starting the next one. Defaults to 0 seconds if unspecified.
groups UpdateGroup[]
Defines the groups to be executed in parallel in this stage. Duplicate groups are not allowed. Min size: 1.
name This property is required. str
The name of the stage. Must be unique within the UpdateRun.
after_stage_wait_in_seconds int
The time in seconds to wait at the end of this stage before starting the next one. Defaults to 0 seconds if unspecified.
groups Sequence[UpdateGroup]
Defines the groups to be executed in parallel in this stage. Duplicate groups are not allowed. Min size: 1.
name This property is required. String
The name of the stage. Must be unique within the UpdateRun.
afterStageWaitInSeconds Number
The time in seconds to wait at the end of this stage before starting the next one. Defaults to 0 seconds if unspecified.
groups List<Property Map>
Defines the groups to be executed in parallel in this stage. Duplicate groups are not allowed. Min size: 1.

UpdateStageResponse
, UpdateStageResponseArgs

Name This property is required. string
The name of the stage. Must be unique within the UpdateRun.
AfterStageWaitInSeconds int
The time in seconds to wait at the end of this stage before starting the next one. Defaults to 0 seconds if unspecified.
Groups List<Pulumi.AzureNative.ContainerService.Inputs.UpdateGroupResponse>
Defines the groups to be executed in parallel in this stage. Duplicate groups are not allowed. Min size: 1.
Name This property is required. string
The name of the stage. Must be unique within the UpdateRun.
AfterStageWaitInSeconds int
The time in seconds to wait at the end of this stage before starting the next one. Defaults to 0 seconds if unspecified.
Groups []UpdateGroupResponse
Defines the groups to be executed in parallel in this stage. Duplicate groups are not allowed. Min size: 1.
name This property is required. String
The name of the stage. Must be unique within the UpdateRun.
afterStageWaitInSeconds Integer
The time in seconds to wait at the end of this stage before starting the next one. Defaults to 0 seconds if unspecified.
groups List<UpdateGroupResponse>
Defines the groups to be executed in parallel in this stage. Duplicate groups are not allowed. Min size: 1.
name This property is required. string
The name of the stage. Must be unique within the UpdateRun.
afterStageWaitInSeconds number
The time in seconds to wait at the end of this stage before starting the next one. Defaults to 0 seconds if unspecified.
groups UpdateGroupResponse[]
Defines the groups to be executed in parallel in this stage. Duplicate groups are not allowed. Min size: 1.
name This property is required. str
The name of the stage. Must be unique within the UpdateRun.
after_stage_wait_in_seconds int
The time in seconds to wait at the end of this stage before starting the next one. Defaults to 0 seconds if unspecified.
groups Sequence[UpdateGroupResponse]
Defines the groups to be executed in parallel in this stage. Duplicate groups are not allowed. Min size: 1.
name This property is required. String
The name of the stage. Must be unique within the UpdateRun.
afterStageWaitInSeconds Number
The time in seconds to wait at the end of this stage before starting the next one. Defaults to 0 seconds if unspecified.
groups List<Property Map>
Defines the groups to be executed in parallel in this stage. Duplicate groups are not allowed. Min size: 1.

UpdateStageStatusResponse
, UpdateStageStatusResponseArgs

AfterStageWaitStatus This property is required. Pulumi.AzureNative.ContainerService.Inputs.WaitStatusResponse
The status of the wait period configured on the UpdateStage.
Groups This property is required. List<Pulumi.AzureNative.ContainerService.Inputs.UpdateGroupStatusResponse>
The list of groups to be updated as part of this UpdateStage.
Name This property is required. string
The name of the UpdateStage.
Status This property is required. Pulumi.AzureNative.ContainerService.Inputs.UpdateStatusResponse
The status of the UpdateStage.
AfterStageWaitStatus This property is required. WaitStatusResponse
The status of the wait period configured on the UpdateStage.
Groups This property is required. []UpdateGroupStatusResponse
The list of groups to be updated as part of this UpdateStage.
Name This property is required. string
The name of the UpdateStage.
Status This property is required. UpdateStatusResponse
The status of the UpdateStage.
afterStageWaitStatus This property is required. WaitStatusResponse
The status of the wait period configured on the UpdateStage.
groups This property is required. List<UpdateGroupStatusResponse>
The list of groups to be updated as part of this UpdateStage.
name This property is required. String
The name of the UpdateStage.
status This property is required. UpdateStatusResponse
The status of the UpdateStage.
afterStageWaitStatus This property is required. WaitStatusResponse
The status of the wait period configured on the UpdateStage.
groups This property is required. UpdateGroupStatusResponse[]
The list of groups to be updated as part of this UpdateStage.
name This property is required. string
The name of the UpdateStage.
status This property is required. UpdateStatusResponse
The status of the UpdateStage.
after_stage_wait_status This property is required. WaitStatusResponse
The status of the wait period configured on the UpdateStage.
groups This property is required. Sequence[UpdateGroupStatusResponse]
The list of groups to be updated as part of this UpdateStage.
name This property is required. str
The name of the UpdateStage.
status This property is required. UpdateStatusResponse
The status of the UpdateStage.
afterStageWaitStatus This property is required. Property Map
The status of the wait period configured on the UpdateStage.
groups This property is required. List<Property Map>
The list of groups to be updated as part of this UpdateStage.
name This property is required. String
The name of the UpdateStage.
status This property is required. Property Map
The status of the UpdateStage.

UpdateStatusResponse
, UpdateStatusResponseArgs

CompletedTime This property is required. string
The time the operation or group was completed.
Error This property is required. Pulumi.AzureNative.ContainerService.Inputs.ErrorDetailResponse
The error details when a failure is encountered.
StartTime This property is required. string
The time the operation or group was started.
State This property is required. string
The State of the operation or group.
CompletedTime This property is required. string
The time the operation or group was completed.
Error This property is required. ErrorDetailResponse
The error details when a failure is encountered.
StartTime This property is required. string
The time the operation or group was started.
State This property is required. string
The State of the operation or group.
completedTime This property is required. String
The time the operation or group was completed.
error This property is required. ErrorDetailResponse
The error details when a failure is encountered.
startTime This property is required. String
The time the operation or group was started.
state This property is required. String
The State of the operation or group.
completedTime This property is required. string
The time the operation or group was completed.
error This property is required. ErrorDetailResponse
The error details when a failure is encountered.
startTime This property is required. string
The time the operation or group was started.
state This property is required. string
The State of the operation or group.
completed_time This property is required. str
The time the operation or group was completed.
error This property is required. ErrorDetailResponse
The error details when a failure is encountered.
start_time This property is required. str
The time the operation or group was started.
state This property is required. str
The State of the operation or group.
completedTime This property is required. String
The time the operation or group was completed.
error This property is required. Property Map
The error details when a failure is encountered.
startTime This property is required. String
The time the operation or group was started.
state This property is required. String
The State of the operation or group.

WaitStatusResponse
, WaitStatusResponseArgs

Status This property is required. Pulumi.AzureNative.ContainerService.Inputs.UpdateStatusResponse
The status of the wait duration.
WaitDurationInSeconds This property is required. int
The wait duration configured in seconds.
Status This property is required. UpdateStatusResponse
The status of the wait duration.
WaitDurationInSeconds This property is required. int
The wait duration configured in seconds.
status This property is required. UpdateStatusResponse
The status of the wait duration.
waitDurationInSeconds This property is required. Integer
The wait duration configured in seconds.
status This property is required. UpdateStatusResponse
The status of the wait duration.
waitDurationInSeconds This property is required. number
The wait duration configured in seconds.
status This property is required. UpdateStatusResponse
The status of the wait duration.
wait_duration_in_seconds This property is required. int
The wait duration configured in seconds.
status This property is required. Property Map
The status of the wait duration.
waitDurationInSeconds This property is required. Number
The wait duration configured in seconds.

Import

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

$ pulumi import azure-native:containerservice:UpdateRun run1 /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ContainerService/fleets/{fleetName}/updateRuns/{updateRunName}
Copy

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

Package Details

Repository
Azure Native pulumi/pulumi-azure-native
License
Apache-2.0
This is the latest version of Azure Native. Use the Azure Native v2 docs if using the v2 version of this package.
Azure Native v3.1.0 published on Tuesday, Apr 8, 2025 by Pulumi
pulumi/pulumi-azure-native