All Products
Search

This Product

    Auto Scaling:CreateScheduledTask

    Document Center

    Auto Scaling:CreateScheduledTask

    Last Updated:Sep 10, 2026

    Membuat tugas terjadwal.

    Deskripsi operasi

    Deskripsi operasi

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

    • Jika beberapa tugas terjadwal memicu aturan penskalaan untuk grup penskalaan yang sama dalam jangka waktu yang serupa, detail aktivitas penskalaan yang dipicu adalah sebagai berikut:

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

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

    • Tugas terjadwal mendukung dua metode penskalaan berikut:

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

      • Gunakan parameter ScalingGroupId untuk menentukan jumlah instans di grup penskalaan.

    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 Tionghoa. Nama harus unik dalam akun yang sama di wilayah yang sama.

    Nilai default: nilai dari 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 dieksekusi saat tugas terjadwal dipicu. Atur parameter ini ke pengenal unik aturan penskalaan.

    Jika Anda menentukan parameter ini, metode penskalaan tugas terjadwal adalah menggunakan aturan penskalaan yang ada.

    Catatan

    Anda tidak dapat menentukan ScheduledAction dan ScalingGroupId secara bersamaan.

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

    string

    No

    Waktu akhir pengulangan untuk tugas terjadwal.

    Tentukan waktu dalam standar ISO 8601 UTC. Format: YYYY-MM-DDThh:mmZ. Waktu akhir tidak boleh 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 UTC. Format: YYYY-MM-DDThh:mmZ. Waktu tidak boleh lebih dari 90 hari dari tanggal pembuatan.

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

    • Jika Anda tidak menentukan RecurrenceType, tugas hanya akan dieksekusi satu kali pada tanggal dan waktu yang ditentukan.

    2014-08-17T16:52Z
    RecurrenceType

    string

    No

    Tipe pengulangan tugas terjadwal. Nilai valid:

    • Daily: Tugas terjadwal dieksekusi sekali setiap jumlah hari yang ditentukan.

    • Weekly: Tugas terjadwal dieksekusi pada hari tertentu setiap minggu.

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

    • Cron: Tugas terjadwal dieksekusi 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 valid: 1 hingga 31.

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

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

    • Jika RecurrenceType diatur ke Cron, nilai 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

    Apakah akan mengaktifkan tugas terjadwal. Nilai valid:

    • true: Diaktifkan.

    • false: Dinonaktifkan.

    Nilai default: true.

    true
    LaunchExpirationTime

    integer

    No

    Periode waktu saat tugas terjadwal yang gagal dicoba ulang. Unit: seconds. Nilai valid: 0 hingga 1800.

    Nilai default: 600.

    600
    MinValue

    integer

    No

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

    0
    MaxValue

    integer

    No

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

    10
    DesiredCapacity

    integer

    No

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

    Catatan

    Grup penskalaan harus memiliki fitur jumlah instans yang diharapkan diaktifkan, yang berarti DesiredCapacity ditentukan saat grup penskalaan dibuat.

    10
    ScalingGroupId

    string

    No

    ID grup penskalaan yang jumlah instansnya dimodifikasi saat tugas terjadwal dipicu.

    Jika Anda menentukan parameter ini, metode penskalaan tugas terjadwal adalah mengatur jumlah instans di grup penskalaan. Anda harus menentukan nilai untuk setidaknya satu dari parameter berikut: MinValue, MaxValue, dan DesiredCapacity.

    Catatan

    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.