Azure CLI を使用して Quantum ワークスペースを管理する

  • [アーティクル]

このガイドでは、Azure コマンド ライン インターフェイス (Azure CLI) を使用して Azure Quantum ワークスペースと必要なリソース グループおよびストレージ アカウントを作成し、Azure Quantum で量子アプリケーションの実行を始める方法について説明します。

前提条件

Azure Quantum サービスを使用するには、次のものが必要です。

  • アクティブなサブスクリプションが含まれる Azure アカウント。 Azure アカウントをお持ちでない場合は、無料で登録し、 従量課金制サブスクリプションにサインアップします。
  • 量子ワークスペースが保存されている Azure リソース グループ。
  • Quantum ワークスペースに関連付ける、リソース グループ内のストレージ アカウント。 複数のワークスペースを同じアカウントに関連付けることができます。
  • Azure CLI。
  • Microsoft Quantum Development Kit。

環境のセットアップ

  1. quantum Azure CLI 拡張機能をインストールします。 コマンド プロンプトを開き、次のコマンドを実行します。これにより、以前のバージョンが既にインストールされている場合も拡張機能がアップグレードされます。

    az extension add --upgrade -n quantum

  2. 自分の資格情報を使用して Azure にログインします。 アカウントに関連付けられているサブスクリプションの一覧が表示されます。

    az login

  3. 使用するサブスクリプションを指定します。

    az account set -s <Your subscription ID>

  4. サブスクリプションに Quantum ワークスペースを初めて作成する場合は、次のコマンドを使用してリソース プロバイダーを登録します。

    az provider register --namespace Microsoft.Quantum

Azure Quantum ワークスペースを作成する

新しい Azure Quantum ワークスペースを作成するには、次の情報が必要です。

  • リソースを配置する場所または Azure リージョンの名前。 Azure CLI ツールでサポートされているリージョンとリソース マネージャー コードの一覧を使用できます (例: westus)。
  • 新しいワークスペースに関連付けるリソース グループ (例: MyResourceGroup)。
  • Quantum ワークスペースと同じリソース グループおよびサブスクリプション内のストレージ アカウント。 Az CLI ツールを使用して新しいストレージ アカウントを作成できます (例: MyStorageAccount)。
  • 作成する Quantum ワークスペースの名前 (例: MyQuantumWorkspace)。
  • ワークスペースで使用する Azure Quantum プロバイダーの一覧。 プロバイダーは一連のプランを提供しますが、それぞれにはプランと、関連するご契約条件、費用、クォータが含まれます。 ワークスペースを作成するには、無料クレジットを提供するプロバイダーから始める場合を除き、対応するプランをプロバイダーと共に指定する必要があります。これらはワークスペースに自動的に追加されます。

ワークスペースで使用するプロバイダーとプランの名前を既に知っている場合は、下の手順 4 に進んでください。 無料クレジットを提供するプロバイダーで始める場合は、次のコマンドを入力できます。

az quantum workspace create \
   -l MyLocation \
   -g MyResourceGroup \
   -w MyQuantumWorkspace \
   -a MyStorageAccount

利用規約に同意するように求められる場合があります。 契約条件に同意するには、Y と入力します。 以下の手順 4 で示す -r パラメーターは必須ではないことに注意してください。

使用するプロバイダーとプランを決定する必要がある場合は、次の手順に従います。

  1. 使用可能な量子プロバイダーの一覧を取得するには、list コマンドを使用します (この例では、場所として westus を使用)。

    az quantum offerings list \
     -l westus \
     -o table

    ヒント

    無料クレジットを提供するプロバイダーを確認する場合は、--autoadd-only パラメーターを使用します。次に例を示します。
    az quantum offerings list --autoadd-only -l westus -o table
    前述のように、これらのプロバイダーはワークスペースに自動的に追加されます。 これらを -r パラメーターで指定する必要はありません。

  2. ワークスペースに含めるプロバイダーとプランを決定したら、show-terms コマンドを使用して条項を確認できます (値の例として MyProviderID と MyPlan を追加)。

    az quantum offerings show-terms \
     -l westus \
     -p MyProviderId \
     -k MyPlan

  3. show-terms コマンドの出力には、このプロバイダーの条項が既に受け入れられているかどうかを示すブール値フィールド accepted と、ライセンス条項を確認するためのリンクが含まれています。 それらの条項に同意する場合は、accept-terms コマンドを使用して同意を記録します。

    az quantum offerings accept-terms \
     -l westus \
     -p MyProviderId \
     -k MyPlan

  4. 必要なすべての条項と条件を確認して同意すると、次の例に示すように、create コマンドを使用し、プロバイダーとプランの組み合わせの一覧をコンマで区切って指定して、ワークスペースを作成できます。

    az quantum workspace create \
     -l westus \
     -g MyResourceGroup \
     -w MyQuantumWorkspace \
     -a MyStorageAccount \
     -r "MyProvider1/MyPlan1, MyProvider2/MyPlan2"

ワークスペースを作成した後も、Azure portalを使用してプロバイダーを追加または削除できます。

Quantum ワークスペースの既定のストレージ アカウントを変更する

既存のワークスペースの既定のストレージ アカウントを変更する必要がある場合は、create コマンドを使用できます。その際、現在のすべてのプロパティと新しいストレージ アカウントを指定します。 次の例では、前の例で作成したワークスペースと同じ設定を使用します。

az quantum workspace create \
   -l westus \
   -g MyResourceGroup \
   -w MyQuantumWorkspace \
   -a MyNEWStorageAccount \
   -r "MyProvider1/MyPlan1, MyProvider2/MyPlan2"

重要

この手順では、実際には新しいストレージ アカウントを使用してワークスペースを再作成します。 ストレージ アカウント以外のすべてのプロパティが元のプロパティとまったく同じであることを確認します。それ以外の場合は、2 つ目のワークスペースが作成されます。

Quantum ワークスペースを削除する

削除する Quantum ワークスペースの名前とリソース グループがわかっている場合は、delete コマンドを使用して実行できます (前の例と同じ名前を使用)。

az quantum workspace delete \
   -g MyResourceGroup \
   -w MyQuantumWorkspace

ヒント

正確な名前を覚えていない場合は、az quantum workspace list -o table を使用して、サブスクリプション内の Quantum ワークスペースの一覧を確認できます。

ワークスペースを削除しても、クラウドで削除されている間も一覧表示されます。 ただし、ワークスペースの provisioningState プロパティは、削除中であることを示すためにすぐに変更されます。 この情報は、show コマンドを使用して確認できます。

az quantum workspace show \
   -g MyResourceGroup \
   -w MyQuantumWorkspace

Note

前に az quantum workspace set コマンドを使用して既定の Quantum ワークスペースを指定した場合は、パラメーターを指定せずに delete コマンドを呼び出すと、既定のワークスペースが削除 (クリア) されます。

az quantum workspace delete

次のステップ

ワークスペースを作成および削除できるようになったので、Azure Quantum で量子アルゴリズムを実行するためのさまざまなtargets方法について説明します。