インスタンスの作成と管理
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を選択します。
インスタンスを編集できるのは管理者とオーナーだけです。 アクセス権の割り当てについては、「 アクセスポリシーとアクセスグループの作成 」ガイドを参照してください。
インスタンスでの Qiskit Functions へのアクセス設定
「Functions」タブとそのオプションは、アカウントに Qiskit Functions へのアクセス権が設定されている場合にのみ表示されます。 アカウントに Qiskit Functions へのアクセス権があるにもかかわらず、インスタンスごとの関数アクセス権を編集するオプションが表示されない場合は、そのアカウントはまだこの方式に移行されていないことを意味します。 移行をご希望の場合は、担当のエンゲージメントマネージャーまたはサポートチームまでご連絡ください。
インスタンスがアクセスできる Qiskit Functions を設定するには、 Resource Controller API を使用する方法（「 インスタンスでの Qiskit Functions へのアクセスを設定する」 を参照）か、 IBM Quantum Platform で以下の手順に従う方法があります。
- 「インスタンス」 ページに移動します。
- ヘッダーにあるアカウント切り替え機能で、正しいアカウントが選択されていることを確認してください。
- 関数へのアクセスを有効にしたいインスタンスを探してください。
- インスタンスの行の末尾にあるオーバーフローメニューをクリックし、「 詳細を編集 」を選択します。
- [関数] タブをクリックします。
- 「機能の有効化」を選択し、有効にしたい機能を選択してください。
- 各規約をお読みいただき、内容を確認してください。
- 「保存」 をクリックして変更を保存してください。
なお、お使いのアカウントで Qiskit Functions へのアクセス権限がある場合は、新しいインスタンスを追加する際にアクセス設定を行うこともできます。 [インスタンスの作成] をクリックし、表示されるウィンドウの手順に従ってください。 「Functions」ステップでは、カタログ関数やカスタム関数へのアクセスを有効にしたり、そのインスタンスがアクセスできる Qiskit Functions を指定したりすることができます。
デフォルトの権限とカスタム権限
IBM Quantum Platform でインスタンスの Qiskit Functions へのアクセス権を設定する際は、デフォルトのユーザーレベルの権限が適用されます。 デフォルトの権限を持つユーザーは、以下の操作を行うことができます：
- 関数とその詳細を表示する
- この関数を使用してジョブを送信する
- ユーザーワークスペースに保存されているファイルの一覧表示とダウンロード
- ユーザーワークスペース内の入力ファイルおよび結果ファイルをアップロード、更新、削除する
カスタム権限を割り当てるには、代わりに Resource Controller API を使用してください。 詳細については、「 インスタンスでの Qiskit Functions へのアクセス設定」 を参照してください。 APIリファレンスを表示するには、「 Functions」 タブで関数の権限の横にある情報アイコンをクリックし、ツールチップ内の「 APIリファレンスを表示」 リンクをクリックします。
カスタム権限が設定されているインスタンスの権限をデフォルトに戻すには、 Resource Controller を使用するか、 IBM Quantum Platform の [ インスタンス] ページで以下の手順に従って、その機能を削除してから再割り当てしてください
- インスタンスの行の末尾にあるオーバーフローメニューをクリックし、「 詳細を編集 」を選択します。
- [関数] タブをクリックします。
- カスタム権限を使用して、その関数へのアクセス権を削除します。
- 保存 をクリックします。
- 関数へのアクセス権を再割り当てするには、以下の手順を繰り返します。インスタンスの「 詳細の編集」 を選択し、「 関数 」タブをクリックして、対象の関数を選択し、「 保存 」をクリックします。 このインスタンスには、その関数に対するデフォルトのユーザーレベルの権限が設定されました。
アーカイブ済みインスタンス
アーカイブされたインスタンスは、以下のいずれかのシナリオの結果です。
特権ユーザーがアカウントをアーカイブしました
アカウントに対して十分な権限を持つユーザーがインスタンスをアーカイブしました。
- インスタンス内の保留中のジョブはすべてキャンセルされます。
- アーカイブされたインスタンスは、インスタンスページの独立した「アーカイブ」セクションに表示されます。
- ジョブはまだ取得可能です。
- ユーザーはアーカイブされたインスタンスに新しいジョブを送信できません。
- アーカイブされたインスタンスは、プランの割り当て量にはカウントされません。
- 十分な権限を持つユーザーは、自身（または他の特権ユーザー）がアーカイブしたインスタンスをいつでも再アクティブ化できます。
管理しているインスタンスをアーカイブするには、 インスタンスページに移動してください。 そのインスタンスの行の末尾で、右側の三点オーバーフローメニューをクリックし、 「インスタンスをアーカイブ」 を選択します。
アカウントはインスタンスのプランへのアクセス権を失いました
そのアカウントは、インスタンスが作成されたプランへのアクセス権を喪失しました。
- アーカイブされたインスタンスは、インスタンスページの独立した「アーカイブ」セクションに表示されます。
- ジョブはまだ取得可能です。
- ユーザーはアーカイブされたインスタンスに新しいジョブを送信できません。
- アーカイブされたインスタンスは、プランの割り当て量にはカウントされません。
- インスタンスの計画が可視化されなくなったためにアーカイブされたインスタンスは、再アクティブ化できません。
次のステップ
- アクセスグループを扱う。
- ユーザーを管理する。
- ログイン情報を保存してください。
- 信頼された Python 環境において、 IBM Quantum Compute Serviceを初期化します。
- 信頼できない環境で「 IBM Quantum 」コンピュート・サービスを初期化します。