更新时间:2026-09-29 GMT+08:00

CLI命令参考

物理服务器管理

API名称

命令

描述

操作

批量查询物理服务器

hcloud CloudDC ListServers

List imetal servers

去调试

查询物理服务器信息

hcloud CloudDC ShowServer

Get imetal server by id

去调试

查询服务器硬件详细信息

hcloud CloudDC ShowServerHardwareAttributes

获取详细硬件信息

去调试

查询服务器固件详细信息

hcloud CloudDC ShowServerFirmwareAttributes

获取详细固件信息

去调试

批量修改物理服务器电源状态

hcloud CloudDC ChangeServerPowerState

修改物理服务器电源状态,此接口为异步接口,电源状态修改成功与否需要根据查询物理服务器信息获得

去调试

导出服务器日志请求

hcloud CloudDC ExportServerLogs

创建服务器日志导出异步任务。根据ShowLogsExportStatus查询status,当status状态为completed时,调用DownloadServerLogs下载日志文件。

去调试

查询日志导出状态

hcloud CloudDC ShowLogsExportStatus

查询日志采集状态及进度。

去调试

获取console地址信息

hcloud CloudDC ShowRemoteConsole

获取console信息

去调试

下载日志文件

hcloud CloudDC DownloadServerLogs

下载服务器日志文件。

去调试

物理服务器诊断

API名称

命令

描述

操作

服务器概览

hcloud CloudDC ShowServerStatus

该 API 用于查询服务器概览、服务器开机状态和服务器运行状态

去调试

服务器告警概览

hcloud CloudDC ShowAlarmSummary

该 API 用于查询服务器告警概览

去调试

服务器告警趋势

hcloud CloudDC ShowAlarmTrend

该 API 用于查询服务器概览、服务器开机状态和服务器运行状态

去调试

服务器告警列表

hcloud CloudDC ListAlarms

该 API 用于查询服务器告警列表

去调试

服务器事件列表

hcloud CloudDC ListEvents

该 API 用于查询服务器事件列表

去调试

查询事件定义

hcloud CloudDC ShowEvent

查询事件定义

去调试

标签管理

API名称

命令

描述

操作

批量创建资源标签

hcloud CloudDC BatchCreateTags

批量创建资源标签

去调试

批量删除资源标签

hcloud CloudDC BatchDeleteTags

批量删除资源标签

去调试

批量创建机柜标签

hcloud CloudDC BatchCreateIrackTags

批量创建机柜标签

去调试

批量删除机柜标签

hcloud CloudDC BatchDeleteIrackTags

批量删除机柜标签

去调试

裸机实例管理

API名称

命令

描述

操作

批量查询实例

hcloud CloudDC ListInstances

批量查询实例

去调试

创建实例

hcloud CloudDC CreateInstance

创建实例,支持指定IP等更多个性化参数创建实例。

去调试

删除实例

hcloud CloudDC DeleteInstance

指定物理服务器删除实例,此接口为异步接口,可通过 ShowInstanceStatus 查询实例状态,实例状态从 shutting-down 变为 terminated,表明删除实例成功。

去调试

修改实例ip

hcloud CloudDC ModifyInstanceIp

用户可选择指定的 iMetal 实例,修改ip。

去调试

批量修改实例密码

hcloud CloudDC ChangeInstancePassword

修改服务器管理账号(root用户或Administrator用户)密码

去调试

批量重新安装OS

hcloud CloudDC ReinstallOs

指定新OS镜像重新安装OS,此接口为异步接口,通过 ShowInstanceStatus 查询实例状态,当状态变为 pending 表明正在重装中,状态为 running 表明完成重装。

去调试

查询实例状态

hcloud CloudDC ShowInstanceStatus

查询实例状态

去调试

批量创建实例

hcloud CloudDC RunInstances

批量创建实例,其中调度策略支持:

去调试

批量删除实例

hcloud CloudDC DeleteInstances

指定物理服务器批量删除实例,此接口为异步接口,可通过 ShowInstanceStatus 查询实例状态,实例状态从 shutting-down 变为 terminated,表明删除实例成功。

去调试

机架管理

API名称

命令

描述

操作

更新 iRack 实例

hcloud CloudDC UpdateIRack

更新iRack信息

去调试

查询 iRack 实例列表

hcloud CloudDC ListIRacks

用户下单后,用户上报iRack设备列表。该 API 可以查看 iRack 实例与关联imetal数量列表。

去调试

机房管理

API名称

命令

描述

操作

修改 IDC 描述

hcloud CloudDC UpdateIDcs

修改 IDC 描述

去调试

查询 IDC 列表

hcloud CloudDC ListIDcs

查询 IDC 列表

去调试