aliyun

阿里云命令行接口

补充说明

aliyun 是阿里云 CLI，按产品调用 OpenAPI，例如 aliyun ecs DescribeInstances、aliyun oss ls。它依赖 profile、地域和 RAM 权限，适合脚本化和批量运维。

常用示例

aliyun configure
aliyun configure --profile prod
aliyun ecs DescribeInstances --RegionId cn-hangzhou
aliyun ecs DescribeInstances --RegionId cn-hangzhou \
  --output cols=InstanceId,Status rows=Instances.Instance[]
aliyun oss ls
aliyun oss cp ./dist.zip oss://my-bucket/
aliyun oss sync ./site oss://my-bucket/site
aliyun cs GET /clusters
aliyun ram ListUsers
aliyun sts AssumeRole --RoleArn acs:ram::1234567890:role/deploy \
  --RoleSessionName deploy

易错点与排错

• 每个产品的 API 名和参数不同；用 aliyun <product> --help 查，不要套用其他云的写法。
• 地域参数通常是 --RegionId；漏掉会落到默认地域或直接报错。
• profile 之间的 AccessKey 和 STS 令牌不同；aliyun configure list 确认当前身份。
• RAM 权限按 Action 和资源授权；AccessDenied 时看策略而不是只看 AK 是否有效。
• STS 临时凭据会过期；长期任务要处理刷新和失败重试。
• oss 子命令和 ECS/OpenAPI 的语法不同；OSS 路径是 oss://bucket/key。
• 输出格式和分页参数因产品而异；脚本里显式指定 --output 和分页。
• AccessKey 不要写进脚本或仓库；用 profile、环境变量或 RAM 角色。

相关命令

• ossutil — OSS 专用客户端
• aws — AWS CLI
• terraform — 声明式管理阿里云资源