文档

huawei-cloud-billing-balance-history

它能做什么

Query the Huawei Cloud BSS (Business Support System) account balance and its history across different time periods, and return a report. Supports three read-only queries: (1) current customer account balance (currency, total debt amount, per-account balances for cash/credit/reward/deposit), (2) balance change records (income/expense detail: recharge, consumption, refund, freeze, etc.) within a user-specified date range, and (3) monthly consumption summary for a user-specified billing cycle (YYYY-MM). Uses the huaweicloudsdkbss Python SDK (show_customer_account_balances, list_customer_account_change_records, show_customer_monthly_sum; v2 API GET /v2/accounts/customer-accounts/balances, /v2/accounts/customer-accounts/account-change-records, /v2/bills/customer-bills/monthly-sum) — KooCLI does NOT support the BSS service, so the SDK is the only execution path. The shipped scripts/query_balance_history.py integrates the execution-quality reporting SDK and reports every run to the skillsopr operations console. Read-only — never creates, modifies or deletes any billing resource. Use this skill whenever the user wants to check the personal Huawei Cloud account balance, balance over a time period, balance change records, income/ expense detail, or monthly bill summary, e.g. for cost review, daily inspection, or debt monitoring. Triggers include: "账户余额", "余额查询", "查询余额", "账单余额", "我的余额", "不同时间段余额", "余额变动", "收支明细", "月度账单", "月度消费", "欠费", "account balance", "query balance", "balance history", "balance change", "income expense", "monthly bill", "monthly consumption", "debt amount".

技能文档

Huawei Cloud Billing Balance History Skill

Overview

This skill queries the Huawei Cloud BSS (Business Support System) account balance and its history across time periods via the BSS v2 API and returns a report. It supports three read-only actions:

Action	What it returns	BSS v2 API
`balance`	Current customer account balance: currency, total debt amount, per-account balances (cash/balance, credit, reward, deposit)	`show_customer_account_balances`
`changes`	Balance change records (income/expense detail) in a date range: recharge, consumption, refund, freeze, transfer, adjustment, etc.	`list_customer_account_change_records`
`monthly-sum`	Monthly consumption summary for a billing cycle (`YYYY-MM`): consume amount, debt, coupon/cash/credit amounts, per-service breakdown	`show_customer_monthly_sum`

It is a read-only inspection skill: it never creates, modifies, or deletes any billing resource.

Architecture:

Agent → scripts/query_balance_history.py (quality-reporting wrapper)
       → huaweicloudsdkbss Python SDK (BssClient)
       → Huawei Cloud BSS v2 API (global endpoint https://bss.myhuaweicloud.com)

API paths (verified from huaweicloudsdkbss v2 SDK _http_info):

Operation	Method	API Path
Show customer account balances	GET	`/v2/accounts/customer-accounts/balances`
List customer account change records	GET	`/v2/accounts/customer-accounts/account-change-records`
Show customer monthly sum	GET	`/v2/bills/customer-bills/monthly-sum`

CLI availability: the KooCLI (hcloud) does not support the BSS service (hcloud BSS returns "Unsupported service: BSS"), so this skill uses the Python SDK as its only execution path. See references/cli-installation-guide.md for SDK setup.

Execution-quality reporting: every invocation of scripts/query_balance_history.py reports a trace_id, status (success / biz_fail / sys_fail), error code and cost to the skillsopr operations console via the vendored scripts/skill_quality_sdk.py. Reporting is non-blocking and fails silently; it never affects the query result.

Applicable Scenarios:

Daily inspection: "how much balance do I have left, and what changed last month?"
Balance check: current cash/credit/reward/deposit balances and arrears
Time-period review: balance change records (income/expense) between two dates
Cost review: monthly consumption summary for a given billing cycle
Debt monitoring: check debt_amount for arrears

能力边界（Capability Boundary）： 本 Skill 仅查询华为云 BSS 账户余额及余额变动/月度消费汇总。不导出账单明细流水（资源消费记录逐条明细）、不查询资源用量、不执行充值/退款/转账/开票等任何资金操作，也不查询代金券/优惠券。若用户询问"逐条消费明细导出"、 "充值"、"开发票"等，请明确告知本 Skill 不提供该能力。

Prerequisites

Python 3.8+ with huaweicloudsdkbss and huaweicloudsdkcore packages installed — See references/cli-installation-guide.md
Huawei Cloud AK/SK — provided via environment variables (HUAWEI_ACCESS_KEY / HUAWEI_SECRET_KEY, or HUAWEICLOUD_SDK_AK / HUAWEICLOUD_SDK_SK). The AK/SK must belong to the account whose balance is queried. Never hardcode credentials into files.
IAM permissions — bss:balance:view (or the system policy BSS ReadOnlyAccess) is required to query account balances and bills. See references/iam-policies.md
BSS is a global service — no region parameter is required; the SDK must use GlobalCredentials with the endpoint https://bss.myhuaweicloud.com.

Workflow

Identify the intent — Determine which query the user needs:
- current balance → balance
- balance over a time range / income-expense detail → changes (ask for start/end dates, e.g. 2026-07-01..2026-07-31)
- monthly bill summary → monthly-sum (ask for billing cycle, e.g. 2026-07)
Check credentials — Ensure AK/SK environment variables are set for the target account.
Run the query — Execute the wrapper script (SDK mode, see Core Commands) with the confirmed parameters.
Present the report — Show the balance/change/monthly summary; highlight arrears if debt_amount > 0.
Handle errors — Missing AK/SK, invalid parameter formats, insufficient IAM permissions, or network failures are reported with a quality error code and a clear message.

Core Commands

All commands are read-only SDK queries; no confirmation is required for execution.

1. Query current account balance (default)

python3 scripts/query_balance_history.py --action balance

2. Query balance change records in a date range

python3 scripts/query_balance_history.py --action changes \
  --balance-type DEBIT --begin 2026-07-01 --end 2026-07-31 --limit 20

--balance-type: DEBIT (cash account) or CREDIT (credit account) (default DEBIT)
--begin / --end: date range YYYY-MM-DD (optional; omitted = no bound)
--revenue-expense-type: optional filter REVENUE (income) or EXPENSE (expense)
--limit: page size 1–100 (default 10)

3. Query monthly consumption summary for a billing cycle

python3 scripts/query_balance_history.py --action monthly-sum \
  --bill-cycle 2026-07 --limit 20

--bill-cycle: required, billing cycle in YYYY-MM format (e.g. 2026-07)

4. JSON output (for automation / further processing)

python3 scripts/query_balance_history.py --action balance --format json
python3 scripts/query_balance_history.py --action changes --begin 2026-07-01 --end 2026-07-31 --format json
python3 scripts/query_balance_history.py --action monthly-sum --bill-cycle 2026-07 --format json

5. Disable quality reporting (local debugging)

SKILL_QUALITY_DISABLE=1 python3 scripts/query_balance_history.py --action balance

Parameter Confirmation

Parameter	Required	Description	Example
`--action`	Yes	Query action: `balance`, `changes`, `monthly-sum`	`changes`
`--balance-type`	No (default `DEBIT`)	Account type for `changes`: `DEBIT` / `CREDIT`	`DEBIT`
`--begin`	No	Start date `YYYY-MM-DD` for `changes`	`2026-07-01`
`--end`	No	End date `YYYY-MM-DD` for `changes`	`2026-07-31`
`--revenue-expense-type`	No	Filter for `changes`: `REVENUE` / `EXPENSE`	`EXPENSE`
`--bill-cycle`	Yes (for `monthly-sum`)	Billing cycle `YYYY-MM`	`2026-07`
`--limit`	No (default 10)	Page size 1–100 (BSS API max 100)	`20`
`--format`	No (default `text`)	Output format: `text` / `json`	`json`

When the user asks for a time period but gives no exact dates, ask for the start/end dates (or billing cycle) before running changes / monthly-sum. For balance, no parameters are required.

KooCLI Command Format Standard

This skill does not use the KooCLI (hcloud): the BSS service is not supported by KooCLI (hcloud BSS returns "Unsupported service: BSS"), so the Python SDK (huaweicloudsdkbss) is the only execution path. The script follows the standard python3 scripts/query_balance_history.py --action [--param=value ...] convention with ---prefixed long options.

Reference Documents

references/iam-policies.md — Least-privilege IAM policies for balance/bill queries
references/cli-installation-guide.md — SDK installation and AK/SK configuration
references/verification-method.md — How to verify query results
references/dataflow-diagram.md — Mermaid data flow diagram
references/acceptance-criteria.md — Acceptance criteria

Command	Purpose
`bash scripts/validate-skill.sh {path}`	Structure and Huawei Cloud specification validation
`bash scripts/test-cli-commands.sh {path} --executor sdk`	Functional testing (SDK mode)

huawei-cloud-billing-account-balance

Query the Huawei Cloud BSS (Business Support System) customer account balance of the current account and return a balance report. Returns the currency, total debt amount, and per-account balances (cash/balance account, credit account, reward account, deposit account) with amounts. Uses the huaweicloudsdkbss Python SDK (`show_customer_account_balances`, v2 API `GET /v2/accounts/customer-accounts/balances`) — KooCLI does NOT support the BSS service, so the SDK is the only execution path. The shipped scripts/query_account_balance.py integrates the execution-quality reporting SDK and reports every run to the skillsopr operations console. Read-only — never creates, modifies or deletes any billing resource. Use this skill whenever the user wants to check the personal Huawei Cloud account balance, remaining balance, debt, or billing account status, e.g. for cost review, before creating pay-per-use resources, or daily inspection. Triggers include: "账户余额", "余额查询", "查询余额", "账单余额", "我的余额", "欠费",

huawei-cloud-billing-bill-query

Query the Huawei Cloud BSS (Business Support System) bills and fees of the current account within ONE billing cycle (one month). Supports three read-only queries: (1) bill fee records (账单费用记录/账单明细) for a billing cycle (YYYY-MM), (2) resource fee records / 流水账单 for a billing cycle, and (3) monthly cost breakdown (月度成本分析). Uses the huaweicloudsdkbss Python SDK (list_customer_bills_fee_records, list_customerself_resource_records, list_customer_bills_monthly_break_down; v2 API GET /v2/bills/customer-bills/fee-records, /v2/bills/customer-bills/res-fee-records, /v2/costs/cost-analysed-bills/monthly-breakdown) — KooCLI does NOT support the BSS service, so the SDK is the only execution path. The shipped scripts/query_bills.py integrates the execution-quality reporting SDK and reports every run to the skillsopr operations console. Time scope is limited to one month (the current month by default) — no multi-month or unbounded range queries. Read-only — never creates, modifies or deletes any bill

huawei-cloud-bss-account-balance

Query the Huawei Cloud account balance (cash/credit account available amount and debt) and the account change records (recharge/consume/refund/adjust) over a configurable time window, defaulting to the last 6 months. Uses the BSS (Business Support System) customer API via the huaweicloudsdkbss SDK, consistent with the console Billing Center. Use when the user wants to: (1) check the current Huawei Cloud account balance, (2) review income/expense records for the last ~half year, (3) verify recharge/consume history, (4) monitor account funds before deployments or renewals. Triggers include: "华为云余额", "账号余额", "账户余额", "查询余额", "余额查询", "近半年流水", "收支明细", "充值记录", "消费记录", "account balance", "Huawei Cloud balance", "balance query", "change records", "spending history", "billing", "BSS"

huawei-cloud-billing-scout

Huawei Cloud BSS billing (not AWS/Azure/other clouds; refuses pricing quotes, real-name review, and any non-billing scope): balance, spend, attribution, reconciliation, coupons, stored-value cards, enterprise/partner billing. One-page briefing via hcloud. Use only when the user explicitly mentions 华为云 / Huawei Cloud / BSS and 余额/账单/对账/资源包/代金券/储值卡/企业或伙伴账务; refuses pay, renew, refund, delete.

作者 huaweicloud-skills-team

huawei-cloud-business-support-query

Queries Huawei Cloud billing and pricing. Covers balances, bills, coupons, cash coupons, stored-value cards, orders, refunds, costs, free resources, resource...

1 次安装

huawei-cloud-business-tf-support

Queries Huawei Cloud billing and fee details only when Terraform needs a billing or pricing inquiry. Covers balances, bills, coupons, cash coupons, stored-value cards, orders, refunds, costs, free resources, resource usage, enterprise accounts, and on-demand/period/ELB/NAT/DCS pricing. No write operations. Use this skill only when Terraform requires billing details, invoice/bill summaries, coupon or balance status, refund/order billing status, or pricing inquiry. Triggers: Terraform 账单查询, Terraform 费用查询, Terraform 价格询价, Terraform 询价, Terraform billing query, Terraform pricing inquiry, Terraform price quote, Terraform bill summary.

作者 huaweiclouddev-dev