All Products
Search
Document Center

Auto Scaling:ModifyScheduledTask

Last Updated:May 25, 2026

Memodifikasi tugas terjadwal. Jika tugas terjadwal yang ada tidak lagi memenuhi kebutuhan bisnis Anda, Anda dapat memanggil operasi ModifyScheduledTask untuk mengubah atribut tugas—seperti aturan penskalaan yang akan dijalankan, pengulangan tugas terjadwal, dan kebijakan pengulangan—tanpa perlu membuat tugas baru.

Catatan penggunaan

Tugas terjadwal mendukung metode penskalaan berikut:

  • ScheduledAction: Tentukan aturan penskalaan yang sudah ada yang ingin dijalankan oleh Auto Scaling saat tugas terjadwal dipicu.

  • ScalingGroupId: Tentukan jumlah minimum, maksimum, atau jumlah instans yang diharapkan untuk grup penskalaan tempat tugas terjadwal tersebut berada.

Catatan

Anda tidak dapat menentukan ScheduledAction dan ScalingGroupId secara bersamaan.

Debugging

OpenAPI Explorer secara otomatis menghitung nilai signature. Untuk kenyamanan Anda, kami menyarankan agar Anda memanggil operasi ini di OpenAPI Explorer. OpenAPI Explorer menghasilkan kode contoh operasi ini secara dinamis untuk berbagai SDK.

Parameter permintaan

Parameter

Type

Required

Example

Description

Action

String

Yes

ModifyScheduledTask

Operasi yang ingin Anda lakukan. Tetapkan nilainya ke ModifyScheduledTask.

ScheduledTaskId

String

Yes

edRtShc57WGXdt8TlPbr****

ID tugas terjadwal.

ScheduledTaskName

String

No

scheduled****

Nama tugas terjadwal. Nama tugas terjadwal harus terdiri dari 2 hingga 64 karakter dan dapat berisi huruf, angka, titik (.), garis bawah (_), dan tanda hubung (-). Nama harus dimulai dengan huruf atau angka. Nama setiap tugas terjadwal harus unik dalam satu wilayah dan dalam satu Akun Alibaba Cloud.

Description

String

No

Test scheduled task.

Deskripsi tugas terjadwal. Deskripsi dapat terdiri dari 1 hingga 200 karakter.

ScheduledAction

String

No

ari:acs:ess:cn-hangzhou:14069264****:scalingrule/asr-bp12tcnol686y1ik****

ID grup penskalaan yang dijalankan oleh Auto Scaling saat tugas terjadwal dipicu. Anda dapat memperoleh ID aturan penskalaan pada halaman detail aturan tersebut. Parameter ini hanya tersedia jika Anda menentukan ScheduledAction.

Catatan

Jika Anda menentukan ScheduledAction, Anda tidak dapat menentukan ScalingGroupId.

RecurrenceEndTime

String

No

2014-08-20T16:55Z

Waktu akhir tugas terjadwal. Tentukan waktu dalam standar ISO 8601 dengan format YYYY-MM-DDThh:mmZ. Waktu harus dalam UTC. Anda tidak dapat menentukan waktu yang lebih dari 365 hari sejak waktu modifikasi tugas terjadwal.

LaunchTime

String

No

2014-08-18T10:52Z

Waktu eksekusi tugas terjadwal. Tentukan waktu dalam standar ISO 8601 dengan format YYYY-MM-DDThh:mmZ. Waktu harus dalam UTC. Anda tidak dapat menentukan waktu yang lebih dari 90 hari sejak waktu modifikasi tugas terjadwal.

  • Jika Anda menentukan RecurrenceType, tugas terjadwal akan dijalankan berulang kali pada waktu yang ditentukan oleh LaunchTime.

  • Jika Anda tidak menentukan RecurrenceType, tugas terjadwal hanya dijalankan sekali pada waktu yang ditentukan oleh LaunchTime.

RecurrenceType

String

No

Daily

Jenis siklus eksekusi berulang tugas terjadwal. Tugas terjadwal dapat dijalankan per hari, per minggu, atau per bulan. Nilai yang valid:

  • Daily: Tugas terjadwal dijalankan berulang setiap jumlah hari tertentu.

  • Weekly: Tugas terjadwal dijalankan pada hari-hari tertentu dalam seminggu.

  • Monthly: Tugas terjadwal dijalankan pada tanggal-tanggal tertentu dalam sebulan.

  • Cron: Tugas terjadwal dijalankan berdasarkan ekspresi cron yang ditentukan.

Pastikan bahwa nilai yang Anda tentukan untuk RecurrenceType dan RecurrenceValue tetap valid secara bersamaan setelah Anda memodifikasi tugas terjadwal.

RecurrenceValue

String

No

2

Nilai numerik yang sesuai dengan siklus eksekusi berulang tugas terjadwal.

  • Jika Anda menetapkan RecurrenceType ke Daily, Anda hanya dapat menentukan satu nilai untuk parameter ini. Nilai yang valid: 1 hingga 31.

  • Jika Anda menetapkan RecurrenceType ke Weekly, Anda dapat menentukan beberapa nilai untuk parameter ini. Pisahkan nilai-nilai tersebut dengan koma (,). Misalnya, nilai yang mewakili Minggu, Senin, Selasa, Rabu, Kamis, Jumat, dan Sabtu adalah 0, 1, 2, 3, 4, 5, dan 6.

  • Jika Anda menetapkan RecurrenceType ke Monthly, Anda dapat menentukan dua nilai dalam format A-B. Nilai A dan B yang valid: 1 hingga 31. B harus lebih besar dari atau sama dengan A.

  • Jika Anda menetapkan RecurrenceType ke Cron, Anda dapat menentukan ekspresi cron. Ekspresi cron ditulis dalam waktu UTC dan terdiri dari bidang-bidang berikut: menit, jam, hari, bulan, dan minggu. Ekspresi tersebut dapat berisi huruf L dan W serta karakter wildcard berikut: koma (,), tanda tanya (?), tanda hubung (-), tanda bintang (*), tanda pagar (#), dan garis miring (/).

Pastikan bahwa nilai yang Anda tentukan untuk RecurrenceType dan RecurrenceValue tetap valid secara bersamaan setelah Anda memodifikasi tugas terjadwal.

TaskEnabled

Boolean

No

true

Menentukan apakah tugas terjadwal diaktifkan. Nilai yang valid:

  • true

  • false

Nilai default: true.

LaunchExpirationTime

Integer

No

600

Durasi waktu di mana Auto Scaling dapat mencoba kembali menjalankan tugas terjadwal jika terjadi kegagalan. Satuan: detik. Nilai yang valid: 0 hingga 1800.

Nilai default: 600.

MinValue

Integer

No

0

Jumlah minimum instans yang harus dipertahankan dalam grup penskalaan. Parameter ini hanya tersedia jika Anda menentukan ScalingGroupId.

MaxValue

Integer

No

10

Jumlah maksimum instans yang dapat dimuat dalam grup penskalaan. Parameter ini hanya tersedia jika Anda menentukan ScalingGroupId.

DesiredCapacity

Integer

No

10

Jumlah instans yang diharapkan dalam grup penskalaan. Parameter ini hanya tersedia jika Anda menentukan ScalingGroupId.

Catatan

Parameter ini hanya berlaku jika Anda menentukan DesiredCapacity saat membuat grup penskalaan.

ScalingGroupId

String

No

asg-bp18p2yfxow2dloq****

ID grup penskalaan yang tugas terjadwalnya ingin Anda modifikasi. Jika Anda menentukan ScalingGroupId, Anda juga harus menentukan salah satu parameter berikut: MinValue, MaxValue, atau DesiredCapacity.

Catatan

Jika Anda menentukan ScalingGroupId, Anda tidak dapat menentukan ScheduledAction.

RegionId

String

No

cn-hangzhou

ID wilayah grup penskalaan.

Parameter respons

Parameter

Type

Example

Description

RequestId

String

473469C7-AA6F-4DC5-B3DB-A3DC0DE3****

ID permintaan.

Contoh

Permintaan contoh

http(s)://ess.aliyuncs.com/?Action=ModifyScheduledTask
&ScheduledTaskId=edRtShc57WGXdt8TlPbr****
&ScheduledTaskName=scheduled****
&Description=Test scheduled task.
&ScheduledAction=ari:acs:ess:cn-hangzhou:14069264****:scalingrule/asr-bp12tcnol686y1ik****
&RecurrenceEndTime=2014-08-20T16:55Z
&LaunchTime=2014-08-18T10:52Z
&RecurrenceType=Daily
&RecurrenceValue=2
&TaskEnabled=true
&LaunchExpirationTime=600
&MinValue=0
&MaxValue=10
&DesiredCapacity=10
&ScalingGroupId=asg-bp18p2yfxow2dloq****
&RegionId=cn-hangzhou
&<Common request parameters>

Respons sukses contoh

XML format

HTTP/1.1 200 OK
Content-Type:application/xml

<ModifyScheduledTaskResponse>
    <RequestId>473469C7-AA6F-4DC5-B3DB-A3DC0DE3****</RequestId>
</ModifyScheduledTaskResponse>

JSON format

HTTP/1.1 200 OK
Content-Type:application/json

{
  "RequestId" : "473469C7-AA6F-4DC5-B3DB-A3DC0DE3****"
}

Kode kesalahan

Untuk daftar kode kesalahan, lihat Service error codes.

HTTP status code

Error code

Error message

Description

404

InvalidScheduledTaskId.NotFound

The specified scheduled task does not exist.

Tugas terjadwal yang ditentukan tidak ada dalam Akun Alibaba Cloud.

400

InvalidScheduledTaskName.Duplicate

The specified value of parameter

ScheduledTaskName

is duplicated.

Tugas terjadwal dengan nama tersebut sudah ada.

400

ScheduledAction.RegionMismatch

The specified scheduled task and the specified scheduled action are not in the same Region.

Aturan penskalaan dan tugas terjadwal yang ditentukan berada di wilayah yang berbeda.