Vultr 本月未出账费用查询与只读 API Key 接入教程

使用专用 account.billing.Read API Key 监控 Vultr 美元未出账费用,区分原始带符号账务值、可用资金与 AI 预算,并完成最小权限配置和首次对账。

仅费用 · 非余额

教程更新

2026-10-17 已核查官方文档并实现接入;真实服务用户创建、最小权限、账户范围与控制台/API 对账仍待用户测试。未代登录、创建资源、支付或修改供应商权限。

所需凭据
专用 Vultr API Key · account.billing.Read
监控币种
USD · 美元十进制主单位,不是分
可以看到什么
本月未出账费用 · 非资金余额
仅 GET https://api.vultr.com/v2/account。account.pending_charges 是凭据对应整个云账务账户本月未出账费用,包含非 AI 服务;account.balance 单独保留原始正负号,不解释为可用资金。

不使用 Quota Monitor 也能直接核对

  1. 打开 Vultr Console,选择正确组织/账户并进入 Billing。History 是发票和付款记录;Make a Payment/账户信用是另一视图。只查看,不提交付款。
  2. 把当前未出账月费用单独记录。若在自己的安全环境调用官方 GET /v2/account,原样保留 account.balance 的正负号以及独立 pending_charges,不根据负数示例推断钱包资金。
  3. 比较同一账户和观察时间,不拿另一项目/Key 或定稿发票替代。该接口不提供明确账期边界、时区和重置时间。
打开 Vultr 官方账务说明(在新标签页打开)

在 Quota Monitor 中接入 Vultr · 云账户账务

  1. 选择正确账户和组织

    自行登录 Vultr Console,选择实际支付业务费用的组织/账户。打开 Billing,把本月未出账费用与信用、付款和发票分开看。

    本连接覆盖整个云账务账户,包含计算、GPU 和非 AI 服务。Quota Monitor 项目不会划分供应商资金,子账户账务需要独立核对。

  2. 创建专用服务用户

    由已有权限的管理员进入组织名称 → Manage Organization → Users → +,选择 User Type: Service User,填写名称和邮箱,检查后点击 Add service user。

    不要为此身份添加无关组或角色。服务用户用于 API,不用于交互登录;监控身份不需要 root 或管理员权限。没有配置权限时联系现有管理员。

  3. 配置最小权限策略

    进入 Manage Organization → Permission Policies → +,给策略命名,仅允许 account billing 下的 account.billing.Read。创建 Add Permission Policy 前核对动作,不选全部权限。

    下方 JSON 是官方 IAM API 的 policy_document,不代表控制台存在粘贴编辑器;控制台用户在策略界面选择相同动作。Resource * 表示账户范围,不代表允许所有动作。此权限也可读取其他账户信息。

    官方 IAM API 的 policy_document · 只读账务

    {
      "Version": "2012-10-17",
      "Statement": [
        {
          "Effect": "Allow",
          "Action": [
            "account.billing.Read"
          ],
          "Resource": "*"
        }
      ]
    }

    复制的是完整 JSON,不含密钥或账号信息。

  4. 把策略绑定到服务用户

    在 Permission Policies 打开刚建策略,选择 Attached Entities → +,只选专用服务用户,再点 Attach Entities。只创建策略不会自动授权。

    同时检查该用户已有组、角色和其他策略,新增窄权限策略不会取消已有宽权限。Quota Monitor 不代建、绑定或修改供应商权限。

  5. 启用 API 并生成独立 Key

    进入 Manage Organization → Users → 服务用户 → API Access → Create API Key,设置 Key Name 和合适到期时间,点击 Generate API Key。只复制保存一次,确认成功复制后 Finalize Key Generation。

    若 API 访问尚未启用,请已有权限的管理员按官方 Enable API Access 文档设置 api_enabled: true,不给监控身份增加用户管理权限。完整 Key 不放聊天、源码、截图或 MCP 参数。

  6. 遵守现有网络白名单

    在用户的 API Access → Access Control List 核对允许网络。官方默认可能包含 Any IPv4 和 Any IPv6;通过 Add IP to Allowlist → 子网/前缀 → Add Subnet 限制为已获准的服务器出口,并避免影响其他客户端。

    不要放宽现有受限策略,也不要为本接入开启 Allow All。若托管环境没有已批准的稳定出口,请先由管理员处理或手动查账;Quota Monitor 不承诺固定 IP。

  7. 在 Quota Monitor 添加 Vultr

    打开目标项目,添加供应商连接,选择「Vultr · 云账户账务」,把专用 Key 填入遮蔽输入框。准备好后保存,凭据会加密,接口地址固定。

    绑定只允许 USD,不支持账户 URL、项目/Key 筛选、内部月预算、金额告警或日消耗覆盖。表单帮助抽屉与公开教程共用内容。

  8. 完成首次成功对账

    刷新连接,确认成功查询时间更新。将 pending_charges 与同一账户当前未出账费用比较,将单独显示的原始 account.balance 与相同带符号 API 值比较。

    例如原始 balance -100.55 与 pending charges 60.25 是两个独立美元值,不是算出的 40.30 钱包。60.123456789012345678 等来源精度会保留。可在自己的安全环境参考官方 API 文档,不向我们发送 Key 或账户身份信息。

  9. 处理失败并安全轮换

    遇到到期、撤销或泄漏,在同一账户创建新的专用受限 Key,再使用 Quota Monitor 的凭据更新。先验证成功读取,再按自己的流程停用旧 Key。

    401/403、限流、格式异常和上游故障不清除之前成功记录。只反馈安全错误码和时间;不绕过权限、放宽 IP、创建云资源、调用模型或付款测试。

Quota Monitor 读取的 Vultr · 云账户账务 数据范围

  • 普通账户 API 未说明 account.balance 的正负号语义。保留正数、负数和零;不反转符号、取绝对值、推断信用/欠款,也不减去 pending_charges 计算钱包。
  • 范围是共享云账户账务,不是 AI 钱包、项目预算、单 Key 限额或子账户汇总。不同用户和 Key 可能共用账务,重复连接不能相加。
  • pending_charges 是本月未出账金额,不是已定稿发票或剩余额度。税费和后续调整可能影响最终账单;不收集费用明细、付款历史,也不根据用量估算资金。
  • 接口不返回明确账期起止、时区或重置时间,因此均保持未知;不假设 UTC 月初、下次重置、燃烧率、剩余天数、内部预算或金额阈值。
  • 只保留两个金额,丢弃姓名、邮箱、ACL 与最近付款信息。失败或不完整响应保留上次成功快照和时间,不产生新的零金额。
  • 范围为整个云账户,含非 AI 服务。原始账务值的正负号语义和精确账期/重置时间未文档化;不推断信用、欠款、钱包、限额、预算或服务可用性。两个金额分别查看。

Vultr · 云账户账务 常见问题与排查

原始账务值为什么为负?
普通账户契约只命名 balance,没有解释正负号。本站原样保留,不称为信用、欠款或可用资金。子账户 UI 示例不能证明普通账户 API 的语义,请向 Vultr 核实自己的账户。
Key 在其他地方可用,但账务读取出现 401/403?
检查到期/撤销、API 访问、服务用户、已绑定 account.billing.Read 以及出口 IP 白名单。模型/资源权限不等于账务读取权限,不追加管理员或 Allow All。
为什么费用不同于发票或 AI 消费?
pending_charges 是整个账户当月未出账费用,含非 AI 云服务。最终发票可能含税费或调整;本站不拆分 AI 消费、不从 balance 扣费用,也不导入历史付款。
为什么没有重置时间、预算和剩余天数?
账户接口不报告精确账期、时区、重置或消费上限。未知就保持未知;此接入禁用内部预算和金额阈值,仍支持同步失败和数据过旧告警。
另一个项目为什么显示相同数字?
Vultr 用户/Key 可能共用账户账务,Quota Monitor 项目是业务分组,不是供应商钱包。同一连接的重复绑定在总览去重;独立创建的重复连接仍不能相加。
查询失败后为什么还能看到金额?
这是保留的上次成功快照和原时间,失败状态单独显示。缺失字段、不支持币种、404/429 或格式异常都不会变成零;真实 Key 权限和账户对账仍待用户测试。

Vultr · 云账户账务 官方资料

教程由 Quota Monitor 整理,非供应商官方教程。平台界面和权限可能变化,请以官方页面为准;实测范围以本页说明为准。

自动监控 Vultr · 云账户账务

手动登录控制台查看很容易忘。Quota Monitor 会通过官方接口替你读取 Vultr · 云账户账务 的数据。

  • 默认每 10 分钟刷新一次,也可以随时手动刷新。
  • 范围为整个云账户,含非 AI 服务。原始账务值的正负号语义和精确账期/重置时间未文档化;不推断信用、欠款、钱包、限额、预算或服务可用性。两个金额分别查看。
  • 通过 REST 或 MCP 读取精确未出账费用和独立带符号账务值;不提供估算资金、内部预算或金额告警。
免费开始使用