全部产品
Search
文档中心

Resource Orchestration Service:ALIYUN::ESS::ScheduledTask

更新时间:Jun 26, 2025

ALIYUN::ESS::ScheduledTask digunakan untuk membuat tugas terjadwal dengan menentukan properti.

Sintaks

{
  "Type": "ALIYUN::ESS::ScheduledTask",
  "Properties": {
    "TaskEnabled": Boolean,
    "Description": String,
    "ScheduledTaskName": String,
    "LaunchExpirationTime": Integer,
    "LaunchTime": String,
    "RecurrenceEndTime": String,
    "RecurrenceType": String,
    "RecurrenceValue": String,
    "ScheduledAction": String,
    "MaxValue": Integer,
    "MinValue": Integer,
    "DesiredCapacity": Integer,
    "ScalingGroupId": String
  }
}

Properti

Properti

Tipe

Diperlukan

Dapat Diedit

Deskripsi

Batasan

TaskEnabled

Boolean

Tidak

Ya

Menentukan apakah akan mengaktifkan tugas terjadwal.

Nilai valid:

  • true (default)

  • false

Description

String

Tidak

Ya

Deskripsi dari tugas terjadwal.

Deskripsi harus memiliki panjang 2 hingga 200 karakter.

ScheduledTaskName

String

Tidak

Ya

Nama tampilan dari tugas terjadwal.

Nama tampilan harus memiliki panjang 2 hingga 40 karakter, dan dapat berisi angka, huruf, garis bawah (_), tanda hubung (-), dan titik (.). Harus dimulai dengan angka atau huruf.

Nama tampilan harus unik dalam akun di suatu wilayah.

Jika Anda tidak menentukan properti ini, nilai default adalah nilai ScheduledScalingTaskId.

LaunchExpirationTime

Integer

Tidak

Ya

Periode waktu selama sistem mencoba kembali tugas terjadwal jika gagal dipicu.

Nilai valid: 0 hingga 21600.

Satuan: detik.

Nilai default: 600.

LaunchTime

String

Ya

Ya

Waktu saat tugas terjadwal dipicu.

Tentukan waktu dalam standar ISO 8601 dalam format YYYY-MM-DDThh:mmZ.

Waktu harus dalam UTC.

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

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

Anda tidak dapat menentukan waktu yang lebih dari 90 hari setelah hari tugas terjadwal dibuat atau dimodifikasi.

RecurrenceEndTime

String

Tidak

Ya

Waktu berakhirnya tugas terjadwal yang dijalankan berulang kali.

Tentukan waktu dalam standar ISO 8601 dalam format YYYY-MM-DDThh:mmZ.

Waktu harus dalam UTC.

Anda tidak dapat menentukan waktu yang lebih dari 90 hari setelah hari tugas terjadwal dibuat atau dimodifikasi.

Anda harus menentukan properti berikut dalam permintaan: RecurrenceType, RecurrenceValue, dan RecurrenceEndTime.

RecurrenceType

String

Tidak

Ya

Interval saat tugas terjadwal dijalankan berulang kali.

Nilai valid:

  • Harian: Tugas terjadwal dijalankan berulang kali setiap jumlah hari tertentu.

  • Mingguan: Tugas terjadwal dijalankan berulang kali pada hari-hari tertentu setiap minggu.

  • Bulanan: Tugas terjadwal dijalankan berulang kali pada hari-hari tertentu setiap bulan.

  • Cron: Tugas terjadwal dijalankan berulang kali berdasarkan ekspresi CRON yang ditentukan.

Anda harus menentukan properti berikut dalam permintaan: RecurrenceType, RecurrenceValue, dan RecurrenceEndTime.

RecurrenceValue

String

Tidak

Ya

Nilai pengulangan dari tugas terjadwal yang dijalankan berulang kali.

Nilai valid:

  • Jika Anda menetapkan RecurrenceType ke Harian, Anda harus menetapkan RecurrenceValue ke nilai yang berkisar antara 1 hingga 31.

  • Jika Anda menetapkan RecurrenceType ke Mingguan, Anda harus menetapkan RecurrenceValue ke satu atau lebih nilai yang berkisar antara 0 hingga 6. Angka dalam rentang 0 hingga 6 masing-masing menentukan hari dalam seminggu dari Minggu hingga Sabtu. Pisahkan beberapa nilai dengan koma (,)

  • Jika Anda menetapkan RecurrenceType ke Bulanan, Anda harus menetapkan RecurrenceValue ke dua nilai dalam format A-B. A dan B berkisar antara 1 hingga 31. B harus lebih besar dari atau sama dengan A.

  • Jika Anda menetapkan RecurrenceType ke Cron, Anda harus menetapkan RecurrenceValue ke ekspresi CRON. Ekspresi CRON menunjukkan waktu UTC dan mendukung bidang berikut: menit, jam, hari dalam sebulan, bulan, dan hari dalam seminggu. Ekspresi CRON mendukung huruf L dan W serta karakter khusus berikut: , ? - * # /

Anda harus menentukan properti berikut dalam permintaan: RecurrenceType, RecurrenceValue, dan RecurrenceEndTime.

ScheduledAction

String

Tidak

Ya

Operasi yang dilakukan saat tugas terjadwal dipicu.

Nilainya bisa mencapai 200 karakter.

Tetapkan nilainya sebagai pengenal unik aturan penskalaan.

MaxValue

Integer

Tidak

Ya

Jumlah maksimum instans dalam grup penskalaan jika Anda menentukan ScalingGroupId.

Tidak ada.

MinValue

Integer

Tidak

Ya

Jumlah minimum instans dalam grup penskalaan jika Anda menentukan ScalingGroupId.

Tidak ada.

DesiredCapacity

Integer

Tidak

Ya

Jumlah instans yang diharapkan dalam grup penskalaan jika Anda menentukan ScalingGroupId.

Anda harus menentukan DesiredCapacity saat membuat grup penskalaan.

ScalingGroupId

String

Tidak

Ya

ID grup penskalaan yang jumlah instansnya harus diubah saat tugas terjadwal dipicu.

Jika Anda menentukan ScalingGroupId, tugas terjadwal melakukan penskalaan berdasarkan jumlah instans yang ditentukan dalam grup penskalaan. Dalam hal ini, Anda harus menentukan setidaknya salah satu properti berikut: MinValue, MaxValue, dan DesiredCapacity.

Catatan

Anda tidak dapat menentukan kedua ScheduledAction dan ScalingGroupId.

Nilai Pengembalian

Fn::GetAtt

ScheduledTaskId: ID dari tugas terjadwal. ID ini unik secara global dan dibuat oleh sistem.

Contoh

  • YAML format

    ROSTemplateFormatVersion: '2015-09-01'
    Resources:
      ScheduledTask:
        Type: ALIYUN::ESS::ScheduledTask
        Properties:
          TaskEnabled: 'true'
          Description: scheduledtask
          ScheduledTaskName: task1
          LaunchTime: 2014-08-17T16:52Z
          RecurrenceEndTime: 2014-08-17T16:55Z
          RecurrenceType: Daily
          RecurrenceValue: '1'
          ScheduledAction: ari:acs:ess:cn-qingdao:1344371:scalingRule/cCBpdYdQuBe2cUxOdu6piOk
    Outputs:
      ScheduledTaskId:
        Value:
          FN::GetAtt:
            - ScheduledTask
            - ScheduledTaskId
  • JSON format

    {
      "ROSTemplateFormatVersion": "2015-09-01",
      "Resources": {
        "ScheduledTask": {
          "Type": "ALIYUN::ESS::ScheduledTask",
          "Properties": {
            "TaskEnabled": "true",
            "Description": "scheduledtask",
            "ScheduledTaskName": "task1",
            "LaunchTime": "2014-08-17T16:52Z",
            "RecurrenceEndTime": "2014-08-17T16:55Z",
            "RecurrenceType": "Daily",
            "RecurrenceValue": "1",
            "ScheduledAction": "ari:acs:ess:cn-qingdao:1344371:scalingRule/cCBpdYdQuBe2cUxOdu6piOk"
          }
        }
      },
      "Outputs": {
        "ScheduledTaskId": {
          "Value": {
            "FN::GetAtt": [
              "ScheduledTask",
              "ScheduledTaskId"
            ]
          }
        }
      }
    }