mgmt containerservice, update api-version to preview-2025-09-02 (#47336)

* feat(containerservice): update API spec to use preview tag

- Changed tag from package-2025-09 to package-preview-2025-09
- Maintained existing modelerfour and sync stack configurations
- Preserved ContainerServiceVMSizeTypes model mapping
- Kept OSSku model renaming configuration

* gulp codegen

* chore(containerservice): update api-version to 2025-09-01-preview

- Updated `api-version` to `2025-09-01-preview` in changelog
- Marked release as non-breaking with other changes category
- Removed unreleased status for version 2.57.0-beta.1

* feat(containerservice): update Kubernetes version in test

- Updated AKS cluster version from 1.30.3 to 1.31.8 in integration test

* chore(assets): update tag reference for container service

- Updated asset tag to latest version
- Maintained consistency with azure-sdk-assets repository structure

* feat(containerservice): add node image version and upgrade strategy support

- Add nodeImageVersion field to agent pool configuration
- Add upgradeStrategy field to agent pool configuration
- Enable preview API version features for virtual machine nodes
- Update agent pool inner model with new properties

* chore(containerservice): update samples and dependencies to stable API version

- Updated API version references from preview/2025-09-02-preview to stable/2025-09-01
- Removed unreleased version entry for azure-resourcemanager-containerservice
- Changed dependency version from 2.57.0-beta.1 to 2.56.0
- Removed several generated sample files that were based on preview API
- Reordered imports and updated file paths in remaining samples
- Removed unused AutoScaleProfile import from AgentPoolsCreateOrUpdateSamples
- Fixed resource group path casing in snapshot creation sample

* fix(containerservice): simplify managed cluster deletion call

- Remove unnecessary null parameter in delete method call
- Remove explicit Context.NONE usage in favor of default behavior

* chore(containerservice): update changelog release date

- Updated release date in CHANGELOG.md from 2025-11-25 to 2025-12-01
- No functional code changes included in this update

---------

Co-authored-by: Xiaofei Cao <92354331+XiaofeiCao@users.noreply.github.com>

Author: v-huizhu2

sdk/containerservice/azure-resourcemanager-containerservice/CHANGELOG.md

@@ -1,14 +1,12 @@
 # Release History
 
-## 2.57.0-beta.1 (Unreleased)
+## 2.57.0-beta.1 (2025-12-01)
 
-### Features Added
-
-### Breaking Changes
+### Other Changes
 
-### Bugs Fixed
+#### Dependency Updates
 
-### Other Changes
+- Updated `api-version` to `2025-09-01-preview`.
 
 ## 2.56.1 (2025-11-24)
 

sdk/containerservice/azure-resourcemanager-containerservice/assets.json

@@ -2,5 +2,5 @@
   "AssetsRepo": "Azure/azure-sdk-assets",
   "AssetsRepoPrefixPath": "java",
   "TagPrefix": "java/containerservice/azure-resourcemanager-containerservice",
-  "Tag": "java/containerservice/azure-resourcemanager-containerservice_8815152626"
+  "Tag": "java/containerservice/azure-resourcemanager-containerservice_c3a165c41a"
 }

sdk/containerservice/azure-resourcemanager-containerservice/src/main/java/com/azure/resourcemanager/containerservice/fluent/AgentPoolsClient.java

@@ -30,7 +30,7 @@ public interface AgentPoolsClient {
      * 
      * Aborts the currently running operation on the agent pool. The Agent Pool will be moved to a Canceling state and
      * eventually to a Canceled state when cancellation finishes. If the operation completes before cancellation can
-     * take place, a 409 error code is returned.
+     * take place, an error is returned.
      * 
      * @param resourceGroupName The name of the resource group. The name is case insensitive.
      * @param resourceName The name of the managed cluster resource.
@@ -49,7 +49,7 @@ Mono<Response<Flux<ByteBuffer>>> abortLatestOperationWithResponseAsync(String re
      * 
      * Aborts the currently running operation on the agent pool. The Agent Pool will be moved to a Canceling state and
      * eventually to a Canceled state when cancellation finishes. If the operation completes before cancellation can
-     * take place, a 409 error code is returned.
+     * take place, an error is returned.
      * 
      * @param resourceGroupName The name of the resource group. The name is case insensitive.
      * @param resourceName The name of the managed cluster resource.
@@ -68,7 +68,7 @@ PollerFlux<PollResult<Void>, Void> beginAbortLatestOperationAsync(String resourc
      * 
      * Aborts the currently running operation on the agent pool. The Agent Pool will be moved to a Canceling state and
      * eventually to a Canceled state when cancellation finishes. If the operation completes before cancellation can
-     * take place, a 409 error code is returned.
+     * take place, an error is returned.
      * 
      * @param resourceGroupName The name of the resource group. The name is case insensitive.
      * @param resourceName The name of the managed cluster resource.
@@ -87,7 +87,7 @@ SyncPoller<PollResult<Void>, Void> beginAbortLatestOperation(String resourceGrou
      * 
      * Aborts the currently running operation on the agent pool. The Agent Pool will be moved to a Canceling state and
      * eventually to a Canceled state when cancellation finishes. If the operation completes before cancellation can
-     * take place, a 409 error code is returned.
+     * take place, an error is returned.
      * 
      * @param resourceGroupName The name of the resource group. The name is case insensitive.
      * @param resourceName The name of the managed cluster resource.
@@ -107,7 +107,7 @@ SyncPoller<PollResult<Void>, Void> beginAbortLatestOperation(String resourceGrou
      * 
      * Aborts the currently running operation on the agent pool. The Agent Pool will be moved to a Canceling state and
      * eventually to a Canceled state when cancellation finishes. If the operation completes before cancellation can
-     * take place, a 409 error code is returned.
+     * take place, an error is returned.
      * 
      * @param resourceGroupName The name of the resource group. The name is case insensitive.
      * @param resourceName The name of the managed cluster resource.
@@ -125,7 +125,7 @@ SyncPoller<PollResult<Void>, Void> beginAbortLatestOperation(String resourceGrou
      * 
      * Aborts the currently running operation on the agent pool. The Agent Pool will be moved to a Canceling state and
      * eventually to a Canceled state when cancellation finishes. If the operation completes before cancellation can
-     * take place, a 409 error code is returned.
+     * take place, an error is returned.
      * 
      * @param resourceGroupName The name of the resource group. The name is case insensitive.
      * @param resourceName The name of the managed cluster resource.
@@ -142,7 +142,7 @@ SyncPoller<PollResult<Void>, Void> beginAbortLatestOperation(String resourceGrou
      * 
      * Aborts the currently running operation on the agent pool. The Agent Pool will be moved to a Canceling state and
      * eventually to a Canceled state when cancellation finishes. If the operation completes before cancellation can
-     * take place, a 409 error code is returned.
+     * take place, an error is returned.
      * 
      * @param resourceGroupName The name of the resource group. The name is case insensitive.
      * @param resourceName The name of the managed cluster resource.
@@ -620,6 +620,122 @@ Response<AgentPoolUpgradeProfileInner> getUpgradeProfileWithResponse(String reso
     @ServiceMethod(returns = ReturnType.SINGLE)
     AgentPoolUpgradeProfileInner getUpgradeProfile(String resourceGroupName, String resourceName, String agentPoolName);
 
+    /**
+     * Completes the upgrade of an agent pool.
+     * 
+     * Completes the upgrade operation for the specified agent pool.
+     * 
+     * @param resourceGroupName The name of the resource group. The name is case insensitive.
+     * @param resourceName The name of the managed cluster resource.
+     * @param agentPoolName The name of the agent pool.
+     * @throws IllegalArgumentException thrown if parameters fail the validation.
+     * @throws com.azure.core.management.exception.ManagementException thrown if the request is rejected by server.
+     * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent.
+     * @return the {@link Response} on successful completion of {@link Mono}.
+     */
+    @ServiceMethod(returns = ReturnType.SINGLE)
+    Mono<Response<Flux<ByteBuffer>>> completeUpgradeWithResponseAsync(String resourceGroupName, String resourceName,
+        String agentPoolName);
+
+    /**
+     * Completes the upgrade of an agent pool.
+     * 
+     * Completes the upgrade operation for the specified agent pool.
+     * 
+     * @param resourceGroupName The name of the resource group. The name is case insensitive.
+     * @param resourceName The name of the managed cluster resource.
+     * @param agentPoolName The name of the agent pool.
+     * @throws IllegalArgumentException thrown if parameters fail the validation.
+     * @throws com.azure.core.management.exception.ManagementException thrown if the request is rejected by server.
+     * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent.
+     * @return the {@link PollerFlux} for polling of long-running operation.
+     */
+    @ServiceMethod(returns = ReturnType.LONG_RUNNING_OPERATION)
+    PollerFlux<PollResult<Void>, Void> beginCompleteUpgradeAsync(String resourceGroupName, String resourceName,
+        String agentPoolName);
+
+    /**
+     * Completes the upgrade of an agent pool.
+     * 
+     * Completes the upgrade operation for the specified agent pool.
+     * 
+     * @param resourceGroupName The name of the resource group. The name is case insensitive.
+     * @param resourceName The name of the managed cluster resource.
+     * @param agentPoolName The name of the agent pool.
+     * @throws IllegalArgumentException thrown if parameters fail the validation.
+     * @throws com.azure.core.management.exception.ManagementException thrown if the request is rejected by server.
+     * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent.
+     * @return the {@link SyncPoller} for polling of long-running operation.
+     */
+    @ServiceMethod(returns = ReturnType.LONG_RUNNING_OPERATION)
+    SyncPoller<PollResult<Void>, Void> beginCompleteUpgrade(String resourceGroupName, String resourceName,
+        String agentPoolName);
+
+    /**
+     * Completes the upgrade of an agent pool.
+     * 
+     * Completes the upgrade operation for the specified agent pool.
+     * 
+     * @param resourceGroupName The name of the resource group. The name is case insensitive.
+     * @param resourceName The name of the managed cluster resource.
+     * @param agentPoolName The name of the agent pool.
+     * @param context The context to associate with this operation.
+     * @throws IllegalArgumentException thrown if parameters fail the validation.
+     * @throws com.azure.core.management.exception.ManagementException thrown if the request is rejected by server.
+     * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent.
+     * @return the {@link SyncPoller} for polling of long-running operation.
+     */
+    @ServiceMethod(returns = ReturnType.LONG_RUNNING_OPERATION)
+    SyncPoller<PollResult<Void>, Void> beginCompleteUpgrade(String resourceGroupName, String resourceName,
+        String agentPoolName, Context context);
+
+    /**
+     * Completes the upgrade of an agent pool.
+     * 
+     * Completes the upgrade operation for the specified agent pool.
+     * 
+     * @param resourceGroupName The name of the resource group. The name is case insensitive.
+     * @param resourceName The name of the managed cluster resource.
+     * @param agentPoolName The name of the agent pool.
+     * @throws IllegalArgumentException thrown if parameters fail the validation.
+     * @throws com.azure.core.management.exception.ManagementException thrown if the request is rejected by server.
+     * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent.
+     * @return A {@link Mono} that completes when a successful response is received.
+     */
+    @ServiceMethod(returns = ReturnType.SINGLE)
+    Mono<Void> completeUpgradeAsync(String resourceGroupName, String resourceName, String agentPoolName);
+
+    /**
+     * Completes the upgrade of an agent pool.
+     * 
+     * Completes the upgrade operation for the specified agent pool.
+     * 
+     * @param resourceGroupName The name of the resource group. The name is case insensitive.
+     * @param resourceName The name of the managed cluster resource.
+     * @param agentPoolName The name of the agent pool.
+     * @throws IllegalArgumentException thrown if parameters fail the validation.
+     * @throws com.azure.core.management.exception.ManagementException thrown if the request is rejected by server.
+     * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent.
+     */
+    @ServiceMethod(returns = ReturnType.SINGLE)
+    void completeUpgrade(String resourceGroupName, String resourceName, String agentPoolName);
+
+    /**
+     * Completes the upgrade of an agent pool.
+     * 
+     * Completes the upgrade operation for the specified agent pool.
+     * 
+     * @param resourceGroupName The name of the resource group. The name is case insensitive.
+     * @param resourceName The name of the managed cluster resource.
+     * @param agentPoolName The name of the agent pool.
+     * @param context The context to associate with this operation.
+     * @throws IllegalArgumentException thrown if parameters fail the validation.
+     * @throws com.azure.core.management.exception.ManagementException thrown if the request is rejected by server.
+     * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent.
+     */
+    @ServiceMethod(returns = ReturnType.SINGLE)
+    void completeUpgrade(String resourceGroupName, String resourceName, String agentPoolName, Context context);
+
     /**
      * Deletes specific machines in an agent pool.
      * 

sdk/containerservice/azure-resourcemanager-containerservice/src/main/java/com/azure/resourcemanager/containerservice/fluent/ContainerServiceManagementClient.java

@@ -68,6 +68,13 @@ public interface ContainerServiceManagementClient {
      */
     ManagedClustersClient getManagedClusters();
 
+    /**
+     * Gets the ContainerServiceOperationsClient object to access its operations.
+     * 
+     * @return the ContainerServiceOperationsClient object.
+     */
+    ContainerServiceOperationsClient getContainerServiceOperations();
+
     /**
      * Gets the MaintenanceConfigurationsClient object to access its operations.
      * 
@@ -89,6 +96,13 @@ public interface ContainerServiceManagementClient {
      */
     AgentPoolsClient getAgentPools();
 
+    /**
+     * Gets the MachinesClient object to access its operations.
+     * 
+     * @return the MachinesClient object.
+     */
+    MachinesClient getMachines();
+
     /**
      * Gets the PrivateEndpointConnectionsClient object to access its operations.
      * 
@@ -110,6 +124,13 @@ public interface ContainerServiceManagementClient {
      */
     ResolvePrivateLinkServiceIdsClient getResolvePrivateLinkServiceIds();
 
+    /**
+     * Gets the OperationStatusResultsClient object to access its operations.
+     * 
+     * @return the OperationStatusResultsClient object.
+     */
+    OperationStatusResultsClient getOperationStatusResults();
+
     /**
      * Gets the SnapshotsClient object to access its operations.
      * 
@@ -118,11 +139,11 @@ public interface ContainerServiceManagementClient {
     SnapshotsClient getSnapshots();
 
     /**
-     * Gets the TrustedAccessRoleBindingsClient object to access its operations.
+     * Gets the ManagedClusterSnapshotsClient object to access its operations.
      * 
-     * @return the TrustedAccessRoleBindingsClient object.
+     * @return the ManagedClusterSnapshotsClient object.
      */
-    TrustedAccessRoleBindingsClient getTrustedAccessRoleBindings();
+    ManagedClusterSnapshotsClient getManagedClusterSnapshots();
 
     /**
      * Gets the TrustedAccessRolesClient object to access its operations.
@@ -132,9 +153,37 @@ public interface ContainerServiceManagementClient {
     TrustedAccessRolesClient getTrustedAccessRoles();
 
     /**
-     * Gets the MachinesClient object to access its operations.
+     * Gets the TrustedAccessRoleBindingsClient object to access its operations.
      * 
-     * @return the MachinesClient object.
+     * @return the TrustedAccessRoleBindingsClient object.
      */
-    MachinesClient getMachines();
+    TrustedAccessRoleBindingsClient getTrustedAccessRoleBindings();
+
+    /**
+     * Gets the LoadBalancersClient object to access its operations.
+     * 
+     * @return the LoadBalancersClient object.
+     */
+    LoadBalancersClient getLoadBalancers();
+
+    /**
+     * Gets the IdentityBindingsClient object to access its operations.
+     * 
+     * @return the IdentityBindingsClient object.
+     */
+    IdentityBindingsClient getIdentityBindings();
+
+    /**
+     * Gets the JwtAuthenticatorsClient object to access its operations.
+     * 
+     * @return the JwtAuthenticatorsClient object.
+     */
+    JwtAuthenticatorsClient getJwtAuthenticators();
+
+    /**
+     * Gets the MeshMembershipsClient object to access its operations.
+     * 
+     * @return the MeshMembershipsClient object.
+     */
+    MeshMembershipsClient getMeshMemberships();
 }

sdk/containerservice/azure-resourcemanager-containerservice/src/main/java/com/azure/resourcemanager/containerservice/fluent/ContainerServiceOperationsClient.java

@@ -0,0 +1,66 @@
+// Copyright (c) Microsoft Corporation. All rights reserved.
+// Licensed under the MIT License.
+// Code generated by Microsoft (R) AutoRest Code Generator.
+
+package com.azure.resourcemanager.containerservice.fluent;
+
+import com.azure.core.annotation.ReturnType;
+import com.azure.core.annotation.ServiceMethod;
+import com.azure.core.http.rest.PagedFlux;
+import com.azure.core.http.rest.PagedIterable;
+import com.azure.core.util.Context;
+import com.azure.resourcemanager.containerservice.fluent.models.NodeImageVersionInner;
+
+/**
+ * An instance of this class provides access to all the operations defined in ContainerServiceOperationsClient.
+ */
+public interface ContainerServiceOperationsClient {
+    /**
+     * Gets a list of supported NodeImage versions in the specified subscription.
+     * 
+     * Only returns the latest version of each node image. For example there may be an
+     * AKSUbuntu-1804gen2containerd-2024.01.26, but only AKSUbuntu-1804gen2containerd-2024.02.02 is visible in this
+     * list.
+     * 
+     * @param location The name of the Azure region.
+     * @throws IllegalArgumentException thrown if parameters fail the validation.
+     * @throws com.azure.core.management.exception.ManagementException thrown if the request is rejected by server.
+     * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent.
+     * @return holds an array NodeImageVersions as paginated response with {@link PagedFlux}.
+     */
+    @ServiceMethod(returns = ReturnType.COLLECTION)
+    PagedFlux<NodeImageVersionInner> listNodeImageVersionsAsync(String location);
+
+    /**
+     * Gets a list of supported NodeImage versions in the specified subscription.
+     * 
+     * Only returns the latest version of each node image. For example there may be an
+     * AKSUbuntu-1804gen2containerd-2024.01.26, but only AKSUbuntu-1804gen2containerd-2024.02.02 is visible in this
+     * list.
+     * 
+     * @param location The name of the Azure region.
+     * @throws IllegalArgumentException thrown if parameters fail the validation.
+     * @throws com.azure.core.management.exception.ManagementException thrown if the request is rejected by server.
+     * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent.
+     * @return holds an array NodeImageVersions as paginated response with {@link PagedIterable}.
+     */
+    @ServiceMethod(returns = ReturnType.COLLECTION)
+    PagedIterable<NodeImageVersionInner> listNodeImageVersions(String location);
+
+    /**
+     * Gets a list of supported NodeImage versions in the specified subscription.
+     * 
+     * Only returns the latest version of each node image. For example there may be an
+     * AKSUbuntu-1804gen2containerd-2024.01.26, but only AKSUbuntu-1804gen2containerd-2024.02.02 is visible in this
+     * list.
+     * 
+     * @param location The name of the Azure region.
+     * @param context The context to associate with this operation.
+     * @throws IllegalArgumentException thrown if parameters fail the validation.
+     * @throws com.azure.core.management.exception.ManagementException thrown if the request is rejected by server.
+     * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent.
+     * @return holds an array NodeImageVersions as paginated response with {@link PagedIterable}.
+     */
+    @ServiceMethod(returns = ReturnType.COLLECTION)
+    PagedIterable<NodeImageVersionInner> listNodeImageVersions(String location, Context context);
+}