Huawei Cloud Billing (BSS)
STOP - Do not answer from general knowledge. Follow the procedure below.
Always run hcloud BSS <Operation> --help --cli-region=cn-north-1 before constructing commands to discover exact parameter names and requirements.
Overview
Domain expertise for billing queries (BSS). Covers cost tracking, bill details, and budget management. Read-only — no resource modifications.
Critical Warnings
| Trap | Why |
|---|---|
| Bills delayed ~24h | Yesterday's costs may not appear until the next day |
| BSS Admin role needed | IAM user must have BSS Administrator or Finance role |
| Currency conversion varies | Cross-region costs use daily exchange rates |
| Region fixed to cn-north-1 | BSS operations only support --cli-region=cn-north-1 in KooCLI. This is a KooCLI metadata limitation — the billing data itself covers all regions. |
| English catalog missing BSS | Unsupported service: BSS under the default en language is a KooCLI catalog gap, not a missing service. devkit detects it and advises the supported fix hcloud configure set --cli-lang=cn (switch is global-only; KooCLI has no per-command --cli-lang flag). Running with Chinese mode from the start (see Prerequisites) avoids the issue entirely. |
缺少必填参数 cli-domain-id / APIGW.0301 |
Invalid credentials — KooCLI can't resolve the account-id |
Common Workflows
| Task | Operation |
|---|---|
| List costs | ListCosts --cli-region=cn-north-1 --project_id=<p> |
| List customer bills | ListCustomerBillsFeeRecords --cli-region=cn-north-1 --project_id=<p> |
| List resource usage | ListResourceUsage --cli-region=cn-north-1 --project_id=<p> |
| List sub-customers | ListConsumeSubCustomers --cli-region=cn-north-1 --project_id=<p> |
| Show account balance | ShowCustomerAccountBalances --cli-region=cn-north-1 |
| List conversions | ListConversions --cli-region=cn-north-1 --project_id=<p> |
Discover exact parameters with --help before executing any command. All BSS operations are read-only.
Troubleshooting
| Error | Fix |
|---|---|
| Access denied | User needs BSS Administrator or Finance role |
| No data returned | Check time range (bills have ~24h delay). Verify project_id |
| Enterprise account restrictions | Some APIs require enterprise real-name authentication |
Cross-Skill References
- Resource lifecycle: See
huawei-ecs,huawei-obsfor creating billable resources