ログイン認証情報を保存する

信頼できるPython環境（個人用ノートパソコンやワークステーションなど）で作業している場合は、save_account() メソッドを使用して認証情報をローカルに保存し、それを使用してサービスを初期化することができます。

注意事項

• 公共のコンピューターやその他の信頼できない環境を使用している場合は、代わりに信頼できない環境でのサービスの初期化の手順に従ってください。
• QiskitではなくREST APIを使用して接続する場合は、こちらの手順に従ってください。
• 必要に応じて、この情報を参照してファイアウォールを設定し、IBM Quantum APIエンドポイントへのアクセスを有効にしてください。

始める前に

1. qiskit および qiskit-ibm-runtime パッケージがインストールされたアクティブなPython環境で作業していることを確認してください。

2. Python仮想環境をアクティブにして、仮想環境内でPythonを実行してください。

3. IBM Quantum Platformにログインしてください。

アクセス認証情報を確認する

1. ヘッダーのアカウント切り替えで、正しいアカウントとリージョンが選択されていることを確認してください。

2. APIキーを確認してください。ダッシュボードでAPIキーを作成し、認証に使用できるよう安全な場所にコピーしてください。なお、同じAPIキーを使用してどのリージョンにも接続できます。

3. 任意：使用するインスタンスをインスタンスページから確認してください。そのCRNにカーソルを合わせ、コピーアイコンをクリックして、インスタンスを識別するために使用できるよう安全な場所に保存してください。

アクセス認証情報を保存する

保存したいアカウントごとに1回、適切なコードを実行して認証情報を保存してください。認証情報を保存した後は、IBM Quantum Compute Serviceの初期化の手順に従って認証情報を読み込んでください。

特定のインスタンスにアクセスする認証情報を保存する:

複数のインスタンスがあり、Quantum Computeに使用するインスタンスを簡単に指定したい場合は、インスタンスCRNを含む認証情報を保存してください。

from qiskit_ibm_runtime import QiskitRuntimeService

QiskitRuntimeService.save_account(
  # For `token`, use the 44-character API_KEY you created 
  # and saved from the IBM Quantum Platform Home dashboard:
  token="<your-api-key>", 
  name="<account-name>", # Optional
  instance="<IBM Cloud CRN or instance name>", # Optional
  set_as_default=True, # Optional
  overwrite=True, # Optional
)

自動インスタンス選択のための認証情報を保存する:

インスタンスCRNを指定せずにこれらの認証情報をQuantum Computeに渡すと、指定されたオプションに基づいて適切なインスタンスが自動的に選択されます。

from qiskit_ibm_runtime import QiskitRuntimeService

QiskitRuntimeService.save_account(
  # For `token`, use the 44-character API_KEY you created 
  # and saved from the IBM Quantum Platform Home dashboard:
  token="<your=api-key>", 
  name="<account-name>", # Optional
  instance="<instance-to-use>", # Optional
  plans_preference="<plan_types>", # Optional
  region="<region>", # Optional
  tags="<instance-tags>", # Optional
  set_as_default=True, # Optional
  overwrite=True, # Optional
)

Available options

• token: IBM Cloud API key. Your token is confidential. Do not share your token in public code.
• instance: Optionally specify the instance to use through its IBM Cloud CRN or instance name.
• plans_preference: Optionally set the types of plans to prioritize. This is ignored if the instance is specified. Available options are open, pay-as-you-go, flex, premium, and on-prem. Instances of a certain plan type are excluded if the plan name is not specified. For example, if [open] is passed in, only Open Plan instances are available. This is ignored if instance is specified.
• region: Optionally set the region to use. Accepted values are us-east and eu-de. This is ignored if instance is specified.
• tags: Optionally specify the instance's tags. Accepts a list of tag name strings. This is ignored if instance is specified.
• name: Optionally name this set of account credentials.
• set_as_default: Set the value to True to save these as your default credentials. If you save only one account, it is automatically set as the default.
• overwrite: Set this value to True to update your default credentials.

Examples

Example 1

This example saves credentials for specific instances, which allow open and premium access. The open credentials are set as the default.

from qiskit_ibm_runtime import QiskitRuntimeService

QiskitRuntimeService.save_account(token="<API_TOKEN>", 
                                  instance="<CRN_for_premium_instance>",
                                  name="premium")
QiskitRuntimeService.save_account(token="<API_TOKEN>", 
                                  instance="<CRN_for_open_instance>",
                                  name="open", set_as_default=True)

例2

この例では、自動インスタンス選択のための認証情報を保存します。Quantum Computeは、アカウントで利用可能なEUリージョンのプレミアムインスタンスのみを検索します。この認証情報が新しいデフォルトになります。

QiskitRuntimeService.save_account(
    token="your-api-key",
    set_as_default=True,
    overwrite = True,

    # Set instance "filters" instead of specifying the instance:
    region="eu-de",
    plans_preference=["premium"]
  )

保存された認証情報を確認する

保存したすべての認証情報を表示するには、service.saved_accounts() を実行してください。デフォルトの認証情報を保存して名前を付けなかった場合は、default-ibm-quantum-platform という名前が付きます。デフォルトの認証情報に名前を付けた場合は、出力に "is_default_account": true が表示されます。

注意事項

• 複数のアカウントを保存する場合は、name パラメーターを使用して区別してください。

• 認証情報は $HOME/.qiskit/qiskit-ibm.json に保存されます。このファイルを手動で編集しないでください。

• 認証情報を保存しない場合は、新しいセッションを開始するたびに（IBM Quantum Compute Serviceをインスタンス化するたびに）認証情報を指定する必要があります。

• 認証情報を手動で指定した場合、保存されたアカウントは使用されません。

次のステップ

推奨事項

• 信頼できるPython環境でIBM Quantum Compute Serviceを初期化する。
• 信頼できない環境でIBM Quantum Compute Serviceを初期化する。
• 利用可能なQPUを確認する。
• Qiskit SDKをローカルで設定する。
• ハードウェアで最初の回路を実行するガイドの手順に従って、量子プログラムを作成して実行する。
• REST APIでIBM Quantum Platformを使用するためのセットアップ。
• チュートリアルを試してみる。