CLI 参考

pikeway keys remove

从本机删除一把已保存的 key。

用法

bash

pikeway keys remove --label <label> [--json]

说明

从本地配置文件中删除该标签的 key。如果删除的是当前 key,剩下的第一把 key 会成为当前 key;如果没有剩余,则在你添加新 key 之前不再有当前 key。

这只是在本地删除 key,key 本身仍然有效,直到你在控制台 /console/keys 吊销它。

参数

--labelstring必填

要删除的 key 的标签。

示例

bash

pikeway keys remove --label old

# rotate a key: remove, then add the new one under the same label
pikeway keys remove --label main && pikeway keys add --label main --key pk-...

输出

仍有其他 key

removed old; active: main

删除了最后一把 key

removed main

--json

json

{ "removed": "old", "active": "main" }

没有剩余 key 时,active 为 null。

错误与退出码

退出码	错误信息	触发条件
2	missing --label	没有传 `--label` 或没有给值。
2	no key labelled "old"	没有该标签的已保存 key。请用 pikeway keys list 确认。

同样支持全局参数 -j, --json。见全局参数与退出码。