全部产品
Search
文档中心

Cloud Phone:SendFile

更新时间:Dec 21, 2025

Kirim file ke cloud phone dari Object Storage Service (OSS) atau tautan unduh publik.

Deskripsi operasi

Saat ini, Anda hanya dapat mengirim file atau folder dari OSS 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 instance.

string

No

ID instans.

acp-34pqe4r0kd9kn****

SourceFilePath

string

Yes

Jalur unggah di dalam cloud phone.

Catatan

Jika UploadType diatur ke OSS atau OSS_BRIDGED, SourceFilePath harus berupa jalur folder di dalam cloud phone, misalnya /sdcard/Download. Jika UploadType diatur ke DOWNLOAD_URL, SourceFilePath harus berupa jalur file di dalam cloud phone, misalnya /sdcard/Download/MyFile.txt.

/sdcard/Download

UploadType

string

Yes

Kelas penyimpanan file sumber.

  • File tersebut merupakan sumber daya OSS.

  • DOWNLOAD_URLFile berasal dari tautan unduhan publik.

  • OSS_BRIDGEDFile tersebut disinkronkan dari tautan unduh publik ke OSS, lalu didistribusikan ke instans cloud phone melalui jaringan internal OSS.

Valid values:

  • DOWNLOAD_URL :

    Tautan unduh publik file tersebut.

  • OSS :

    Resource file OSS.

OSS

UploadEndpoint

string

No

Titik akhir layanan untuk mengunggah file ke OSS. Parameter ini wajib ditentukan 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 wilayah yang sama untuk mempercepat transfer data dan menghindari biaya lalu lintas internet. Misalnya, titik akhir internal untuk wilayah China (Hangzhou) adalah oss-cn-hangzhou-internal.aliyuncs.com. Untuk informasi selengkapnya, lihat Wilayah dan titik akhir OSS.

oss-cn-hangzhou-internal.aliyuncs.com

UploadUrl

string

Yes

  • Jika UploadType diatur ke OSS, UploadUrl adalah alamat cloud file tersebut di OSS.

Catatan

Nama bucket OSS harus diawali dengan awalan "cloudphone-saved-bucket-", contohnya "cloudphone-saved-bucket-example". Anda juga harus membuat folder OSS untuk digunakan sebagai folder backup. Format UploadUrl adalah "oss://" + "Nama bucket" + "/" + "Nama folder" + "/" + "Nama file".

  • Jika UploadType diatur ke DOWNLOAD atau OSS_BRIDGED, UploadUrl adalah tautan unduh publik file tersebut.

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

TargetFileName

string

No

Nama file setelah diunggah dari OSS ke cloud phone.

Catatan

Parameter ini opsional ketika UploadType diatur ke OSS atau OSS_BRIDGED. Jika Anda tidak mengisi parameter ini, file akan mempertahankan nama aslinya setelah diunggah ke cloud phone. Jika Anda menentukan nilai untuk parameter ini, file akan diubah namanya sesuai nilai yang ditentukan setelah diunggah ke jalur yang ditetapkan oleh SourceFilePath. Parameter ini tidak berlaku ketika UploadType diatur ke DOWNLOAD_URL.

test.txt

AutoInstall

boolean

No

Menentukan apakah aplikasi yang diunggah akan diinstal secara otomatis.

true

Elemen respons

Element

Type

Description

Example

object

Parameter respons.

Data

array<object>

Data yang dikembalikan.

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

object

Objek hasil.

AndroidInstanceId

string

ID instans.

acp-34pqe4r0kd9kn****

TaskId

string

ID task.

t-4ks224ujixw****

RequestId

string

ID unik permintaan. Jika terjadi error, berikan ID ini untuk troubleshooting.

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

TaskId

string

ID task 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.