Release notes
This page summarizes the major changes in recent releases of the Alibaba Cloud CLI, highlighting new features and important fixes to help you decide whether to upgrade. For a complete changelog, see GitHub Releases.
Version check and upgrade
Run the following command to check your Alibaba Cloud CLI version:
aliyun version
Run the following command to upgrade to the latest version:
aliyun upgrade
After the upgrade completes, run aliyun version again to verify the update.
For more upgrade options, see Install, update, and uninstall Alibaba Cloud CLI.
Change summary
The following sections list major changes in recent releases, in reverse chronological order.
v3.5.1 (2026-09-18)
Adds JSON/JSONL output and pagination to OSS listing operations for scripting.
Adds pre-execution validation and previews for OSS single-file uploads and single-object deletion.
Fixes known issues.
v3.5.0 (2026-09-07)
Extends AI mode with structured errors, spelling suggestions, and recovery guidance.
Removes retired products
acm,aigen,Ddi,scdn,scsp,viapi-regen, andWebPlus. Migrate affected scripts.Updates PascalCase commands to use
DomainAPI version2018-01-29instead of2016-05-11, andQualitycheckversion2019-01-15instead of2016-08-01. Update affected scripts.
v3.4.11 (2026-07-29)
Extends
--estimate-costsupport to invocation scenarios such as SLS and OSS.
v3.4.9 (2026-07-24)
Adds
aliyun ecctlfor the Elastic Compute Control CLI.Fixes parsing of commands with quotes or line continuations in External credential mode.
Fixes the
--profileparameter inaliyun osssubcommands.Fixes MaxCompute CLI installation failures caused by insufficient permissions on Windows.
v3.4.8 (2026-07-17)
Adds
aliyun mseutilfor the MSE utility.Adds
aliyun flow-clifor the Flow CLI.Adds
--cli-dry-runfor request previews in PascalCase commands.Adds support for profile endpoint and VPC endpoint settings in OSS commands.
Fixes saving of the configured read timeout.
v3.4.7 (2026-07-15)
Adds support for plugin aliases.
Adds support for specifying the size of mock responses.
Fixes incorrect plugin selection during bulk updates.
v3.4.6 (2026-07-10)
Adds
--estimate-cost-contextto pass pricing context for cost estimates.Adds support for simulating execution delays in mock commands.
v3.4.5 (2026-07-07)
Adds
aliyun esa-clifor the ESA CLI.Adds custom STS endpoints for OIDC and role authentication.
v3.4.3 (2026-07-01)
Adds
ALIBABA_CLOUD_DISABLE_EXTERNAL_PROCESSto disable credential retrieval through External and CredentialsURI modes.
v3.4.2 (2026-06-26)
Adds
--estimate-costto estimate costs without executing the target API.Adds
aliyun list-supported-pricing-apisto list APIs that support cost estimation.
v3.4.1 (2026-06-24)
Adds
aliyun lindormfor the Lindorm CLI.Adds the
aliyun spark-submitcommand.
v3.4.0 (2026-06-23)
Adds
aliyun rostranfor ROS template conversion.Adds a diagnosis subcommand to the ACR CLI.
Adds
--cli-dry-run-jsonfor request previews in JSON format.Adds
Anonymousmode for APIs that allow anonymous access.Improves retry delays after API throttling.
v3.3.23 (2026-06-10)
-
Certain plugins that manage their own credentials, such as rdc, no longer require a pre-configured credential profile.
v3.3.22 (2026-06-05)
-
Optimizes the logging policy for self-built gateway products.
v3.3.21 (2026-06-04)
-
Improves safety policy rule matching to match against the commands that users actually type for ROA-style APIs.
v3.3.20 (2026-06-03)
-
Adds call context logging for OpenAPI calls.
v3.3.19 (2026-06-03)
-
Adds the
aliyun maxccommand, which integrates the MaxCompute CLI. -
Generalizes AppManager credential pass-through to support multiple authentication modes.
v3.3.18 (2026-05-29)
-
Adds the
aliyun iact3command, which integrates the ROS IaC testing tool. -
Adds the
aliyun kmsclicommand, which integrates the Key Management Service (KMS) CLI. -
Improves the
aliyun cms2command descriptions and clarifies error return codes.
v3.3.17 (2026-05-28)
-
Adds support for passing the
--languageand--profileparameters during plugin execution. -
Adds support for ComputeNest PyPI virtual environments.
-
Adds the
aliyun codeup-clicommand.
v3.3.16 (2026-05-23)
-
Adds the
aliyun acrutilcommand, a utility for managing resources in Container Registry (ACR). -
Adds support for the
BearerTokencredential mode to thealiyun configurecommand. -
Improves error messages.
v3.3.15 (2026-05-15)
-
Adds the
aliyun saectlcommand, which integrates the Serverless App Engine CLI and is automatically downloaded on first use. -
Adds the
aliyun cms2command, which integrates the CloudMonitor 2.0 CLI as a standalone binary for managing monitoring integrations, Prometheus, alerting rules, and PromQL. -
Adds support for OpenTelemetry observability.
-
Adds support for passing OTEL headers in the plugin environment.
v3.3.14 (2026-05-09)
-
Adds the
aliyun appmanagercommand, which integrates the AppManager CLI. -
Adds the
--nameparameter to thealiyun plugin installcommand. -
Improves the agent detection logic.
v3.3.13 (2026-05-08)
No functional changes in this release.
v3.3.12 (2026-04-29)
-
Adds the
aliyun mockcommand. -
Adds the
aliyun agentbaycommand.
v3.3.11 (2026-04-27)
Fixes a potential MCP proxy crash when saving credentials fails.
v3.3.10 (2026-04-21)
Updates API information. Users of v3.3.9 should upgrade to this version.
v3.3.9 (2026-04-21) (Prerelease)
This prerelease has an abnormal API metadata deletion issue. Upgrade to v3.3.10.
v3.3.8 (2026-04-17)
-
Adds the
--packageparameter to thealiyun plugin installcommand to install a plugin from a local package. -
Adds the
aliyun plugin showcommand to view plugin details.
v3.3.7 (2026-04-16)
Fixes incorrect endpoint overrides by environment variables.
v3.3.6 (2026-04-14)
Fixes parsing of the
-eendpoint parameter in OSS subcommands.
v3.3.5 (2026-04-14)
-
Adds the
aliyun upgradecommand for one-click CLI upgrades.
v3.3.4 (2026-04-01)
Fixes unknown-parameter parsing in plugin commands.
v3.3.3 (2026-03-26)
-
Adds the
aliyun configure safety-policycommand to configure a safety policy that requires manual confirmation for operations. -
Adds the
aliyun configure ai-modecommand to configure the AI mode. -
Adds the
--yes/-yglobal parameter to bypass the safety policy confirmation prompt.
v3.3.2 (2026-03-18)
Updates API information.
v3.3.1 (2026-03-16)
Adds
--user-agentto append custom User-Agent identifiers.Adds support for repeated parameters in plugin commands.
v3.3.0 (2026-03-13)
This version introduces a plugin-based architecture, which reduces the installation package size and improves startup speed.
-
Refactors cloud product CLI capabilities into plugins that are installed on demand instead of being built-in.
-
Adds the
aliyun plugincommand group (install / uninstall / list / update / search) for managing plugins. -
Adds an automatic plugin installation feature that downloads and installs the required plugin when you run a cloud product command.
Full changelog
The preceding sections summarize major changes. For a complete changelog with details on dependency updates, bug fixes, and API metadata changes, see the Alibaba Cloud CLI GitHub Releases page.