インスタンスの作成と管理
IBM Quantum Platform サービスへのアクセスは、割り当てられたインスタンスによって制御されます。 ユーザーは複数のインスタンスに所属することができます。
インスタンスとは、量子プログラムの実行や、エラー軽減処理などの古典的計算タスクを含む、ワークロードの実行を管理する仮想サーバー（ IBM Quantum Compute Serviceのデプロイメント）のことです。 インスタンスは、そのクラウドリソース名 （ CRN ）によって識別されます。 この CRN は、Qiskitプログラムからワークロードを送信する際に使用できます。
アクセス可能なインスタンスは、ダッシュボードで確認するか、ダッシュボードから「インスタンス」タブをクリックすることで確認できます。 各インスタンスはCRN識別子とともにリストされる。
利用するサービスプラン（オープンや従量制など）ごとに、利用する地域ごとに異なるインスタンスが必要です。 アカウント管理者と十分な権限を持つ人は、インスタンスを作成し、その割り当て、使用量制限、量子コンピュータ、ユーザー権限などの構成を定義できます。
IBM Quantum Platform ダッシュボードには、アクセス権限を持つインスタンスが表示されます。 アクセス権に応じて、 インスタンスページでインスタンスの詳細をすべて表示、編集、削除できます。
どのインスタンスを使用しているかを把握しておくことが重要です。なぜなら、Open Planに関連付けられていないすべてのインスタンスには費用が発生する（または、プランに割り当てられた利用時間にカウントされる）からです。
オープンプランインスタンス
Open Planのユーザーは、世界最高水準のQPUで量子回路を無料で実行できます（28日間のローリング期間につき最大10分間）。 QPUの使用状況は、プラットフォームのダッシュボードおよび 「ワークロード 」ページで確認できます。
従量課金プランのインスタンス
「Pay-As-You-Goプラン」は有料プランです。 このプランを使用するには、インスタンスを作成し、そのインスタンスをプランに割り当てる必要があります。 このプランを使用してQPUに送信されるすべてのワークロードには、料金が発生します。 従量課金型インスタンスには、総コストの上限を設定することができます（任意）。
Flex Plan インスタンス
Flexプランは有料プランです。 このプランをご利用になるには、まず IBM までご連絡の上、お申し込みください。 次に、インスタンスを作成し、それをプランに割り当てます。 このプランを使用してQPUに送信されるすべてのワークロードは、割り当てられたサブスクリプションの枠にカウントされます。
管理者は、Flex Planのインスタンスに対して、契約期間中有効な利用制限を設定できます。 管理者がインスタンスを「制限付き」として設定した場合（使用状況エリアに「残り」列が表示されます）、そのインスタンスが（管理者が定義した）割り当て量を超過しても、アクティブなワークロード（セッションを含む）は引き続き実行されますが、保留中のワークロードは、空き容量が確保されるまでキューに残ったままとなります。 インスタンスにリソース制限が設定されておらず、そのインスタンスが割り当てられたリソース量を超過した場合、そのインスタンスで実行されるジョブは優先度が低下し、キュー待ち時間が長くなる可能性があります。
インスタンスの使用量が割り当てを超えた場合、アラートが表示されます。
プレミアムプランのインスタンス
プレミアムプランは有料プランです。 このプランをご利用になるには、まず IBM までご連絡の上、お申し込みください。 次に、インスタンスを作成し、それをプランに割り当てます。 このプランを使用してQPUに送信されるすべてのワークロードは、割り当てられたサブスクリプションの枠にカウントされます。
管理者は、プレミアムプランのインスタンスに対して、そのプランの28日間のローリング利用期間に適用される利用制限を設定できます。 管理者がインスタンスを「制限付き」として設定した場合（使用状況エリアに「残り」列が表示されます）、そのインスタンスが（管理者が定義した）割り当て量を超過しても、アクティブなワークロード（セッションを含む）は引き続き実行されますが、保留中のワークロードは、空き容量が確保されるまでキューに残ったままとなります。 インスタンスにリソース制限が設定されておらず、そのインスタンスが割り当てられたリソース量を超過した場合、そのインスタンスで実行されるジョブは優先度が低下し、キュー待ち時間が長くなる可能性があります。
インスタンスの使用量が割り当てを超えた場合、アラートが表示されます。
コード内でインスタンスを指定してください
サービスの初期化時、またはワークロードをQPUに送信する際（例： `QiskitRuntimeService.backend() を使用する場合）、CRNまたはインスタンス名を使用して、使用するインスタンスを指定できます。コード内でインスタンスを指定する方法については、 「アカウントの初期化」 を参照してください。
インスタンスが渡された場合、そのインスタンスのバックエンドとジョブのみが利用可能になります（ v0.40.1 以降で許可されています qiskit-ibm-runtime ）。
サービスを初期化する際にインスタンスを含めない場合、アカウント内の全インスタンスにまたがるすべてのバックエンドとジョブが利用可能になります。 この場合、バックエンドが指定されると、 「インスタンスの自動選択 」で説明されているように、そのバックエンドにアクセス可能なインスタンスが検索され使用されます。
Qiskit Runtime v0.40.1 またはそれ以降が必要：
- インスタンス名を使ってインスタンスを指定する
- インスタンスを渡さない
- 優先インスタンスタイプと地域の設定
Qiskit Runtime v0.42 以降では、 インスタンスの自動選択時に無料プランがデフォルトで優先されます。
インスタンスの作成
以下の手順に従って、インスタンスを作成し、アカウントに追加してください。 組織向けに「Quantum Compute on Cloud」を設定する必要がある管理者の場合は、「 組織向けのQuantum Computeの計画」 を参照してください。
-
アカウントにインスタンスを追加するには、まずヘッダーのアカウントスイッチャーで正しいアカウントとリージョンが選択されていることを確認します。
- 複数の IBM Cloud アカウントを持つことができます。 期待するインスタンスやジョブが表示されない場合は、別のアカウントをお試しください。
- 同じAPIキーを使用してどちらのリージョンにもアクセスできますが、ログインしているリージョンで作成されたインスタンスしか表示およびアクセスできません。
- オープン・インスタンスを作成する場合は、US-EASTリージョンを選択する必要があります。
「 IBM Quantum Platform 」
地域についてインスタンスは選択された地域に作成される。 この地域はこれらの重要な特徴を決定する：
- どのQPUが使用可能か。
- コンパイルなど、ジョブの古典的な計算が行われる場所。
- ユーザーのワークフローデータが残る場所。
ワークフローのデータには、入力回路、回路パラメータ、量子計算結果が含まれる。 ショット数、回路サイズ、その他のジョブ統計などのメタデータは含まれない。
ユーザーのワークフローデータがグローバルな分散型サービス拒否保護レイヤーにさらされるのを避けるために、 仮想プライベートエンドポイントを使用することができます。
qiskit-ibm-runtimeprivate_endpointパラメータ を通してこれをサポートしている。 -
ダッシュボードの［Instances］ペインで［ View all］をクリックするか、メインメニューから ［Instances］ ページに移動します。
-
インスタンス]ページで、[ インスタンスの作成] をクリックします。
- 名前を入力し、オプションでタグを追加する。
- IBM Cloud®、複数のリソース・グループにアクセスできる場合、このインスタンスが属するリソース・グループを変更することができます。 詳しくは、 リソースグループの管理とリソースグループ内のリソースへのアクセス権を参照してください。
-
このインスタンスに関連付けられている料金プランを選択してください（例：従量課金制）。 選択した料金プランに応じて、このインスタンスに割り当てるコスト上限や利用可能時間などのオプションを指定できます。 なお、このインスタンスが無料プランに関連付けられていない場合、このインスタンスを使用してワークロードを実行すると、費用が発生します。
-
次へ をクリックします。 インスタンスがアクセスできるQPUのリストが表示されます。
- インスタンスがリストされたすべてのQPU（および今後このプランに追加されるすべてのQPU）にアクセスできるようにする場合は、[ Next] をクリックします。
- オープン・インスタンスをセットアップしていない場合は、このインスタンスでアクセスできるQPUをカスタマイズできます。 Customize allocated compute resources "トグルをクリックします。 このインスタンスがアクセスできる特定のQPUを選択し、[ Next] をクリックします。
Note
割り当てられたコンピュートリソースをカスタマイズした場合、利用可能なQPUは、親プランに加えられた変更に関係なく、自動的に更新されることはありません。 ただし、QPUの追加や削除は後で手動で行うことができる。 カスタマイズしない場合、そのアカウントがプラン上でアクセスできるすべてのQPUに常にアクセスできます。 そのため、将来新しいQPUがプランに追加された場合、インスタンスは自動的にそのQPUにアクセスできる。
-
アクセスグループペインが開きます。 このインスタンスに対して「協力者」アクセスグループが自動的に作成されます。 このアクセスグループに追加されたユーザーは、このインスタンスに割り当てられた時間を利用できます。 IBM Cloud コンソールを使用して、 アクセスグループを変更または追加で作成できます。 アクセスグループの設定方法については、設定手順を参照してください。
-
Create instanceをクリックします。 インスタンス・ ページでインスタンスを表示できるようになりました。 アカウントに複数のプランを設定している場合、各プランタイプはインスタンステーブルに独自のタブを持ちます。
「インスタンス」テーブルの「保留中のワークロード」列には、このインスタンスのすべてのQPUにわたって現在キューに入れられているワークロードの数が表示されます。
インスタンスとその割り当てを編集する
インスタンスページでインスタンスを見つける。 インスタンスの行の最後にあるオーバーフローメニューをクリックし、Edit detailsを選択します。
インスタンスを編集できるのは管理者とオーナーだけです。 アクセス権の割り当てについては、「 アクセスポリシーとアクセスグループの作成 」ガイドを参照してください。
アーカイブ済みインスタンス
アーカイブされたインスタンスは、以下のいずれかのシナリオの結果です。
特権ユーザーがアカウントをアーカイブしました
アカウントに対して十分な権限を持つユーザーがインスタンスをアーカイブしました。
- インスタンス内の保留中のジョブはすべてキャンセルされます。
- アーカイブされたインスタンスは、インスタンスページの独立した「アーカイブ」セクションに表示されます。
- ジョブはまだ取得可能です。
- ユーザーはアーカイブされたインスタンスに新しいジョブを送信できません。
- アーカイブされたインスタンスは、プランの割り当て量にはカウントされません。
- 十分な権限を持つユーザーは、自身（または他の特権ユーザー）がアーカイブしたインスタンスをいつでも再アクティブ化できます。
管理しているインスタンスをアーカイブするには、 インスタンスページに移動してください。 そのインスタンスの行の末尾で、右側の三点オーバーフローメニューをクリックし、 「インスタンスをアーカイブ」 を選択します。
アカウントはインスタンスのプランへのアクセス権を失いました
そのアカウントは、インスタンスが作成されたプランへのアクセス権を喪失しました。
- アーカイブされたインスタンスは、インスタンスページの独立した「アーカイブ」セクションに表示されます。
- ジョブはまだ取得可能です。
- ユーザーはアーカイブされたインスタンスに新しいジョブを送信できません。
- アーカイブされたインスタンスは、プランの割り当て量にはカウントされません。
- インスタンスの計画が可視化されなくなったためにアーカイブされたインスタンスは、再アクティブ化できません。
次のステップ
- アクセスグループを扱う。
- ユーザーを管理する。
- ログイン情報を保存してください。
- 信頼された Python 環境において、 IBM Quantum Compute Serviceを初期化します。
- 信頼できない環境で「 IBM Quantum 」コンピュート・サービスを初期化します。