Membuat dan mengelola instance

Akses ke layanan IBM Quantum® Platform dikendalikan oleh instance yang ditugaskan kepadamu. Pengguna bisa tergabung di beberapa instance sekaligus.

Instance adalah server virtual (deployment IBM Quantum Compute Service) yang mengelola eksekusi workload-mu, termasuk menjalankan program kuantum dan tugas komputasi klasik (seperti pemrosesan error mitigation). Instance diidentifikasi melalui Cloud Resource Name (CRN)-nya. CRN ini bisa digunakan saat mengirim workload dari program Qiskit-mu.

Kamu bisa melihat instance yang bisa kamu akses di dashboard, atau dengan mengklik tab "Instances" dari dashboard. Setiap instance ditampilkan beserta pengenal CRN-nya.

Kamu memerlukan instance yang berbeda untuk setiap paket layanan (seperti Open atau Pay-As-You-Go) yang kamu gunakan di setiap region yang ingin kamu pakai. Manajer akun dan siapa saja dengan izin yang cukup bisa membuat instance dan mendefinisikan konfigurasinya, seperti alokasi, batas penggunaan, komputer kuantum, dan izin pengguna.

Dashboard IBM Quantum Platform menampilkan instance yang bisa kamu akses. Tergantung aksesmu, kamu bisa melihat detail lengkap, mengedit, dan menghapus instance di halaman Instances.

Penting untuk memahami instance mana yang kamu gunakan, karena semua instance yang tidak terkait dengan Open Plan akan dikenakan biaya (atau dihitung terhadap waktu yang dialokasikan untuk paketmu).

catatan

Job yang kamu jalankan dan job yang dijalankan oleh kolaborator lain di instance yang sama akan dihitung dalam penggunaan yang dilaporkan untuk instance tersebut.

Kamu bisa melihat penggunaan instance di halaman Instances, atau, bagi yang memiliki wewenang yang sesuai, di halaman Analytics. Perlu diperhatikan bahwa kedua halaman tersebut mungkin menampilkan angka penggunaan yang berbeda karena halaman Instance menampilkan total penggunaan sebelum timestamp saat ini, sementara halaman Analytics menggunakan batas hari penuh.

Instance Open Plan

Pengguna Open Plan bisa menjalankan circuit kuantum di QPU terbaik di dunia secara gratis (setara resource unit (RU) untuk 10 menit penggunaan quantum processing unit (QPU) per jendela bergulir 28 hari). Penggunaan bisa dipantau di halaman Platform dashboard dan Workloads.

Instance Pay-As-You-Go Plan

Pay-As-You-Go Plan adalah paket berbayar. Untuk menggunakan paket ini, kamu harus membuat instance dan menugaskannya ke paket tersebut. Semua workload yang dikirim ke QPU menggunakan paket ini akan dikenakan biaya. Instance pay-as-you-go bisa memiliki batas biaya total (opsional).

Instance Flex Plan

Flex Plan adalah paket berbayar. Untuk menggunakan paket ini, kamu harus terlebih dahulu Menghubungi IBM untuk mendaftar. Kemudian, buat instance dan tugaskan ke paket tersebut. Semua workload yang dikirim ke QPU menggunakan paket ini akan dihitung terhadap langganan yang dialokasikan untukmu.

Administrator bisa menetapkan batas penggunaan pada instance Flex Plan yang berlaku selama durasi kontrak. Jika sebuah instance telah ditandai sebagai "limited" oleh administratormu (kamu akan melihat kolom "Remaining" di area penggunaan) dan instance tersebut melebihi alokasinya (yang ditentukan oleh administratormu), workload yang sedang aktif akan terus berjalan (termasuk session) tetapi workload yang tertunda akan tetap berada di antrean hingga ada waktu yang tersedia. Jika sebuah instance tidak dibatasi dan melebihi alokasinya, job yang dijalankan dengan instance tersebut kemungkinan akan berjalan dengan prioritas lebih rendah dan mengalami waktu antrean yang lebih lama.

Sebuah peringatan akan muncul pada penggunaan instance saat melebihi alokasinya.

Instance Premium Plan

Premium Plan adalah paket berbayar. Untuk menggunakan paket ini, kamu harus terlebih dahulu Menghubungi IBM untuk mendaftar. Kemudian, buat instance dan tugaskan ke paket tersebut. Semua workload yang dikirim ke QPU menggunakan paket ini akan dihitung terhadap langganan yang dialokasikan untukmu.

Administrator bisa menetapkan batas penggunaan pada instance Premium Plan yang berlaku untuk jendela penggunaan bergulir 28 hari paket tersebut. Jika sebuah instance telah ditandai sebagai "limited" oleh administratormu, kamu akan melihat kolom "Remaining" di area penggunaan. Jika instance-mu telah ditandai "limited" dan melebihi batas yang ditetapkan oleh administratormu, workload yang tertunda akan tetap berada di antrean hingga ada waktu yang tersedia; namun, workload yang sedang aktif akan terus berjalan, termasuk workload dalam session mode.

Jika sebuah instance tidak dibatasi dan instance tersebut melebihi alokasinya, workload yang dijalankan dengan instance tersebut kemungkinan akan berjalan dengan prioritas lebih rendah dan mengalami waktu antrean yang lebih lama.

Sebuah peringatan akan muncul pada penggunaan instance saat melebihi alokasinya.

Menentukan instance dalam kode-mu

Kamu bisa menggunakan CRN atau nama instance untuk menentukan instance yang akan digunakan — baik saat menginisialisasi layanan, maupun saat mengirim workload ke QPU (misalnya, dengan `QiskitRuntimeService.backend()). Untuk instruksi menentukan instance dalam kode-mu, lihat Inisialisasi akun-mu.

Ketika sebuah instance dimasukkan, hanya Backend dan job dari instance tersebut yang tersedia (diizinkan di qiskit-ibm-runtime v0.40.1 dan yang lebih baru).

Jika instance tidak disertakan saat menginisialisasi layanan, semua backend dan job di semua instance dalam akunmu akan tersedia. Dalam hal ini, saat backend ditentukan, instance yang bisa mengakses backend tersebut akan ditemukan dan digunakan seperti yang dijelaskan di Pemilihan instance otomatis.

Versi yang diperlukan

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

• Menggunakan nama instance untuk menentukan instance

• Tidak memasukkan instance

• Mengatur tipe instance dan region yang diinginkan

Untuk Qiskit Runtime v0.42 atau yang lebih baru, paket gratis diprioritaskan secara default saat pemilihan instance otomatis digunakan.

Membuat instance

Ikuti langkah-langkah berikut untuk membuat instance dan menambahkannya ke akunmu. Jika kamu adalah administrator yang perlu menyiapkan Quantum Compute di Cloud untuk organisasimu, lihat Merencanakan Quantum Compute untuk organisasi.

1. Untuk menambahkan instance ke akunmu, pertama pastikan kamu telah memilih akun dan region yang benar di pemilih akun di header.

   • Kamu bisa memiliki (atau menjadi bagian dari) beberapa akun IBM Cloud. Jika kamu tidak melihat instance atau job yang kamu harapkan, coba akun yang berbeda.

   • Kamu bisa mengakses salah satu region menggunakan API key yang sama, tetapi kamu hanya bisa melihat dan mengakses instance yang dibuat di region tempat kamu masuk.

   • Jika kamu ingin membuat instance Open, kamu harus memilih region us-east.

   

   Tentang region

   Instance akan dibuat di region yang dipilih. Region ini menentukan karakteristik penting berikut:

   • QPU mana yang tersedia.
   • Di mana komputasi klasik job, seperti kompilasi, berlangsung.
   • Di mana data workflow pengguna disimpan.

   Data workflow mencakup circuit input, parameter circuit, dan hasil komputasi kuantum. Ini tidak mencakup metadata, seperti jumlah shot, ukuran circuit, atau statistik job lainnya.

   Untuk menghindari paparan data workflow pengguna ke lapisan perlindungan Distributed Denial of Service global, kamu bisa menggunakan Virtual Private Endpoints. qiskit-ibm-runtime mendukung ini melalui parameter private_endpoint.

2. Dari panel Instances di dashboard, klik View all, atau buka halaman Instances dari menu utama.

3. Dari halaman Instances, klik Create instance.

   • Masukkan nama dan secara opsional tambahkan tag.

   • Jika kamu memiliki akses ke lebih dari satu resource group di IBM Cloud®, kamu bisa memilih untuk mengubah resource group tempat instance ini berada. Lihat Managing resource groups dan Giving access to resources in resource groups untuk informasi lebih lanjut.

4. Pilih paket harga yang terkait dengan instance ini (misalnya, Pay-As-You-Go). Tergantung pada paket harga yang dipilih, kamu bisa menentukan opsi lain, seperti batas biaya atau jumlah RU yang dialokasikan untuk instance ini. Perlu diperhatikan bahwa jika instance ini tidak terkait dengan paket gratis, biaya akan dikenakan saat instance ini digunakan untuk menjalankan workload.

5. Klik Next. Daftar QPU yang bisa diakses instance ditampilkan.

   • Jika kamu ingin instance memiliki akses ke semua QPU yang terdaftar (dan semua QPU yang ditambahkan ke paket ini di masa mendatang), klik Next.

   • Jika kamu tidak menyiapkan instance open, kamu bisa menyesuaikan QPU mana yang bisa diakses dengan instance ini. Klik toggle "Customize allocated compute resources". Pilih QPU tertentu yang bisa diakses oleh instance ini, lalu klik Next.

     catatan

     Jika kamu menyesuaikan resource komputasi yang dialokasikan, QPU yang tersedia tidak akan pernah diperbarui secara otomatis, terlepas dari perubahan apa pun yang dilakukan pada paket induk. Namun, kamu bisa menambah atau menghapus QPU secara manual nantinya. Jika kamu tidak menyesuaikannya, kamu akan selalu memiliki akses ke QPU mana pun yang bisa diakses akun pada paket tersebut. Jadi jika di masa mendatang ada QPU baru yang ditambahkan ke paket, instance secara otomatis memiliki akses ke sana.

     Mock device disembunyikan secara default di daftar ini. Aktifkan toggle untuk menampilkannya, lalu pilih mock device yang ingin disertakan. Kamu bisa membatasi sebuah instance hanya ke mock device dengan memilih mock device saja. Ini berguna untuk pelajar atau peserta kursus, yang kemudian bisa memvalidasi payload mereka secara end-to-end tanpa menghabiskan waktu QPU atau RU yang sebenarnya. Karena instance hanya punya akses ke mock device, pengguna memilih backend lewat nama mock-nya, misalnya service.backend("mock_phoenix"). Untuk informasi lebih lanjut, lihat Dry-run jobs.

6. Panel Access group terbuka. Grup akses "collaborators" secara otomatis dibuat untuk instance ini. Pengguna yang ditambahkan ke grup akses ini bisa menggunakan waktu yang dialokasikan untuk instance ini. Kamu bisa memodifikasi atau membuat grup akses tambahan menggunakan konsol IBM Cloud. Lihat Setting up access groups untuk petunjuknya.

7. Klik Create instance. Kamu sekarang bisa melihat instance di halaman Instances. Jika kamu telah menyiapkan beberapa paket di akunmu, setiap jenis paket memiliki tab sendiri di tabel Instances.

Pending workloads

Kolom Pending workloads di tabel Instances menampilkan jumlah workload yang saat ini diantrekan di instance ini di semua QPU.

Mengedit instance dan alokasinya

Temukan instance di halaman Instances. Klik menu overflow di ujung baris instance tersebut, dan pilih Edit details.

catatan

Hanya administrator dan pemilik yang bisa mengedit instance. Lihat panduan Membuat kebijakan akses dan grup akses untuk informasi tentang menetapkan akses.

Konfigurasi akses Qiskit Functions di sebuah instance

catatan

Tab Functions beserta opsinya hanya muncul jika akunmu sudah dikonfigurasi dengan akses Qiskit Functions. Jika akunmu punya akses Qiskit Functions tetapi kamu tidak melihat opsi untuk mengedit akses function per instance, berarti akunmu belum dimigrasikan ke metode ini. Hubungi engagement manager-mu atau tim Support untuk dimigrasikan.

Kamu bisa mengonfigurasi Qiskit Functions mana saja yang bisa diakses sebuah instance, baik dengan menggunakan Resource Controller API (lihat Konfigurasi akses Qiskit Functions di sebuah instance), maupun dengan mengikuti langkah-langkah berikut di IBM Quantum Platform.

1. Buka halaman Instances.

2. Pastikan kamu sudah memilih akun yang benar di pemilih akun di header.

3. Temukan instance yang ingin kamu aktifkan akses functions-nya.

4. Klik menu overflow di ujung baris instance tersebut, lalu pilih Edit details.

5. Klik tab Functions.

6. Aktifkan akses functions dan pilih function yang ingin kamu aktifkan.

7. Baca dan konfirmasikan bahwa kamu sudah membaca perjanjiannya.

8. Klik Save untuk menyimpan perubahanmu.

Perlu diingat, jika akunmu punya akses ke Qiskit Functions, kamu juga bisa mengonfigurasi akses saat menambahkan instance baru. Klik Create instance dan ikuti langkah-langkah di jendela yang terbuka. Pada langkah Functions, kamu bisa mengaktifkan akses ke catalog functions dan custom functions, serta menentukan Qiskit Functions mana saja yang bisa diakses instance tersebut.

Izin default dan kustom

Izin tingkat pengguna default berlaku saat kamu menyiapkan akses Qiskit Functions untuk sebuah instance di IBM Quantum Platform. Pengguna dengan izin default bisa melakukan hal-hal berikut:

• Melihat function beserta detailnya

• Mengirimkan job menggunakan function tersebut

• Menampilkan daftar dan mengunduh file yang disimpan di workspace pengguna

• Mengunggah, memperbarui, dan menghapus file input dan hasil di workspace pengguna

Untuk menetapkan izin Custom, gunakan Resource Controller API. Lihat Konfigurasi akses Qiskit Functions di sebuah instance untuk informasi lebih lanjut. Untuk menemukan referensi API, klik ikon informasi di samping izin sebuah function di tab Functions, lalu klik tautan View the API reference di tooltip.

Untuk mengembalikan izin default pada instance yang memiliki izin kustom, gunakan Resource Controller atau hapus dan tetapkan ulang function tersebut di IBM Quantum Platform, dengan melakukan langkah berikut di halaman Instances:

1. Klik menu overflow di ujung baris instance tersebut, lalu pilih Edit details.

2. Klik tab Functions.

3. Hapus akses ke function dengan izin kustom tersebut.

4. Klik Save.

5. Ulangi langkah-langkahnya untuk menetapkan ulang akses ke function tersebut: pilih Edit details untuk instance, klik tab Functions, pilih function-nya, lalu klik Save. Sekarang instance tersebut memiliki izin tingkat pengguna default untuk function itu.

Instance yang diarsipkan

Instance yang diarsipkan adalah hasil dari salah satu skenario berikut.

Pengguna dengan hak istimewa telah mengarsipkan akun

Pengguna dengan hak istimewa yang cukup untuk akun tersebut telah mengarsipkan instance.

• Semua job yang tertunda di instance dibatalkan.
• Instance yang diarsipkan muncul di bagian "Archive" terpisah pada halaman Instances.
• Job masih bisa diambil.
• Pengguna tidak bisa mengirimkan job baru ke instance yang diarsipkan.
• Instance yang diarsipkan tidak dihitung terhadap alokasi paketmu.
• Pengguna dengan hak istimewa yang cukup bisa mengaktifkan kembali instance yang mereka (atau pengguna lain dengan hak istimewa) arsipkan kapan saja.

Untuk mengarsipkan instance yang kamu kelola, buka halaman Instances. Di ujung baris untuk instance tersebut, klik menu overflow tiga titik di sebelah kanan, lalu pilih Archive instance.

Akun tidak lagi memiliki akses ke paket instance

Akun tidak lagi memiliki akses ke paket tempat instance dibuat.

• Instance yang diarsipkan muncul di bagian "Archive" terpisah pada halaman Instances.

• Job masih bisa diambil.

• Pengguna tidak bisa mengirimkan job baru ke instance yang diarsipkan.

• Instance yang diarsipkan tidak dihitung terhadap alokasi paketmu.

• Instance yang telah diarsipkan karena tidak lagi memiliki visibilitas ke paket instance tidak bisa diaktifkan kembali.

Langkah selanjutnya

Rekomendasi

• Bekerja dengan grup akses.
• Mengelola pengguna.
• Simpan kredensial login-mu.
• Inisialisasi IBM Quantum Compute Service di lingkungan Python yang terpercaya.
• Inisialisasi IBM Quantum Compute Service di lingkungan yang tidak terpercaya.