All Products
Search
Document Center

Cloud Phone:CreateScreenshot

Last Updated:Jun 10, 2026

Operasi API asinkron ini menghasilkan screenshot cloud phone.

Deskripsi operasi

This operation creates a screenshot of a cloud phone and uploads it to the default Object Storage Service (OSS) bucket. The operation returns a task ID. You can then call the DescribeTasks operation to retrieve the download link for the screenshot.

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. Mendukung screenshot batch.

string

Yes

The instance ID.

acp-ig2bdpk374l12****

OssBucketName

string

No

Bucket OSS kustom. Nama bucket harus diawali dengan awalan cloudphone-saved-bucket-. Instans cloud phone dan bucket OSS harus berada di wilayah yang sama. Jika Anda mengosongkan parameter ini, bucket default bernama cloudphone-saved-bucket-{RegionOfCloudPhone}-{AliUid} akan dibuat.

cloudphone-saved-bucket-cn-shanghai-default

SkipCheckPolicyConfig

string

No

Apakah akan melewatkan pemeriksaan kebijakan screenshot. Nilai default: false.

false

ScreenshotId

string

No

ID screenshot. Screenshot yang dihasilkan diberi nama "ScreenshotId_AndroidInstanceId.png."

Penting

ScreenshotId harus memiliki panjang 2 hingga 128 karakter, diawali dengan huruf, tetapi tidak boleh diawali dengan http:// atau https://. Karakter yang diizinkan meliputi huruf, angka, garis bawah (_), dan tanda hubung (-).

.

image

Elemen respons

Element

Type

Description

Example

object

PlainResult<integer>

RequestId

string

The unique ID of the request. If you encounter an issue, provide this request ID for troubleshooting.

3AF82CE1-2801-52CE-BF64-B491DD7C****

Tasks

array<object>

The list of tasks.

object

The task.

AndroidInstanceId

string

The instance ID.

acp-bwhtebzah2fse****

TaskId

string

The task ID. You can use this ID to call the DescribeTasks operation and query the screenshot task. When the task is complete, you can get the download link for the screenshot.

t-imr0fufqd7cle****

ScreenshotId

string

The screenshot ID. The generated screenshot is named "ScreenshotId_AndroidInstanceId.png."

image

Contoh

Respons sukses

JSONformat

{
  "RequestId": "3AF82CE1-2801-52CE-BF64-B491DD7C****",
  "Tasks": [
    {
      "AndroidInstanceId": "acp-bwhtebzah2fse****",
      "TaskId": "t-imr0fufqd7cle****",
      "ScreenshotId": "image"
    }
  ]
}

Kode kesalahan

Lihat Error Codes untuk daftar lengkap.

Catatan rilis

Lihat Release Notes untuk daftar lengkap.