ガイド更新日：
2026 年 9 月 28 日にユーザーから中国サイトでの成功報告がありました。正確な金額、使用した CAM ポリシー、MCP での照合は独立して記録されていません。ご自身のアカウント、権限、金額を確認してください。
- 必要な認証情報
- CAM SecretId + SecretKey
- 監視通貨
- CNY · 人民元
- 監視の対象
- クラウドの実利用可能残高 · 与信を除く
- 公式の RealBalance を 100 で割り、分から人民元に正確に換算します。現金、振替収益、特典資金を含み、保留額と未払い額を差し引いた金額です。互換用の Balance や与信で代用しません。CreditBalance、RealCreditBalance、一時的な与信は別々に表示します。
Tencent Cloud / Hunyuan（中国） を Quota Monitor に接続する
中国アカウントと管理者を確認する
支払い元アカウントの Billing Center を開き、通貨が CNY か確認します。グループやパートナー精算では財務担当者に資金元を確認してください。CAM ユーザー、ポリシー、キーの作成は管理者が行い、管理者自身のキーは提出しません。
残高照会ポリシーを作成する
CAM → Policies → Create Custom Policy → Policy Syntax → Blank Template を開き、QuotaMonitorBalanceReadOnly と命名して、内容全体を以下の JSON に置き換えます。同名がある場合は内容を確認するか別名を使い、業務用ポリシーを上書きしないでください。
finance:DescribeAccountBalance をそのまま使用します。接頭辞は billing ではなく finance です。リソース * はアカウント単位のこの操作で必要ですが、全操作の許可ではありません。ID、リージョン、認証情報の入力は不要です。このアクションだけが含まれることを確認してください。
Tencent Cloud / Hunyuan（中国） の読み取り専用ポリシー JSON
{ "version": "2.0", "statement": [ { "effect": "allow", "action": [ "finance:DescribeAccountBalance" ], "resource": [ "*" ] } ] }キーやアカウント情報を含まない JSON 全体をコピーします。
カスタム作成でサブユーザーを追加する
Users → User List → New User → Custom Creation を開きます。通知専用ではなく、リソースにアクセスし通知も受け取れるユーザーを選びます。クイック作成は管理者権限が選ばれる場合があるため使わないでください。既存の残高照会専用ユーザーがある場合は、ポリシー確認へ進めます。
プログラムによるアクセスのみ有効にする
ユーザー名を quota-monitor などにし、Programmatic Access のみ有効にします。コンソールアクセスとパスワードは不要です。必須連絡先の入力や管理者の本人確認は通常どおり行ってください。
カスタムポリシーを付与して作成する
ポリシー一覧を Custom で絞り込み、QuotaMonitorBalanceReadOnly を選びます。AdministratorAccess、QCloudFinanceFullAccess、強い権限のグループは追加しません。確認して作成し、完了画面にキーが表示されたら対応する組を安全に保存します。
ユーザーの実際の権限を確認する
ユーザーの Permission Policies で、カスタムポリシーの付与を確認します。なければそのユーザーの Authorize から選択して再確認してください。ポリシー一覧に存在するだけでは不十分です。支払い、リソース、モデル、管理者の権限は追加しません。
SecretId と SecretKey の組を保存する
未保存の場合は、このサブユーザーの API Keys → Create Key で本人確認を完了し、同じ組の両方の値を安全に保存します。SecretKey は作成時にしか表示されません。Hunyuan キーや一時的な STS 認証情報は使わず、ほかの業務で使うキーを削除しないでください。
プロジェクトに接続を保存する
Quota Monitor でプロジェクトを作成または開き、「プロバイダーを追加」→「新しい接続を追加」→ Tencent Cloud / Hunyuan（中国）を選びます。SecretId と SecretKey を対応する欄に入力してください。リージョン、Uin、Hunyuan プロジェクト ID は不要です。保存して接続すると両方が暗号化され、ID の末尾 4 文字のみ表示されます。
更新して RealBalance を照合する
同期成功を待つか手動で更新し、同じアカウントの Billing Center の RealBalance と比較します。API は分単位で、ダッシュボードは CNY で表示します。詳細で現金、収益、特典資金、保留額、未払い額、与信を確認し、与信を主残高に加算しないでください。チャージは公式サイトで行います。
Quota Monitor が取得する Tencent Cloud / Hunyuan（中国） のデータ範囲
- 中国サイトの CNY アカウントのみ対応しています。エンドポイントは通貨を返さないため、CNY は対応サイトに基づくもので、自動検出ではありません。国際サイトの請求は別の接続が必要です。
- クラウド製品、プロジェクト、キーは資金を共有します。Hunyuan 専用のウォレットではありません。モデルパック、無料トークン、クーポン一覧、Coding Plan の枠は対象外です。アカウントの特典資金とクーポン一覧は別です。
- 取得結果は精算より遅れる場合があります。与信がある場合、RealBalance が少ない・ゼロというだけではサービス利用可否を判断できません。アカウント、精算関係、項目、時刻を合わせて比較してください。
- ダッシュボードには、最後に成功した照会結果を表示します。手動更新で再照会できますが、プロバイダーの請求反映の遅延は解消できません。照会が失敗したあとに残る古い残高は、新しい結果ではありません。
Tencent Cloud / Hunyuan（中国） のよくある質問とトラブルシューティング
- CAM ユーザーやポリシーを作成できません。
- クラウドアカウント管理者に専用ユーザーの設定を依頼してください。監視用ユーザーに管理者権限を付けたり、管理者のパスワードを提出したりしないでください。
- カスタムポリシーが見つからない場合は？
- Custom で絞り込み、保存した正確な名前で検索し、同じクラウドアカウントに作成されていることを確認します。最後に対象ユーザーへの付与も確認してください。
- ポリシー JSON が拒否される場合は？
- エディター全体をコピーした JSON に置き換え、Markdown のコード囲み、コメント、装飾用の引用符を含めないでください。バージョンと statement の大文字・小文字を維持し、finance:DescribeAccountBalance を使用します。billing:DescribeAccountBalance や finance:* に変えないでください。
- SecretId だけ保存しました。SecretKey は復元できますか？
- 信頼できる保管先を確認してください。SecretKey は再表示できません。専用ユーザーで新しい組を作成して保存します。キー数の上限に達している場合はローテーションを調整し、無関係な本番用キーを無効にしないでください。
- Hunyuan キーは使えますか？ユーザーのコンソールログインは必要ですか？
- CAM SecretId / SecretKey を使用します。プログラムアクセス専用ユーザーがコンソールにログインできないのは正常です。設定と照合は管理者が行います。
- 認証情報や権限が拒否される場合は？
- 有効で省略のない中国サイトのキーの組と、所有ユーザーに付与されたポリシーを確認します。finance:DescribeAccountBalance、リソース *、明示的な拒否、制限を確認してください。メインアカウントや管理者のキーに切り替えず、マスキングしたエラーコードと時刻のみ共有してください。
- 現金や与信と金額が異なるのはなぜですか？
- RealBalance は特典資金を含み、保留額と未払い額を差し引きます。CreditBalance と RealCreditBalance は別の指標です。分から元への換算では十進数の精度を保持します。
- HTTP 200 のエラー、時刻エラー、項目欠落への対処は？
- HTTP 200 でも Response.Error を確認します。RealBalance がない場合、Balance、与信、ゼロで代用しません。時刻エラーが続く場合は管理者に確認を依頼してください。古い取得結果は過去の記録として残ります。
Tencent Cloud / Hunyuan（中国） の公式資料
- 公式資料 · cloud.tencent.com/document/api/555/20253（新しいタブで開きます）
- 公式資料 · cloud.tencent.com/document/product/555/61542（新しいタブで開きます）
- 公式資料 · cloud.tencent.com/document/product/598/92835（新しいタブで開きます）
- 公式資料 · cloud.tencent.com/document/product/598/13674（新しいタブで開きます）
- 公式資料 · cloud.tencent.com/document/product/598/10602（新しいタブで開きます）
- 公式資料 · cloud.tencent.com/document/product/598/37140（新しいタブで開きます）
- 公式資料 · cloud.tencent.com/document/api/555/19175（新しいタブで開きます）
Quota Monitor が作成したガイドで、プロバイダーの公式チュートリアルではありません。画面や権限は変更される場合があるため、公式ページも確認してください。検証済みの範囲は、ここに記載した内容に限られます。