All Products
Search

This Product

    Auto Scaling:CreateScheduledTask

    Document Center

    Auto Scaling:CreateScheduledTask

    Last Updated:May 25, 2026

    Membuat Tugas terjadwal. Tugas terjadwal adalah jenis tugas penskalaan yang telah ditentukan sebelumnya untuk mengeksekusi aturan penskalaan tertentu secara otomatis pada waktu yang telah dijadwalkan. Anda dapat memanggil operasi CreateScheduledTask guna menerapkan skalabilitas otomatis pada sumber daya komputasi, sehingga menjamin kelangsungan bisnis dan meminimalkan biaya sumber daya.

    Catatan penggunaan

    • Jika tugas terjadwal gagal karena adanya aktivitas penskalaan aktif dalam grup penskalaan atau karena grup penskalaan dinonaktifkan, tugas tersebut akan secara otomatis dicoba ulang selama jendela waktu yang ditentukan oleh parameter LaunchExpirationTime. Jika percobaan ulang otomatis tetap gagal, tugas terjadwal akan diabaikan pada waktu eksekusi yang telah ditentukan.

    • Jika beberapa tugas terjadwal mencoba menjalankan aturan penskalaan yang sama untuk suatu grup penskalaan secara bersamaan, berlaku aturan berikut:

      • Grup penskalaan dengan Expected Number of Instances yang dikonfigurasi: Aktivitas penskalaan yang dipicu oleh tugas terjadwal merupakan aktivitas penskalaan paralel. Dalam jendela waktu yang berdekatan, Auto Scaling dapat memicu beberapa tugas terjadwal dan menjalankan beberapa aktivitas penskalaan paralel secara bersamaan.

      • Grup penskalaan tanpa konfigurasi Expected Number of Instances: Hanya aktivitas penskalaan dari tugas terjadwal yang paling awal dieksekusi. Karena grup penskalaan hanya mengizinkan satu aktivitas penskalaan aktif dalam satu waktu, tugas terjadwal lainnya akan secara otomatis mencoba ulang dalam jendela waktu yang ditentukan oleh LaunchExpirationTime. Setelah tugas pertama selesai, setiap percobaan ulang dari tugas lain dalam jendela waktu LaunchExpirationTime akan menyebabkan penerapan berkelanjutan aturan penskalaan, dengan setiap iterasi menghasilkan aktivitas penskalaan yang berbeda.

    • Anda dapat menggunakan salah satu metode berikut untuk menentukan mode penskalaan pada tugas terjadwal:

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

      • ScalingGroupId: Tentukan jumlah minimum, maksimum, atau expected number of instances untuk grup penskalaan tempat Anda membuat tugas terjadwal.

    Debugging

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

    Parameter permintaan

    Parameter

    Type

    Required

    Example

    Description

    Action

    String

    Yes

    CreateScheduledTask

    Operasi yang ingin Anda lakukan. Tetapkan nilainya ke CreateScheduledTask.

    RegionId

    String

    Yes

    cn-qingdao

    ID wilayah untuk tugas terjadwal.

    ScheduledTaskName

    String

    No

    scheduled****

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

    Jika Anda tidak menentukan parameter ini, nilai ScheduledTaskId yang digunakan.

    Description

    String

    No

    Test scheduled task.

    Deskripsi tugas terjadwal. Deskripsi harus terdiri dari 2 hingga 200 karakter.

    ScheduledAction

    String

    No

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

    Aturan penskalaan yang ingin Anda eksekusi saat tugas terjadwal dipicu. Tentukan pengenal unik aturan penskalaan tersebut.

    Jika Anda menentukan parameter ini, Anda harus menggunakan ScheduledAction untuk menentukan aturan penskalaan yang sudah ada dalam tugas terjadwal.

    Catatan

    Jika Anda menentukan ScheduledAction, Anda tidak dapat menentukan ScalingGroupId.

    RecurrenceEndTime

    String

    No

    2014-08-17T16:55Z

    Waktu berakhir tugas terjadwal.

    Tentukan waktu dalam standar ISO 8601 dengan format YYYY-MM-DDThh:mmZ. Tugas terjadwal harus berakhir paling lambat 365 hari setelah dibuat.

    LaunchTime

    String

    Yes

    2014-08-17T16:52Z

    Waktu mulai tugas terjadwal.

    Tentukan waktu dalam standar ISO 8601 dengan format Tugas terjadwal harus dimulai paling lambat 90 hari setelah dibuat.

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

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

    RecurrenceType

    String

    No

    Daily

    Interval pengulangan eksekusi tugas terjadwal. Nilai yang valid:

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

    • Weekly: Tugas terjadwal dipicu berulang kali pada hari-hari tertentu setiap minggu.

    • Monthly: Tugas terjadwal dijalankan pada hari tertentu setiap bulan.

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

    Jika Anda menentukan RecurrenceType, Anda juga harus menentukan RecurrenceValue.

    RecurrenceValue

    String

    No

    1

    Jumlah pengulangan eksekusi tugas terjadwal.

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

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

    • Jika Anda mengatur parameter 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 mengatur parameter 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 (/).

    Jika Anda menentukan RecurrenceType, Anda juga harus menentukan RecurrenceValue.

    TaskEnabled

    Boolean

    No

    true

    Menentukan apakah tugas terjadwal diaktifkan.

    • true

    • false

    Nilai default: true.

    LaunchExpirationTime

    Integer

    No

    600

    Periode waktu selama tugas terjadwal yang gagal dapat dicoba ulang. Satuan: detik. Nilai yang valid: 0 hingga 21600.

    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 tempat tugas terjadwal diterapkan.

    Jika Anda menentukan parameter ini, Anda juga harus menentukan minimal satu dari parameter berikut: MinValue, MaxValue, dan DesiredCapacity.

    Catatan

    Jika Anda menentukan ScalingGroupId, Anda tidak dapat menentukan ScheduledAction.

    Parameter respons

    Parameter

    Type

    Example

    Description

    ScheduledTaskId

    String

    edRtShc57WGXdt8TlPbr****

    Pengenal unik yang dihasilkan sistem untuk tugas terjadwal di tingkat global.

    RequestId

    String

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

    ID permintaan.

    Contoh

    Contoh permintaan

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

    Contoh respons sukses

    XML format

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

<CreateScheduledTaskResponse>
    <ScheduledTaskId>edRtShc57WGXdt8TlPbr****</ScheduledTaskId>
    <RequestId>473469C7-AA6F-4DC5-B3DB-A3DC0DE3****</RequestId>
</CreateScheduledTaskResponse>

    JSON format

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

{
  "ScheduledTaskId" : "edRtShc57WGXdt8TlPbr****",
  "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

    InvalidRegionId.NotFound

    The specified region does not exist.

    Wilayah yang ditentukan tidak ada.

    400

    InvalidScheduledTaskName.Duplicate

    The specified value of parameter ScheduledTaskName is duplicated.

    Tugas terjadwal dengan nama tersebut sudah ada.

    400

    QuotaExceeded.ScheduledTask

    Scheduled task quota exceeded.

    Akun saat ini telah mencapai kapasitas maksimum untuk tugas terjadwal.

    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.