360 Secure SkillHub
360 安全技能中心

hcs-elb-loadbalancers

通过华为云 ELB Python SDK 分页拉取指定区域/项目下的负载均衡实例,支持按名称模糊和运行状态过滤,输出实例名称、ID、供给/运行状态、VIP、EIP、可用区、类型等字段;默认 JSON,可选 Markdown 表格,并提供无需凭证的模拟数据模式。

yangaiwu
yangaiwu
热度 7.64
最近更新 2026-08-20 10:05:03
分类:数据依赖:代码执行 / 第三方 API应用场景:数据处理 / 报告撰写 / API 集成

安装技能

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

执行命令安装此 skill: npx secure-skills-cli add hcs-elb-loadbalancers
Metadata
name
hcs-elb-loadbalancers
version
0.1.0
description
查询华为云 ELB(弹性负载均衡)实例列表,支持列出账号下(region/project 范围)全部负载均衡实例,可选按名称/状态过滤,输出实例名称、ID、运行状态、VIP 地址、EIP 地址、可用区、类型。
triggers
["查询华为云ELB","查询负载均衡","列出ELB实例","华为云ELB列表","负载均衡查询"]
tags
["huawei-cloud","elb","loadbalancer","query"]

hcs-elb-loadbalancers

查询华为云 ELB(弹性负载均衡)实例的技能,提供以下能力:

  • 能力 A:列出账号下(region/project 范围)全部 ELB 负载均衡实例,可按 --name 模糊过滤、--status 运行状态过滤。
  • 输出字段:实例名称、ID、供给状态(provisioning_status)、运行状态(operating_status)、VIP 地址、EIP 地址、可用区、类型(独享/共享)、创建/更新时间。

环境变量(认证)

真实调用前需设置(不硬编码密钥):

变量 必填 说明
HWCLOUD_AK 是 华为云 Access Key
HWCLOUD_SK 是 华为云 Secret Key
HWCLOUD_PROJECT_ID 否 项目 ID,缺省由 AK/SK 解析默认项目

使用

# 列出全部 ELB 负载均衡实例(默认区域 cn-east-3)
python3 scripts/hcs-elb-loadbalancers.py list --region cn-east-3

# 按名称模糊过滤
python3 scripts/hcs-elb-loadbalancers.py list --name web-lb

# 按运行状态过滤(ONLINE / FROZEN 等)
python3 scripts/hcs-elb-loadbalancers.py list --status ONLINE

# Markdown 表格输出
python3 scripts/hcs-elb-loadbalancers.py list --format md

# 无凭证验证(内置模拟数据)
python3 scripts/hcs-elb-loadbalancers.py list --mock
python3 scripts/hcs-elb-loadbalancers.py list --mock --region cn-east-3 --format json
python3 scripts/hcs-elb-loadbalancers.py list --mock --format md

输出

默认 JSON,字段:

{
  "capability": "list",
  "region": "cn-east-3",
  "project_id": "xxx",
  "count": 2,
  "loadbalancers": [
    {
      "id": "lb-0aaa1111bbbb2222cccc",
      "name": "web-lb-01",
      "provisioning_status": "ACTIVE",
      "operating_status": "ONLINE",
      "admin_state_up": true,
      "guaranteed": true,
      "vip_address": "192.168.1.100",
      "vip_subnet_cidr_id": "subnet-aaa111",
      "vpc_id": "vpc-prod-001",
      "availability_zone_list": ["cn-east-3a"],
      "eips": [{"eip_id": "eip-001", "eip_address": "121.36.10.50", "ip_version": 4}],
      "publicips": [],
      "enterprise_project_id": "0",
      "created_at": "2024-01-15T08:30:00Z",
      "updated_at": "2024-06-01T12:00:00Z"
    }
  ]
}

--format md 输出 Markdown 表格(实例名称/实例ID/运行状态/供给状态/VIP地址/EIP地址/可用区/类型)。

退出码

码 含义
0 成功
2 参数错误
3 缺少认证(未设置 HWCLOUD_AK/HWCLOUD_SK)
4 API 调用失败

依赖

  • Python 3.8+
  • 真实调用:huaweicloudsdkelb(见 requirements.txt)
  • mock 模式无需任何第三方依赖

实现说明

使用华为云 ELB Python SDK (huaweicloudsdkelb V3) 的 ListLoadBalancersRequest 分页拉取全部负载均衡实例:

  • API 端点:GET /v3/{project_id}/elb/loadbalancers
  • 分页参数:limit(最大 2000)+ marker(page_info.next_marker)
  • 过滤参数:name(名称匹配)、operating_status(运行状态)

负载均衡实例详情关键字段映射(SDK 属性 → JSON key):

SDK 属性 JSON key 说明
name name 实例名称
id id 实例 ID
provisioning_status provisioning_status 供给状态(ACTIVE/PENDING_DELETE 等)
operating_status operating_status 运行状态(ONLINE/FROZEN)
admin_state_up admin_state_up 是否启用
guaranteed guaranteed 是否独享型负载均衡
vip_address vip_address 私网 VIP 地址
vpc_id vpc_id 所属 VPC ID
availability_zone_list availability_zone_list 可用区列表
eips eips 弹性公网 IP 列表
created_at created_at 创建时间
updated_at updated_at 更新时间

详见 references/elb-loadbalancers-api.md。