Skip to content

{AKS} aks-preview: vendor new SDK and bump API version to 2026-08-02-preview - #10491

Merged
JaysonTaiMicrosoft merged 1 commit into
Azure:mainfrom
FumingZhang:fuming/aks-preview-2026-08-sdk
Oct 20, 2026
Merged

JaysonTaiMicrosoft merged 1 commit into
Azure:mainfrom
FumingZhang:fuming/aks-preview-2026-08-sdk

Conversation

@FumingZhang

@FumingZhang FumingZhang commented Oct 20, 2026 •

Copy link
Copy Markdown
Member

🤖 PR Validation — ️✔️ All clear

Breaking Changes
️✔️ None

Related command

az aks, az aks nodepool, az aks bastion

Description

Vendor a locally generated Python SDK for AKS API version 2026-08-02-preview and advance aks-preview from 22.0.0b13 to 22.0.0b14.

  • Generate from the merged August TypeSpec source, Azure/azure-rest-api-specs#46811, at commit ebc13f67950a95e50c6828c27dd979e8608c0329.
  • Use the Python SDK repository's pinned tsp-client 0.33.1 and @azure-tools/typespec-python 0.63.10, explicitly selecting api-version=2026-08-02-preview.
  • Replace only the vendored azure_mgmt_preview_aks namespace. Its 26 files match the generator output byte-for-byte except for the intentional API-version marker.
  • Update the extension version, release history, API mapping, and 291 replay recordings.

Required compatibility update

The August API moves managed Bastion settings to properties.networkProfile.clusterAPIConnectivityProfile.bastion. Update enable/update/disable and tunnel consumers to this schema while preserving explicit Bastion precedence, missing-profile initialization, unspecified Bastion values, and sibling Cloud Shell/network settings.

Update the two affected replay fixtures and assertions. Regression tests use actual generated SDK models to verify serialization and preservation of existing settings. CLI JSON uses networkProfile.clusterApiConnectivityProfile.bastion.

All other recording changes are exact API-version replacements. The vendored client's actual default API and the August-preview-only begin_rebalance_load_balancers operation were verified.

Validation

Validated against Azure CLI dev at 3d9e7668428e7698bec7ff48781eb10b78f9fe7e with the stable ContainerService Python SDK 41.8.0 integration.

  • azdev test azext_aks_preview --series --no-exitfirst --pytest-args -n 4 -q: 1,595 passed, 126 skipped.
  • Focused Bastion unit and replay tests: 39 passed.
  • azdev style aks-preview: pylint and flake8 passed using existing repository configuration.
  • azdev linter aks-preview: passed.
  • python scripts/ci/test_index.py -q: passed, 2 skipped.
  • Python compilation, command-index loading, generated-file/recording comparisons, and git diff --check: passed.
  • Repository secret scanner: no secrets detected in extension source or replay recordings.

azdev extension list and imported module paths were checked to ensure tests used this extension checkout and the current CLI checkout. Tests ran in playback mode; no live Azure resources were created.

This is local CLI vendoring, not an official preview SDK generation/release. src/index.json is intentionally unchanged.

General Guidelines

  • Ran azdev style aks-preview locally.
  • Ran python scripts/ci/test_index.py -q locally.
  • The extension version conforms to the extension version schema.

About Extension Publish

Update only the extension source, version, history, and API mapping. The existing post-merge release process owns building/publishing and the subsequent src/index.json update; this PR does not publish anything.

Vendor the locally generated Python SDK from the merged August TypeSpec using pinned generator versions. Migrate Bastion consumers and replay fixtures to the new cluster API connectivity profile, preserving existing command behavior.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Copilot AI balanced review requested due to automatic review settings October 20, 2026 00:49

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

🔵 Needs a closer look

The changes require final human review because they are too complex or risky for automated approval.

No open issues 🎉

What changed in this PR

Updates aks-preview to 22.0.0b14 and adopts AKS API 2026-08-02-preview, including compatibility changes for managed Bastion.

Changes:

  • Updates SDK defaults and registers new operation groups.
  • Moves Bastion consumers and assertions to the cluster API connectivity profile.
  • Updates release documentation and replay API versions.
File Description
src/​aks-preview/​setup.py Updated as part of this pull request.
src/​aks-preview/​README.rst Updated as part of this pull request.
src/​aks-preview/​HISTORY.rst Updated as part of this pull request.
src/​aks-preview/​azext_aks_preview/​vendored_sdks/​azure_mgmt_preview_aks/​operations/​__init__.py Updated as part of this pull request.
src/​aks-preview/​azext_aks_preview/​vendored_sdks/​azure_mgmt_preview_aks/​aio/​operations/​__init__.py Updated as part of this pull request.
src/​aks-preview/​azext_aks_preview/​vendored_sdks/​azure_mgmt_preview_aks/​aio/​_configuration.py Updated as part of this pull request.
src/​aks-preview/​azext_aks_preview/​vendored_sdks/​azure_mgmt_preview_aks/​aio/​_client.py Updated as part of this pull request.
src/​aks-preview/​azext_aks_preview/​vendored_sdks/​azure_mgmt_preview_aks/​_version.py Updated as part of this pull request.
src/​aks-preview/​azext_aks_preview/​vendored_sdks/​azure_mgmt_preview_aks/​_configuration.py Updated as part of this pull request.
src/​aks-preview/​azext_aks_preview/​vendored_sdks/​azure_mgmt_preview_aks/​_client.py Updated as part of this pull request.
src/​aks-preview/​azext_aks_preview/​tests/​latest/​test_aks_commands.py Updated as part of this pull request.
src/​aks-preview/​azext_aks_preview/​tests/​latest/​test_aks_bastion.py Updated as part of this pull request.
src/​aks-preview/​azext_aks_preview/​tests/​latest/​recordings/​test_get_version.yaml Updated as part of this pull request.
src/​aks-preview/​azext_aks_preview/​tests/​latest/​recordings/​test_aks_upgrade_node_image_only_nodepool.yaml Updated as part of this pull request.
src/​aks-preview/​azext_aks_preview/​tests/​latest/​recordings/​test_aks_upgrade_node_image_only_cluster.yaml Updated as part of this pull request.
src/​aks-preview/​azext_aks_preview/​tests/​latest/​recordings/​test_aks_update_with_both_enable_and_disable_continuous_monitor.yaml Updated as part of this pull request.
src/​aks-preview/​azext_aks_preview/​tests/​latest/​recordings/​test_aks_nodepool_get_upgrades.yaml Updated as part of this pull request.
src/​aks-preview/​azext_aks_preview/​tests/​latest/​recordings/​test_aks_list_vm_skus.yaml Updated as part of this pull request.
src/​aks-preview/​azext_aks_preview/​tests/​latest/​recordings/​test_aks_extension_type_backup.yaml Updated as part of this pull request.
src/​aks-preview/​azext_aks_preview/​tests/​latest/​recordings/​test_aks_extension_backup.yaml Updated as part of this pull request.
src/​aks-preview/​azext_aks_preview/​tests/​latest/​recordings/​test_aks_enable_utlra_ssd.yaml Updated as part of this pull request.
src/​aks-preview/​azext_aks_preview/​tests/​latest/​recordings/​test_aks_deployment_safeguards_with_pss.yaml Updated as part of this pull request.
src/​aks-preview/​azext_aks_preview/​tests/​latest/​recordings/​test_aks_deployment_safeguards_basic.yaml Updated as part of this pull request.
src/​aks-preview/​azext_aks_preview/​tests/​latest/​recordings/​test_aks_deployment_safeguards_argument_validation.yaml Updated as part of this pull request.
src/​aks-preview/​azext_aks_preview/​tests/​latest/​recordings/​test_aks_create_with_workload_identity_enabled.yaml Updated as part of this pull request.
src/​aks-preview/​azext_aks_preview/​tests/​latest/​recordings/​test_aks_create_with_web_application_routing.yaml Updated as part of this pull request.
src/​aks-preview/​azext_aks_preview/​tests/​latest/​recordings/​test_aks_create_with_transit_encryption_type.yaml Updated as part of this pull request.
src/​aks-preview/​azext_aks_preview/​tests/​latest/​recordings/​test_aks_create_with_transit_encryption_type_mtls.yaml Updated as part of this pull request.
src/​aks-preview/​azext_aks_preview/​tests/​latest/​recordings/​test_aks_create_with_transit_encryption_type_and_advanced_networkpolicies.yaml Updated as part of this pull request.
src/​aks-preview/​azext_aks_preview/​tests/​latest/​recordings/​test_aks_create_with_standard_sku.yaml Updated as part of this pull request.
src/​aks-preview/​azext_aks_preview/​tests/​latest/​recordings/​test_aks_create_with_service_account_image_pull.yaml Updated as part of this pull request.
src/​aks-preview/​azext_aks_preview/​tests/​latest/​recordings/​test_aks_create_with_premium_sku.yaml Updated as part of this pull request.
src/​aks-preview/​azext_aks_preview/​tests/​latest/​recordings/​test_aks_create_with_overlay_network_plugin_mode.yaml Updated as part of this pull request.
src/​aks-preview/​azext_aks_preview/​tests/​latest/​recordings/​test_aks_create_with_ossku.yaml Updated as part of this pull request.
src/​aks-preview/​azext_aks_preview/​tests/​latest/​recordings/​test_aks_create_with_optimized_addon_scaling.yaml Updated as part of this pull request.
src/​aks-preview/​azext_aks_preview/​tests/​latest/​recordings/​test_aks_create_with_openservicemesh_addon.yaml Updated as part of this pull request.
src/​aks-preview/​azext_aks_preview/​tests/​latest/​recordings/​test_aks_create_with_on_demand_monitor.yaml Updated as part of this pull request.
src/​aks-preview/​azext_aks_preview/​tests/​latest/​recordings/​test_aks_create_with_oidc_issuer_enabled.yaml Updated as part of this pull request.
src/​aks-preview/​azext_aks_preview/​tests/​latest/​recordings/​test_aks_create_with_nsg_control.yaml Updated as part of this pull request.
src/​aks-preview/​azext_aks_preview/​tests/​latest/​recordings/​test_aks_create_with_network_plugin_none.yaml Updated as part of this pull request.
src/​aks-preview/​azext_aks_preview/​tests/​latest/​recordings/​test_aks_create_with_network_dataplane_cilium.yaml Updated as part of this pull request.
src/​aks-preview/​azext_aks_preview/​tests/​latest/​recordings/​test_aks_create_with_managed_disk.yaml Updated as part of this pull request.
src/​aks-preview/​azext_aks_preview/​tests/​latest/​recordings/​test_aks_create_with_kube_proxy_config.yaml Updated as part of this pull request.
src/​aks-preview/​azext_aks_preview/​tests/​latest/​recordings/​test_aks_create_with_keda.yaml Updated as part of this pull request.
src/​aks-preview/​azext_aks_preview/​tests/​latest/​recordings/​test_aks_create_with_ingress_appgw_addon.yaml Updated as part of this pull request.
src/​aks-preview/​azext_aks_preview/​tests/​latest/​recordings/​test_aks_create_with_image_integrity_enabled.yaml Updated as part of this pull request.
src/​aks-preview/​azext_aks_preview/​tests/​latest/​recordings/​test_aks_create_with_image_cleaner_enabled_with_interval_hours.yaml Updated as part of this pull request.
src/​aks-preview/​azext_aks_preview/​tests/​latest/​recordings/​test_aks_create_with_image_cleaner_enabled_with_default_interval_hours.yaml Updated as part of this pull request.
src/​aks-preview/​azext_aks_preview/​tests/​latest/​recordings/​test_aks_create_with_ephemeral_disk.yaml Updated as part of this pull request.
src/​aks-preview/​azext_aks_preview/​tests/​latest/​recordings/​test_aks_create_with_enable_upstream_kubescheduler_user_configuration.yaml Updated as part of this pull request.
src/​aks-preview/​azext_aks_preview/​tests/​latest/​recordings/​test_aks_create_with_enable_cost_analysis.yaml Updated as part of this pull request.
src/​aks-preview/​azext_aks_preview/​tests/​latest/​recordings/​test_aks_create_with_enable_cilium_dataplane.yaml Updated as part of this pull request.
src/​aks-preview/​azext_aks_preview/​tests/​latest/​recordings/​test_aks_create_with_enable_ai_toolchain_operator.yaml Updated as part of this pull request.
src/​aks-preview/​azext_aks_preview/​tests/​latest/​recordings/​test_aks_create_with_defaultdomain.yaml Updated as part of this pull request.
src/​aks-preview/​azext_aks_preview/​tests/​latest/​recordings/​test_aks_create_with_default_network.yaml Updated as part of this pull request.
src/​aks-preview/​azext_aks_preview/​tests/​latest/​recordings/​test_aks_create_with_continuous_control_plane_and_addon_monitor.yaml Updated as part of this pull request.
src/​aks-preview/​azext_aks_preview/​tests/​latest/​recordings/​test_aks_create_with_confcom_addon.yaml Updated as part of this pull request.
src/​aks-preview/​azext_aks_preview/​tests/​latest/​recordings/​test_aks_create_with_confcom_addon_helper_enabled.yaml Updated as part of this pull request.
src/​aks-preview/​azext_aks_preview/​tests/​latest/​recordings/​test_aks_create_with_azuremonitorappmonitoring.yaml Updated as part of this pull request.
src/​aks-preview/​azext_aks_preview/​tests/​latest/​recordings/​test_aks_create_with_azurekeyvaultsecretsprovider_addon.yaml Updated as part of this pull request.
src/​aks-preview/​azext_aks_preview/​tests/​latest/​recordings/​test_aks_create_with_app_routing_istio_fails_when_asm_enabled.yaml Updated as part of this pull request.
src/​aks-preview/​azext_aks_preview/​tests/​latest/​recordings/​test_aks_create_with_app_routing_enabled.yaml Updated as part of this pull request.
src/​aks-preview/​azext_aks_preview/​tests/​latest/​recordings/​test_aks_create_with_app_routing_enabled_and_nginx_specified.yaml Updated as part of this pull request.
src/​aks-preview/​azext_aks_preview/​tests/​latest/​recordings/​test_aks_create_with_app_routing_enabled_and_nginx_specified_abbrv.yaml Updated as part of this pull request.
src/​aks-preview/​azext_aks_preview/​tests/​latest/​recordings/​test_aks_create_with_apiserver_vnet_integration.yaml Updated as part of this pull request.
src/​aks-preview/​azext_aks_preview/​tests/​latest/​recordings/​test_aks_create_with_apiserver_vnet_integration_public.yaml Updated as part of this pull request.
src/​aks-preview/​azext_aks_preview/​tests/​latest/​recordings/​test_aks_create_web_application_routing_with_private_dns_zone.yaml Updated as part of this pull request.
src/​aks-preview/​azext_aks_preview/​tests/​latest/​recordings/​test_aks_create_or_update_with_health_probe_mode.yaml Updated as part of this pull request.
src/​aks-preview/​azext_aks_preview/​tests/​latest/​recordings/​test_aks_create_none_private_dns_zone.yaml Updated as part of this pull request.
src/​aks-preview/​azext_aks_preview/​tests/​latest/​recordings/​test_aks_create_node_provisioning_profile.yaml Updated as part of this pull request.
src/​aks-preview/​azext_aks_preview/​tests/​latest/​recordings/​test_aks_create_dualstack_with_default_network.yaml Updated as part of this pull request.
src/​aks-preview/​azext_aks_preview/​tests/​latest/​recordings/​test_aks_create_and_update_with_node_restriction.yaml Updated as part of this pull request.
src/​aks-preview/​azext_aks_preview/​tests/​latest/​recordings/​test_aks_create_again_should_fail.yaml Updated as part of this pull request.
src/​aks-preview/​azext_aks_preview/​tests/​latest/​recordings/​test_aks_create_addon_with_azurekeyvaultsecretsprovider_with_secret_rotation.yaml Updated as part of this pull request.
src/​aks-preview/​azext_aks_preview/​tests/​latest/​recordings/​test_aks_create_add_nodepool_with_custom_ca_trust_certificates.yaml Updated as part of this pull request.
src/​aks-preview/​azext_aks_preview/​tests/​latest/​recordings/​test_aks_cluster_kata.yaml Updated as part of this pull request.
src/​aks-preview/​azext_aks_preview/​tests/​latest/​recordings/​test_aks_cluster_kata_mshv_vm_isolation.yaml Updated as part of this pull request.
src/​aks-preview/​azext_aks_preview/​tests/​latest/​recordings/​test_aks_azure_service_mesh_get_revisions.yaml Updated as part of this pull request.
src/​aks-preview/​azext_aks_preview/​tests/​latest/​recordings/​test_aks_addon_update_all_disabled.yaml Updated as part of this pull request.
src/​aks-preview/​azext_aks_preview/​tests/​latest/​recordings/​test_aks_addon_show_openservicemesh_enabled.yaml Updated as part of this pull request.
src/​aks-preview/​azext_aks_preview/​tests/​latest/​recordings/​test_aks_addon_show_confcom_enabled.yaml Updated as part of this pull request.
src/​aks-preview/​azext_aks_preview/​tests/​latest/​recordings/​test_aks_addon_show_all_disabled.yaml Updated as part of this pull request.
src/​aks-preview/​azext_aks_preview/​tests/​latest/​recordings/​test_aks_addon_list_openservicemesh_enabled.yaml Updated as part of this pull request.
src/​aks-preview/​azext_aks_preview/​tests/​latest/​recordings/​test_aks_addon_list_confcom_enabled.yaml Updated as part of this pull request.
src/​aks-preview/​azext_aks_preview/​tests/​latest/​recordings/​test_aks_addon_list_all_disabled.yaml Updated as part of this pull request.
src/​aks-preview/​azext_aks_preview/​tests/​latest/​recordings/​test_aks_abort.yaml Updated as part of this pull request.
src/​aks-preview/​azext_aks_preview/​managedbastion.py Updated as part of this pull request.
src/​aks-preview/​azext_aks_preview/​custom.py Updated as part of this pull request.

Review effort: Balanced

@yonzhan

Copy link
Copy Markdown
Collaborator

/azp run

@azure-pipelines

Copy link
Copy Markdown
Azure Pipelines:
Successfully started running 2 pipeline(s).

@JaysonTaiMicrosoft
JaysonTaiMicrosoft merged commit 68277ba into Azure:main Oct 20, 2026
26 checks passed
@azclibot

Copy link
Copy Markdown
Collaborator

[Release] Update index.json for extension [ aks-preview-22.0.0b14 ] : https://dev.azure.com/msazure/One/_build/results?buildId=186691268&view=results

Jenniferyingni pushed a commit to Jenniferyingni/azure-cli-extensions that referenced this pull request Oct 21, 2026
API version 2026-08-02-preview adds
storageProfile.diskCSIDriver.quickAttachDetach.enabled, which turns on
Quick Attach Detach for the AzureDisk CSI driver. The SDK bump in Azure#10491
picked up the model; this exposes it on create.

--enable-quick-attach-detach (preview) sets the nested property and also
sets diskCSIDriver.enabled=true, since QAD requires the disk driver. It is
rejected client-side together with --disable-disk-driver. Kubernetes
version, OIDC issuer and Windows pool requirements are left to the RP,
which returns specific errors for each.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

5 participants