360 Secure SkillHub
360 安全技能中心

huawei-cloud-bms-list

通过 KooCLI 或 Python SDK 只读查询当前租户下的华为云裸金属服务器列表，输出名称、ID 与状态，可按名称、状态过滤并支持分页；不涉及创建、删除、修改或单台详情查询。

erickeyhu-hug
erickeyhu-hug
热度 40.27
最近更新 2026-09-22 02:58:06
分类：搜索依赖：代码执行 / 第三方 API应用场景：工作流 / 研究

安装技能

复制下面的话术发给你的 Agent，它会通过 secure-skills 检索并安装该技能。

执行命令安装此 skill： npx secure-skills-cli add huawei-cloud-bms-list
Metadata
name
huawei-cloud-bms-list
description
Query the list of Huawei Cloud BMS (Bare Metal Server) instances under the current tenant / project, focused on the BMS NAME list. Returns each server's name, id and status; can also output a pure BMS name-only list. Supports filtering by status, name and pagination (limit/offset). Uses the KooCLI command `hcloud BMS ListBareMetalServers --cli-region={region}` (primary) against the v1 API, or the huaweicloudsdkbms Python SDK (fallback). Read-only — never creates, modifies or deletes any bare metal server. Use this skill whenever the user wants to list/inspect the BMS instances of the tenant or query the BMS name list, e.g. for BMS inventory, daily inspection, or cost review. Triggers include: "list BMS", "BMS list", "query BMS names", "BMS name list", "裸金属服务器列表", "查询裸金属服务器", "BMS名称列表", "裸金属服务器名称", "list bare metal servers", "how many BMS".
tags
["huawei-cloud","bms","list","bare-metal","query"]

Huawei Cloud BMS List Skill

Overview

This skill queries the list of BMS (Bare Metal Server) instances under the current Huawei Cloud tenant / project and returns their key attributes — in particular the BMS name list (name), along with id and status. It is a read-only inspection skill: it never creates, modifies, or deletes servers, volumes, NICs, or any related resources.

Architecture:

Agent → hcloud CLI (KooCLI, BMS ListBareMetalServers, primary) → Huawei Cloud BMS v1 API
       ↘ huaweicloudsdkbms Python SDK (fallback)                ↗

API path (verified from huaweicloudsdkbms v1 SDK _list_bare_metal_servers_http_info):

Operation Method API Path
List bare metal servers GET /v1/{project_id}/baremetalservers/detail

Applicable Scenarios:

  • BMS inventory: "list all BMS instances of this tenant" or "show me the BMS name list"
  • Daily inspection: snapshot of all bare metal servers with their status
  • Cost review: enumerate servers to spot unused or oversized resources
  • Fast lookup: retrieve the exact BMS name(s) for follow-up operations

能力边界（Capability Boundary）： 本 Skill 仅查询 BMS（裸金属服务器）列表。不创建/删除/修改裸金属服务器， 也不查询/操作单台服务器的详情（show-by-id）、网卡、磁盘、密码等其它资源。 若用户询问"创建/删除/重启裸金属服务器"、"查询单台服务器详情"、"挂载磁盘"等， 请明确告知本 Skill 不提供该能力。

Prerequisites

  1. hcloud CLI (KooCLI) installed and authenticated — See references/cli-installation-guide.md
  2. Python 3.8+ with huaweicloudsdkbms package installed (SDK fallback only)
  3. IAM permissions — bms:servers:list (or the system policy BMS ReadOnlyAccess) is required to list bare metal servers. See references/iam-policies.md
  4. A region where the tenant owns BMS instances; specify it with --cli-region

Workflow

  1. Identify the intent — Confirm the user wants to list BMS instances (and optionally the filters: status, name, or name-only output).
  2. Confirm region — Default cn-north-4; let the user override with another region if needed.
  3. Run the query — Use the CLI command below with the requested filters.
  4. Present the results — Show the server name, id and status for each BMS; on a name-list request, output just the names.
  5. Handle errors — If the CLI fails (credentials/permissions/network), retry with the SDK fallback described in references/verification-method.md.

Core Commands

KooCLI format: hcloud <Service> <Operation> --cli-region=<region> [--key=value]

List all BMS instances (names, ids, status)

hcloud BMS ListBareMetalServers --cli-region={region} --cli-output=json

List only the BMS names

hcloud BMS ListBareMetalServers --cli-region={region} --cli-output=json | jq -r '.servers[].name'

Compact fields: name, id, status

hcloud BMS ListBareMetalServers --cli-region={region} --cli-output=json \
  | jq -r '.servers[] | [.name, .id, .status] | @tsv'

Filter by BMS status

hcloud BMS ListBareMetalServers --cli-region={region} --status=ACTIVE --cli-output=json

Status enum: ACTIVE, BUILD, ERROR, HARD_REBOOT, REBOOT, REBUILD, SHUTOFF.

Note: Invalid status values are silently ignored by the BMS API — the request still returns HTTP 200 with an unfiltered server list. Always use the exact enum values listed above; a typo will not raise an error and the returned list will not be filtered as expected.

Filter by BMS name

hcloud BMS ListBareMetalServers --cli-region={region} --name={server_name} --cli-output=json

Pagination (limit / offset)

hcloud BMS ListBareMetalServers --cli-region={region} --limit=25 --offset=1 --cli-output=json

Note: In the BMS v1 list response, the server name is the top-level name field of each item in servers[]. The id is id and the status is status. count holds the total number of matched servers.

Parameter Confirmation

Parameter Required Description Example
{region} Yes Huawei Cloud region cn-north-4
{status} No Server status filter ACTIVE
{name} No Server name filter bms-01
{limit} No Page size (default 25, max 1000) 25
{offset} No Page number (starts at 1) 1

KooCLI Command Format Standard

The KooCLI command format is:

hcloud <Service> <Operation> --cli-region=<region> [--key=value ...]

Note: this is a generic format template, not an executable command — replace <Service>, <Operation>, <region> and the parameters with real values (e.g. hcloud BMS ListBareMetalServers --cli-region=cn-north-4).

  • Service name: BMS (starts with uppercase).
  • Operation name: PascalCase — ListBareMetalServers.
  • Region: always pass --cli-region=<region>.
  • Simple parameters use --key=value, for example --status=ACTIVE.

Reference Documents