All Products
Search

This Product

    Auto Scaling:CreateScheduledTask

    Document Center

    Auto Scaling:CreateScheduledTask

    Last Updated:Jun 12, 2026

    Membuat tugas terjadwal. Anda dapat memanggil operasi CreateScheduledTask untuk membuat tugas terjadwal yang menjalankan aturan penskalaan tertentu pada waktu yang ditentukan untuk menskalakan sumber daya komputasi secara otomatis, membantu Anda memenuhi kebutuhan bisnis sekaligus mengendalikan biaya.

    Deskripsi operasi

    • Jika tugas terjadwal gagal memicu aturan penskalaan karena grup penskalaan sedang menjalankan aktivitas penskalaan atau dinonaktifkan, tugas terjadwal secara otomatis mencoba kembali dalam periode yang ditentukan oleh LaunchExpirationTime. Jika tidak, pemicu terjadwal akan dilewati.

    • Jika beberapa tugas terjadwal memicu aturan penskalaan untuk grup penskalaan yang sama pada waktu yang berdekatan, detail aktivitas penskalaan adalah sebagai berikut:

      • Grup penskalaan dengan jumlah instans yang diharapkan yang dikonfigurasi: Aktivitas penskalaan yang dipicu oleh beberapa tugas terjadwal adalah aktivitas penskalaan paralel. Misalnya, ketika beberapa tugas terjadwal dijalankan pada waktu yang berdekatan, grup penskalaan dapat memicu beberapa aktivitas penskalaan paralel secara bersamaan.

      • Grup penskalaan tanpa jumlah instans yang diharapkan yang dikonfigurasi: Tugas terjadwal yang dipicu paling awal menjalankan aktivitas penskalaan terlebih dahulu. Karena grup penskalaan hanya dapat memiliki satu aktivitas penskalaan pada satu waktu, tugas terjadwal berikutnya secara otomatis mencoba kembali dalam periode yang ditentukan oleh LaunchExpirationTime. Jika aktivitas penskalaan sebelumnya selesai sementara tugas terjadwal berikutnya masih mencoba kembali dalam LaunchExpirationTime, aturan penskalaan tugas terjadwal tersebut dijalankan dan aktivitas penskalaan yang sesuai dipicu.

    • Tugas terjadwal mendukung dua metode penskalaan berikut:

      • Gunakan parameter ScheduledAction untuk menentukan aturan penskalaan yang akan dijalankan.

      • Gunakan parameter ScalingGroupId untuk mengatur jumlah instans dalam grup penskalaan.

      Catatan

      Anda tidak dapat menentukan ScheduledAction dan ScalingGroupId secara bersamaan.

    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

    Tabel berikut menjelaskan otorisasi yang diperlukan untuk memanggil API ini. Anda dapat menentukannya dalam kebijakan Resource Access Management (RAM). Kolom pada tabel dijelaskan sebagai berikut:

    • Action: Aksi yang dapat digunakan dalam elemen Action pada pernyataan kebijakan izin RAM untuk memberikan izin guna melakukan operasi tersebut.

    • API: API yang dapat Anda panggil untuk melakukan aksi tersebut.

    • Access level: Tingkat akses yang telah ditentukan untuk setiap API. Nilai yang valid: create, list, get, update, dan delete.

    • Resource type: Jenis resource yang mendukung otorisasi untuk melakukan aksi tersebut. Ini menunjukkan apakah aksi tersebut mendukung izin tingkat resource. Resource yang ditentukan harus kompatibel dengan aksi tersebut. Jika tidak, kebijakan tersebut tidak akan berlaku.

      • Untuk API dengan izin tingkat resource, jenis resource yang diperlukan ditandai dengan tanda bintang (*). Tentukan Nama Sumber Daya Alibaba Cloud (ARN) yang sesuai dalam elemen Resource pada kebijakan.

      • Untuk API tanpa izin tingkat resource, ditampilkan sebagai All Resources. Gunakan tanda bintang (*) dalam elemen Resource pada kebijakan.

    • Condition key: Kunci kondisi yang didefinisikan oleh layanan. Kunci ini memungkinkan kontrol granular, berlaku baik hanya untuk aksi maupun untuk aksi yang terkait dengan resource tertentu. Selain kunci kondisi spesifik layanan, Alibaba Cloud menyediakan serangkaian common condition keys yang berlaku di semua layanan yang didukung RAM.

    • Dependent action: Aksi dependen yang diperlukan untuk menjalankan aksi tersebut. Untuk menyelesaikan aksi tersebut, pengguna RAM atau role RAM harus memiliki izin untuk melakukan semua aksi dependen.

    Action

    Access level

    Resource type

    Condition key

    Dependent action

    ess:CreateScheduledTask

    create

    *ScalingGroup

    acs:ess:{#regionId}:{#accountId}:scalinggroup/{#ScalingGroupId}

    		 None None

    Parameter permintaan

    Parameter

    Type

    Required

    Description

    Example
    RegionId

    string

    Yes

    ID wilayah tempat tugas terjadwal berada.

    cn-qingdao
    ScheduledTaskName

    string

    No

    Nama tugas terjadwal. Nama harus terdiri dari 2 hingga 64 karakter dan dapat berisi huruf, angka, garis bawah (_), tanda hubung (-), dan titik (.). Nama harus diawali dengan angka, huruf, atau karakter China. Nama harus unik dalam akun yang sama di wilayah yang sama.

    Nilai default: nilai ScheduledTaskId.

    scheduled****
    Description

    string

    No

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

    Test scheduled task.
    ScheduledAction

    string

    No

    Aturan penskalaan yang akan dijalankan saat tugas terjadwal dipicu. Atur parameter ini ke pengidentifikasi unik aturan penskalaan.

    Jika Anda menentukan ScheduledAction, metode penskalaan tugas terjadwal adalah menggunakan aturan penskalaan yang sudah ada. Anda tidak dapat menentukan ScheduledAction dan ScalingGroupId secara bersamaan.

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

    string

    No

    Waktu berakhir untuk eksekusi berulang 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 dari tanggal pembuatan.

    2014-08-17T16:55Z
    LaunchTime

    string

    No

    Waktu saat tugas terjadwal dipicu. 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 dari tanggal pembuatan.

    • Jika Anda menentukan RecurrenceType, parameter ini menentukan waktu di mana tugas dijalankan secara berulang secara default.

    • Jika Anda tidak menentukan RecurrenceType, tugas hanya dijalankan sekali pada tanggal dan waktu yang ditentukan.

    2014-08-17T16:52Z
    RecurrenceType

    string

    No

    Tipe pengulangan tugas terjadwal. Nilai yang valid:

    • Daily: Tugas terjadwal dijalankan setiap jumlah hari yang ditentukan.

    • Weekly: Tugas terjadwal dijalankan pada hari-hari tertentu setiap minggu.

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

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

    Anda harus menentukan RecurrenceType dan RecurrenceValue secara bersamaan.

    Daily
    RecurrenceValue

    string

    No

    Nilai pengulangan tugas terjadwal.

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

    • Jika RecurrenceType diatur ke Weekly, Anda dapat menentukan beberapa nilai yang dipisahkan dengan koma (,). Nilai untuk Minggu, Senin, Selasa, Rabu, Kamis, Jumat, dan Sabtu adalah 0,1,2,3,4,5,6.

    • Jika RecurrenceType diatur ke Monthly, nilainya dalam format A-B. Nilai yang valid untuk A dan B: 1 hingga 31. B harus lebih besar dari atau sama dengan A.

    • Jika RecurrenceType diatur ke Cron, nilainya adalah ekspresi cron berbasis UTC yang mendukung lima bidang: menit, jam, hari, bulan, dan hari dalam seminggu. Karakter wildcard berikut didukung: koma (,), tanda tanya (?), tanda hubung (-), tanda bintang (*), tanda pagar (#), garis miring (/), L, dan W.

    Anda harus menentukan RecurrenceType dan RecurrenceValue secara bersamaan.

    1
    TaskEnabled

    boolean

    No

    Menentukan apakah akan mengaktifkan tugas terjadwal. Nilai yang valid:

    • true: mengaktifkan tugas.

    • false: menonaktifkan tugas.

    Nilai default: true.

    true
    LaunchExpirationTime

    integer

    No

    Periode waktu di mana tugas terjadwal yang gagal dicoba kembali. Unit: detik. Nilai yang valid: 0 hingga 1800.

    Nilai default: 600.

    600
    MinValue

    integer

    No

    Jumlah minimum instans dalam grup penskalaan saat metode penskalaan tugas terjadwal adalah mengatur jumlah instans dalam grup penskalaan.

    0
    MaxValue

    integer

    No

    Jumlah maksimum instans dalam grup penskalaan saat metode penskalaan tugas terjadwal adalah mengatur jumlah instans dalam grup penskalaan.

    10
    DesiredCapacity

    integer

    No

    Jumlah instans yang diharapkan dalam grup penskalaan saat metode penskalaan tugas terjadwal adalah mengatur jumlah instans dalam grup penskalaan.

    Catatan

    Grup penskalaan harus mendukung fitur jumlah instans yang diharapkan. Ini berarti DesiredCapacity telah ditentukan saat grup penskalaan dibuat.

    10
    ScalingGroupId

    string

    No

    ID grup penskalaan yang jumlah instansnya ingin Anda ubah saat tugas terjadwal dipicu.

    Jika Anda menentukan ScalingGroupId, metode penskalaan tugas terjadwal adalah mengatur jumlah instans dalam grup penskalaan. Anda harus menentukan setidaknya satu dari MinValue, MaxValue, dan DesiredCapacity. Anda tidak dapat menentukan ScheduledAction dan ScalingGroupId secara bersamaan.

    asg-bp18p2yfxow2dloq****

    Elemen respons

    Element

    Type

    Description

    Example

    object

    ScheduledTaskId

    string

    ID tugas terjadwal. ID bersifat unik secara global dan dihasilkan oleh sistem.

    edRtShc57WGXdt8TlPbr****
    RequestId

    string

    ID permintaan.

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

    Contoh

    Respons sukses

    JSONformat

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

    Kode kesalahan

    Lihat Error Codes untuk daftar lengkap.

    Catatan rilis

    Lihat Release Notes untuk daftar lengkap.