All Products
Search

This Product

    Cloud Phone:DescribeTasks

    Document Center

    Cloud Phone:DescribeTasks

    Last Updated:Oct 12, 2026

    Mengkueri daftar tugas saat ini dari instans Cloud Phone. Banyak operasi pada Cloud Phone, seperti pembuatan, pengaktifan, dan penghentian, dilakukan secara asinkron. Sistem menghasilkan ID tugas yang dapat Anda gunakan untuk mengkueri progres dan hasil operasi. Anda dapat memanggil operasi ini untuk mengkueri daftar tugas lengkap dan status eksekusi.

    Deskripsi operasi

    • Anda dapat memanggil operasi DescribeTasks untuk mengkueri status operasi satu atau beberapa instans cloud phone.

    • Kueri tugas saat ini didukung untuk operasi seperti pengaktifan, penghentian, restart, reset, pencadangan atau pemulihan, instalasi aplikasi, dan perintah jarak jauh.

    • Bidang Level membedakan level tugas. Jika Level diatur ke 1, tugas tersebut adalah tugas batch. Jika Level diatur ke 2, tugas tersebut adalah tugas tingkat instans.

    Contoh:

    Asumsikan Anda memulai ulang dua instans cloud phone dengan ID instans acp-25nt4kk9whhok**** dan acp-j2taq887orj8l****. requestId yang dikembalikan untuk operasi ini adalah B8ED2BA9-0C6A-5643-818F-B5D60A64****. Untuk memeriksa hasil operasi batch ini, Anda dapat memanggil DescribeTasks dan mengatur InvokeId ke B8ED2BA9-0C6A-5643-818F-B5D60A64****. Untuk mendapatkan hasil restart untuk instans dengan ID acp-25nt4kk9whhok****, Anda dapat memanggil DescribeTasks dan mengatur ParentTaskId ke ID tugas batch dan AndroidInstanceId ke acp-25nt4kk9whhok****.

    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
    InvokeId

    string

    No

    ID eksekusi perintah. Anda dapat memasukkan requestId yang dikembalikan oleh operasi sebelumnya.

    B8ED2BA9-0C6A-5643-818F-B5D60A64****
    ResourceIds

    array

    No

    Daftar ID Sumber daya.

    string

    No

    ID Sumber daya. Jika Anda mengkueri status tugas operasi pengaktifan, penghentian, restart, dan reset cloud phone, atur parameter ini ke ID instans.

    acp-25nt4kk9whhok****
    TaskIds

    array

    No

    Daftar ID tugas.

    string

    No

    ID tugas.

    t-bp67acfmxazb4p****
    ParentTaskId

    string

    No

    ID tugas induk.

    t-iaej5dkbnmivx****
    TaskType

    string

    No

    Tipe tugas.

    Valid values:

    • BackupFile :

      Pencadangan data.

    • StopInstance :

      Penghentian instans.

    • RebootInstance :

      Restart instans.

    • StartApp :

      Pengaktifan aplikasi.

    • SendFile :

      Unggah file.

    • RunCommand :

      Perintah jarak jauh.

    • RestartApp :

      Restart aplikasi.

    • ResetInstance :

      Reset instans.

    • RecoverFile :

      Pemulihan data.

    • UninstallApp :

      Penghapusan instalasi aplikasi.

    • StopApp :

      Penghentian aplikasi.

    • Screenshot :

      Tangkapan layar.

    • InstallApp :

      Instalasi aplikasi.

    • FetchFile :

      Unduh file.

    • UpdateGroupImage :

      Penggantian image.

    • StartInstance :

      Pengaktifan instans.

    StartInstance
    TaskTypes

    array

    No

    Daftar tipe tugas.

    string

    No

    Tipe tugas.

    StartInstance
    TaskStatus

    string

    No

    Status tugas.

    Valid values:

    • PartFinished :

      Sebagian berhasil.

    • Finished :

      Selesai.

    • Failed :

      Gagal.

    • Skipped :

      Dilewati.

    • Processing :

      Berjalan.

    • Waiting :

      Menunggu.

    Processing
    TaskStatuses

    array

    No

    Daftar status tugas.

    string

    No

    Status tugas.

    Finished
    Level

    integer

    No

    Level tugas. Nilai 1 menunjukkan tugas batch. Nilai 2 menunjukkan tugas tingkat instans.

    1
    InstanceId

    string

    No

    ID instans.

    acp-2zecay9ponatdc4m****
    InstanceName

    string

    No

    Nama instans.

    defaultInstanceName
    Param

    string

    No

    Bidang tambahan.

    param
    MaxResults

    integer

    No

    Jumlah entri maksimum per halaman untuk kueri berhalaman. Nilai valid: 1 hingga 100. Nilai default: 10.

    10
    NextToken

    string

    No

    Token yang menentukan posisi awal untuk pembacaan. Jika parameter ini dikosongkan, pembacaan dimulai dari awal.

    FFbc8N4E1iOlcSxC+8boa0HHH2LKWbggYUinyrZWvtS1oTrMYCg1HuMLGuftj0****

    Elemen respons

    Element

    Type

    Description

    Example

    object

    Parameter tanggapan.

    NextToken

    string

    Token yang menentukan posisi awal untuk pembacaan. Jika parameter ini dikosongkan, pembacaan dimulai dari awal.

    AAAAAV3MpHK1AP0pfERHZN5pu6kU+SQXzm0H9mu/FiSc****
    Data

    array<object>

    Daftar objek hasil yang dikembalikan.

    object

    Objek hasil yang dikembalikan.

    TaskId

    string

    ID tugas.

    t-bp67acfmxazb4p****
    InvokeId

    string

    ID eksekusi perintah.

    B8ED2BA9-0C6A-5643-818F-B5D60A64****
    RegionId

    string

    ID wilayah.

    cn-hangzhou
    ResourceId

    string

    ID Sumber daya.

    acp-25nt4kk9whhok****
    TaskType

    string

    Tipe tugas.

    StartInstance
    TaskStatus

    string

    Status tugas.

    Processing
    StartTime

    string

    Waktu mulai tugas. Pengatur waktu ditampilkan dalam UTC dan mengikuti standar ISO 8601.

    2022-10-11T08:53:32Z
    FinishTime

    string

    Waktu akhir tugas. Pengatur waktu ditampilkan dalam UTC dan mengikuti standar ISO 8601.

    2022-10-11T08:53:32Z
    Param

    string

    Parameter tugas.

    param
    Result

    string

    Hasil eksekusi tugas.

    {'Success': True}
    ErrorCode

    string

    Kode kesalahan.

    SendFileFailed
    ErrorMsg

    string

    Paket kesalahan.

    connect error.
    Level

    integer

    Level tugas.

    1
    FailedChildCount

    integer

    Jumlah total tugas turunan yang gagal.

    2
    SuccessChildCount

    integer

    Jumlah total tugas turunan yang berhasil.

    98
    RunningChildCount

    integer

    Jumlah total tugas turunan yang berjalan.

    0
    TotalChildCount

    integer

    Jumlah total tugas turunan untuk tugas batch saat ini.

    100
    InstanceId

    string

    ID instans.

    acp-uto81vfd8t8z****
    InstanceName

    string

    Nama instans.

    defaultInstanceName
    InstanceStatus

    string

    Status instans.

    RUNNING
    Operator

    string

    Operator.

    test
    ParentTaskId

    string

    ID tugas induk.

    t-41oan3tza16vs****
    TotalCount

    integer

    Jumlah total entri.

    10
    RequestId

    string

    ID permintaan.

    B8ED2BA9-0C6A-5643-818F-B5D60A64****

    Contoh

    Respons sukses

    JSONformat

    {
  "NextToken": "AAAAAV3MpHK1AP0pfERHZN5pu6kU+SQXzm0H9mu/FiSc****",
  "Data": [
    {
      "TaskId": "t-bp67acfmxazb4p****",
      "InvokeId": "B8ED2BA9-0C6A-5643-818F-B5D60A64****",
      "RegionId": "cn-hangzhou",
      "ResourceId": "acp-25nt4kk9whhok****",
      "TaskType": "StartInstance",
      "TaskStatus": "Processing",
      "StartTime": "2022-10-11T08:53:32Z",
      "FinishTime": "2022-10-11T08:53:32Z",
      "Param": "param",
      "Result": "{'Success': True}",
      "ErrorCode": "SendFileFailed",
      "ErrorMsg": "connect error.",
      "Level": 1,
      "FailedChildCount": 2,
      "SuccessChildCount": 98,
      "RunningChildCount": 0,
      "TotalChildCount": 100,
      "InstanceId": "acp-uto81vfd8t8z****",
      "InstanceName": "defaultInstanceName",
      "InstanceStatus": "RUNNING",
      "Operator": "test",
      "ParentTaskId": "t-41oan3tza16vs****"
    }
  ],
  "TotalCount": 10,
  "RequestId": "B8ED2BA9-0C6A-5643-818F-B5D60A64****"
}

    Kode kesalahan

    Lihat Error Codes untuk daftar lengkap.

    Catatan rilis

    Lihat Release Notes untuk daftar lengkap.