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.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.12 (2026-04-29)
-
Adds the
aliyun mockcommand. -
Adds the
aliyun agentbaycommand.
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.5 (2026-04-14)
-
Adds the
aliyun upgradecommand for one-click CLI upgrades.
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.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.