All Products
Search
Document Center

Auto Scaling:ModifyScheduledTask

Last Updated:Jun 12, 2026

Mengubah parameter konfigurasi tugas terjadwal yang ada dengan menentukan ID tugas. Anda dapat mengubah parameter seperti aturan penskalaan yang akan dijalankan, jumlah instans dalam grup penskalaan, frekuensi eksekusi tugas, dan kebijakan pengulangan.

Deskripsi operasi

Tugas terjadwal mendukung dua metode penskalaan:

  • 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:ModifyScheduledTask

update

*ScalingGroup

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

None None

Parameter permintaan

Parameter

Type

Required

Description

Example

ScheduledTaskId

string

Yes

ID tugas terjadwal.

edRtShc57WGXdt8TlPbr****

ScheduledTaskName

string

No

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

scheduled****

Description

string

No

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

Test scheduled task.

ScheduledAction

string

No

Pengenal unik aturan penskalaan yang akan dijalankan. Parameter ini hanya berlaku ketika metode penskalaan diatur untuk menggunakan aturan penskalaan yang ada. Anda dapat melihat pengenal tersebut pada halaman detail aturan penskalaan.

Catatan

Anda tidak dapat menentukan ScheduledAction dan ScalingGroupId secara bersamaan.

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

RecurrenceEndTime

string

No

Pengatur waktu akhir untuk eksekusi berulang tugas terjadwal. Tentukan pengatur waktu dalam standar ISO 8601 dengan format YYYY-MM-DDThh:mmZ. Pengatur waktu harus dalam UTC. Pengatur waktu akhir tidak boleh lebih dari 365 hari dari tanggal modifikasi.

2014-08-20T16:55Z

LaunchTime

string

No

Pengatur waktu pelaksanaan tugas terjadwal. Tentukan pengatur waktu dalam standar ISO 8601 dengan format YYYY-MM-DDThh:mmZ. Pengatur waktu harus dalam UTC. Pengatur waktu tidak boleh lebih dari 90 hari dari tanggal modifikasi.

  • Jika Anda menentukan RecurrenceType, pengatur waktu yang ditentukan oleh parameter ini digunakan sebagai pengatur waktu default untuk setiap pengulangan.

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

2014-08-18T10:52Z

RecurrenceType

string

No

Tipe pengulangan tugas terjadwal. Tugas dapat dijalankan berdasarkan jadwal harian, mingguan, bulanan, atau ekspresi cron. Nilai 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.

Setelah modifikasi, RecurrenceType dan RecurrenceValue harus sama-sama valid.

Daily

RecurrenceValue

string

No

Nilai yang sesuai dengan tipe 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 (,). Misalnya, nilai untuk Minggu, Senin, Selasa, Rabu, Kamis, Jumat, dan Sabtu adalah 0,1,2,3,4,5,6.

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

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

Setelah modifikasi, RecurrenceType dan RecurrenceValue harus sama-sama valid.

2

TaskEnabled

boolean

No

Apakah akan mengaktifkan tugas terjadwal. Nilai valid:

  • true: Diaktifkan.

  • false: Dinonaktifkan.

Nilai default: true.

true

LaunchExpirationTime

integer

No

Periode waktu saat Penyesuaian Skala Otomatis mencoba kembali eksekusi tugas terjadwal setelah operasi yang dipicu gagal. Unit: detik. Nilai valid: 0 hingga 1800.

Nilai default: 600.

600

MinValue

integer

No

Jumlah minimum instans dalam grup penskalaan. Parameter ini hanya berlaku ketika metode penskalaan diatur untuk mengonfigurasi jumlah instans dalam grup penskalaan.

0

MaxValue

integer

No

Jumlah maksimum instans dalam grup penskalaan. Parameter ini hanya berlaku ketika metode penskalaan diatur untuk mengonfigurasi jumlah instans dalam grup penskalaan.

10

DesiredCapacity

integer

No

Jumlah instans yang diharapkan dalam grup penskalaan. Parameter ini hanya berlaku ketika metode penskalaan diatur untuk mengonfigurasi jumlah instans dalam grup penskalaan.

Catatan

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

10

ScalingGroupId

string

No

ID grup penskalaan yang ingin Anda ubah jumlah instansnya saat tugas terjadwal dipicu. Parameter ini hanya berlaku ketika metode penskalaan diatur untuk mengonfigurasi jumlah instans dalam grup penskalaan. Setelah Anda menentukan ScalingGroupId, 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****

RegionId

string

No

ID wilayah.

cn-hangzhou

Elemen respons

Element

Type

Description

Example

object

RequestId

string

ID permintaan.

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

Contoh

Respons sukses

JSONformat

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

Kode kesalahan

HTTP status code

Error code

Error message

Description

400 Throttling Request was denied due to request throttling.

Lihat Error Codes untuk daftar lengkap.

Catatan rilis

Lihat Release Notes untuk daftar lengkap.