All Products
Search
Document Center

Cloud Phone:FetchFile

Last Updated:Jun 10, 2026

Mengambil file dari cloud phone ke Object Storage Service (OSS).

Deskripsi operasi

This operation fetches only files or folders from a cloud phone to Object Storage Service.

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 ID instans cloud phone.

string

No

The ID of a cloud phone instance.

acp-34pqe4r0kd9kn****

SourceFilePath

string

Yes

Jalur file atau folder yang akan diambil dari cloud phone.

/data/a.txt

UploadType

string

Yes

Tipe layanan penyimpanan untuk file yang diambil.

Catatan

Hanya Object Storage Service (OSS) yang didukung.

OSS

UploadEndpoint

string

Yes

Titik akhir untuk mengunggah file ke OSS.

Catatan

Jika cloud phone dan bucket OSS tujuan berada di wilayah yang sama, gunakan titik akhir internal untuk mempercepat transfer dan menghindari biaya jaringan publik. Sebagai contoh, di wilayah China (Hangzhou), gunakan 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

URL tujuan di OSS.

Catatan

Nama bucket tujuan harus diawali dengan cloudphone-saved-bucket-, misalnya cloudphone-saved-bucket-example. Anda juga harus membuat folder di bucket untuk berfungsi sebagai direktori tujuan. UploadUrl harus mengikuti format: oss://<bucket_name>/<folder_name>.

oss://cloudphone-saved-bucket-example/received

ClientToken

string

No

Token yang dihasilkan klien untuk memastikan idempotensi permintaan. Panjang token dapat mencapai 100 karakter.

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

Elemen respons

Element

Type

Description

Example

object

The response object.

Data

array<object>

An array of results, with one entry for each instance specified in the request.

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

object

The result for a single cloud phone instance.

AndroidInstanceId

string

The ID of the cloud phone instance.

acp-34pqe4r0kd9kn****

TaskId

string

The ID of the task created for this specific instance.

t-bp67acfmxazb4p****

RequestId

string

The request ID. Provide this ID when contacting 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-bp67acfmxazb4p****"
    }
  ],
  "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.