All Products
Search

This Product

    Cloud Phone:SendFile

    Document Center

    Cloud Phone:SendFile

    Last Updated:Jun 10, 2026

    Mengirim file dari Object Storage Service (OSS) atau tautan unduhan publik ke satu atau beberapa ponsel cloud.

    Deskripsi operasi

    Use this operation to send files or folders from Object Storage Service (OSS) to cloud phones.

    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

    ID satu atau beberapa instans ponsel cloud.

    string

    No

    The instance ID of a cloud phone.

    acp-34pqe4r0kd9kn****
    SourceFilePath

    string

    Yes

    Jalur tujuan pada ponsel cloud.

    Catatan

    Jika UploadType adalah OSS atau OSS_BRIDGED, SourceFilePath harus menentukan direktori, misalnya /sdcard/Download/. Jika UploadType adalah DOWNLOAD_URL, SourceFilePath harus menentukan jalur file lengkap, misalnya /sdcard/Download/MyFile.txt.

    /sdcard/Download
    UploadType

    string

    Yes

    Tipe penyimpanan file sumber. Nilai valid:

    • OSS: File disimpan di Object Storage Service (OSS).

    • DOWNLOAD_URL: File dapat diakses melalui tautan unduhan publik.

    • OSS_BRIDGED: Layanan terlebih dahulu mengunduh file dari tautan unduhan publik ke Bucket OSS internal, lalu mendistribusikannya ke instans ponsel cloud melalui jaringan internal.

    Valid values:

    • OSS_BRIDGED :

      公网下载链接同步 OSS 后分发

    • DOWNLOAD_URL :
    • OSS :

    OSS
    UploadEndpoint

    string

    No

    Titik akhir layanan Object Storage Service (OSS). Parameter ini wajib diisi jika UploadType adalah OSS atau OSS_BRIDGED.

    Catatan

    Jika instans ponsel cloud dan Bucket OSS berada di wilayah yang sama, Anda dapat menentukan Titik akhir internal untuk mempercepat transfer data dan menghindari biaya transfer data publik. Misalnya, Titik akhir internal untuk wilayah China (Hangzhou) adalah oss-cn-hangzhou-internal.aliyuncs.com. Untuk daftar lengkap titik akhir, lihat Wilayah dan titik akhir OSS.

    oss-cn-hangzhou-internal.aliyuncs.com
    UploadUrl

    string

    Yes

    • Jika UploadType adalah OSS, parameter ini menentukan URI objek sumber di Object Storage Service (OSS).

    Catatan

    URI harus dalam format oss://<bucket-name>/<object-key>. Nama Bucket OSS yang ditentukan harus memiliki awalan cloudphone-saved-bucket-, misalnya cloudphone-saved-bucket-example.

    • Jika UploadType adalah DOWNLOAD_URL atau OSS_BRIDGED, parameter ini menentukan tautan unduhan publik file sumber.

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

    string

    No

    Nama file tujuan pada ponsel cloud.

    Catatan

    Parameter ini bersifat opsional dan hanya berlaku ketika UploadType diatur ke OSS atau OSS_BRIDGED. Jika Anda menentukan parameter ini, file akan disimpan dengan nama ini di jalur yang ditentukan oleh SourceFilePath. Jika Anda membiarkan parameter ini kosong, nama file sumber akan digunakan. Parameter ini diabaikan ketika UploadType diatur ke DOWNLOAD_URL.

    test.txt
    AutoInstall

    boolean

    No

    Apakah akan menginstal aplikasi secara otomatis setelah file diunggah.

    true
    ClientToken

    string

    No

    Token yang dihasilkan klien yang memastikan idempotensi permintaan dan mencegah pengiriman duplikat. Token dapat berisi hingga 100 karakter.

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

    string

    No

    Elemen respons

    Element

    Type

    Description

    Example

    object

    The response parameters.

    Data

    array<object>

    The details of the created tasks.

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

    object

    The details of a single task.

    AndroidInstanceId

    string

    The instance ID.

    acp-34pqe4r0kd9kn****
    TaskId

    string

    The ID of the individual task for a specific cloud phone.

    t-4ks224ujixw****
    RequestId

    string

    A unique identifier for the request. If you encounter an issue, provide this request ID to technical support for troubleshooting.

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

    string

    The batch task ID.

    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.