用途:通过官方 aliyun CLI 执行阿里云 OpenAPI 操作,提供从安装、配置、API 发现、执行到排错的标准化流程。
主要能力:先运行版本守卫脚本 ensure_aliyun_cli.py(默认 24 小时检查间隔,可配置;未安装或低于最低版本时自动下载安装最新官方包);配置凭证与默认地域;用 aliyun <product> --help 与 aliyun <product> <ApiName> --help 确认参数;支持通用形式 aliyun <product> <ApiName> --Param1 value1 与 REST 形式 aliyun <product> [GET|POST|PUT|DELETE] <PathPattern> --body '...json...'。示例命令包括 aliyun ecs DescribeRegions、aliyun ecs DescribeInstances --RegionId cn-hangzhou、aliyun sls ListProject --endpoint cn-hangzhou.log.aliyuncs.com --size 100。安装示例(Linux):curl -fsSL https://aliyuncli.alicdn.com/aliyun-cli-linux-latest-amd64.tgz -o /tmp/aliyun-cli.tgz 等步骤。配置示例:aliyun configure set --profile default --mode AK --access-key-id <AK> --access-key-secret <SK> --region cn-hangzhou;可用 aliyun configure list 查看配置。
使用方式:建议先执行版本守卫脚本,明确用户意图、地域、资源标识及操作是否为只读;先做一次最小只读查询验证连通性与权限,再执行有界范围的变更操作,并保存版本检查、API 输出与错误日志到 output/alicloud-platform-aliyun-cli/。
适用场景:需要通过命令行调用阿里云 OpenAPI 完成资源查询与管理的场景,如 ECS、SLS 等产品操作。
限制:需预先配置最小权限的阿里云凭证,优先使用环境变量 ALICLOUD_ACCESS_KEY_ID、ALICLOUD_ACCESS_KEY_SECRET 及可选 ALICLOUD_REGION_ID;地域不明确时应先询问用户再执行变更操作;删除、覆盖前应先输出目标资源列表;批量操作先小范围验证一条。常见问题包括 InvalidAccessKeyId.NotFound、SignatureDoesNotMatch(检查 AK/SK 与 profile)、MissingRegionId(补 --region 或配置默认地域)、SLS endpoint 错误(显式传 --endpoint)。其余价格与平台支持等事实资料未提供。