huawei-cloud-cost-estimation

用途

该技能面向华为云（Huawei Cloud / 华为云 / hcloud）的成本估算与资源开通场景。当用户询问某资源多少钱、哪种规格与计费模式组合更合适、某资源能否开通，或如何退订时使用。核心原则有三条：价格只能来自当前 hcloud 响应的报价结果，绝不猜测、类比或凭记忆给出；开通是唯一允许的写操作路径；退订只提供控制台指引，不生成也不执行任何退订命令或 API。

前置条件

需已安装华为云 CLI（hcloud）7.2.2 及以上版本，并配置已完成认证的 profile，具备 BSS 只读权限及生命周期操作所需的 IAM 依赖权限。可用以下命令自检：

• hcloud version
• hcloud configure list
• hcloud BSS ListServiceTypes --cli-region=cn-north-1 --cli-output=json --limit=1

若未安装或未认证，应引导用户查看 CLI 安装与认证指南自行配置；不得替用户配置凭据，也不接受在对话中粘贴 AK/SK/token。所有 BSS 命令固定使用 --cli-region=cn-north-1，资源实际部署地域写在报价条的 region 字段中。

需要注意：询价链路依赖已认证账号的 BSS（Business Support System）接口。在沙箱或受限环境中若未开通 BSS 访问，价格链路无法端到端验证，此时应明确说明当前环境无法查询价格并停止，不得编造金额。

主要能力

价格估算（4 步 RFQ 流程）

1. 解析：识别云服务类型、资源类型、地域、规格，以及包周期时长或按需用量。
2. 澄清：对缺失的地域、数量、时长/用量、线性规格大小、歧义类别或未确定变体，用一个问题给出 2 至 4 个候选项。仅披露并应用安全默认值：操作系统 linux、可用区留空、分期付款模式 NA。
3. 查询：通过 BSS 只读接口依次解析服务类型、资源类型、规格、用量类型与计量单位，再生成包周期或按需报价。多匹配时需向用户确认；规格匹配也可能最终失败。不得虚构时长，也不得混用容量槽与用量槽。
4. 校验与呈现：核验各分项加总等于总计，币种、周期与数量一致；按“[服务] [规格] [地域] [数量 × 周期] = 金额”呈现总额，并说明“非最终账单”；仅在接口返回时展示折扣。

资源开通（7 道关卡）

按顺序执行：

1. 允许清单：将意图映射到允许清单中的操作，不在清单内则拒绝。
2. 帮助：先运行 hcloud <Service> <Operation> --help 获取必填与条件字段，遇到 [APIE_ERROR] 或缺少 schema 即停止，不猜测。
3. 解决依赖：执行只读依赖查询，如 VPC、子网、可用区、镜像、规格等，多匹配时让用户选择。
4. 费用：尽可能走价格估算；否则明确告知“价格未知且可能产生费用”并单独取得批准。
5. 预演：在完整命令上加全局 --dryrun，失败需修复并重跑，不得将失败的预演推进为执行。
6. 确认：展示资源、地域、规格、数量、计费方式、已知或未知价格及批量顺序，等待用户明确确认。
7. 执行：仅移除 --dryrun 后按顺序执行，失败即停止，不自动回滚，并报告成功、失败与未执行项。

任何参数、地域、数量或操作变更都会使预演与确认失效，需回到帮助步骤重新进行。允许清单共 74 个创建操作（如 ECS/CreateServers、DDS/CreateInstance、RDS/CreateInstance），参数始终来自当前 --help 输出，不得凭记忆填写。

退订指引

不生成也不执行退订 CLI/API，--dryrun 也不能替代控制台预览。包周期资源引导用户到华为云控制台 → 费用中心 → 订单 → 退订，提醒先备份或迁移数据，并核对账号、资源、关联资源、退款、费用与退款去向后再提交。按需计费资源不适用退订，引导用户备份后在服务控制台自行删除资源。

范围边界

• 在范围内：报价、预算与比价；开通与创建（限允许清单）；退订指引（仅控制台）。
• 范围外：历史账单、余额与对账应路由到费用中心或只读 BSS 计费接口；非华为云价格礼貌拒绝；非允许清单写操作仅给控制台指引；对话中的 AK/SK/token 引导用户自行配置。

使用示例

查询包周期价格使用 hcloud BSS ListRateOnPeriodDetail，按需价格使用 hcloud BSS ListOnDemandResourceRatings，均固定 --cli-region=cn-north-1，数组参数用点号形式（如 --product_infos.1.id=1），输出用 --cli-output=json。线性产品（容量、带宽、共享带宽）还需传 --product_infos.N.resource_size 与 --product_infos.N.size_measure_id（17 表示 GB，15 表示 Mbps）。创建操作示例（VPC/CreateVpc）：

hcloud VPC CreateVpc --help
hcloud VPC CreateVpc --vpc.name={name} --vpc.cidr=172.16.0.0/16 --cli-region={region} --dryrun

其他允许清单操作遵循同样形态：先 --help，再据其构造完整命令，加 --dryrun，通过预演并取得明确确认后才去掉 --dryrun 执行。

限制

• 价格不可在无 BSS 访问的环境中查询，且不保证为最终账单金额。
• 未通过 --dryrun 和明确确认前，不得发起真实创建调用。
• 不得自动化或发出退订操作。
• 企业项目（EPS）不支持 cn-north-1，查询需用 cn-north-4 或其他支持 EPS 的地域。
• 执行节奏上，最多三条命令的链路可直接推进到下一个安全检查点；更长的链路每轮只运行两三条并汇报进度，即使请求不间断执行，澄清、未知费用审批、预演与写操作确认仍为强制环节。