bk-cli sops — 标准运维能力使用说明

用于通过 bk-cli sops 调用蓝鲸标准运维（SOPS）API 的系统子命令。

CRITICAL — 开始前 MUST 先用 Read 工具读取 ../bk-cli-shared/SKILL.md。共享 skill 负责认证、context、tenant、stage、dry-run、verbose、header/body 和通用请求规则；本 skill 只补充 sops 命令自己的语义与输入约定。

当前覆盖范围

当前 skill 覆盖这些常用命令：

• gettemplatelist
• gettasklist
• gettaskstatus
• gettaskdetail
• create_task
• start_task
• operate_task

Commands

模板查询

gettemplatelist

bk-cli sops get_template_list --bk_biz_id 2
bk-cli sops get_template_list --bk_biz_id 2 --keyword deploy

• 调用路径：GET /gettemplatelist/{bkbizid}/

任务管理

gettasklist

bk-cli sops get_task_list --bk_biz_id 2
bk-cli sops get_task_list --bk_biz_id 2 --keyword deploy --limit 50

• 调用路径：GET /gettasklist/{bkbizid}/

create_task

bk-cli sops create_task --bk_biz_id 2 --template_id 100 --name "deploy-v1"
bk-cli sops create_task --bk_biz_id 2 --template_id 100 --name "deploy" --constants '{"${key}":"value"}'

• 从模板创建任务
• --constants 必须是 JSON 对象，CLI 会以嵌套对象形式写入请求体
• 调用路径：POST /createtask/{templateid}/{bkbizid}/

start_task

bk-cli sops start_task --bk_biz_id 2 --task_id 100

• 启动已创建的任务
• 调用路径：POST /starttask/{taskid}/{bkbizid}/

gettaskstatus

bk-cli sops get_task_status --task_id 100 --bk_biz_id 2

• 调用路径：GET /gettaskstatus/{taskid}/{bkbiz_id}/

gettaskdetail

bk-cli sops get_task_detail --task_id 100 --bk_biz_id 2

• 调用路径：GET /gettaskdetail/{taskid}/{bkbiz_id}/

operate_task

bk-cli sops operate_task --bk_biz_id 2 --task_id 100 --action pause
bk-cli sops operate_task --bk_biz_id 2 --task_id 100 --action resume
bk-cli sops operate_task --bk_biz_id 2 --task_id 100 --action revoke

• 操作任务：暂停、继续或终止
• action 必须是 pause / resume / revoke 之一
• 调用路径：POST /operatetask/{taskid}/{bkbizid}/