All Products
Search
Document Center

Cloud Phone:ModifyScheduledTask

Last Updated:Aug 08, 2026

Memodifikasi tugas terjadwal agen.

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.

Sintaks permintaan

POST  HTTP/1.1

Parameter permintaan

Parameter

Type

Required

Description

Example

ScheduledId

string

Yes

ID tugas terjadwal.

sch-260705-agb*****

TaskVersion

integer

Yes

Nomor versi CAS.

1

TaskName

string

No

Nama tugas.

NewTaskName.

UserPrompt

string

No

Prompt pengguna.

Jalankan tugas sinkronisasi data harian.

CronExpression

string

No

Ekspresi cron.

0 30 * * *

InstanceIds

array

No

Daftar ID instans.

["acp-5hh431emkt6u*****"]

string

No

Daftar ID instans cloud phone. Maksimal 3 instans dapat dikaitkan.

acp-5hh431emkt6u*****

Status

string

No

Mengalihkan status. Nilai yang valid: ACTIVE dan DISABLED.

ACTIVE.

RunConfig

object

No

Konfigurasi eksekusi.

{"maxSteps":10,"timeoutSeconds":3600}

Skills

array

No

Daftar ID skill. Maksimal 1 ID skill didukung. Nilai ini akan menimpa aim_task_config.run_config setelah modifikasi.

["sk-abc"]

string

No

MaxSteps

integer

No

Jumlah maksimum langkah eksekusi.

10

TimeoutSeconds

integer

No

Periode timeout, dalam detik.

3600

ExtraParams

string

No

String JSON parameter tambahan.

{"batchSize":"1000"}

Elemen respons

Element

Type

Description

Example

object

ApiResponse

RequestId

string

ID permintaan.

9A51B1DF-96FF-3BCC-B08C-783161D3****

Code

string

Kode status API.

200

Message

string

Pesan respons.

Success.

TotalCount

integer

Jumlah total catatan.

1

Tasks

array<object>

Daftar hasil modifikasi.

array<object>

Tugas.

ScheduledId

string

ID tugas terjadwal.

sch-260705-agbx*****

NewVersion

integer

Nomor versi CAS yang diperbarui.

2

InstanceResults

array<object>

Daftar hasil pengiriman batch untuk tugas terjadwal instans.

object

Hasil pengiriman tugas terjadwal instans.

InstanceId

string

ID instans.

acp-4dkmkip0l0uw*****

Success

boolean

Menunjukkan apakah operasi berhasil.

true.

ErrorMessage

string

Pesan error.

Instance not found.

Contoh

Respons sukses

JSONformat

{
  "RequestId": "9A51B1DF-96FF-3BCC-B08C-783161D3****",
  "Code": "200",
  "Message": "Success.",
  "TotalCount": 1,
  "Tasks": [
    {
      "ScheduledId": "sch-260705-agbx*****",
      "NewVersion": 2,
      "InstanceResults": [
        {
          "InstanceId": "acp-4dkmkip0l0uw*****",
          "Success": true,
          "ErrorMessage": "Instance not found."
        }
      ]
    }
  ]
}

Kode kesalahan

Lihat Error Codes untuk daftar lengkap.

Catatan rilis

Lihat Release Notes untuk daftar lengkap.