All Products
Search
Document Center

Cloud Phone:Ikhtisar API

Last Updated:Jul 13, 2026

Standar API dan SDK siap pakai dalam berbagai bahasa

Spesifikasi OpenAPI produk ini (eds-aic/2023-09-30) mematuhi standar RPC. Alibaba Cloud menyediakan SDK siap pakai untuk berbagai bahasa pemrograman populer guna mengabstraksi kompleksitas tingkat rendah seperti request signing. Hal ini memungkinkan developer untuk memanggil API menggunakan sintaks khusus tanpa perlu menangani detail HTTP secara langsung.

Signature kustom

Jika SDK tidak mendukung kebutuhan spesifik Anda, seperti signature kustom, Anda harus menandatangani request secara manual menggunakan signature mechanism. Perhatikan bahwa proses penandatanganan manual memerlukan upaya yang signifikan (estimasi 5 hari kerja). Untuk mendapatkan dukungan, bergabunglah dengan grup DingTalk kami (ID: 147535001692).

Sebelum Anda mulai

Akun Alibaba Cloud memiliki hak administratif penuh. Jika pasangan AccessKey dikompromikan, semua resource terkait dapat terekspos terhadap akses tidak sah, sehingga menimbulkan risiko keamanan yang signifikan. Buat Resource Access Management (RAM) user dengan akses khusus API dan gunakan kebijakan RAM untuk menerapkan principle of least privilege (PoLP). Gunakan akun Alibaba Cloud hanya jika benar-benar diperlukan.

Untuk memanggil API secara aman, konfigurasikan hal berikut:

  • Akun RAM user

  • Pasangan AccessKey untuk akun tersebut

JVS Mobile

API

Judul

Deskripsi

CreateCreditPackage CreateCreditPackage Membuat pesanan untuk paket kredit.
DescribeCreditPackage DescribeCreditPackage Mengambil detail satu atau beberapa paket kredit.
CreateMobileAgentPackage CreateMobileAgentPackage Membuat pesanan paket.
DeleteMobileAgentPackage Hapus Paket Menghapus paket node.
DescribeMobileAgentPackage DescribeMobileAgentPackage Mengambil detail satu atau beberapa paket node.
RenewMobileAgentPackage RenewMobileAgentPackage Memperpanjang paket Agen seluler.
ModifyJVSInstance ModifyJVSInstance Mengubah konfigurasi instans JVS.
DescribeJVSInstance DescribeJVSInstance Mengambil detail instans JVS.
RunAgentTask Menjalankan tugas agen. Memicu Agen untuk menjalankan tugas otomatisasi AI pada node Mobile.
DescribeAgentTask Mengkueri detail tugas agen. Mengkueri informasi tentang tugas agen.
CancelAgentTask CancelAgentTask Membatalkan tugas agen yang sedang berjalan pada node seluler.
PauseAgentTask Jeda Tugas Agen Menjeda tugas agen yang sedang berjalan pada node Mobile.
ResumeAgentTask ResumeAgentTask Melanjutkan tugas otomatisasi agen yang dijeda pada instans seluler.

Matriks cloud phone

API

Judul

Deskripsi

CreateCloudPhoneNode CreateCloudPhoneNode Di Cloud Phone, matrix adalah unit manajemen sumber daya logis yang merepresentasikan instans server fisik. Membuat matrix akan menyediakan server fisik, yang kemudian dapat Anda partisi menjadi beberapa instans Cloud Phone independen. Instans-instans ini berbagi sumber daya komputasi, penyimpanan, dan jaringan dari matrix. Konfigurasi matrix menentukan berapa banyak instans yang dapat Anda buat.
DescribeCloudPhoneNodes DescribeCloudPhoneNodes Mengueri detail matriks-matriks Cloud Phone. Dalam layanan Cloud Phone, sebuah matriks (Cloud Phone Server) adalah unit pengelolaan sumber daya logis yang mewakili sebuah instance server fisik. Server fisik ini dapat dipartisi menjadi beberapa instance Cloud Phone independen yang berbagi sumber daya komputasi, penyimpanan, dan jaringan dasar dari matriks tersebut. Membuat sebuah matriks setara dengan menyediakan sebuah server fisik tempat Anda dapat membuat instance-instance Cloud Phone. Jumlah instance yang dapat Anda buat bervariasi tergantung pada konfigurasinya.
ModifyCloudPhoneNode Mengubah Matrix cloud phone Mengubah Matrix cloud phone. Saat ini, Anda hanya dapat mengubah nama Matrix cloud phone. Catatan: Dalam sistem Cloud Phone, Matrix (Server Cloud Phone) adalah unit manajemen sumber daya logis yang merepresentasikan satu instans server fisik. Server fisik ini dapat dipartisi menjadi beberapa instans cloud phone yang berjalan secara independen. Instans-instans ini berbagi sumber daya komputasi, penyimpanan, dan jaringan mendasar dari Matrix. Membuat Matrix setara dengan menyewa server fisik khusus. Pada server ini, Anda kemudian dapat membuat instans cloud phone. Jumlah instans yang dapat Anda buat bergantung pada konfigurasinya.
RenewCloudPhoneNodes RenewCloudPhoneNodes Memperpanjang masa berlaku node cloud phone tertentu.
ChangeCloudPhoneNode ChangeCloudPhoneNode Memodifikasi konfigurasi matriks cloud phone, termasuk tipe instans dan jumlah instans cloud phone.
ExpandDataVolume ExpandDataVolume Memperluas penyimpanan matriks cloud phone. Anda dapat memperluas penyimpanan bersama untuk file tingkat matriks seperti image, dan penyimpanan instans. Memperluas penyimpanan akan menimbulkan biaya baru, dan tanggapan API akan mengembalikan ID pesanan.
DeleteCloudPhoneNodes DeleteCloudPhoneNodes Menghapus matriks cloud phone.

Kelompok instans

API

Judul

Deskripsi

DescribeSpec DescribeSpec Mengkueri spesifikasi yang tersedia untuk cloud phone. Informasi ini diperlukan untuk membuat instans. Untuk mode matriks cloud phone, operasi ini juga mengembalikan jumlah minimum dan maksimum instans yang diizinkan per matriks.
CheckResourceStock Periksa Status Stok Sumber Daya Memeriksa inventaris Sumber daya Cloud Phone. Sebelum membuat instans, panggil operasi ini untuk memeriksa ketersediaan Sumber daya di wilayah target. Buat instans hanya setelah Anda mengonfirmasi bahwa Sumber daya tersedia.
CreateAndroidInstanceGroup CreateAndroidInstanceGroup Membuat kelompok instans cloud phone pay-as-you-go atau langganan. Sebuah kelompok instans dapat mengelola beberapa instans. Anda dapat mengelompokkan instans dengan fungsi serupa ke dalam sebuah kelompok instans untuk mengelolanya sebagai satu unit.
DescribeAndroidInstanceGroups Kueri Detail Kelompok Instans Mengkueri detail kelompok instans cloud phone.
ModifyAndroidInstanceGroup ModifyAndroidInstanceGroup Mengubah atribut kelompok instans.
UpgradeAndroidInstanceGroup Peningkatan Kelompok Instans Android Meningkatkan kelompok instans. Operasi ini hanya mendukung penskalakan keluar kelompok instans, yang menambah jumlah instans.
DowngradeAndroidInstanceGroup DowngradeAndroidInstanceGroup Menurunkan kapasitas kelompok instans. Saat ini, operasi ini hanya memungkinkan Anda menghapus instans cloud phone tertentu dari kelompok instans.
RenewAndroidInstanceGroups RenewAndroidInstanceGroups Memperpanjang kelompok Instansi langganan Cloud Phone. Jika kelompok Instansi langganan kedaluwarsa, sistem akan menghapus kelompok instans dan instansnya secara otomatis setelah 15 hari. Anda tidak dapat memulihkan Sumber daya yang telah dihapus. Perpanjang kelompok instans Anda segera untuk mencegah loss resource.
UpdateInstanceGroupImage UpdateInstanceGroupImage Memperbarui image dari grup instance. Pembaruan ini memengaruhi semua instance dalam grup.
DeleteAndroidInstanceGroup DeleteAndroidInstanceGroup Menghapus kelompok instans Android. Semua instans dalam kelompok tersebut juga dihapus. Operasi ini tidak dapat dibatalkan. Lanjutkan dengan hati-hati.

Instans

API

Judul

Deskripsi

DescribeAndroidInstances Kueri Detail Instans Mengkueri detail instans cloud phone.
ModifyAndroidInstance ModifyAndroidInstance Memodifikasi informasi instance Android. Saat ini, operasi ini hanya dapat digunakan untuk memodifikasi nama instance dan batas bandwidth upstream serta downstream.
AuthorizeAndroidInstance Menugaskan atau Membatalkan Penugasan Pengguna ke Instans Mengotorisasi atau mencabut otorisasi instans Android untuk pengguna.
StartAndroidInstance Start Instance Menjalankan instans cloud phone.
StopAndroidInstance StopAndroidInstance Menghentikan (mematikan) sebuah instance Android.
RebootAndroidInstancesInGroup RebootAndroidInstancesInGroup Merestart (mematikan lalu menyalakan) instans Cloud Phone.
ResetAndroidInstancesInGroup ResetAndroidInstancesInGroup Mengatur ulang instans dengan menginstal ulang sistem operasi menggunakan image aslinya. Catatan: Operasi pengaturan ulang akan gagal jika image yang digunakan untuk membuat Cloud Phone telah dihapus.
UpdateInstanceImage UpdateInstanceImage Mengubah image dari instance di cloud phone matrix. Anda hanya dapat mengubah image untuk instance ketika instance berada dalam status Running (Sedang Berjalan), Stopped (Dihentikan), atau Failed to change the image (Gagal mengubah image). Vendor GPU dari image target harus cocok dengan vendor GPU dari server tempat instance berjalan. Jika Anda mengubah image lintas versi mayor, seperti dari Android 10 ke Android 12, sistem akan menghapus semua data. Operasi ini setara dengan mengubah image dan kemudian mereset instance.
ExpandPhoneDataVolume Perluas Volume Data Telepon Memperluas penyimpanan telepon untuk satu atau beberapa instans matriks.
InstanceHealer InstanceHealer Mendiagnosis dan memulihkan instans cloud phone matrix. Operasi ini membersihkan file log sistem instans untuk mencegah instans menjadi tidak dapat dipulihkan akibat disk penuh.
StartInstanceAdb StartInstanceAdb Mengaktifkan koneksi Android Debug Bridge (ADB) untuk instans dan membuat aturan pemetaan Internet untuk Port ADB-nya. Fitur ini hanya tersedia untuk jaringan standar.
StopInstanceAdb StopInstanceAdb Menonaktifkan koneksi ADB untuk instans Android dan menghapus aturan penerusan port ADB-nya. Operasi ini hanya berlaku untuk jaringan standar.
ListInstanceAdbAttributes ListInstanceAdbAttributes Mengkueri informasi koneksi Android Debug Bridge (ADB) untuk instans. Operasi ini hanya tersedia untuk jaringan standar.
Sambungkan & putuskan sambungan Sambungkan & putuskan sambungan
BatchGetAcpConnectionTicket BatchGetAcpConnectionTicket Mengambil tiket koneksi secara batch. Operasi ini menghasilkan tiket koneksi secara asinkron. Dalam sebagian besar kasus, tiket dikembalikan langsung di tanggapan panggilan pertama. Namun, dalam beberapa situasi, tanggapan awal akan berisi `TaskId`. Anda kemudian harus melakukan polling pada titik akhir ini dengan `TaskId` hingga pembuatan selesai dan tiket dikembalikan.
DisconnectAndroidInstance Memutuskan instans android Memutuskan instans yang terhubung atau melepaskan asosiasi instans yang terkait dengan pengguna lain.
Perintah jarak jauh Perintah jarak jauh
RunCommand RunCommand Menjalankan perintah pada satu atau beberapa instans ponsel cloud.
DescribeInvocations DescribeInvocations Menanyakan hasil eksekusi perintah yang dijalankan dengan memanggil operasi RunCommand.
RunSyncCommand RunSyncCommand Menjalankan perintah sinkron pada satu atau beberapa instans Cloud Phone dan mengembalikan hasil eksekusi.
Unggah dan unduh file Unggah dan unduh file
SendFile SendFile Mengirim file dari Object Storage Service (OSS) atau tautan unduhan publik ke satu atau beberapa ponsel cloud.
FetchFile Mengambil file dari cloud phone Mengambil file dari cloud phone ke Object Storage Service (OSS).
Tangkapan layar Tangkapan layar
CreateScreenshot CreateScreenshot Operasi API asinkron ini menghasilkan screenshot cloud phone.
Kolaborasi streaming Kolaborasi streaming
GenerateCoordinationCode Menghasilkan kode kolaborasi. Secara default, Anda hanya dapat menggunakan operasi BatchGetAcpConnectionTicket untuk mendapatkan tiket koneksi ke cloud phone, dan cloud phone hanya mendukung satu pengguna yang terhubung dalam satu pengatur waktu. Untuk mengizinkan beberapa pengguna terhubung ke cloud phone secara bersamaan, hubungkan ke cloud phone dengan convenience account, gunakan operasi ini untuk menghasilkan kode kolaborasi menggunakan akun saat ini, dan bagikan kode tersebut ke convenience account lainnya agar mereka dapat mengakses cloud phone yang sama.
EndCoordination EndCoordination Mengakhiri semua tugas koordinasi untuk instans cloud phone dan membatalkan kode koordinasi.

Image

API

Judul

Deskripsi

ImportImage ImportImage Mengimpor image kustom.
DescribeImageList DescribeImageList Mengkueri daftar image yang tersedia.
CreateCustomImage CreateCustomImage Membuat image kustom dari instance ponsel cloud. Kemudian, Anda dapat menggunakan image tersebut untuk membuat lebih banyak ponsel cloud dengan konfigurasi yang sama.
UpdateCustomImageName UpdateCustomImageName Memperbarui nama image kustom.
DistributeImage DistributeImage Mendistribusikan image ke satu atau beberapa region. Hal ini memungkinkan Anda menggunakan image tersebut untuk membuat cloud phone di region selain region sumbernya.
DeleteImages DeleteImages Menghapus gambar kustom.

Aplikasi

API

Judul

Deskripsi

CreateApp CreateApp Membuat aplikasi Android. Sebelum Anda dapat menginstal aplikasi, Anda harus menggunakan operasi API ini untuk membuatnya. Aplikasi tidak diunduh saat dibuat. Aplikasi hanya diunduh selama penginstalan. Pastikan cloud phone dapat mengakses URL unduhan.
DescribeApps DescribeApps Mengkueri aplikasi.
ModifyApp ModifyApp Ubah atribut aplikasi.
DeleteApps DeleteApps Menghapus aplikasi. Sebelum menghapus aplikasi, pastikan aplikasi tidak terinstal pada instans mana pun.
InstallApp InstallApp Menginstal aplikasi secara batch pada instans Cloud Phone.
UninstallApp UninstallApp Menghapus instalasi aplikasi dari satu atau beberapa instans Cloud Phone.
OperateApp OperateApp Mengoperasikan aplikasi di cloud phone, seperti membuka, menutup, dan membuka kembali aplikasi.

Key pair

API

Judul

Deskripsi

CreateKeyPair CreateKeyPair Anda dapat terhubung ke Cloud Phone menggunakan Android Debug Bridge (ADB). ADB memungkinkan Anda mengelola Perangkat dan aplikasi, serta mentransfer file. Operasi ini memerlukan izin tingkat tinggi. Karena Cloud Phone tidak memiliki antarmuka fisik, Anda tidak dapat menggunakan koneksi USB untuk Pemicu kotak dialog otorisasi pada Perangkat. Oleh karena itu, Anda harus mengonfigurasi pasangan kunci sebelum terhubung ke Cloud Phone dengan ADB melalui jaringan. Pasangan kunci ini memastikan bahwa Perangkat memercayai Klien dan semua operasi aman. Anda dapat memanggil operasi CreateKeyPair untuk membuat pasangan kunci ADB. Sistem menyimpan kunci publik dan mengembalikan kunci privat. Kunci privat berada dalam format PKCS#8 yang dienkode PEM dan mematuhi standar koneksi ADB. Anda harus menyimpan kunci privat dengan aman.
DescribeKeyPairs DescribeKeyPairs Mengkueri satu atau beberapa pasangan kunci.
ImportKeyPair ImportKeyPair Mengimpor kunci publik pasangan kunci Android Debug Bridge (ADB).
ModifyKeyPairName ModifyKeyPairName Mengubah pasangan kunci Android Debug Bridge (ADB).
DeleteKeyPairs Hapus Pasangan Kunci Menghapus pasangan kunci Android Debug Bridge (ADB).
AttachKeyPair AttachKeyPair Memasang pasangan kunci Android Debug Bridge (ADB) ke satu atau beberapa instance cloud phone.
DetachKeyPair DetachKeyPair Melepaskan pasangan kunci Android Debug Bridge (ADB) dari satu atau beberapa instans cloud phone.
SetAdbSecure SetAdbSecure Mengatur status otentikasi untuk instans cloud phone. Jika Anda mengaktifkan otentikasi Android Debug Bridge (ADB) untuk instans cloud phone, sistem akan memverifikasi validitas key pair ADB yang disediakan oleh pengguna akhir saat mereka terhubung ke instans melalui ADB. Untuk memastikan otentikasi dan koneksi berjalan lancar, kami menyarankan Anda menyambungkan key pair ADB ke instans cloud phone. Jika Anda menonaktifkan otentikasi ADB untuk instans cloud phone, sistem tidak akan lagi memverifikasi validitas key pair ADB apa pun. Akibatnya, pengguna akhir dapat terhubung ke instans cloud phone melalui ADB tanpa otentikasi, asalkan koneksi jaringan berfungsi dengan baik.

Backup

API

Judul

Deskripsi

DescribeBackupFiles Kueri File Backup Mengkueri daftar file backup.
DescribeBuckets DescribeBuckets Mengkueri informasi tentang bucket. Operasi ini hanya mengembalikan bucket yang namanya diawali dengan `cloudphone-saved-bucket-`.
BackupAndroidInstance BackupAndroidInstance Membuat cadangan penuh instans Cloud Phone. Cadangan mencakup aplikasi dan properti yang terpasang.
BackupApp BackupApp Mencadangkan aplikasi tertentu pada instans cloud phone. Cadangan mencakup aplikasi dan cache-nya.
RecoverAndroidInstance RecoverAndroidInstance Memulihkan cadangan instans penuh ke instans cloud phone lain.
RecoverApp RecoverApp Memulihkan aplikasi dari file backup ke instans cloud phone lain.
BackupFile BackupFile Membuat file cadangan dan mengunggahnya ke penyimpanan jarak jauh. Anda dapat menggunakan operasi ini untuk pencadangan data rutin. Anda juga dapat mencadangkan file dari satu instans dan memulihkannya ke beberapa instans, proses yang mirip dengan replikasi atau migrasi data.
RecoveryFile RecoveryFile Memulihkan file cadangan.
DeleteBackupFile DeleteBackupFile Menghapus batch file backup.

Kebijakan

API

Judul

Deskripsi

CreatePolicyGroup CreatePolicyGroup Membuat kebijakan yang menerapkan pengaturan terpadu pada cloud phone. Pengaturan ini mencakup fitur seperti pengalihan jaringan, watermark, resolusi, dan clipboard.
ListPolicyGroups Kueri detail kebijakan. Mengkueri detail kebijakan.
ModifyPolicyGroup ModifyPolicyGroup Memodifikasi informasi grup kebijakan.
DeletePolicyGroup DeletePolicyGroup Menghapus satu atau beberapa kelompok kebijakan.

Templat properti sistem

API

Judul

Deskripsi

CreateSystemPropertyTemplate CreateSystemPropertyTemplate Membuat templat properti sistem. Pasangan kunci-nilai yang didefinisikan dalam templat dikirim ke cloud phone dan ditetapkan sebagai properti dalam sistem Android menggunakan perintah setprop. APK atau program terkait kemudian dapat membaca nilai properti tersebut.
SendSystemPropertyTemplate SendSystemPropertyTemplate Mengirim templat properti ke instans cloud phone dan, berdasarkan templat tersebut, mengatur properti di sistem Android menggunakan perintah setprop. APK atau program terkait dapat membaca nilai properti ini. Jika Anda menentukan beberapa ID templat, templat properti akan dikirim secara acak ke instans cloud phone.
DescribeSystemPropertyTemplates DescribeSystemPropertyTemplates Menjelaskan template properti sistem.
GetInstanceProperties GetInstanceProperties Mengambil properti instans. Operasi ini menjalankan perintah android getprop untuk mengambil semua properti cloud phone.
ModifySystemPropertyTemplate ModifySystemPropertyTemplate Mengubah templat properti.
DeleteSystemPropertyTemplates DeleteSystemPropertyTemplates Menghapus templat properti sistem.

Pemantauan

API

Judul

Deskripsi

InstallMonitorAgent InstallMonitorAgent Memasang plugin pemantauan dalam satu langkah. Instans hanya dapat menghasilkan data pemantauan setelah plugin dipasang.
UninstallMonitorAgent Uninstall Agen Pemantauan Menguninstall plugin pemantauan.
DescribeMetricLast DescribeMetricLast Mengkueri data pemantauan terbaru untuk instans atau matriks. Anda dapat mengkueri data deret waktu seperti CPU, memori, disk, dan jaringan.
DescribeMetricList DescribeMetricList Meminta data pemantauan untuk metrik yang ditentukan, seperti bandwidth jaringan.
DescribeMetricTop DescribeMetricTop Meminta data pemantauan terbaru untuk metrik seperti bandwidth jaringan instansi dan mengembalikan hasilnya dalam daftar terurut.

Lainnya

API

Judul

Deskripsi

ModifyDisplayConfig ModifyDisplayConfig Mengubah pengaturan tampilan.
DescribeDisplayConfig DescribeDisplayConfig Mengkueri pengaturan tampilan.
GetNetworkBlacklist GetNetworkBlacklist Mengkueri blacklist akses jaringan untuk alamat IP dan nama domain.
SetNetworkBlacklist SetNetworkBlacklist Menambahkan atau menghapus alamat IP dan nama domain dari daftar hitam akses jaringan.
DescribeRegions Query Available Regions Mengkueri wilayah yang tersedia.
DescribeTasks DescribeTasks Mengkueri tugas yang dibuat untuk instans cloud phone. Banyak operasi pada cloud phone—seperti membuat, memulai, atau menghentikannya—bersifat asinkron. Saat Anda memulai operasi, sistem mengembalikan `Task ID` yang dapat Anda gunakan untuk Track progres dan hasil akhirnya. Anda dapat memanggil API ini untuk mengambil daftar semua tugas dan status eksekusinya.
ListTagResources ListTagResources Mengkueri tag yang terkait dengan instans Cloud Phone.
ModifyInstanceChargeType ModifyInstanceChargeType Mengubah metode penagihan. Saat ini, operasi ini hanya memungkinkan Anda mengubah metode penagihan dari pay-as-you-go menjadi langganan.
TagResources TagResources Menambahkan tag ke satu atau beberapa cloud phone.
UntagResources UntagResources Menghapus tag dari cloud phone. Jika sebuah tag tidak lagi dikaitkan dengan cloud phone mana pun setelah dihapus, tag tersebut akan otomatis dihapus.

Others

API

Judul

Deskripsi

ActivateEdgeMobileAgent Mengaktifkan Perangkat Agen Edge. Mengaktifkan perangkat agen edge.
CreateEdgeMobileAgentPackage Membeli paket agen edge. Membuat Pesanan untuk membeli paket agen gerbang pintar edge.
DescribeCreditDetail Kueri Detail Kredit. Mengkueri semua catatan perubahan kredit.
DescribeEdgeMobileAgentPackages Query detail paket agen edge. Mengkueri detail paket agen edge.
RefreshAuthTokens Menyegarkan Token Otentikasi Model. Menyegarkan token otentikasi model.