主题
API 与 CLI
日常创建、查看和排查任务时，请优先使用 Web 控制台。使用 API 或 CLI 自动化时，需要匹配目标环境的接口资料、接入地址、认证方式、授权范围和版本规则；开始前先从平台管理员取得这些信息。
如果需要查看接口字段和请求样例，可以查阅 RLark 项目中的 API 调用样例（简体中文）、Storage API 说明（简体中文）和 OpenAPI 文件。这些资料对应 main 分支；接入具体环境时，必须改用与该环境相同的 Git tag 或 commit，并继续遵守本页的认证和授权要求。
在自动化前确认接入信息
编写脚本、SDK、CI 流程或外部集成前，请平台管理员明确提供：
- 目标环境及其精确 RLark 版本或 commit；
- 允许使用的 Base URL、端点、方法和资源范围；
- 认证方式、身份、授权范围和凭据轮换方式；
- API 版本的兼容、升级和弃用规则；
- 并发更新、
resourceVersion、重试、幂等性和速率限制要求； - 日志、审计、配额、故障恢复和支持方式；
- 写操作的影响、停止条件、恢复方案和验证方法。
这些信息不完整时，请继续使用已获授权的控制台流程，不要从浏览器开发者工具复制请求来构造写操作。
v1alpha1 可能随版本变化
RLark 资源使用 rlinf.io/v1alpha1。字段、行为和端点可能随升级变化；自动化必须与目标环境的精确版本保持一致。
区分控制台会话和 API 凭据
浏览器登录只用于进入控制台，不会签发可供自动化使用的 Bearer token。浏览器中保存的会话标记也不是 API 凭据。
自动化调用应使用组织批准的身份和凭据。
写请求返回成功后检查资源状态
成功响应表示接口已经接受请求。创建、更新或删除还可能触发后续的资源协调和数据面操作；请继续检查目标资源状态、数据面处理结果和业务输出。在这些结果确认前，不要启动依赖该变更的后续操作。
使用 YAML 预览核对任务
创建任务时显示的 YAML 预览用于检查即将提交的 RLark Job CRD。它不是通用 YAML 导入、版本迁移或审计工具，也不会展示 RLinf/Hydra 的最终解析配置。
使用版本匹配的 API 资料
管理后台的“接口参考”页面只提供静态展示。生产自动化请使用与目标环境版本匹配的 API 资料，并采用平台管理员提供的认证、授权和接入方式。
使用命令行工具
rlarkadm用于平台部署和数据平面接入，只应由获授权的管理员按照环境运行手册使用。- 使用
rlarkctl前，请从平台管理员取得与目标环境匹配的二进制、安装和认证步骤、版本兼容范围及受支持命令。缺少任一项时，继续使用已获授权的控制台流程。