Azure Quantum ワークスペースに接続するさまざまな方法
Azure Quantum ワークスペースを作成したら、それに接続し、Python パッケージを使用してコードをazure-quantum
送信できます。 パッケージにはazure-quantum
、Workspace
Azure Quantum ワークスペースを表すクラスが用意されています。
ワークスペースにアクセスするその他の方法については、「 サービス プリンシパルを使用した認証 」または 「マネージド ID を使用した認証」を参照してください。
前提条件
アクティブなサブスクリプションが含まれる Azure アカウント。 Azure アカウントをお持ちでない場合は、無料で登録し、 従量課金制サブスクリプションにサインアップします。
Azure Quantum ワークスペース。 「Azure Quantum ワークスペースを作成する」をご覧ください。
Azure Quantum
azure-quantum
パッケージの最新バージョン。python -m pip install --upgrade azure-quantum
Azure CLI を使用する場合は、最新バージョンが必要です。 インストール手順については、以下を参照してください。
接続文字列を使用して接続する
接続文字列を使用して、Azure Quantum ワークスペースへの接続パラメーターを指定できます。 次のシナリオでは、接続文字列を使用できます。
- ワークスペースアクセスを、Azure アカウントを持たない他のユーザーと共有したいと考えています。
- 限られた期間、ワークスペースのアクセス権を他のユーザーと共有する必要があります。
- 会社のポリシーにより、Microsoft Entra IDを使用することはできません。
ヒント
すべての Azure Quantum ワークスペースには、 プライマリ キーとセカンダリ キーとそれに対応する接続文字列があります。 ワークスペースへの他のユーザーへのアクセスを許可する場合は、セカンダリ キーを共有し、独自のサービスにプライマリを使用できます。 これにより、必要に応じて、独自のサービスでダウンタイムを発生させることなく、セカンダリ キーを置き換えることができます。 ワークスペース アクセスの共有の詳細については、「ワークスペース アクセス を共有する」を参照してください。
接続文字列のコピー
Azure portal にログインし、Azure Quantum ワークスペースを選択します。
左側のパネルで、[操作アクセス キー] >に移動します。
アクセス キー を有効にする必要があります。 アクセス キーが無効になっている場合は、まずそれらを有効にする必要があります。 これを行う方法については、「 アクセス キーの管理」を参照してください。
[コピー] アイコンをクリックして、接続文字列をコピーします。 プライマリ 接続文字列またはセカンダリ 接続文字列を選択できます。
警告
アカウント アクセス キーまたは接続文字列をクリア テキストに格納すると、セキュリティ上のリスクが発生するためお勧めしません。 暗号化された形式でアカウント キーを格納するか、Azure Quantum ワークスペースへのアクセスにMicrosoft Entra承認を使用するようにアプリケーションを移行します。
接続文字列を使用して Azure Quantum ワークスペースにアクセスする
接続文字列をコピーしたら、それを使用して Azure Quantum ワークスペースに接続できます。
Python 環境を使用している場合は、Azure Quantum ワークスペースに接続するオブジェクトを作成 Workspace
できます。 オブジェクトを Workspace
作成するときは、Azure Quantum ワークスペースを識別するための 2 つのオプションがあります。
オブジェクトは、 を
Workspace
呼び出from_connection_string
すことで作成できます。# Creating a new Workspace object from a connection string from azure.quantum import Workspace connection_string = "[Copy connection string]" workspace = Workspace.from_connection_string(connection_string) print(workspace.get_targets())
コードに接続文字列をコピーしない場合は、環境変数に接続文字列を格納し、 を使用
Workspace()
することもできます。# Using environment variable to connect with connection string connection_string = "[Copy connection string]" import os os.environ["AZURE_QUANTUM_CONNECTION_STRING"] = connection_string from azure.quantum import Workspace workspace = Workspace() print(workspace.get_targets())
キーを有効または無効にして再生成する方法の詳細については、「 アクセス キーの管理」を参照してください。
重要
アクセス キーが無効になっている場合、接続文字列またはアクセス キーを使用するすべての要求は承認されていません。 引き続きワークスペース パラメーターを使用して、ワークスペースに接続できます。
ワークスペース パラメーターを使用して接続する
すべての Azure Quantum ワークスペースには、それに接続するために使用できる一意のパラメーター セットがあります。 次のパラメーターを使用して、Azure Quantum ワークスペースに接続できます。
パラメーター | 説明 |
---|---|
subscription_id |
Azure サブスクリプション ID。 |
resource_group |
Azure リソース グループ名です。 |
name |
Azure Quantum ワークスペースの名前。 |
location |
Azure Quantum ワークスペースがプロビジョニングされている Azure リージョン。 これは、"米国東部" などのリージョン名、または "eastus" などの場所名として指定できます。 |
resource_id |
Azure Quantum ワークスペースの Azure リソース ID。 |
ワークスペース パラメーターは、Azure portalの Azure Quantum ワークスペースの概要に関するページで確認できます。
Azure アカウントにログインします。 https://portal.azure.com
Azure Quantum ワークスペースを選択し、[ 概要] に移動します。
フィールドのパラメーターをコピーします。
ワークスペース パラメーターを使用して Azure Quantum ワークスペースに接続する
Workspace
Azure Quantum ワークスペースに接続するオブジェクトを作成します。 オブジェクトを Workspace
作成するときは、Azure Quantum ワークスペースを識別するための 2 つのオプションがあります。
場所とリソース ID (推奨) を指定できます。
from azure.quantum import Workspace workspace = Workspace( resource_id = "", # Add the resource ID of your workspace location = "" # Add the location of your workspace (for example "westus") )
場所、サブスクリプション ID、リソース グループ、ワークスペース名を指定できます。
from azure.quantum import Workspace workspace = Workspace( subscription_id = "", # Add the subscription ID of your workspace resource_group = "", # Add the resource group of your workspace workspace_name = "", # Add the name of your workspace location = "" # Add the location of your workspace (for example "westus") )
次の手順
フィードバック
https://aka.ms/ContentUserFeedback」を参照してください。
以下は間もなく提供いたします。2024 年を通じて、コンテンツのフィードバック メカニズムとして GitHub の issue を段階的に廃止し、新しいフィードバック システムに置き換えます。 詳細については、「フィードバックの送信と表示