All Products
Search
Document Center

Platform For AI:Mengelola instans Instant Service

Last Updated:Aug 29, 2026

Instans adalah lingkungan runtime terisolasi yang dibuat dari sebuah templat. Anda dapat membuat instans melalui Konsol atau SDK, serta melakukan berbagai operasi seperti akses terminal, desktop VNC, manajemen file, pemanggilan layanan, jeda dan lanjutkan, simpan sebagai templat, serta reklamasi saat kedaluwarsa pada halaman detail instans.

Ikhtisar

Instans merupakan lapisan terendah dalam hierarki sumber daya tiga tingkat PAI-Instant Service (ruang > templat > instans). Setiap instans:

  • Berjalan secara terisolasi: memiliki kernel sistem operasi tamu, sistem file, dan kredensial akses sendiri.

  • Memiliki siklus hidup independen: dapat dibuat, dijeda, dilanjutkan, dan dihapus secara independen.

  • Memiliki properti unik: mencakup ID instans, Access Token, sistem file, URL akses, dan port layanan.

Catatan

Untuk model sumber daya tiga tingkat lengkap, lihat Ikhtisar Instant Service — Hierarki sumber daya.

Catatan penggunaan

Untuk koneksi persisten yang berlangsung lebih dari 24 jam, stabilitas koneksi tidak dijamin.

Membuat instans

Buat dari Konsol

PAI-Instant Service menyediakan tiga titik masuk Konsol untuk membuat instans:

  1. Titik masuk 1: Di workbench Instant Service, klik tombol Create Instance.

  2. Titik masuk 2: Di daftar Private Templates/Public Templates, pilih aksi Create Instance untuk templat target.

  3. Titik masuk 3: Di halaman detail templat, klik Create Instance di instance list.

Pada kotak dialog Create Instance, konfigurasikan parameter berikut:

Parameter

Wajib

Deskripsi

Template

Ya

Templat yang menjadi dasar instans.

Expiration time

Ya

Waktu maksimum keberadaan instans, misalnya 1 jam. Aktifkan toggle Never Expires untuk menonaktifkan kedaluwarsa (tidak disarankan untuk produksi).

Environment variables

Tidak

Variabel lingkungan yang terlihat di dalam instans, dalam format pasangan kunci-nilai.

Custom tags

Tidak

Tag pasangan kunci-nilai untuk instans, berguna untuk pencarian dan kategorisasi.

Klik Create Instance untuk membuat instans.

Buat dengan SDK

PAI-Instant Service secara native kompatibel dengan E2B SDK. Penggunaannya sama seperti E2B:

import os
from e2b import Sandbox

# Set authentication credentials
os.environ["E2B_API_KEY"] = "<YOUR-TOKEN>"
os.environ["E2B_DOMAIN"] = "sandbox01.cn-shanghai.pai-eas.aliyuncs.com"

# Create an instance
sandbox = Sandbox.create(
    template="<YOUR-TEMPLATE-ID>",
    timeout=300000,
)

print(f"Sandbox ID: {sandbox.sandbox_id}")          

Di halaman Template Details, klik SDK Access di pojok kanan atas untuk melihat konfigurasi koneksi SDK dan contoh kode Python. Untuk detail API lebih lanjut, lihat Integrasi E2B SDK.

Menggunakan instans

Lihat detail instans

Buka workbench Instant Service, temukan instans target di instance list, lalu klik Details di kolom Actions untuk membuka halaman detail instans.

Halaman detail instans menampilkan:

  • Spesifikasi sumber daya: CPU, memori, dan disk.

  • Informasi status: status (Running/Paused) dan waktu aktif.

  • Informasi dasar: ID instans, templat, waktu pembuatan, waktu kedaluwarsa, ID Pengguna RAM, ID akun Alibaba Cloud, dan Access Token.

  • Metadata: pasangan kunci-nilai seperti sandbox.alicloud.com/service-name dan userId.

Buka terminal

Klik Open Terminal untuk membuka jendela Web Terminal. Terminal menampilkan ID instans, ID templat, dan timeout sesi (timeout idle 10 menit dan maksimum 30 menit secara default).

Jalankan perintah shell apa pun langsung di terminal. Ini setara dengan memanggil sandbox.commands.run() melalui SDK, dan berguna untuk debugging serta verifikasi lingkungan Anda.

Buka VNC

Untuk templat jenis Desktop, klik Open VNC untuk memulai sesi Remote Desktop.

Catatan

Layanan noVNC harus mendengarkan di Port 6080. Antarmuka depan mengarahkan ulang ke port ini untuk akses Remote Desktop.

VNC berguna untuk:

  • Debugging aplikasi yang memerlukan antarmuka grafis.

  • Verifikasi visual otomatisasi browser (seperti Playwright dan Selenium).

  • Pengujian GUI dan pengambilan tangkapan layar.

Manajemen file

Halaman detail instans menyediakan panel File Management dengan tampilan struktur direktori:

  • Jelajahi struktur direktori di dalam instans, seperti bin, boot, code, dev, etc, dan home.

  • Buat folder, unggah file, refresh tampilan, navigasi naik satu level, dan kembali ke Direktori root.

  • Lihat ukuran file dan waktu modifikasi.

Manajemen file setara dengan memanggil sandbox.files.read() / sandbox.files.write() melalui SDK, dan memungkinkan Anda mengakses hasil waktu proses dengan cepat tanpa meninggalkan Konsol.

Panggil layanan

Panel Service Invocation menyediakan antarmuka interaksi HTTP untuk memanggil layanan yang berjalan di dalam instans.

Opsi konfigurasi:

  • Metode permintaan: GET, POST, PUT, DELETE, dan lainnya.

  • Port: port pendengar layanan di dalam instans.

  • Path: path URL untuk permintaan, seperti /health.

  • Request headers: Header HTTP kustom, seperti Content-Type: application/json.

  • Preview URL: URL permintaan lengkap yang dirakit oleh sistem, yang dapat Anda salin dan gunakan langsung.

Klik Send Request. Panel HTTP Interaction History di sebelah kanan menampilkan konten permintaan dan tanggapan untuk debugging real-time.

Penting

Akses eksternal ke layanan instans: Layanan yang berjalan di dalam instans secara otomatis mendapatkan URL yang dapat diakses publik dalam format https://<port>-<sandbox-id>.<domain>/<path>. Panggil URL ini langsung dari klien HTTP mana pun tanpa pemetaan port tambahan.

Lihat log permintaan

Beralih ke tab Request Logs untuk melihat semua permintaan HTTP yang diteruskan ke instans melalui bidang data. Gunakan log ini untuk audit dan troubleshooting.

Jeda dan lanjutkan

Anda dapat menjeda dan melanjutkan instans untuk menyimpan statusnya guna dipulihkan nanti atau disimpan sebagai templat.

  • Pause: Klik Pause di instance list atau panggil sandbox.pause(). Status instans dipertahankan ke penyimpanan instans.

  • Resume: Klik Resume di instance list atau panggil Sandbox.connect("<sandbox-id>"). Instans dengan cepat kembali ke status Berjalan.

Penting

Instans yang dijeda terus ditagih dengan laju yang sama seperti instans yang sedang Berjalan (termasuk CPU, memori, dan sistem disk). Untuk mengurangi biaya, hapus instans yang tidak lagi digunakan. Untuk detailnya, lihat Tagihan.

Simpan sebagai templat

Anda dapat menyimpan status saat ini dari suatu instans, termasuk file, dependensi yang terpasang, dan proses yang sedang berjalan, sebagai templat baru untuk penggunaan ulang lingkungan.

Skenario umum:

  • Setelah menyelesaikan perubahan kode dan konfigurasi lingkungan selama pengembangan, simpan instans sebagai templat untuk menghindari pembuatan ulang image setiap kali ada perubahan.

  • Tangkap lingkungan runtime agen yang telah dikonfigurasi sepenuhnya sebagai templat standar untuk penggunaan tim.

Prasyarat: Layanan instan harus memiliki Enterprise Edition Image Instance yang telah dikonfigurasi (Standar atau Edisi Perusahaan).

Prosedur:

  1. Jeda instans yang ingin Anda simpan sebagai templat.

  2. Klik Save as Template.

  3. Masukkan nama dan deskripsi untuk templat baru.

  4. Klik OK. Sistem membuat templat baru berdasarkan status instans saat ini.

Catatan

Templat baru muncul di daftar Private Templates pada workbench Instant Service.

Kedaluwarsa dan reklamasi instans

Instans direklamasi melalui mekanisme berikut:

  • Penghancuran otomatis ketika waktu kedaluwarsa yang ditentukan saat pembuatan tercapai.

  • Penghapusan manual melalui Konsol atau SDK.

Perpanjang timeout instans

Anda dapat memperpanjang timeout dengan dua cara:

Metode

Perilaku

Sandbox.connect(timeout=...)

Memperpanjang timeout saat menyambung ulang. Jika instans dijeda, instans akan dilanjutkan secara otomatis dengan timeout baru. Jika sedang berjalan, timeout hanya diperpanjang jika nilai timeout yang diminta melebihi sisa waktu.

sandbox.set_timeout(N)

Secara eksplisit menetapkan timeout baru. Mengatur ulang waktu kedaluwarsa menjadi waktu saat ini ditambah nilai timeout yang ditentukan.

Langkah selanjutnya