# CLI命令参考 #### 裸金属服务器生命周期管理 | API名称 | 命令 | 描述 | 操作 | |:---|:---|:---|:---| | 查询裸金属服务器详情列表 | hcloud BMS ListBareMetalServers | 用户根据设置的请求条件筛选裸金属服务器，并获取裸金属服务器的详细信息。该接口支持查询裸金属服务器计费方式，以及是否被冻结。 | [去调试](https://console.huaweicloud.com/apiexplorer/#/openapi/BMS/cli?api=ListBareMetalServers) | | 查询裸金属服务器列表 | hcloud BMS ListBareMetalServersDetail | 用户根据设置的请求条件筛选裸金属服务器，并获取裸金属服务器的详细信息。 | [去调试](https://console.huaweicloud.com/apiexplorer/#/openapi/BMS/cli?api=ListBareMetalServersDetail) | | 创建裸金属服务器 | hcloud BMS CreateBareMetalServers | 创建一台或多台裸金属服务器。 | [去调试](https://console.huaweicloud.com/apiexplorer/#/openapi/BMS/cli?api=CreateBareMetalServers) | | 查询裸金属服务器详情 | hcloud BMS ListBareMetalServerDetails | 获取裸金属服务器详细信息，该接口支持查询裸金属服务器的计费方式，以及是否被冻结。 | [去调试](https://console.huaweicloud.com/apiexplorer/#/openapi/BMS/cli?api=ListBareMetalServerDetails) | #### 裸金属服务器状态管理 | API名称 | 命令 | 描述 | 操作 | |:---|:---|:---|:---| | 修改裸金属服务器名称 | hcloud BMS ChangeBaremetalServerName | 修改裸金属服务器名称。 | [去调试](https://console.huaweicloud.com/apiexplorer/#/openapi/BMS/cli?api=ChangeBaremetalServerName) | | 重装裸金属服务器操作系统 | hcloud BMS ReinstallBaremetalServerOs | 重装裸金属服务器的操作系统。快速发放裸金属服务器支持裸金属服务器数据盘不变的情况下，使用原镜像重装系统盘。重装操作系统支持密码或者密钥注入。 | [去调试](https://console.huaweicloud.com/apiexplorer/#/openapi/BMS/cli?api=ReinstallBaremetalServerOs) | | 启动裸金属服务器 | hcloud BMS BatchStartBaremetalServers | 根据给定的裸金属服务器ID列表，批量启动裸金属服务器。 | [去调试](https://console.huaweicloud.com/apiexplorer/#/openapi/BMS/cli?api=BatchStartBaremetalServers) | | 重启裸金属服务器 | hcloud BMS BatchRebootBaremetalServers | 根据给定的裸金属服务器ID列表，批量重启裸金属服务器。 | [去调试](https://console.huaweicloud.com/apiexplorer/#/openapi/BMS/cli?api=BatchRebootBaremetalServers) | | 关闭裸金属服务器 | hcloud BMS BatchStopBaremetalServers | 根据给定的裸金属服务器ID列表，批量关闭裸金属服务器。 | [去调试](https://console.huaweicloud.com/apiexplorer/#/openapi/BMS/cli?api=BatchStopBaremetalServers) | | 获取裸金属服务器远程登录地址 | hcloud BMS ShowServerRemoteConsole | 获取裸金属服务器远程登录地址。 | [去调试](https://console.huaweicloud.com/apiexplorer/#/openapi/BMS/cli?api=ShowServerRemoteConsole) | | 切换裸金属服务器的操作系统 | hcloud BMS ChangeBaremetalServerOs | 切换裸金属服务器的操作系统。切换操作系统支持密码或者密钥注入。 | [去调试](https://console.huaweicloud.com/apiexplorer/#/openapi/BMS/cli?api=ChangeBaremetalServerOs) | #### 裸金属服务器元数据管理 | API名称 | 命令 | 描述 | 操作 | |:---|:---|:---|:---| | 更新裸金属服务器元数据 | hcloud BMS UpdateBaremetalServerMetadata | 更新裸金属服务器元数据。如果元数据中没有待更新字段，则自动添加该字段。如果元数据中已存在待更新字段，则直接更新字段值；如果元数据中的字段不在请求参数中，则保持不变。 | [去调试](https://console.huaweicloud.com/apiexplorer/#/openapi/BMS/cli?api=UpdateBaremetalServerMetadata) | #### 裸金属服务器元数据配置管理 | API名称 | 命令 | 描述 | 操作 | |:---|:---|:---|:---| | 更新裸金属服务器元数据配置 | hcloud BMS UpdateMetadataOptions | 更新裸金属服务器元数据配置，通过本接口，您可以选择启用或关闭IMDS服务，也可以选择IMDS服务的版本。 | [去调试](https://console.huaweicloud.com/apiexplorer/#/openapi/BMS/cli?api=UpdateMetadataOptions) | | 查询裸金属服务器元数据配置 | hcloud BMS ShowMetadataOptions | 查询云服务器元数据配置，通过本接口，您可以查询指裸金属服务器的元数据配置。 | [去调试](https://console.huaweicloud.com/apiexplorer/#/openapi/BMS/cli?api=ShowMetadataOptions) | #### 裸金属服务器网卡管理 | API名称 | 命令 | 描述 | 操作 | |:---|:---|:---|:---| | 查询裸金属服务器网卡信息 | hcloud BMS ShowBaremetalServerInterfaceAttachments | 查询裸金属服务器的网卡信息，比如网卡的IP地址、MAC地址。 | [去调试](https://console.huaweicloud.com/apiexplorer/#/openapi/BMS/cli?api=ShowBaremetalServerInterfaceAttachments) | | 裸金属服务器解绑弹性网卡 | hcloud BMS DeleteServerNics | 解绑裸金属服务器中的一张或多张弹性网卡。 | [去调试](https://console.huaweicloud.com/apiexplorer/#/openapi/BMS/cli?api=DeleteServerNics) | | 修改裸金属服务器弹性网卡的属性 | hcloud BMS UpdateBaremetalServerInterfaceAttachments | 修改裸金属服务器所绑定的弹性网卡属性：终止时删除，即删除裸金属服务器，或者解绑网卡时是否删除该网卡。 | [去调试](https://console.huaweicloud.com/apiexplorer/#/openapi/BMS/cli?api=UpdateBaremetalServerInterfaceAttachments) | | 裸金属服务器绑定弹性网卡 | hcloud BMS AddServerNics | 为裸金属服务器绑定一张或多张弹性网卡。 | [去调试](https://console.huaweicloud.com/apiexplorer/#/openapi/BMS/cli?api=AddServerNics) | | 编辑port | hcloud BMS ModifyVmNic | 编辑裸金属服务器网卡信息。 | [去调试](https://console.huaweicloud.com/apiexplorer/#/openapi/BMS/cli?api=ModifyVmNic) | #### 裸金属服务器云硬盘管理 | API名称 | 命令 | 描述 | 操作 | |:---|:---|:---|:---| | 裸金属服务器挂载云硬盘 | hcloud BMS AttachBaremetalServerVolume | 裸金属服务器创建成功后，如果发现磁盘不够用或者当前磁盘不满足要求，可以将已有云硬盘挂载给裸金属服务器，作为数据盘使用。 | [去调试](https://console.huaweicloud.com/apiexplorer/#/openapi/BMS/cli?api=AttachBaremetalServerVolume) | | 裸金属服务器卸载云磁盘 | hcloud BMS DetachBaremetalServerVolume | 将挂载至裸金属服务器中的磁盘卸载；对于挂载在系统盘盘位（也就是"/dev/sda"挂载点）上的磁盘，不允许执行卸载操作；对于挂载在数据盘盘位（非"/dev/sda"挂载点）上的磁盘，支持离线卸载和在线卸载（裸金属服务器处于"运行中"状态）磁盘。 | [去调试](https://console.huaweicloud.com/apiexplorer/#/openapi/BMS/cli?api=DetachBaremetalServerVolume) | | 查询裸金属服务器挂载的云硬盘信息 | hcloud BMS ShowBaremetalServerVolumeInfo | 查询裸金属服务器挂载的云硬盘信息。 | [去调试](https://console.huaweicloud.com/apiexplorer/#/openapi/BMS/cli?api=ShowBaremetalServerVolumeInfo) | #### 裸金属服务器密码管理 | API名称 | 命令 | 描述 | 操作 | |:---|:---|:---|:---| | 查询是否支持一键重置密码 | hcloud BMS ShowResetPwd | 查询裸金属服务器是否支持一键重置密码。 | [去调试](https://console.huaweicloud.com/apiexplorer/#/openapi/BMS/cli?api=ShowResetPwd) | | 一键重置裸金属服务器密码 | hcloud BMS ResetPwdOneClick | 在裸金属服务器支持一键重置密码功能的前提下，重置裸金属服务器管理账号（root用户或Administrator用户）的密码。 | [去调试](https://console.huaweicloud.com/apiexplorer/#/openapi/BMS/cli?api=ResetPwdOneClick) | | Windows裸金属服务器获取密码 | hcloud BMS ShowWindowsBaremetalServerPwd | 获取Windows裸金属服务器初始安装时系统生成的管理员账户（Administrator账户或Cloudbase-init设置的账户）随机密码。 如果裸金属服务器是通过私有镜像创建的，请确保已安装Cloudbase-init。公共镜像默认已安装该软件。 | [去调试](https://console.huaweicloud.com/apiexplorer/#/openapi/BMS/cli?api=ShowWindowsBaremetalServerPwd) | | Windows裸金属服务器清除密码 | hcloud BMS DeleteWindowsBareMetalServerPassword | 清除Windows裸金属服务器初始安装时系统生成的密码记录。清除密码后，不影响裸金属服务器密码登录功能，但不能再使用获取密码功能来查询该裸金属服务器密码。 如果裸金属服务器是通过私有镜像创建的，请确保已安装Cloudbase-init。公共镜像默认已安装该软件。 | [去调试](https://console.huaweicloud.com/apiexplorer/#/openapi/BMS/cli?api=DeleteWindowsBareMetalServerPassword) | #### 裸金属服务器租户配额管理 | API名称 | 命令 | 描述 | 操作 | |:---|:---|:---|:---| | 查询租户配额 | hcloud BMS ShowTenantQuota | 查询该租户下，所有资源的配额信息，包括已使用配额。 | [去调试](https://console.huaweicloud.com/apiexplorer/#/openapi/BMS/cli?api=ShowTenantQuota) | #### 裸金属服务器规格管理 | API名称 | 命令 | 描述 | 操作 | |:---|:---|:---|:---| | 查询规格详情和规格扩展信息列表 | hcloud BMS ListBaremetalFlavorDetailExtends | 查询裸金属服务器的规格详情和规格的扩展信息。您可以调用此接口查询"baremetal:extBootType"参数取值，以确认某个规格是否支持快速发放。 | [去调试](https://console.huaweicloud.com/apiexplorer/#/openapi/BMS/cli?api=ListBaremetalFlavorDetailExtends) | | 查询可用资源 | hcloud BMS ShowAvailableResource | 查询可用资源。 | [去调试](https://console.huaweicloud.com/apiexplorer/#/openapi/BMS/cli?api=ShowAvailableResource) | #### Job管理 | API名称 | 命令 | 描述 | 操作 | |:---|:---|:---|:---| | 查询Job状态 | hcloud BMS ShowJobInfos | 查询Job的执行状态。 对于创建裸金属服务器物理机、挂卸卷等异步API，命令下发后，会返回job_id，通过job_id可以查询任务的执行状态。 | [去调试](https://console.huaweicloud.com/apiexplorer/#/openapi/BMS/cli?api=ShowJobInfos) | #### 查询API版本信息 | API名称 | 命令 | 描述 | 操作 | |:---|:---|:---|:---| | 查询API版本信息列表 | hcloud BMS ShowVersionsInfo | 查询裸金属服务器当前所有可用的API版本。 | [去调试](https://console.huaweicloud.com/apiexplorer/#/openapi/BMS/cli?api=ShowVersionsInfo) | | 查询指定API版本信息 | hcloud BMS ShowSpecifiedVersion | 查询裸金属服务器指定API版本的信息。 | [去调试](https://console.huaweicloud.com/apiexplorer/#/openapi/BMS/cli?api=ShowSpecifiedVersion) | #### 裸金属服务器二维标签管理 | API名称 | 命令 | 描述 | 操作 | |:---|:---|:---|:---| | 批量添加裸金属服务器标签 | hcloud BMS BatchCreateBaremetalServerTags | 为指定裸金属服务器批量添加标签。 标签管理服务（Tag Management Service，TMS）使用该接口批量管理裸金属服务器的标签。 | [去调试](https://console.huaweicloud.com/apiexplorer/#/openapi/BMS/cli?api=BatchCreateBaremetalServerTags) | | 批量删除裸金属服务器标签 | hcloud BMS BatchDeleteBaremetalServerTags | 为指定云服务器批量删除标签。 TMS使用该接口批量管理裸金属服务器的标签。 | [去调试](https://console.huaweicloud.com/apiexplorer/#/openapi/BMS/cli?api=BatchDeleteBaremetalServerTags) | | 查询裸金属服务器标签 | hcloud BMS ShowBaremetalServerTags | 查询指定云服务器的标签信息。 TMS使用该接口查询指定裸金属服务器的全部标签数据。 | [去调试](https://console.huaweicloud.com/apiexplorer/#/openapi/BMS/cli?api=ShowBaremetalServerTags) |