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

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

前提条件

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

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

環境のセットアップ

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

   az extension add --upgrade -n quantum
   

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

   az login
   

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

   az account set -s <Your subscription ID>
   

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

   az provider register --namespace Microsoft.Quantum
   

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

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

• リソースを作成する場所または Azure リージョン名。 Azure CLI ツールでサポートされているリージョンとリソース マネージャー コードの一覧を使用できます (例: westus)。
• 新しいワークスペースに関連付けられているリソース グループ 。たとえば、myResourceGroup 。
• 量子ワークスペースと同じリソース グループとサブスクリプション内のストレージ アカウント。 MyStorageAccountなど、Az CLI ツール から新しいストレージ アカウントを作成できます。
• 作成する量子ワークスペースの名前、たとえば、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"

量子ワークスペースを削除する

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

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

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

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

az quantum workspace delete

次のステップ

ワークスペースを作成および削除できるようになったので、Azure Quantum targets について説明します。