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

CLI命令参考

生命周期管理

API名称

命令

描述

操作

创建凭据

hcloud CSMS CreateSecret

创建新的凭据,并将凭据值存入凭据的初始版本。

去调试

查询凭据列表

hcloud CSMS ListSecrets

查询当前用户在本项目下创建的所有凭据。

去调试

查询凭据

hcloud CSMS ShowSecret

查询指定凭据的信息。

去调试

更新凭据

hcloud CSMS UpdateSecret

更新指定凭据的元数据信息。

去调试

立即删除凭据

hcloud CSMS DeleteSecret

立即删除指定的凭据,且无法恢复。

去调试

恢复凭据对象

hcloud CSMS UploadSecretBlob

通过上传凭据备份文件,恢复凭据对象

去调试

下载凭据备份

hcloud CSMS DownloadSecretBlob

下载指定凭据的备份文件

去调试

创建凭据的定时删除任务

hcloud CSMS DeleteSecretForSchedule

指定延迟删除时间,创建删除凭据的定时任务,可设置7~30天的的延迟删除时间。

去调试

取消凭据的定时删除任务

hcloud CSMS RestoreSecret

取消凭据的定时删除任务,凭据对象恢复可使用状态。

去调试

轮转凭据

hcloud CSMS RotateSecret

立即执行轮转凭据。在指定的凭据中,创建一个新的凭据版本,用于加密存储后台随机产生的凭据值。同时将新创建的凭据版本标记为SYSCURRENT状态。

去调试

批量导入凭据

hcloud CSMS BatchImportSecrets

批量导入凭据。

去调试

凭据版本管理

API名称

命令

描述

操作

创建凭据版本

hcloud CSMS CreateSecretVersion

在指定的凭据中,创建一个新的凭据版本,用于加密保管新的凭据值。默认情况下,新创建的凭据版本被标记为SYSCURRENT状态,而SYSCURRENT标记的前一个凭据版本被标记为SYSPREVIOUS状态。您可以通过指定VersionStage参数来覆盖默认行为。

去调试

查询凭据的版本列表

hcloud CSMS ListSecretVersions

查询指定凭据下的版本列表信息。

去调试

更新凭据版本

hcloud CSMS UpdateVersion

当前支持更新指定凭据版本的有效期,只能更新ENABLED状态的凭据。在关联订阅的事件包含“版本过期”基础事件类型时,每次更新版本有效期后仅会触发一次事件通知。

去调试

查询凭据的版本与凭据值

hcloud CSMS ShowSecretVersion

查询指定凭据版本的信息和版本中的明文凭据值,只能查询ENABLED状态的凭据。

去调试

凭据版本状态管理

API名称

命令

描述

操作

更新凭据的版本状态

hcloud CSMS UpdateSecretStage

更新凭据的版本状态。

去调试

查询凭据的版本状态

hcloud CSMS ShowSecretStage

查询指定凭据版本状态标记的版本信息。

去调试

删除凭据的版本状态

hcloud CSMS DeleteSecretStage

删除指定的凭据版本状态。

去调试

凭据标签管理

API名称

命令

描述

操作

查询凭据实例

hcloud CSMS ListResourceInstances

查询凭据实例。通过标签过滤,筛选用户凭据,返回凭据列表。

去调试

批量添加或删除凭据标签

hcloud CSMS BatchCreateOrDeleteTags

  • 功能介绍:批量添加或删除凭据标签。

去调试

查询凭据标签

hcloud CSMS ListSecretTags

查询凭据标签。

去调试

添加凭据标签

hcloud CSMS CreateSecretTag

添加凭据标签。

去调试

删除凭据标签

hcloud CSMS DeleteSecretTag

删除凭据标签。

去调试

查询项目标签

hcloud CSMS ListProjectSecretsTags

查询用户在指定项目下的所有凭据标签集合。

去调试

用户管理

API名称

命令

描述

操作

查询用户列表

hcloud CSMS ListUsers

查询用户列表。

去调试

获取用户详情

hcloud CSMS ShowUserDetail

根据用户id查询用户详情。

去调试

修改用户密码

hcloud CSMS UpdateUserPassword

修改用户密码

去调试

事件管理

API名称

命令

描述

操作

创建事件

hcloud CSMS CreateSecretEvent

创建事件,事件可配置在一个或多个凭据对象上。当事件为启用状态且包含的基础事件类型在凭据对象上触发时,云服务会将对应的事件通知发送至事件指定的通知主题上。

去调试

查询事件列表

hcloud CSMS ListSecretEvents

查询当前用户在本项目下创建的所有事件。

去调试

查询事件

hcloud CSMS ShowSecretEvent

查询指定事件的信息。

去调试

更新事件

hcloud CSMS UpdateSecretEvent

更新指定事件的元数据信息。支持更新的元数据包含事件启用状态、基础类型列表、通知主题。

去调试

立即删除事件

hcloud CSMS DeleteSecretEvent

立即删除指定的事件,且无法恢复。如事件存在凭据引用,则无法删除,请先解除关联。

去调试

查询已触发的事件通知记录

hcloud CSMS ListNotificationRecords

查询三个月内所有已触发的事件通知记录。

去调试

凭据轮转管理

API名称

命令

描述

操作

查询任务列表

hcloud CSMS ListSecretTask

查询任务列表。

去调试

创建服务委托

hcloud CSMS CreateAgency

创建服务委托。用于创建凭据管理服务相关委托和函数工作流相关委托。

去调试

查看是否有服务委托

hcloud CSMS ShowAgency

查看是否有服务委托

去调试

获取凭据轮转函数模板

hcloud CSMS ShowSecretFunctionTemplates

获取凭据轮转函数模板。

去调试

授权管理

API名称

命令

描述

操作

授权列表

hcloud CSMS ListGrants

授权列表

去调试

更新授权

hcloud CSMS UpdateGrant

更新授权

去调试

授权操作

hcloud CSMS CreateGrants

授权操作

去调试

删除授权

hcloud CSMS DeleteGrant

删除授权

去调试

密码管理

API名称

命令

描述

操作

生成随机密码

hcloud CSMS GenerateRandomPassword

生成随机密码

去调试

凭据检测管理

API名称

命令

描述

操作

检测传入凭据的凭据强度

hcloud CSMS CheckSecrets

检测传入的凭据。

去调试

获取租户的凭据检测配置

hcloud CSMS ShowSecretsConfig

获取租户的凭据检测配置。

去调试

更改获取租户的凭据检测配置

hcloud CSMS UpdateSecretsConfig

更改获取租户的凭据检测配置。

去调试

相关文档