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 ListResourceInstances | 查询凭据实例。通过标签过滤,筛选用户凭据,返回凭据列表。 | |
| 批量添加或删除凭据标签 | hcloud CSMS BatchCreateOrDeleteTags | ||
| 查询凭据标签 | hcloud CSMS ListSecretTags | 查询凭据标签。 | |
| 添加凭据标签 | hcloud CSMS CreateSecretTag | 添加凭据标签。 | |
| 删除凭据标签 | hcloud CSMS DeleteSecretTag | 删除凭据标签。 | |
| 查询项目标签 | hcloud CSMS ListProjectSecretsTags | 查询用户在指定项目下的所有凭据标签集合。 |
用户管理
事件管理
| API名称 | 命令 | 描述 | 操作 |
|---|---|---|---|
| 创建事件 | hcloud CSMS CreateSecretEvent | 创建事件,事件可配置在一个或多个凭据对象上。当事件为启用状态且包含的基础事件类型在凭据对象上触发时,云服务会将对应的事件通知发送至事件指定的通知主题上。 | |
| 查询事件列表 | hcloud CSMS ListSecretEvents | 查询当前用户在本项目下创建的所有事件。 | |
| 查询事件 | hcloud CSMS ShowSecretEvent | 查询指定事件的信息。 | |
| 更新事件 | hcloud CSMS UpdateSecretEvent | 更新指定事件的元数据信息。支持更新的元数据包含事件启用状态、基础类型列表、通知主题。 | |
| 立即删除事件 | hcloud CSMS DeleteSecretEvent | 立即删除指定的事件,且无法恢复。如事件存在凭据引用,则无法删除,请先解除关联。 | |
| 查询已触发的事件通知记录 | hcloud CSMS ListNotificationRecords | 查询三个月内所有已触发的事件通知记录。 |
凭据轮转管理
授权管理
密码管理
| API名称 | 命令 | 描述 | 操作 |
|---|---|---|---|
| 生成随机密码 | hcloud CSMS GenerateRandomPassword | 生成随机密码 |