Release notes

Updated at:
Copy as MD

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.

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, and WebPlus. Migrate affected scripts.

  • Updates PascalCase commands to use Domain API version 2018-01-29 instead of 2016-05-11, and Qualitycheck version 2019-01-15 instead of 2016-08-01. Update affected scripts.

v3.4.11 (2026-07-29)

  • Extends --estimate-cost support to invocation scenarios such as SLS and OSS.

v3.4.9 (2026-07-24)

  • Adds aliyun ecctl for the Elastic Compute Control CLI.

  • Fixes parsing of commands with quotes or line continuations in External credential mode.

  • Fixes the --profile parameter in aliyun oss subcommands.

  • Fixes MaxCompute CLI installation failures caused by insufficient permissions on Windows.

v3.4.8 (2026-07-17)

  • Adds aliyun mseutil for the MSE utility.

  • Adds aliyun flow-cli for the Flow CLI.

  • Adds --cli-dry-run for 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-context to pass pricing context for cost estimates.

  • Adds support for simulating execution delays in mock commands.

v3.4.5 (2026-07-07)

  • Adds aliyun esa-cli for the ESA CLI.

  • Adds custom STS endpoints for OIDC and role authentication.

v3.4.3 (2026-07-01)

  • Adds ALIBABA_CLOUD_DISABLE_EXTERNAL_PROCESS to disable credential retrieval through External and CredentialsURI modes.

v3.4.2 (2026-06-26)

  • Adds --estimate-cost to estimate costs without executing the target API.

  • Adds aliyun list-supported-pricing-apis to list APIs that support cost estimation.

v3.4.1 (2026-06-24)

  • Adds aliyun lindorm for the Lindorm CLI.

  • Adds the aliyun spark-submit command.

v3.4.0 (2026-06-23)

  • Adds aliyun rostran for ROS template conversion.

  • Adds a diagnosis subcommand to the ACR CLI.

  • Adds --cli-dry-run-json for request previews in JSON format.

  • Adds Anonymous mode 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 maxc command, which integrates the MaxCompute CLI.

  • Generalizes AppManager credential pass-through to support multiple authentication modes.

v3.3.18 (2026-05-29)

  • Adds the aliyun iact3 command, which integrates the ROS IaC testing tool.

  • Adds the aliyun kmscli command, which integrates the Key Management Service (KMS) CLI.

  • Improves the aliyun cms2 command descriptions and clarifies error return codes.

v3.3.17 (2026-05-28)

  • Adds support for passing the --language and --profile parameters during plugin execution.

  • Adds support for ComputeNest PyPI virtual environments.

  • Adds the aliyun codeup-cli command.

v3.3.16 (2026-05-23)

  • Adds the aliyun acrutil command, a utility for managing resources in Container Registry (ACR).

  • Adds support for the BearerToken credential mode to the aliyun configure command.

  • Improves error messages.

v3.3.15 (2026-05-15)

  • Adds the aliyun saectl command, which integrates the Serverless App Engine CLI and is automatically downloaded on first use.

  • Adds the aliyun cms2 command, 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 appmanager command, which integrates the AppManager CLI.

  • Adds the --name parameter to the aliyun plugin install command.

  • 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 mock command.

  • Adds the aliyun agentbay command.

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 --package parameter to the aliyun plugin install command to install a plugin from a local package.

  • Adds the aliyun plugin show command 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 -e endpoint parameter in OSS subcommands.

v3.3.5 (2026-04-14)

  • Adds the aliyun upgrade command 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-policy command to configure a safety policy that requires manual confirmation for operations.

  • Adds the aliyun configure ai-mode command to configure the AI mode.

  • Adds the --yes / -y global 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-agent to 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 plugin command 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.