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.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.12 (2026-04-29)

  • Adds the aliyun mock command.

  • Adds the aliyun agentbay command.

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.5 (2026-04-14)

  • Adds the aliyun upgrade command for one-click CLI upgrades.

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.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.