インスタンスの作成と管理
IBM Quantum Platform サービスへのアクセスは、あなたが割り当てられているインスタンスによって管理されます。ユーザーは複数のインスタンスに所属することができます。
インスタンスは仮想サーバー（IBM Quantum Compute Service のデプロイ）であり、量子プログラムの実行やクラシカルコンピュートタスク（エラー緩和の処理など）を含む、ワークロードの実行を管理します。インスタンスはクラウドリソース名（CRN）によって識別されます。この CRN は、Qiskit プログラムからワークロードを送信する際に使用できます。
ダッシュボードからアクセス可能なインスタンスを確認するか、ダッシュボードの「Instances」タブをクリックすることで確認できます。各インスタンスはその CRN 識別子とともに一覧表示されます。
使用するリージョンごと、使用するサービスプラン（Open や Pay-As-You-Go など）ごとに異なるインスタンスが必要です。アカウントマネージャーおよび十分な権限を持つユーザーは、インスタンスを作成し、割り当て、使用制限、量子コンピューター、ユーザー権限などの設定を定義できます。
IBM Quantum Platform のダッシュボードには、アクセス可能なインスタンスが表示されます。アクセス権限に応じて、Instances ページでインスタンスの詳細を確認、編集、削除することができます。
Open Plan に関連付けられていないすべてのインスタンスにはコストが発生する（またはプランの割り当て時間に計上される）ため、使用しているインスタンスを把握しておくことが重要です。
Open Plan インスタンス
Open Plan ユーザーは、世界最高峰の QPU 上で量子回路を無料で実行できます（28 日間のローリングウィンドウあたり最大 10 分）。QPU の使用状況は、Platform ダッシュボードおよびWorkloads ページで追跡できます。
Pay-As-You-Go Plan インスタンス
Pay-As-You-Go Plan は有料プランです。このプランを使用するには、インスタンスを作成してプランに割り当てる必要があります。このプランを使用して QPU に送信されたすべてのワークロードに料金が発生します。Pay-as-you-go インスタンスには合計コスト制限を設定できます（オプション）。
Flex Plan インスタンス
Flex Plan は有料プランです。このプランを使用するには、まずIBM にお問い合わせしてサインアップする必要があります。その後、インスタンスを作成してプランに割り当てます。このプランを使用して QPU に送信されたすべてのワークロードは、割り当てられたサブスクリプションに計上されます。
管理者は、契約期間中に適用される Flex Plan インスタンスの使用制限を設定できます。管理者によってインスタンスが「limited」としてマークされている場合（使用量エリアに「Remaining」列が表示されます）、インスタンスが割り当て（管理者が定義）を超えると、アクティブなワークロードは引き続き実行されます（セッションを含む）が、保留中のワークロードは時間が利用可能になるまでキューに残ります。インスタンスに制限が設定されておらず、割り当てを超えた場合、そのインスタンスで実行されるジョブは優先度が低くなり、キュー待ち時間が長くなる可能性があります。
インスタンスの使用量が割り当てを超えると、アラートが表示されます。
Premium Plan インスタンス
Premium Plan は有料プランです。このプランを使用するには、まずIBM にお問い合わせしてサインアップする必要があります。その後、インスタンスを作成してプランに割り当てます。このプランを使用して QPU に送信されたすべてのワークロードは、割り当てられたサブスクリプションに計上されます。
管理者は Premium Plan インスタンスに使用制限を設定できます。この制限は、プランの 28 日間のローリング使用ウィンドウに適用されます。管理者によってインスタンスが「limited」としてマークされている場合、使用量エリアに「Remaining」列が表示されます。インスタンスが「limited」としてマークされており、管理者が設定した制限を超えた場合、保留中のワークロードは時間が利用可能になるまでキューに残りますが、session modeのワークロードを含め、アクティブなワークロードは引き続き実行されます。
インスタンスに制限が設定されておらず、割り当てを超えた場合、そのインスタンスで実行されるワークロードは優先度が低くなり、キュー待ち時間が長くなる可能性が高くなります。
インスタンスの使用量が割り当てを超えると、アラートが表示されます。
コードでインスタンスを指定する
CRN またはインスタンス名を使用して、使用するインスタンスを指定できます。指定のタイミングは、サービスの初期化時、または QPU へのワークロード送信時（例：`QiskitRuntimeService.backend()）です。コードでインスタンスを指定する手順については、アカウントを初期化するを参照してください。
インスタンスが渡された場合、そのインスタンスのバックエンドとジョブのみが利用可能になります（qiskit-ibm-runtime v0.40.1以降で許可）。
サービスの初期化時にインスタンスが指定されない場合、アカウント内のすべてのインスタンスにわたるすべてのバックエンドとジョブが利用可能になります。この場合、バックエンドが指定されると、そのバックエンドにアクセスできるインスタンスがインスタンスの自動選択の説明に従って検索・使用されます。
以下の機能には Qiskit Runtime v0.40.1 以降が必要です。
-
インスタンス名を使用してインスタンスを指定する
-
インスタンスを渡さない
-
優先インスタンスタイプとリージョンを設定する
Qiskit Runtime v0.42 以降では、自動インスタンス選択が使用される場合、無料プランがデフォルトで優先されます。
インスタンスを作成する
以下の手順に従って、インスタンスを作成してアカウントに追加します。組織向けに Cloud 上で Quantum Compute を設定する必要がある管理者の方は、組織向け Quantum Compute の計画を参照してください。
-
アカウントにインスタンスを追加するには、まずヘッダーのアカウントスイッチャーで正しいアカウントとリージョンが選択されていることを確認します。
-
複数の IBM Cloud アカウントを持つ（またはその一部である）ことができます。期待するインスタンスやジョブが表示されない場合は、別のアカウントを試してください。
-
同じ API キーを使用してどちらのリージョンにもアクセスできますが、ログインしているリージョンで作成されたインスタンスのみを表示・アクセスできます。
-
Open インスタンスを作成する場合は、us-east リージョンを選択する必要があります。
リージョンについてインスタンスは選択されたリージョンに作成されます。このリージョンによって以下の重要な特性が決まります。
- 利用可能な QPU の種類。
- コンパイルなど、ジョブのクラシカル計算が実行される場所。
- ユーザーのワークフローデータが保存される場所。
ワークフローデータには、入力回路、回路パラメーター、量子計算結果が含まれます。ショット数、回路のサイズ、その他のジョブ統計などのメタデータは含まれません。
ユーザーのワークフローデータがグローバルな分散型サービス拒否（DDoS）保護レイヤーに公開されないようにするには、Virtual Private Endpoints を使用できます。
qiskit-ibm-runtimeはprivate_endpointパラメーターを通じてこれをサポートしています。 -
-
ダッシュボードの Instances ペインから View all をクリックするか、メインメニューから Instances ページに移動します。
-
Instances ページから Create instance をクリックします。
-
名前を入力し、オプションでタグを追加します。
-
IBM Cloud® で複数のリソースグループにアクセスできる場合、このインスタンスが属するリソースグループを変更できます。詳細については、リソースグループの管理およびリソースグループ内のリソースへのアクセス権の付与を参照してください。
-
-
このインスタンスに関連付ける料金プラン（例：Pay-As-You-Go）を選択します。選択した料金プランに応じて、コスト制限やこのインスタンスに割り当てる分数など、他のオプションを指定できます。このインスタンスが無料プランに関連付けられていない場合、ワークロードの実行に使用するとコストが発生することに注意してください。
-
Next をクリックします。インスタンスがアクセスできる QPU の一覧が表示されます。
-
インスタンスが一覧表示されたすべての QPU（および将来このプランに追加されるすべての QPU）にアクセスできるようにする場合は、Next をクリックします。
-
Open インスタンスを設定していない場合、このインスタンスでアクセスできる QPU をカスタマイズできます。「Customize allocated compute resources」トグルをクリックします。このインスタンスがアクセスできる特定の QPU を選択し、Next をクリックします。
備考割り当てたコンピュートリソースをカスタマイズした場合、親プランに変更が加えられても、利用可能な QPU は自動的に更新されません。ただし、後から手動で QPU を追加または削除することができます。カスタマイズしない場合は、アカウントがそのプランでアクセスできる QPU に常にアクセスできます。そのため、将来プランに新しい QPU が追加された場合、インスタンスは自動的にそれへのアクセス権を取得します。
-
-
Access group ペインが開きます。このインスタンスのための「collaborators」アクセスグループが自動的に作成されます。このアクセスグループに追加されたユーザーは、このインスタンスに割り当てられた時間を使用できます。IBM Cloud コンソールを使用して、追加のアクセスグループを変更または作成できます。手順については、アクセスグループの設定を参照してください。
-
Create instance をクリックします。Instances ページでインスタンスを確認できるようになります。アカウントに複数のプランが設定されている場合、各プランタイプには Instances テーブルに独自のタブがあります。
Instances テーブルの「Pending workloads」列には、このインスタンスにおいてすべての QPU にわたって現在キューに入っているワークロードの数が表示されます。
インスタンスとその割り当ての編集
Instances ページでインスタンスを見つけます。インスタンスの行の末尾にあるオーバーフローメニューをクリックし、「Edit details」を選択します。
インスタンスを編集できるのは管理者とオーナーのみです。アクセス権の割り当てについては、アクセスポリシーとアクセスグループの作成ガイドを参照してください。
アーカイブされたインスタンス
アーカイブされたインスタンスは、以下のいずれかのシナリオによって生じます。
権限のあるユーザーがアカウントをアーカイブした場合
アカウントに対して十分な権限を持つユーザーがインスタンスをアーカイブしました。
- インスタンス内の保留中のジョブはキャンセルされます。
- アーカイブされたインスタンスは、Instances ページの「Archive」セクションに別途表示されます。
- ジョブは引き続き取得できます。
- ユーザーはアーカイブされたインスタンスに新しいジョブを送信できません。
- アーカイブされたインスタンスはプランの割り当てにカウントされません。
- 十分な権限を持つユーザーは、自分（または他の権限ユーザー）がアーカイブしたインスタンスをいつでも再アクティブ化できます。
管理しているインスタンスをアーカイブするには、Instances ページに移動します。該当インスタンスの行の末尾にある3点オーバーフローメニューをクリックし、Archive instance を選択します。
アカウントがインスタンスのプランへのアクセス権を失った場合
アカウントが、インスタンスが作成されたプランへのアクセス権を失いました。
-
アーカイブされたインスタンスは、Instances ページの「Archive」セクションに別途表示されます。
-
ジョブは引き続き取得できます。
-
ユーザーはアーカイブされたインスタンスに新しいジョブを送信できません。
-
アーカイブされたインスタンスはプランの割り当てにカウントされません。
-
インスタンスのプランへの参照権限がなくなったためにアーカイブされたインスタンスは、再アクティブ化できません。