ガイド更新日:
2026-10-17 に公式エンドポイント、QueryAccountBalance、SDK、RAM、請求文書を確認して実装しました。国際サイトの実アカウント、権限、ログイン後の操作と金額照合はユーザー検証待ちです。中国サイトの検証結果は流用しません。代理ログイン、モデル呼び出し、権限変更は行っていません。
- 必要な認証情報
- 国際サイト専用 RAM ユーザーの AccessKey ID / AccessKey Secret
- 監視通貨
- USD / CNY / JPY を明示選択。応答通貨と一致、換算なし
- 監視の対象
- クラウドアカウント利用可能額 · 信用枠を含む場合あり、現金ではない
- 固定の読み取り専用 POST https://business.ap-southeast-1.aliyuncs.com/、QueryAccountBalance 2017-12-14、ACS3-HMAC-SHA256 のみです。業務パラメーター、本文、リダイレクトはありません。主値 availableAmount は AvailableAmount、availableCashAmount、creditAmount、mybankCreditAmount、quotaLimit は別表示です。AI 以外も含む国際クラウド請求アカウント全体であり、Model Studio 専用ウォレット、プロジェクト残高、Key 上限ではありません。
キーを保存せず手動で確認
- 国際請求画面にログインし、Account > Billing Account で実際の支払アカウントと通貨を確認します。
- 利用可能額、現金、信用枠、請求を別々に読み、共有クラウド範囲を確認します。Key やプロジェクトを合算しません。
- 同じ通貨・範囲・近い時刻で照合します。非対応通貨、未返却値、未確定請求は換算せず区別します。
Alibaba Cloud 国際サイト / Model Studio を Quota Monitor に接続する
国際サイトの請求アカウントと通貨を確認
国際 Billing and Cost Management を開き、Account > Billing Account で業務が使う支払アカウントを確認します。利用可能額は Model Studio と他のクラウドサービスに共用される場合があり、AI 専用ではありません。
実際の決済通貨を控えます。本接続は USD、CNY、JPY のみです。EUR、SGD、HKD などは手動確認とし、監視目的で通貨変更しません。段階的な画面移行中は旧画面に New Console リンクがある場合のみ使用し、パスを推測しません。
既存の管理者が専用 RAM ユーザーを作成
国際 RAM の Identities > Users > Create User で Logon Name と Display Name(例 QuotaMonitorBalance)を設定します。ルートアカウントの AccessKey は使いません。
必要なのは Permanent AccessKey によるプログラムアクセスだけで、Console Access や管理者権限は不要です。公式の安全確認を私的に完了し、長期キーの必要性を確認します。既存の管理権限がなければ管理者に依頼し、監視ユーザーを昇格しません。
最小の読み取り専用請求ポリシーを作成
Permissions > Policies > Create Policy の JSON Editor で、下記 Version 1 ポリシーを貼り、QuotaMonitorBalanceRead と名付けます。bss:DescribeAcccount の c は連続3個です。Resource * はこの操作の公式リソース範囲です。
管理者、FullAccess、請求書き込み権限や新版 bss:DescribeBillingAccount に置き換えません。本接続は2017年版のみを呼びます。ポリシーにアカウント識別子、キー、エンドポイントや実際の秘密は含まれません。
Alibaba Cloud 国際サイト / Model Studio の読み取り専用ポリシー JSON
{ "Version": "1", "Statement": [ { "Effect": "Allow", "Action": [ "bss:DescribeAcccount" ], "Resource": "*" } ] }キーやアカウント情報を含まない JSON 全体をコピーします。
正しい RAM ユーザーにポリシーを付与
Identities > Users に戻り、専用ユーザーの Actions > Attach Policy を選びます。Grant Permission で Principal を確認し、Resource Scope は Account level / Entire Alibaba Cloud Account、Custom Policy は QuotaMonitorBalanceRead を選んで確定します。
作成しただけでは権限は付与されません。有効な付与内容を確認し、リソースグループや管理ポリシーで代用しないでください。既存管理者による一度限りの設定で、監視処理は権限を管理しません。
組になった AK/SK を私的に保存
ユーザー作成時に長期 AccessKey が生成済みなら、その組を使用し重複作成しません。既存専用ユーザーでは詳細 > Credential > AccessKey > Create AccessKey から公式用途選択と安全確認を行います。
完全な AccessKey Secret は通常作成時のみ表示され、AK/SK は同じ組である必要があります。ユーザー自身による AccessKey 管理を全体で有効にせず、STS SecurityToken、モデルキー、Authorization ヘッダーを入力しません。公式の最大2組の輪換制約を守ります。
国際サイトと実際の通貨を選択
Quota Monitor の対象プロジェクトで接続を追加し、Alibaba Cloud 国際サイト / Model Studio を選びます。2つのパスワード欄に専用 RAM の AccessKey ID と AccessKey Secret を入力し、請求画面と一致する USD、CNY、JPY を明示選択します。
MCP の安全な認証情報設定リンクも同じプロバイダーです。AK/SK を AI 会話やツール引数に渡しません。暗号化保存され、他の画面には末尾4文字のみ表示します。地域、任意 URL、プロジェクト、Key フィルターはなく、ヘルプは入力を読み取り・送信しません。
更新して公式の利用可能額と照合
初回同期後に成功時刻が更新されたことを確認し、同じ支払アカウント・通貨の Available Credit / AvailableAmount と比較します。123.4567890123456789 USD はドル主単位でセントではありません。ゼロと負値の意味を保持します。
主カードは現金でなく利用可能額です。AvailableCashAmount、CreditAmount、MybankCreditAmount、QuotaLimit は別々に照合します。欠落や null は未返却で、ゼロや加算項ではありません。モデル枠、リセット時刻、最終費用は返らず、providerAvailable は不明です。
共有範囲とバージョン制限を理解
Key やプロジェクトで同額が表示されても同一請求アカウントの共有かもしれません。合算せず、モデル使用量、パッケージ、予算、信用上限、中国サイトの資金と区別します。
別の2023年版 GetFundAccountAvailableAmount はアカウント種別と複数通貨の項目が異なります。本接続は文書化された2017年版と単一権限に固定します。自動フォールバックや権限拡大はなく、通貨不一致・対象外では旧スナップショットを保持します。
安全なエラー対処とキー輪換
401/403 では国際サイト、AK/SK の組・失効、実際のポリシー付与と bss:DescribeAcccount の綴りを確認します。AuthSiteFail、SignatureDoesNotMatch、InvalidTimeStamp、SignatureNonceUsed はサイトとサーバー時刻を確認し、429 は待って再試行します。有料モデルで試しません。
専用監視キーだけを安全なフォームで輪換し、成功後に旧監視キーを停止します。業務キーは触りません。失敗時は旧金額をゼロにせず成功時刻も更新しません。機密除去済みエラーコードのみ共有し、Cookie 送信、入金、アップグレード、権限拡大はしません。
Quota Monitor が取得する Alibaba Cloud 国際サイト / Model Studio のデータ範囲
- 2017 年版 API の記載通貨は USD、CNY、JPY のみです。実際の請求通貨を選び、応答との完全一致を要求します。国際サイトの EUR、SGD、HKD などは本接続では非対応です。推測・換算や監視目的の通貨変更はしません。
- 中国サイト aliyun と国際サイト aliyun_global は認証情報、固定エンドポイント、検証状態が別です。中国への再試行、2023 API への自動切替、権限拡大は行いません。
- 利用可能額には信用枠、返金、未確定請求の影響があり、引き出せる現金ではありません。AvailableCashAmount、CreditAmount、MybankCreditAmount、QuotaLimit を合算して再計算しません。未返却値はゼロではなく不明です。
- 複数のクラウドサービス、Key、Quota Monitor プロジェクトが同じ請求アカウントを共有し得ます。重複接続を合算しないでください。別アカウントの支払いも含む場合があり、実際の支払範囲を確認します。
- 原値は通貨の主単位で、セント等ではありません。十進文字列と符号を保持します。リセット、期限、モデル可用性、最終請求額は推定しません。手入力の日次消費による残日数は推定値です。
- ダッシュボードには、最後に成功した照会結果を表示します。手動更新で再照会できますが、プロバイダーの請求反映の遅延は解消できません。照会が失敗したあとに残る古い残高は、新しい結果ではありません。
Alibaba Cloud 国際サイト / Model Studio のよくある質問とトラブルシューティング
- Model Studio の残高や現金ですか?
- どちらでもありません。AvailableAmount は共有国際クラウド請求アカウントの利用可能額で、信用枠を含み得ます。現金は別項目で、モデル・プロジェクト・Key に自動配分されません。
- 通貨選択が必要な理由と EUR・SGD・HKD への対応は?
- 2017年版の記載は USD、CNY、JPY のみです。明示選択と応答の完全一致が必要で、他通貨は安全に拒否します。USD の仮定、換算、決済通貨変更の依頼はしません。
- ポリシーを作成しても403になる
- 作成と付与は別です。専用 RAM ユーザーの Attach Policy、アカウント単位の範囲、有効なカスタムポリシーと bss:DescribeAcccount(c は連続3個)を確認します。管理者や FullAccess は追加しません。
- モデルキー、中国の AK、STS が使えないのは?
- Model Studio API キーは RAM AK/SK ではありません。中国と国際アカウントは別です。STS、任意エンドポイント、利用者指定地域ルーティングには非対応で、URL 変更は回避策になりません。
- 金額の差や現金の負値について
- 支払アカウント、通貨、時刻を合わせ、AvailableAmount と現金・信用を別々に比較します。再計算、合算、信用上限から現金を推定しません。正の利用可能額も全モデルの成功を保証しません。
- タイムアウト、429、項目欠落への対処は?
- 時間を置き公式状態を確認します。通貨不一致、金額欠落・形式不正、失敗応答は旧スナップショットと成功時刻を保持します。AK/SK、署名、原応答、識別情報を公開せず、機密除去済みコードのみ共有します。
Alibaba Cloud 国際サイト / Model Studio の公式資料
- 公式資料 · www.alibabacloud.com/help/en/user-center/developer-reference/api-bssopenapi-2017-12-14-queryaccountbalance(新しいタブで開きます)
- 公式資料 · www.alibabacloud.com/help/en/user-center/developer-reference/api-bssopenapi-2017-12-14-endpoint(新しいタブで開きます)
- 公式資料 · www.alibabacloud.com/help/en/user-center/fund-account-overview(新しいタブで開きます)
- 公式資料 · www.alibabacloud.com/help/en/ram/user-guide/create-a-ram-user(新しいタブで開きます)
- 公式資料 · www.alibabacloud.com/help/en/ram/create-a-custom-policy(新しいタブで開きます)
- 公式資料 · www.alibabacloud.com/help/en/ram/user-guide/grant-permissions-to-the-ram-user(新しいタブで開きます)
- 公式資料 · www.alibabacloud.com/help/en/ram/user-guide/create-an-accesskey-pair(新しいタブで開きます)
- 公式資料 · www.alibabacloud.com/help/en/sdk/product-overview/v3-request-structure-and-signature(新しいタブで開きます)
- 公式資料 · www.alibabacloud.com/help/en/user-center/developer-reference/api-bssopenapi-2023-09-30-getfundaccountavailableamount(新しいタブで開きます)
- 公式資料 · www.alibabacloud.com/help/en/model-studio/get-api-key(新しいタブで開きます)
Quota Monitor が作成したガイドで、プロバイダーの公式チュートリアルではありません。画面や権限は変更される場合があるため、公式ページも確認してください。検証済みの範囲は、ここに記載した内容に限られます。