ガイド更新日:
2026-10-17 に公式資料を確認し実装済み。実サービスユーザーの作成、最小権限、アカウント範囲、コンソール/API の照合はユーザーによる実機確認待ちです。代理ログイン、リソース作成、支払い、権限変更は行っていません。
- 必要な認証情報
- 専用 Vultr API キー · account.billing.Read
- 監視通貨
- USD · ドル単位の十進数、セントではありません
- 監視の対象
- 今月の未請求料金 · 利用可能資金ではない
- GET https://api.vultr.com/v2/account のみ。account.pending_charges は認証先のクラウド請求アカウント全体の今月の未請求料金で、AI 以外も含みます。account.balance は元の符号を保って別表示し、利用可能資金とは解釈しません。
Quota Monitor を使わず直接確認する
- Vultr Console で正しい組織/アカウントを選び Billing を開きます。History は請求書と支払い、Make a Payment/クレジットは別の表示です。閲覧のみで、支払いを送信しないでください。
- 今月の未請求料金を別に確認します。ご自身の安全な環境で公式 GET /v2/account を使う場合、account.balance の符号と独立した pending_charges を保ち、負の例から資金を推定しません。
- 同じアカウントと観測時刻で照合し、別のプロジェクト/キーや確定請求書と混同しません。この API は明確な期間境界、タイムゾーン、リセット時刻を返しません。
Vultr · クラウド請求 を Quota Monitor に接続する
正しいアカウントと組織を選ぶ
Vultr Console にご自身でログインし、利用料金を支払う組織/アカウントを選択します。Billing で今月の未請求料金をクレジット、支払い、請求書と分けて確認します。
接続は計算、GPU、AI 以外を含むクラウド請求全体を対象にします。Quota Monitor のプロジェクトは資金を分割しません。子アカウントの請求は別途照合してください。
専用サービスユーザーを作成する
既存の権限を持つ管理者が組織名 → Manage Organization → Users → + を開きます。User Type: Service User を選び、名前とメールを入力して確認後 Add service user を押します。
不要なグループやロールは付けません。サービスユーザーは API 用で、対話ログイン用ではありません。監視に root/管理者権限は不要です。設定権限がなければ既存の管理者に依頼します。
最小権限ポリシーを定義する
Manage Organization → Permission Policies → + で名前を付け、account billing の account.billing.Read だけを許可します。Add Permission Policy の前に選択内容を確認し、全アクションを選ばないでください。
以下の JSON は公式 IAM API の policy_document です。Console に貼り付け欄があるという意味ではなく、UI では同じアクションを選びます。Resource * はアカウント全体の範囲で、全操作の許可ではありません。他のアカウント情報も読み取れます。
Vultr · クラウド請求 の読み取り専用ポリシー JSON
{ "Version": "2012-10-17", "Statement": [ { "Effect": "Allow", "Action": [ "account.billing.Read" ], "Resource": "*" } ] }キーやアカウント情報を含まない JSON 全体をコピーします。
サービスユーザーにポリシーを割り当てる
Permission Policies から作成したポリシーを開き、Attached Entities → + で専用サービスユーザーだけを選び Attach Entities を押します。作成だけでは権限は付きません。
既存のグループ、ロール、他ポリシーも確認します。限定ポリシーの追加は既存の広い権限を削除しません。Quota Monitor はポリシーの作成、割り当て、変更を代行しません。
API を有効にして独立キーを作る
Manage Organization → Users → サービスユーザー → API Access → Create API Key を開きます。Key Name と適切な有効期限を設定し Generate API Key を押します。一度だけコピーして安全に保存し、確認後 Finalize Key Generation を選びます。
API が無効なら既存の権限を持つ管理者が公式 Enable API Access 手順で api_enabled: true を設定します。監視ユーザーにユーザー管理権限を追加しません。キー全体をチャット、コード、画像、MCP 引数に入れないでください。
既存のネットワーク許可リストを守る
ユーザーの API Access → Access Control List で許可ネットワークを確認します。既定では Any IPv4 と Any IPv6 が許可される場合があります。Add IP to Allowlist → サブネット/プレフィックス → Add Subnet で承認済みサーバー出口に限定し、他クライアントを妨げないようにします。
既存の制限を緩めたり、この接続のために Allow All を選んだりしないでください。承認済み固定出口がない場合は管理者に相談するか手動で確認します。Quota Monitor は固定 IP を約束しません。
Quota Monitor に Vultr を接続する
対象プロジェクトで接続を追加し「Vultr · クラウド請求」を選び、専用キーをマスク入力欄へ貼り付けます。準備ができたら保存します。キーは暗号化され、接続先は固定です。
USD のみを使用します。アカウント URL、プロジェクト/キーの絞り込み、内部月予算、金額アラート、日次消費上書きは使えません。ヘルプドロワーと公開ガイドは同じ内容です。
最初の成功スナップショットを照合する
更新後、成功時刻が進んだことを確認します。pending_charges を同じアカウントの未請求料金と比較し、別表示の元の account.balance は同じ符号付き API 値と比較します。
例えば balance -100.55 と pending charges 60.25 は独立した USD 値で、計算した 40.30 のウォレットではありません。60.123456789012345678 のような元の精度を保持します。公式 API はご自身の安全な環境で確認し、キーや個人情報を送らないでください。
失敗と安全なローテーション
期限切れ、失効、漏洩時は同じアカウントに新しい専用の制限キーを作り、Quota Monitor の認証情報更新を使います。読み取り成功を確認してから通常の手順で旧キーを廃止します。
401/403、レート制限、不正データ、障害では前回の成功値を消しません。安全なエラーコードと時刻のみ共有してください。権限回避、IP 制限緩和、リソース作成、モデル呼び出し、支払いでテストしないでください。
Quota Monitor が取得する Vultr · クラウド請求 のデータ範囲
- 通常アカウント API は account.balance の符号規則を説明していません。正・負・ゼロを保持し、符号反転、絶対値化、債務/クレジットの推定、pending_charges を引くウォレット計算は行いません。
- 共有クラウドアカウントの請求であり、AI 専用ウォレット、プロジェクト予算、キー上限、子アカウント集計ではありません。複数ユーザー/キーで共有されるため、重複接続を合算しないでください。
- pending_charges は月次の未請求額で、確定請求書や残りクレジットではありません。税や後日の調整で最終請求額が変わる場合があります。料金明細、支払履歴、推定資金は収集しません。
- 明確な期間の開始/終了、タイムゾーン、リセット時刻は返されません。不明のままとし、UTC 月初、次回リセット、消費率、残り日数、内部予算、金額しきい値を推測しません。
- 保持するのは二つの金額のみです。氏名、メール、ACL、最終支払い情報は破棄します。不完全な応答や失敗では最後の成功値と時刻を保持し、新しいゼロにはしません。
- AI 以外も含むクラウド全体です。元の値の符号規則と正確な期間/リセットは未記載のため、クレジット、債務、ウォレット、上限、予算、利用可否を推定しません。二つの金額を別々に確認します。
Vultr · クラウド請求 のよくある質問とトラブルシューティング
- 元の請求値が負なのはなぜ?
- 通常アカウントの契約は balance と命名するだけで符号を説明していません。クレジット、債務、使える資金とは呼ばず保持します。子アカウント UI の例は通常 API の根拠ではありません。ご自身のアカウントについて Vultr に確認してください。
- 他で使えるキーなのに 401/403 が出る?
- 期限、失効、API 有効化、サービスユーザー、account.billing.Read の割り当て、出口 IP を確認します。モデル/リソース権限は請求読み取り権限とは異なります。管理者権限や Allow All を追加しないでください。
- 請求書や AI 費用と一致しない?
- pending_charges は AI 以外も含む全アカウントの当月未請求料金です。最終請求書には税や調整が入る場合があります。AI 費用の配分、balance からの差し引き、過去の支払い取得は行いません。
- リセット時刻、予算、残り日数がない?
- API は正確な期間、タイムゾーン、リセット、支出上限を返しません。不明は不明のままです。この接続では内部予算と金額しきい値を無効にし、同期失敗と古いデータの通知は使用できます。
- 別プロジェクトでも同じ値になる?
- Vultr の複数ユーザー/キーは請求を共有できます。Quota Monitor のプロジェクトは業務上の分類で、独立ウォレットではありません。同じ接続の重複バインドは概要で除外しますが、別に作成した重複接続も合算しないでください。
- 失敗後も金額が表示される?
- 前回成功した値と元の時刻を保持し、エラーは別表示します。欠落、未対応通貨、404/429、不正応答をゼロとは扱いません。実キーの権限と照合はユーザーによる確認待ちです。
Vultr · クラウド請求 の公式資料
- 公式資料 · github.com/vultr/vultr-mcp/blob/main/openapi.json(新しいタブで開きます)
- 公式資料 · docs.vultr.com/platform/iam/policies/iam-policy-actions-map/account-actions(新しいタブで開きます)
- 公式資料 · docs.vultr.com/platform/iam/service-user/how-to-create-a-service-user(新しいタブで開きます)
- 公式資料 · docs.vultr.com/platform/iam/policies/how-to-create-a-policy(新しいタブで開きます)
- 公式資料 · docs.vultr.com/platform/iam/policies/how-to-attach-a-policy-to-a-user(新しいタブで開きます)
- 公式資料 · github.com/vultr/iam-management-api/blob/main/iam-management-api.yml(新しいタブで開きます)
- 公式資料 · docs.vultr.com/platform/iam/organizations/manage-user-api-access/how-to-create-an-api-key-for-a-user(新しいタブで開きます)
- 公式資料 · docs.vultr.com/platform/iam/organizations/manage-user-api-access/how-to-enable-vultr-api-access-for-users(新しいタブで開きます)
- 公式資料 · docs.vultr.com/platform/iam/organizations/manage-user-api-access/how-to-manage-vultr-api-access-control-for-users(新しいタブで開きます)
- 公式資料 · docs.vultr.com/platform/billing/view-payment-history(新しいタブで開きます)
- 公式資料 · docs.vultr.com/support/platform/billing/does-vultr-support-local-currency-invoicing(新しいタブで開きます)
- 公式資料 · docs.vultr.com/support/platform/billing/does-vultr-collect-vat-or-sales-tax(新しいタブで開きます)
- 公式資料 · docs.vultr.com/support/platform/users/what-is-the-difference-between-a-user-and-a-sub-account-in-vultr(新しいタブで開きます)
- 公式資料 · docs.vultr.com/platform/other/sub-accounts/monitor-sub-accounts(新しいタブで開きます)
Quota Monitor が作成したガイドで、プロバイダーの公式チュートリアルではありません。画面や権限は変更される場合があるため、公式ページも確認してください。検証済みの範囲は、ここに記載した内容に限られます。