核心功能与用法
alicloud-ai-recommend-airec 是面向阿里云智能推荐（AIRec）服务的运维管理工具，基于官方 OpenAPI RPC 接口实现资源全生命周期管理。该工具采用"元数据优先"的设计理念，通过调用 OpenAPI 元数据端点自动发现可用 API 列表及参数 schema，降低人工查阅文档的成本。
典型工作流程：
1. 环境准备：通过环境变量 ALICLOUD_ACCESS_KEY_ID / ALICLOUD_ACCESS_KEY_SECRET 配置认证信息，可选设置 ALICLOUD_REGION_ID 作为默认地域
2. API 发现：执行 list_openapi_meta_apis.py 脚本获取 Airec 产品（产品代码：Airec，默认版本：2020-11-26）的完整 API 清单
3. 资源操作：遵循高频模式——清单类用 List* / Describe*、变更类用 Create* / Update* / Modify*、诊断类用 Get* / Query*
4. 结果验证：通过 describe/list 类 API 确认操作生效，所有输出保存至 output/alicloud-ai-recommend-airec/ 目录
显著优点：
- 官方 SDK 背书，接口稳定性与兼容性有保障
- 元数据驱动，自动适配 API 版本变更
- 标准化输出目录，便于审计与复现
- 支持 OpenAPI Explorer 可视化调试
潜在局限：
- 需预先配置阿里云 AccessKey，存在密钥管理风险
- 地域策略需人工判断或交互确认，自动化场景可能中断
- 仅覆盖 2020-11-26 及后续 API 版本，历史版本兼容性未明确
- 依赖 Python 运行时环境，非容器化部署需手动处理依赖
适用人群：
- 阿里云 AIRec 服务运维工程师
- 推荐系统架构师（需批量管理多环境资源）
- DevOps 团队（构建推荐引擎 CI/CD 流水线）
常规风险提示：
- AccessKey 属于敏感凭证，严禁硬编码或提交至版本仓库
- 变更类操作（Create/Update/Modify）建议先在测试实例验证
- 未明确设置地域时可能误操作非预期资源，生产环境务必显式指定
ALICLOUD_REGION_ID - API 限流策略未在文档中披露，高频调用需自行实现退避重试