Cipta dan urus instans

Akses kepada perkhidmatan IBM Quantum® Platform dikawal oleh instans yang anda ditetapkan kepadanya. Pengguna boleh menjadi ahli beberapa instans.

Instans ialah pelayan maya (penempatan IBM Quantum Compute Service) yang menguruskan pelaksanaan beban kerja anda, termasuk melaksanakan program kuantum dan tugas pengkomputeran klasik (seperti memproses mitigasi ralat). Instans dikenal pasti oleh Cloud Resource Name (CRN) mereka. CRN ini boleh digunakan semasa menghantar beban kerja dari program Qiskit anda.

Anda boleh melihat instans yang anda ada akses di papan pemuka, atau dengan mengklik tab "Instances" dari papan pemuka. Setiap instans disenaraikan dengan pengecam CRN-nya.

Anda memerlukan instans yang berbeza untuk setiap pelan perkhidmatan (seperti Open atau Pay-As-You-Go) yang anda gunakan di setiap rantau yang ingin anda gunakan. Pengurus akaun dan sesiapa yang mempunyai kebenaran yang mencukupi boleh mencipta instans dan menentukan konfigurasinya, seperti peruntukan, had penggunaan, komputer kuantum, dan kebenaran pengguna.

Papan pemuka IBM Quantum Platform memaparkan instans yang anda ada akses. Bergantung pada akses anda, anda boleh melihat butiran penuh, mengedit, dan memadam instans di halaman Instances.

Adalah penting anda faham instans mana yang anda gunakan, kerana semua instans yang tidak berkaitan dengan Open Plan menanggung kos (atau dikira ke arah masa yang diperuntukkan untuk pelan anda).

nota

Kerja yang anda jalankan dan kerja yang dijalankan oleh rakan kolaborator lain dalam instans yang sama dikira ke arah penggunaan yang dilaporkan untuk instans tersebut.

Anda boleh melihat penggunaan instans di halaman Instances, atau, bagi mereka yang mempunyai autoriti yang sesuai, di halaman Analytics. Perhatikan bahawa halaman-halaman tersebut mungkin menunjukkan nombor penggunaan yang berbeza kerana halaman Instance menunjukkan jumlah penggunaan sebelum cap masa semasa, manakala halaman Analytics menggunakan sempadan hari penuh.

Instans Open Plan

Pengguna Open Plan boleh menjalankan litar kuantum pada QPU terbaik di dunia secara percuma (setara unit sumber (RU) bagi 10 minit penggunaan unit pemprosesan kuantum (QPU) setiap tetingkap bergulir 28 hari). Penggunaan boleh dipantau di halaman Platform dashboard dan Workloads.

Instans Pay-As-You-Go Plan

Pay-As-You-Go Plan ialah pelan berbayar. Untuk menggunakan pelan ini, anda mesti mencipta instans dan menetapkannya kepada pelan tersebut. Semua beban kerja yang dihantar ke QPU menggunakan pelan ini menanggung caj. Instans Pay-as-you-go boleh mempunyai had jumlah kos (pilihan).

Instans Flex Plan

Flex Plan ialah pelan berbayar. Untuk menggunakan pelan ini, anda mesti terlebih dahulu Hubungi IBM untuk mendaftar. Kemudian, cipta instans dan tetapkannya kepada pelan tersebut. Semua beban kerja yang dihantar ke QPU menggunakan pelan ini dikira ke arah langganan yang diperuntukkan untuk anda.

Pentadbir boleh menetapkan had penggunaan pada instans Flex Plan yang terpakai untuk sepanjang tempoh kontrak. Jika instans telah ditandakan sebagai "terhad" oleh pentadbir anda (anda akan melihat lajur "Remaining" dalam kawasan penggunaan) dan instans melebihi peruntukkannya (ditakrifkan oleh pentadbir anda), sebarang beban kerja yang aktif akan terus berjalan (termasuk Session) tetapi beban kerja yang belum dilaksanakan akan kekal dalam giliran sehingga lebih banyak masa tersedia. Jika instans tidak terhad dan instans melebihi peruntukkannya, kerja yang dijalankan dengan instans tersebut berkemungkinan berjalan dengan keutamaan lebih rendah dan mengalami masa giliran yang lebih lama.

Amaran dipaparkan pada penggunaan instans apabila ia melebihi peruntukkannya.

Instans Premium Plan

Premium Plan ialah pelan berbayar. Untuk menggunakan pelan ini, anda mesti terlebih dahulu Hubungi IBM untuk mendaftar. Kemudian, cipta instans dan tetapkannya kepada pelan tersebut. Semua beban kerja yang dihantar ke QPU menggunakan pelan ini dikira ke arah langganan yang diperuntukkan untuk anda.

Pentadbir boleh menetapkan had penggunaan pada instans Premium Plan yang terpakai untuk tetingkap penggunaan bergulir 28 hari pelan tersebut. Jika instans telah ditandakan sebagai "terhad" oleh pentadbir anda, anda akan melihat lajur "Remaining" dalam kawasan penggunaan. Jika instans anda telah ditandakan "terhad" dan melebihi had yang ditetapkan oleh pentadbir anda, sebarang beban kerja yang belum dilaksanakan akan kekal dalam giliran sehingga lebih banyak masa tersedia; walau bagaimanapun, sebarang beban kerja yang aktif akan terus berjalan, termasuk beban kerja dalam session mode.

Jika instans tidak terhad dan instans melebihi peruntukannya, beban kerja yang dijalankan dengan instans tersebut berkemungkinan berjalan dengan keutamaan lebih rendah dan mengalami masa giliran yang lebih lama.

Amaran dipaparkan pada penggunaan instans apabila ia melebihi peruntukkannya.

Tentukan instans dalam kod anda

Anda boleh menggunakan CRN atau nama instans untuk menentukan instans yang hendak digunakan — sama ada semasa memulakan perkhidmatan, atau semasa menghantar beban kerja ke QPU (contohnya, dengan `QiskitRuntimeService.backend()). Untuk arahan menentukan instans dalam kod anda, lihat Mulakan akaun anda.

Apabila instans dihantar masuk, hanya Backend dan kerja dari instans tersebut yang tersedia (dibenarkan dalam qiskit-ibm-runtime v0.40.1 dan ke atas).

Jika instans tidak disertakan semasa memulakan perkhidmatan, semua Backend dan kerja dari semua instans dalam akaun anda tersedia. Dalam kes ini, apabila Backend ditentukan, instans yang boleh mengakses Backend dijumpai dan digunakan seperti yang diterangkan dalam Pilih instans secara automatik.

Versi yang diperlukan

Qiskit Runtime v0.40.1 atau lebih baru diperlukan untuk yang berikut:

• Menggunakan nama instans untuk menentukan instans

• Tidak menghantar instans

• Menetapkan jenis instans dan rantau pilihan

Untuk Qiskit Runtime v0.42 atau lebih baru, pelan percuma diutamakan secara lalai apabila pemilihan instans automatik digunakan.

Cipta instans

Ikut langkah-langkah ini untuk mencipta instans dan menambahkannya ke akaun anda. Jika anda pentadbir yang perlu menyediakan Quantum Compute on Cloud untuk organisasi anda, rujuk Rancang Quantum Compute untuk organisasi.

1. Untuk menambah instans ke akaun anda, pastikan dahulu anda telah memilih akaun dan rantau yang betul dalam penukar akaun di pengepala.

   • Anda boleh mempunyai (atau menjadi sebahagian daripada) beberapa akaun IBM Cloud. Jika anda tidak nampak instans atau kerja yang dijangkakan, cuba akaun yang berbeza.

   • Anda boleh mengakses mana-mana rantau menggunakan kunci API yang sama, tetapi anda hanya boleh melihat dan mengakses instans yang dicipta dalam rantau yang anda log masuk.

   • Jika anda ingin mencipta instans Open, anda mesti memilih rantau us-east.

   

   Tentang rantau

   Instans akan dicipta dalam rantau yang dipilih. Rantau ini menentukan ciri-ciri penting berikut:

   • QPU mana yang tersedia.
   • Di mana pengkomputeran klasik kerja, seperti penyusunan, berlaku.
   • Di mana data aliran kerja pengguna kekal.

   Data aliran kerja termasuk litar input, parameter litar, dan keputusan pengkomputeran kuantum. Ia tidak termasuk metadata, seperti bilangan tembakan, saiz litar, atau statistik kerja lain.

   Untuk mengelakkan pendedahan data aliran kerja pengguna kepada lapisan perlindungan Distributed Denial of Service global, anda boleh menggunakan Virtual Private Endpoints. qiskit-ibm-runtime menyokong ini melalui parameter private_endpoint.

2. Dari panel Instances papan pemuka, klik View all, atau pergi ke halaman Instances dari menu utama.

3. Dari halaman Instances, klik Create instance.

   • Masukkan nama dan secara pilihan tambah tag.

   • Jika anda mempunyai akses kepada lebih daripada satu kumpulan sumber dalam IBM Cloud®, anda boleh memilih untuk menukar kumpulan sumber yang dimiliki instans ini. Lihat Mengurus kumpulan sumber dan Memberi akses kepada sumber dalam kumpulan sumber untuk maklumat lanjut.

4. Pilih pelan harga yang berkaitan dengan instans ini (contohnya, Pay-As-You-Go). Bergantung pada pelan harga yang dipilih, anda boleh menentukan pilihan lain, seperti had kos atau bilangan RU yang hendak diperuntukkan untuk instans ini. Perhatikan bahawa jika instans ini tidak berkaitan dengan pelan percuma, kos akan ditanggung apabila instans ini digunakan untuk menjalankan beban kerja.

5. Klik Next. Senarai QPU yang boleh diakses oleh instans ditunjukkan.

   • Jika anda ingin instans mempunyai akses kepada semua QPU yang tersenarai (dan semua QPU yang ditambah ke pelan ini pada masa hadapan), klik Next.

   • Jika anda tidak menyediakan instans terbuka, anda boleh menyesuaikan QPU mana yang boleh diakses dengan instans ini. Klik togol "Customize allocated compute resources". Pilih QPU tertentu yang boleh diakses instans ini, kemudian klik Next.

     nota

     Jika anda menyesuaikan sumber pengkomputeran yang diperuntukkan, QPU yang tersedia tidak akan pernah dikemaskini secara automatik, tanpa mengira sebarang perubahan yang dibuat pada pelan induk. Walau bagaimanapun, anda boleh menambah atau membuang QPU secara manual kemudian. Jika anda tidak menyesuaikannya, anda akan sentiasa mempunyai akses kepada mana-mana QPU yang boleh diakses akaun dalam pelan tersebut. Jadi jika pada masa hadapan ada QPU baharu ditambah ke pelan, instans secara automatik mempunyai akses kepadanya.

     Peranti mock disembunyikan dalam senarai ini secara lalai. Hidupkan togol untuk menunjukkannya, kemudian pilih peranti mock yang hendak disertakan. Anda boleh menghadkan instans kepada peranti mock sahaja dengan memilih peranti mock sahaja. Ini berguna untuk pelajar atau peserta kursus, yang kemudian boleh mengesahkan payload mereka dari hujung ke hujung tanpa menggunakan masa QPU sebenar atau RU. Oleh sebab instans hanya mempunyai akses kepada peranti mock, pengguna memilih backend mengikut nama mock-nya, contohnya service.backend("mock_phoenix"). Untuk maklumat lanjut, lihat Job dry-run.

6. Panel Kumpulan Akses dibuka. Kumpulan akses "collaborators" dicipta secara automatik untuk instans ini. Pengguna yang ditambah ke kumpulan akses ini boleh menggunakan masa yang diperuntukkan kepada instans ini. Anda boleh mengubah suai atau mencipta kumpulan akses tambahan menggunakan konsol IBM Cloud. Lihat Menyediakan kumpulan akses untuk arahan.

7. Klik Create instance. Anda kini boleh melihat instans di halaman Instances. Jika anda telah menyediakan beberapa pelan pada akaun anda, setiap jenis pelan mempunyai tab tersendiri pada jadual Instances.

Pending workloads

Lajur Pending workloads pada jadual Instances menunjukkan bilangan beban kerja yang sedang menunggu dalam giliran dalam instans ini merentas semua QPU.

Edit instans dan peruntukkannya

Cari instans di halaman Instances. Klik menu limpahan di hujung baris instans, dan pilih Edit details.

nota

Hanya pentadbir dan pemilik yang boleh mengedit instans. Lihat panduan Cipta polisi akses dan kumpulan akses untuk maklumat tentang menetapkan akses.

Konfigurasikan akses Qiskit Functions dalam sesuatu instans

nota

Tab Functions dan pilihannya hanya dipaparkan jika akaun anda telah dikonfigurasikan dengan akses Qiskit Functions. Jika akaun anda mempunyai akses Qiskit Functions tetapi anda tidak melihat pilihan untuk mengedit akses function bagi setiap instans, akaun anda belum dimigrasikan ke kaedah ini. Hubungi pengurus perhubungan anda atau pasukan Sokongan untuk dimigrasikan.

Anda boleh mengkonfigurasi Qiskit Functions yang boleh diakses oleh sesuatu instans, sama ada dengan menggunakan Resource Controller API (lihat Konfigurasikan akses Qiskit Functions pada instans), atau dengan mengikuti langkah-langkah berikut dalam IBM Quantum Platform.

1. Pergi ke halaman Instances.

2. Pastikan anda telah memilih akaun yang betul dalam penukar akaun di pengepala.

3. Cari instans yang anda ingin dayakan akses functions-nya.

4. Klik menu limpahan di hujung baris instans, kemudian pilih Edit details.

5. Klik tab Functions.

6. Dayakan akses functions dan pilih function yang ingin anda dayakan.

7. Baca dan sahkan bahawa anda telah membaca perjanjian tersebut.

8. Klik Save untuk menyimpan perubahan anda.

Perhatikan bahawa jika akaun anda mempunyai akses kepada Qiskit Functions, anda juga boleh mengkonfigurasi akses semasa menambah instans baharu. Klik Create instance dan ikuti langkah-langkah dalam tetingkap yang dibuka. Semasa langkah Functions, anda boleh menghidupkan akses kepada Catalog Functions dan Custom Functions, serta menentukan Qiskit Functions yang boleh diakses oleh instans tersebut.

Kebenaran lalai dan tersuai

Kebenaran lalai peringkat pengguna terpakai apabila anda menyediakan akses Qiskit Functions untuk sesuatu instans dalam IBM Quantum Platform. Pengguna dengan kebenaran lalai boleh melakukan perkara berikut:

• Melihat function dan butirannya

• Menghantar job menggunakan function

• Menyenaraikan dan memuat turun fail yang disimpan dalam ruang kerja pengguna

• Memuat naik, mengemas kini dan memadam fail input dan hasil dalam ruang kerja pengguna

Untuk menetapkan kebenaran Custom, gunakan Resource Controller API sebagai gantinya. Lihat Konfigurasikan akses Qiskit Functions pada instans untuk maklumat lanjut. Untuk mencari rujukan API, klik ikon maklumat di sebelah kebenaran function dalam tab Functions, kemudian klik pautan View the API reference dalam tip alat.

Untuk memulihkan kebenaran lalai bagi instans yang mempunyai kebenaran tersuai, gunakan Resource Controller atau alih keluar dan tetapkan semula function dalam IBM Quantum Platform, dengan melakukan perkara berikut pada halaman Instances:

1. Klik menu limpahan di hujung baris instans, kemudian pilih Edit details.

2. Klik tab Functions.

3. Alih keluar akses kepada function yang mempunyai kebenaran tersuai.

4. Klik Save.

5. Ulangi langkah-langkah untuk menetapkan semula akses kepada function: pilih Edit details bagi instans, klik tab Functions, pilih function, dan klik Save. Instans kini mempunyai kebenaran lalai peringkat pengguna untuk function tersebut.

Instans yang diarkibkan

Instans yang diarkibkan ialah hasil daripada salah satu senario berikut.

Pengguna berkeistimewaan telah mengarkibkan akaun

Pengguna dengan keistimewaan yang mencukupi untuk akaun telah mengarkibkan instans tersebut.

• Sebarang kerja yang belum dilaksanakan dalam instans dibatalkan.
• Instans yang diarkibkan muncul dalam bahagian "Archive" yang berasingan di halaman Instances.
• Kerja masih boleh diperoleh semula.
• Pengguna tidak boleh menghantar kerja baharu ke instans yang diarkibkan.
• Instans yang diarkibkan tidak dikira terhadap peruntukan pelan anda.
• Pengguna dengan keistimewaan yang mencukupi boleh mengaktifkan semula instans yang mereka (atau pengguna berkeistimewaan lain) arkibkan pada bila-bila masa.

Untuk mengarkibkan instans yang anda urus, pergi ke halaman Instances. Di hujung baris untuk instans tersebut, klik menu limpahan tiga titik di sebelah kanan, kemudian pilih Archive instance.

Akaun tidak lagi mempunyai akses kepada pelan instans

Akaun tidak lagi mempunyai akses kepada pelan yang di bawahnya instans dicipta.

• Instans yang diarkibkan muncul dalam bahagian "Archive" yang berasingan di halaman Instances.

• Kerja masih boleh diperoleh semula.

• Pengguna tidak boleh menghantar kerja baharu ke instans yang diarkibkan.

• Instans yang diarkibkan tidak dikira terhadap peruntukan pelan anda.

• Instans yang telah diarkibkan kerana ia tidak lagi mempunyai keterlihatan ke dalam pelan instans tidak boleh diaktifkan semula.

Langkah seterusnya

Cadangan

• Bekerja dengan kumpulan akses.
• Urus pengguna.
• Simpan kelayakan log masuk anda.
• Mulakan IBM Quantum Compute Service dalam persekitaran Python yang dipercayai.
• Mulakan IBM Quantum Compute Service dalam persekitaran tidak dipercayai.