All Products
Search
Document Center

Cloud Phone:SendFile

Last Updated:Oct 27, 2026

Mengirim file dari Object Storage Service (OSS) atau URL unduhan publik ke cloud phone.

Deskripsi operasi

Saat ini, hanya file atau folder dari Object Storage Service (OSS) yang dapat dikirim ke cloud phone.

Coba sekarang

Coba API ini di OpenAPI Explorer tanpa perlu penandatanganan manual. Panggilan yang berhasil akan secara otomatis menghasilkan contoh kode SDK sesuai dengan parameter Anda. Unduh kode tersebut dengan kredensial bawaan yang aman untuk penggunaan lokal.

Test

RAM authorization

Tidak ada otorisasi untuk operasi ini. Jika Anda mengalami masalah saat menjalankan operasi ini, hubungi dukungan teknis.

Parameter permintaan

Parameter

Type

Required

Description

Example

AndroidInstanceIdList

array

Yes

Daftar instans.

string

No

ID instans.

acp-34pqe4r0kd9kn****

SourceFilePath

string

Yes

Jalur unggahan di dalam cloud phone tempat file diunggah.

Catatan

Jika UploadType adalah OSS atau OSS_BRIDGED, jalur unggahan SourceFilePath di dalam cloud phone harus berupa direktori, seperti /sdcard/Download. Jika UploadType adalah DOWNLOAD_URL, jalur unggahan SourceFilePath di dalam cloud phone harus berupa file, seperti /sdcard/Download/MyFile.txt.

/sdcard/Download

UploadType

string

Yes

Tipe penyimpanan file yang akan diunggah.

  • OSS: File yang akan diunggah adalah Sumber daya OSS.

  • DOWNLOAD_URL: File yang akan diunggah adalah URL unduhan publik.

  • OSS_BRIDGED: File disinkronkan ke OSS melalui URL unduhan publik lalu didistribusikan ke instans cloud phone melalui jaringan internal OSS.

Valid values:

  • DOWNLOAD_URL :

    URL unduhan publik file.

  • OSS :

    Sumber daya file OSS.

OSS

UploadEndpoint

string

No

Nama domain layanan untuk mengunggah file ke OSS. Parameter ini wajib diisi ketika UploadType diatur ke OSS atau OSS_BRIDGED.

Catatan

Jika cloud phone dan bucket OSS berada di wilayah yang sama, Anda dapat menggunakan titik akhir internal untuk mempercepat kecepatan transmisi dan menghindari biaya Lalu lintas internet. Misalnya, titik akhir internal untuk wilayah China (Hangzhou) adalah oss-cn-hangzhou-internal.aliyuncs.com. Untuk informasi selengkapnya tentang pemetaan antara wilayah dan titik akhir, lihat Wilayah dan titik akhir.

oss-cn-hangzhou-internal.aliyuncs.com

UploadUrl

string

Yes

  • Jika UploadType adalah OSS, UploadUrl adalah alamat cloud file yang diunggah ke OSS.

Catatan

Nama bucket OSS harus diawali dengan awalan "cloudphone-saved-bucket-", seperti "cloudphone-saved-bucket-example". Anda harus membuat folder OSS sebagai direktori cadangan. Format UploadUrl adalah "oss://" + "Nama bucket" + "/" + "Nama folder" + "Nama file yang diunggah".

  • Jika UploadType adalah DOWNLOAD atau OSS_BRIDGED, UploadUrl adalah URL unduhan publik file.

oss://cloudphone-saved-bucket-example/send/a.txt

TargetFileName

string

No

Nama file yang diunggah dari OSS ke cloud phone.

Catatan

Jika UploadType adalah OSS atau OSS_BRIDGED, parameter TargetFileName bersifat opsional. Jika TargetFileName kosong, nama file asli akan dipertahankan saat file OSS diunggah ke cloud phone. Jika TargetFileName tidak kosong, nama file di direktori SourceFilePath pada cloud phone akan diatur ke nilai TargetFileName. Jika UploadType adalah DOWNLOAD_URL, parameter TargetFileName tidak berlaku.

test.txt

AutoInstall

boolean

No

Apakah akan menginstal aplikasi yang diunggah secara otomatis.

true

ClientToken

string

No

Token klien yang digunakan untuk memastikan idempotensi permintaan dan mencegah pengiriman duplikat. Panjang token dapat mencapai 100 karakter.

425F351C-3F8E-5218-A520-B6311D0D****

FileMd5

string

No

Nilai MD5 file input.

Elemen respons

Element

Type

Description

Example

object

Parameter tanggapan.

Data

array<object>

Data yang dikembalikan.

425F351C-3F8E-5218-A520-B6311D0D****

object

Objek hasil yang dikembalikan.

AndroidInstanceId

string

ID instans.

acp-34pqe4r0kd9kn****

TaskId

string

ID tugas.

t-4ks224ujixw****

RequestId

string

ID unik permintaan. Jika Anda mengalami masalah, berikan ID permintaan ini kepada tim dukungan teknis untuk pemecahan masalah.

425F351C-3F8E-5218-A520-B6311D0D****

TaskId

string

ID tugas batch.

t-ehs0yoedj0xe9****

Contoh

Respons sukses

JSONformat

{
  "Data": [
    {
      "AndroidInstanceId": "acp-34pqe4r0kd9kn****",
      "TaskId": "t-4ks224ujixw****"
    }
  ],
  "RequestId": "425F351C-3F8E-5218-A520-B6311D0D****",
  "TaskId": "t-ehs0yoedj0xe9****"
}

Kode kesalahan

Lihat Error Codes untuk daftar lengkap.

Catatan rilis

Lihat Release Notes untuk daftar lengkap.