ログイン情報を保存する

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

開始前に

1. Python の稼働環境下で作業していることを確認し、 および qiskit パッケージ qiskit-ibm-runtime がインストールされていることを確認してください。
2. Python 仮想環境をアクティブにし、仮想環境で Python を実行します。
3. IBM Quantum Platform にログインしてください。

アクセス認証情報をお探しください

1. ヘッダーのアカウントスイッチャーで、正しいアカウントと地域が選択されていることを確認してください。
2. APIキーを検索します。 ダッシュボードから APIキーを作成し、安全な場所にコピーして認証に使用できるようにします。 同じAPIキーを使ってどの地域にも接続できることに注意してください。
3. オプション： Instances ページから使用するインスタンスを探します。 その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
)

使用可能なオプション

• token: IBM Cloud APIキー。 あなたのトークンは秘密です。 公開コードでトークンを共有しないでください。
• instance:オプションで、 IBM Cloud CRNまたはインスタンス名で使用するインスタンスを指定する。
• plans_preference:オプションで優先するプランの種類を設定します。 インスタンスが指定されている場合は無視される。 利用可能なオプションは、 open、 pay-as-you-go、 flex、 premium、 on-prem。 プラン名が指定されていない場合、特定のプランタイプのインスタンスは除外されます。 例えば [open] を渡すと、オープン・プラン・インスタンスのみが利用可能です。 instance が指定されている場合は無視される。
• region:オプションで使用する地域を設定する。 使用可能な値は us-east と eu-de。 instance が指定されている場合は無視される。
• tags:オプションでインスタンスのタグを指定する。 タグ名文字列のリストを受け取る。 instance が指定されている場合は無視される。
• name:オプションで、このアカウント認証情報のセットに名前を付ける。
• set_as_default:デフォルトの認証情報として保存するには、値を True に設定します。 アカウントを1つだけ保存した場合、そのアカウントは自動的にデフォルトとして設定されます。
• overwrite:デフォルトの認証情報を更新するには、この値を True に設定します。

例

例 1

この例では、特定のインスタンスの認証情報を保存し、オープンとプレミアムアクセスを許可している。 オープン資格情報はデフォルトとして設定されている。

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 をインスタンス化するたびに）、その認証情報を指定する必要があります。
• 認証情報を手動で指定した場合、保存されたアカウントは使用されません。

次のステップ