更新时间:2026-08-26 GMT+08:00
分享

CLI命令参考

密钥对管理

API名称

命令

描述

操作

查询SSH密钥对列表

hcloud KPS ListKeypairs

查询SSH密钥对列表

去调试

创建和导入SSH密钥对

hcloud KPS CreateKeypair

创建和导入SSH密钥对

去调试

查询SSH密钥对详细信息

hcloud KPS ListKeypairDetail

查询SSH密钥对详细信息

去调试

删除SSH密钥对

hcloud KPS DeleteKeypair

删除SSH密钥对。

去调试

更新SSH密钥对描述

hcloud KPS UpdateKeypairDescription

更新SSH密钥对描述。

去调试

导入私钥

hcloud KPS ImportPrivateKey

导入私钥到指定密钥对。

去调试

导出私钥

hcloud KPS ExportPrivateKey

导出指定密钥对的私钥。

去调试

清除私钥

hcloud KPS ClearPrivateKey

清除SSH密钥对私钥。

去调试

批量导入SSH密钥对

hcloud KPS BatchImportKeypair

批量导入SSH密钥对,单次批量导入不得超过10条记录。

去调试

批量导出密钥对私钥

hcloud KPS BatchExportPrivateKey

批量导出密钥对私钥,单次最多导出10条数据

去调试

密钥对任务管理

API名称

命令

描述

操作

绑定SSH密钥对

hcloud KPS AssociateKeypair

给指定的虚拟机绑定(替换或重置,替换需提供虚拟机已配置的SSH密钥对私钥;重置不需要提供虚拟机的SSH密钥对私钥)新的SSH密钥对。

去调试

解绑SSH密钥对

hcloud KPS DisassociateKeypair

给指定的虚拟机解除绑定SSH密钥对并恢复SSH密码登录。

去调试

查询任务信息

hcloud KPS ListKeypairTask

根据SSH密钥对接口返回的task_id,查询SSH密钥对当前任务的执行状态。

去调试

查询失败的任务信息

hcloud KPS ListFailedTask

查询绑定、解绑等操作失败的任务信息。

去调试

删除所有失败的任务

hcloud KPS DeleteAllFailedTask

删除操作失败的任务信息。

去调试

删除失败的任务

hcloud KPS DeleteFailedTask

删除失败的任务。

去调试

查询正在处理的任务信息

hcloud KPS ListRunningTask

查询正在处理的任务信息。

去调试

批量绑定SSH密钥对

hcloud KPS BatchAssociateKeypair

给指定的虚拟机批量绑定新的SSH密钥对。

去调试

相关文档