用途:通过阿里云 CLI 插件 aliyun-cli-devops 调用云效 OpenAPI,覆盖 Codeup、Flow、Projex、AppStack、Packages、TestHub 等模块。数据面只用个人访问令牌(PAT),不使用 aliyun configure / AK-SK。
检测(不预装):运行 aliyun version 与 aliyun devops version;CLI ≥ 3.3.0 且插件返回版本则继续,否则读 references/install.md 安装 CLI 与插件。
凭证检查:只检测环境变量是否存在,绝不打印令牌。PowerShell 检查 $env:ALIBABA_CLOUD_YUNXIAO_ACCESS_TOKEN 及 ORGANIZATION_ID 或 API_BASE_URL;bash 检查 -n "$ALIBABA_CLOUD_YUNXIAO_ACCESS_TOKEN"。未配置时按 references/install.md 引导用户获取 PAT 和 organization-id 或 Region 版 api-base-url。
组织类型:中心版用内置 openapi-rdc.aliyuncs.com,不设 api-base-url,必须设 ALIBABA_CLOUD_YUNXIAO_ORGANIZATION_ID;Region 版用控制台实例访问域名作 ALIBABA_CLOUD_YUNXIAO_API_BASE_URL,不设组织 ID。
PAT 获取:云效工作台 → 头像 → 个人设置 → 个人访问令牌,仅创建时显示一次,需最小权限并设过期时间。禁止把令牌写入命令行、回复、日志或 commit,检查时只报已设置或未设置。
模块前缀:app-stack-* AppStack、base-* 组织成员、codeup-* Codeup、flow-* Flow、insight-* Insight、packages-* Packages、projex-* Projex、test-hub-* TestHub。
调用方式:aliyun devops <command> [flags],优先环境变量,用 --cli-query 收窄输出。示例:aliyun devops codeup-list-repositories --page 1 --per-page 20;aliyun devops projex-search-projects --page 1 --per-page 10。不确定命令或参数时用 aliyun devops --help 或 aliyun devops <command> --help,不要猜。
限制:需先具备阿里云 CLI、devops 插件与有效 PAT;令牌只在创建时显示一次,需自行保管;价格、配额等未提供。