SuperAPI AI 工具集

trial-management

部署与运维

查看项目

更新于 10-29 14:30

技能介绍

Trial Management 用于管理 Acquia Cloud 上的试用 Drupal 站点,基于 v2 Cloud API 的 Trials 接口(acli api:),属于轻量的预开通(pre-MEO)能力,而非 MEO(acli api:v3:)。一个用户同一时间只能拥有一个活动试用。

主要用途包括:创建新的试用 Drupal 站点;检查试用是否仍在开通、已完成或已失败;获取已完成试用的实时站点 URL 与管理员登录链接;重试开通失败的试用;在创建前选择 Drupal 模板或 AWS 区域。

试用生命周期为:创建后进入 pending,再进入 in-progress,最终到达 completed 或 failed;failed 可通过重试回到 in-progress。状态始终是 pending、in-progress、completed、failed 之一。应使用 api:account:find-trial 轮询,不能假定开通完成,使用 _links 前必须先确认状态。pending/in-progress 时仅有 percent_complete(0-100 整数),没有站点链接;completed 时出现 _links.site(公开实时 URL)与 _links.admin(一次性登录链接);failed 时出现 _links.retry。

使用方式:先运行 acli auth:login 完成认证;执行 acli api:account:find-trial 查询自己的试用状态(无需 ID 参数,返回 404 表示没有活动试用);用 acli api:trials:create <site_name> <site_template_id> <region> 创建试用,site_name 需匹配 ^[a-z][a-z0-9]*$(小写字母数字、字母开头、最长 60 字符);用 acli api:trials:retry <trialId> 重试失败试用;用 acli api:trials:list-templates 与 acli api:trials:list-regions 解析模板与区域,两者均支持 --offset 与 --limit 分页。注意创建成功返回的是消息与 _links.self 而非完整对象,且 --task-wait 不适用,需继续轮询 find-trial;CLI 无法按 ID 查询试用,GET /trials/{trialId} 仅限 REST。

适用场景:为开发者快速开通 Drupal 试用站点并取回访问链接、跟踪开通进度、在失败后恢复。限制:需有效 Acquia 账号并先认证;同一时间仅一个活动试用;模板/区域需从列表动态获取;设备码登录会阻塞等待用户在浏览器确认。