Azure Quantum でクォータを管理する方法
Azure Quantum クォータは、QPU targetsの使用に関するプロバイダー定義の制限です。 クォータは、プロバイダーのシステムの整合性を維持しながら、ユーザーの偶発的なコスト超過を防ぐのに役立ちます。 クォータはプロバイダー プランの選択に基づいており、通常はサポート チケットを使用して増やすことができます。
クォータによって追跡される使用量は、必ずしもコストまたはクレジットに関連付けられているわけではありませんが、関連付けられていることもあります。
ヒント
初めてのユーザーは自動的に
クォータの計算方法
Azure Quantum では、ハードウェアおよびソフトウェア プロバイダーが自社のオファリングのクォータを決定し、管理します。 クォータの詳細については、各プロバイダーのリファレンス ページを参照してください。 プロバイダーが次の一覧に表示されない場合、そのプロバイダーはクォータを定義しません。
クォータの残りの確認
Azure Quantum の使用量とクォータは、各プロバイダーの使用量単位に応じて測定されます。 一部のプロバイダーはクォータを定義せず、表示する使用状況情報を持っていません。
Note
課金プランではなく Azure Quantum クレジット プランを使用している場合、クォータ情報は割り当てられたクレジットに対応付けられています。 その場合、クォータでは受け取ったクレジットの合計数が一覧表示されます。
Azure portal を使用してクォータを追跡する
- ご利用の Azure サブスクリプションの資格情報を使って、Azure portal にサインインします。
- ご利用の Azure Quantum ワークスペースを選択します。
- 左側のパネルの [ Operations で、 Credits とクォータ タブに移動し、 Quotas ブレードを選択します。
- 選択したプロバイダーごとに消費されたクォータと残りのクォータを確認します。 クォータ情報が 3 つの列に表示されていることに注意してください。
- Workspace usage (ワークスペース使用量): 現在のワークスペースの使用制限です。 各 Azure Quantum ワークスペースには使用制限があります。
- Azure subscription usage (Azure サブスクリプションの使用量): 現在のリージョンとサブスクリプション内のすべてのワークスペースの使用量です。 すべてのクォータがこのレベルで追跡されるわけではありません。
- Cadence (更新頻度): クォータが更新される期間。 月単位の場合は、毎月 1 日に使用量がリセットされます。 1 回限りの場合、使用量はリセットされません。
このビューには、Azure Quantum クレジットがクォータとして含まれています。 これによりユーザーは、プロバイダーが追跡する単位と、関連付けられている間隔に応じて表示されるクレジット情報を確認できます。
Azure CLI を使用してクォータを追跡する
クォータは、Azure コマンドライン インターフェイス (Azure CLI) を使用して確認できます。 詳細については、「Azure CLI を使用して Quantum ワークスペースを管理する」を参照してください。
Azure CLI
quantum
拡張機能をインストールします。 コマンド プロンプトを開き、次のコマンドを実行します。以前のバージョンが既にインストールされている場合は、これにより拡張機能のアップグレードも実行されます。az extension add --upgrade -n quantum
自分の資格情報を使用して Azure にログインします。 ご自分のアカウントに関連付けられているサブスクリプションの一覧が表示されます。
az login
使用するサブスクリプションを指定します。
az account set -s <Your subscription ID>
使用するワークスペースを選択します。 リソース グループと場所も指定する必要があることに注意してください。
az quantum workspace set \ -g MyResourceGroup \ -w MyWorkspace \ -l MyLocation \ -o table
az quantum workspace quotas
コマンドを使用して、選択したワークスペースのクォータ情報を表示します。az quantum workspace quotas -o table
|Dimension | Holds | Limit | Period | ProviderId | Scope | Utilization| |--------- | ----- | --------- | -------- | ----------| ------------ | -----------| |qgs | 0.0 | 8333334.0 | Infinite | ionq | Subscription | 33334.0| |hqc | 0.0 | 800.0 | Infinite | quantinuum | Subscription | 0.0|
上記の出力を例として参照してください。 この例では、qgs
の行が、そのアカウントの IonQ の制限が 8333334 qgs
であり、そのうち 33334 qgs
が使用されたことを示しています。 また、このアカウントの Quantinuum の制限は 800
HQC で、そのうち 0
が使用されています。
"Scope" 列は、クォータが現在のワークスペースとサブスクリプションのどちらを参照しているかを示しています。
- Workspace (ワークスペース): クォータは個々のワークスペースに対して追跡されます。
- Subscription (サブスクリプション): クォータは、同じサブスクリプション/リージョン内のすべてのワークスペースについてまとめて追跡されます。
"Period" 列は、クォータが更新される期間を示しています。
- Monthly (月単位): 毎月 1 日に使用量がリセットされます。
- 無限: 使用状況はリセットされません (Azure ポータル ビューでは 1 回とも呼ばれます)。
Python SDK を使用してクォータを追跡する
最新バージョンの
azure-quantum
Python パッケージをインストールします。新しい Python ファイルを開きます。
Workspace
オブジェクトのインスタンスを作成します。これにより、以前に Azure にデプロイしたワークスペースに接続できます。from azure.quantum import Workspace # Copy the following settings for your workspace workspace = Workspace ( resource_id = "", # Add your resource_id location = "" # Add your workspace location (for example, "westus") )
get_quotas
メソッドを使用して、選択したワークスペースのクォータ情報を表示します。quotas = workspace.get_quotas()
[{'dimension': 'qgs', 'scope': 'Subscription', 'provider_id': 'ionq', 'utilization': 33334.0, 'holds': 0.0, 'limit': 16666667.0, 'period': 'Infinite'}, {'dimension': 'hqc', 'scope': 'Subscription', 'provider_id': 'quantinuum', 'utilization': 0.0, 'holds': 0.0, 'limit': 40.0, 'period': 'Infinite'}, {'dimension': 'ehqc', 'scope': 'Subscription', 'provider_id': 'quantinuum', 'utilization': 0.0, 'holds': 0.0, 'limit': 160.0, 'period': 'Infinite'}, {'dimension': 'combined_job_hours', 'scope': 'Workspace', 'provider_id': 'Microsoft', 'utilization': 0.0, 'holds': 0.0, 'limit': 20.0, 'period': 'Monthly'}, {'dimension': 'combined_job_hours', 'scope': 'Subscription', 'provider_id': 'Microsoft', 'utilization': 0.011701412083333333, 'holds': 0.0, 'limit': 1000.0, 'period': 'Monthly'}]
上記の出力を例として参照してください。 この例では、qgs
の行が、そのアカウントの IonQ の制限が 8333334 qgs
であり、そのうち 33334 qgs
が使用されたことを示しています。 同時実行ジョブの数とは、ワークスペースごとに一度にキューに入れることができるジョブの数です。
scope
項目は、クォータが現在のワークスペースまたはサブスクリプションを参照しているかどうかを示します。
- Workspace (ワークスペース): クォータは個々のワークスペースに対して追跡されます。
- Subscription (サブスクリプション): クォータは、同じサブスクリプション/リージョン内のすべてのワークスペースについてまとめて追跡されます。
period
項目は、クォータが更新された期間を示します。
- Monthly (月単位): 毎月 1 日に使用量がリセットされます。
- 無限: 使用状況はリセットされません (Azure ポータル ビューでは 1 回とも呼ばれます)。
ヒント
get_quotas
メソッドは、Python ディクショナリの形式で結果を返します。 人間が判読しやすい形式にするには、次のコード サンプルを使用して、サブスクリプションとワークスペース レベルで残りのクォータ > の概要を出力します。
次のコードをコピーして、サブスクリプション レベルでクォータ 追跡します。
# This gathers usage against quota for the various providers (quota is set at the subscription level).
# Note that a provider may have multiple quotas, such as Quantinuum that limits usage of their Emulator.
rigetti_quota = 0
ionq_quota = 0
quantinuum_hqc_quota = 0
quantinuum_ehqc_quota = 0
rigetti_quota_utilization = 0
ionq_quota_utilization = 0
quantinuum_hqc_quota_utilization = 0
quantinuum_ehqc_quota_utilization = 0
for quota in workspace.get_quotas():
if (quota['provider_id'] == 'rigetti'):
rigetti_quota = quota['limit']
rigetti_quota_utilization = quota['utilization']
if (quota['provider_id'] == 'ionq'):
ionq_quota = quota['limit']
ionq_quota_utilization = quota['utilization']
if (quota['dimension'] == 'hqc'):
quantinuum_hqc_quota = quota['limit']
quantinuum_hqc_quota_utilization = quota['utilization']
if (quota['dimension'] == 'ehqc'):
quantinuum_ehqc_quota = quota['limit']
quantinuum_ehqc_quota_utilization = quota['utilization']
print('Rigetti quota use: ', "{:,}".format(rigetti_quota_utilization), '/', "{:,}".format(rigetti_quota))
print('IonQ quota use:', "{:,}".format(ionq_quota_utilization), '/', "{:,}".format(ionq_quota))
print('Quantinuum HQC quota use:', "{:,}".format(quantinuum_hqc_quota_utilization), '/', "{:,}".format(quantinuum_hqc_quota))
print('Quantinuum eHQC quota use:', "{:,}".format(quantinuum_ehqc_quota_utilization), '/', "{:,}".format(quantinuum_ehqc_quota))
次のコードをコピーして、 ワークスペース レベルでクォータを追跡します。
# This gathers usage against quota for the various providers for the current workspace
# As there can be multiple workspaces in a subscription, the quota usage for the workspace is less or equal to usage against quota at the subscription level
amount_utilized_rigetti = 0
amount_utilized_ionq = 0
amount_utilized_quantinuum_hqc = 0
amount_utilized_quantinuum_ehqc = 0
for job in workspace.list_jobs():
if (job.details.cost_estimate != None):
for event in job.details.cost_estimate.events:
if (event.amount_consumed > 0):
#print(event.amount_consumed, event.dimension_name, 'on', job.details.provider_id)
if (job.details.provider_id == 'rigetti'):
amount_utilized_rigetti += event.amount_consumed
if (job.details.provider_id == 'ionq'):
amount_utilized_ionq += event.amount_consumed
if (job.details.provider_id == 'quantinuum'):
#print(event.amount_consumed, event.dimension_name, 'on', job.details.provider_id)
#print(event)
if (event.dimension_id == 'hqc'):
amount_utilized_quantinuum_hqc += event.amount_consumed
else:
amount_utilized_quantinuum_ehqc += event.amount_consumed
print(job.id, event)
print('Rigetti quota use in current workspace: ', "{:,}".format(amount_utilized_rigetti), '/', "{:,}".format(rigetti_quota))
print('IonQ quota use in current workspace:', "{:,}".format(amount_utilized_ionq), '/', "{:,}".format(ionq_quota))
print('Quantinuum HQC quota use in current workspace:', "{:,}".format(amount_utilized_quantinuum_hqc), '/', "{:,}".format(quantinuum_hqc_quota))
print('Quantinuum eHQC quota use in current workspace:', "{:,}".format(amount_utilized_quantinuum_ehqc), '/', "{:,}".format(quantinuum_ehqc_quota))
追加のクォータの要求
Azure Quantum クレジット プランを使用していない場合は、サポート チケットを作成することでクォータの増加をリクエストできます。
ご利用の Azure サブスクリプションの資格情報を使って、Azure portal にサインインします。
ご利用の Azure Quantum ワークスペースを選択します。
左側パネルにある [操作] の [Credits and quotas](クレジットとクォータ) ブレードに移動し、[クォータ] タブを選択します。
[クォータ] ページの [Increase](増加) ボタンを押すか、ポータルのサイド パネルで [New support request](新しいサポート リクエスト) ボタンを選択します。
サポート チケットが開きます。 次の手順に従ってリクエストに記入します。
- イシューには、「Azure Quantum クォータのオーバーライド リクエスト」と記入します
- [Isuue Type] (イシューの種類) で、[技術] を選択します
- ワークスペースが存在するサブスクリプションを選択します
- [すべてのサービス] を選択します
- [サービスの種類] として [Azure Quantum – Preview](Azure Quantum – プレビュー) を選択します
- [リソース] で、クォータを変更したいワークスペースを選択します
- 問題の種類として [その他] を選択します
- [ソリューション]に進み、さらに [詳細] に進みます
- すべてのフィールドに入力します [Description](説明) に、次の情報を含めます。
- クォータを変更するプロバイダーの名前
- クォータを変更するのは、サブスクリプション スコープとワークスペース スコープのどちらか
- 変更するクォータと、変更するクォータの量
- クォータを増やす理由を記入すると、Microsoft が決定を下す際に役立つ場合があります。