Azure Quantum でクォータを管理する方法

[アーティクル]
06/21/2024

Azure Quantum クォータは、QPU targetsの使用に関するプロバイダー定義の制限です。クォータは、プロバイダーのシステムの整合性を維持しながら、ユーザーの偶発的なコスト超過を防ぐのに役立ちます。クォータはプロバイダープランの選択に基づいており、通常はサポートチケットを使用して増やすことができます。
クォータによって追跡される使用量は、必ずしもコストまたはクレジットに関連付けられているわけではありませんが、関連付けられていることもあります。

ヒント

Azure Quantum ワークスペースを作成すると、量子ハードウェアプロバイダーごとに自動的に USD500 無料 Azure Quantum クレジットが取得されます。 Azure Quantum クレジットを使用して、最初の量子プログラムを実際の量子ハードウェアに送信できます。

クォータの計算方法

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](新しいサポートリクエスト) ボタンを選択します。
サポートチケットが開きます。次の手順に従ってリクエストに記入します。
1. イシューには、「Azure Quantum クォータのオーバーライドリクエスト」と記入します
2. [Isuue Type] (イシューの種類) で、[技術] を選択します
3. ワークスペースが存在するサブスクリプションを選択します
4. [すべてのサービス] を選択します
5. [サービスの種類] として [Azure Quantum – Preview](Azure Quantum – プレビュー) を選択します
6. [リソース] で、クォータを変更したいワークスペースを選択します
7. 問題の種類として [その他] を選択します
8. [ソリューション]に進み、さらに [詳細] に進みます
9. すべてのフィールドに入力します [Description](説明) に、次の情報を含めます。
- クォータを変更するプロバイダーの名前
- クォータを変更するのは、サブスクリプションスコープとワークスペーススコープのどちらか
- 変更するクォータと、変更するクォータの量
- クォータを増やす理由を記入すると、Microsoft が決定を下す際に役立つ場合があります。

次の方法で共有

Azure Quantum でクォータを管理する方法

クォータの計算方法

クォータの残りの確認

Azure portal を使用してクォータを追跡する

Azure CLI を使用してクォータを追跡する

Python SDK を使用してクォータを追跡する

追加のクォータの要求

フィードバック

その他のリソース

次の方法で共有

Azure Quantum でクォータを管理する方法

クォータの計算方法

クォータの残りの確認

Azure portal を使用してクォータを追跡する

Azure CLI を使用してクォータを追跡する

Python SDK を使用してクォータを追跡する

追加のクォータの要求

関連するコンテンツ

フィードバック

その他のリソース