Menjadwalkan tugas monetisasi

Anda sedang melihat dokumentasi Apigee Edge.
Buka Dokumentasi Apigee X. info

Ringkasan tugas terjadwal

Monetisasi menyediakan penjadwal tugas dan serangkaian tugas yang telah dijadwalkan untuk dijalankan waktu yang ditentukan.

Tabel di bawah ini mencantumkan pekerjaan terjadwal yang disediakan oleh monetisasi dan waktunya dijadwalkan untuk berjalan (semua waktu yang tercantum dalam UTC). Tercantum juga pemicu untuk setiap tugas.

Selain lowongan yang tercantum di atas, ada tugas yang dapat Anda aktifkan melalui peristiwa notifikasi, seperti yang tercantum dalam tabel berikut. Untuk mengetahui informasi selengkapnya, lihat Menyiapkan notifikasi.

Mengelola jadwal tugas monetisasi menggunakan API

Bagian berikut menjelaskan cara mengelola jadwal tugas monetisasi menggunakan API:

• Mengonfigurasi pemicu
• Membuat ekspresi cron
• Melihat tugas terjadwal menggunakan API
• Memperbarui tugas terjadwal menggunakan API
• Menonaktifkan dan mengaktifkan kembali tugas terjadwal menggunakan API

Untuk mengetahui informasi selengkapnya tentang API yang dijelaskan di bagian ini, lihat Tugas terjadwal di API alamat IP internal.

Mengonfigurasi pemicu

Penjadwal bergantung pada {i>trigger<i} (pemicu) untuk menjalankan tugas. Tugas terjadwal dijalankan saat pemicu dieksekusi. Properti pemicu mengonfigurasi eksekusi tugas, dan dengan menyetel dari properti ini, Anda dapat mengontrol karakteristik eksekusi tugas seperti ketika sebuah tugas dieksekusi, dan seberapa sering.

Dua jenis pemicu yang paling umum adalah pemicu cron dan sederhana pemicu. Pemicu cron memiliki properti cronExpression yang menentukan jadwal eksekusi. Pemicu sederhana tidak memiliki properti cronExpression; Anda menentukan startTime untuk menunjukkan kapan pemicu diterapkan, dan secara opsional, endTime.

Properti pemicu adalah sebagai berikut (semua waktu yang tercantum dalam UTC):

Membuat ekspresi cron

Ekspresi cron adalah string yang terdiri dari enam atau tujuh kolom yang dipisahkan oleh ruang kosong. Tujuan ekspresi yang mewakili serangkaian waktu, biasanya sebagai jadwal untuk mengeksekusi suatu rutinitas. Cron ekspresi yang ditentukan dalam properti cronExpression pemicu digunakan untuk menjadwalkan eksekusi pemicu tersebut.

Dengan keterangan:

Karakter khusus didefinisikan sebagai berikut:

Berikut adalah beberapa contoh ekspresi cron (semua waktu tercantum dalam UTC):

Melihat tugas terjadwal menggunakan API

Anda dapat melihat semua tugas terjadwal saat ini dengan mengajukan permintaan GET ke /triggers?orgid={org_name}.

Contoh:

$ curl -H "Accept:application/json" -X GET \ "http://localhost:8080/v1/mint/triggers?orgid={org_name}" \ -u email:password

Berikut ini contoh responsnya:

[ {
  "createdDate" : 1457924378176,
  "cronExpression" : "3 0 0 * * ?",
  "enabled" : true,
  "group" : "management-server",
  "id" : "MINT.RESET_DEVELOPER_RATE_PLAN_COUNTER@@@management-server@@@DEFAULT@@@management-server@@@DEFAULT",
  "jobId" : "MINT.RESET_DEVELOPER_RATE_PLAN_COUNTER@@@management-server",
  "name" : "MINT.RESET_DEVELOPER_RATE_PLAN_COUNTER@@@management-server@@@DEFAULT",
  "priority" : "1",
  "suiteId" : "DEFAULT",
  "triggerDataMap" : {
    "custom_lock_key" : "mint.scheduler.__ORG_ID__.resetdeveloperrateplancounter@@@management"
  },
  "updatedDate" : 1457924378176
}, {
  "createdDate" : 1457924378014,
  "cronExpression" : "",
  "enabled" : true,
  "group" : "management-server",
  "id" : "MINT.ADHOC_NOTIFY@@@management-server@@@DEFAULT@@@management-server@@@DEFAULT",
  "jobId" : "MINT.ADHOC_NOTIFY@@@management-server",
  "name" : "MINT.ADHOC_NOTIFY@@@management-server@@@DEFAULT",
  "priority" : "4",
  "startTime" : "1372916749000",
  "suiteId" : "DEFAULT",
  "triggerDataMap" : {
    "custom_lock_key" : "mint.scheduler.__ORG_ID__.adhocnotify@@@management"
  },
  "updatedDate" : 1457924378014
}, {
  "createdDate" : 1457924377877,
  "cronExpression" : "0 20 1 * * ?",
  "enabled" : true,
  "group" : "management-server",
  "id" : "MINT.CHARGE_DAILY@@@management-server@@@DEFAULT@@@management-server@@@DEFAULT",
  "jobId" : "MINT.CHARGE_DAILY@@@management-server",
  "name" : "MINT.CHARGE_DAILY@@@management-server@@@DEFAULT",
  "priority" : "1",
  "suiteId" : "DEFAULT",
  "triggerDataMap" : {
    "custom_lock_key" : "mint.scheduler.__ORG_ID__.chargedaily@@@management"
  },
  "updatedDate" : 1457924377877
},
...
]

Anda juga dapat melihat tugas terjadwal tertentu dengan mengajukan permintaan GET ke /triggers/{trig_id}, dengan {trig_id} adalah identifikasi pekerjaan pemicu, seperti yang dijelaskan dalam Ringkasan tugas terjadwal. Contoh:

$ curl -X GET \ "http://localhost:8080/v1/mint/triggers/MINT.RENEW_DEV_RATEPLAN@@@management-server@@@DEFAULT@@@management-server@@@DEFAULT" \ -u email:password

Berikut ini contoh responsnya:

{
    "createdDate" : 1457924377925,
    "cronExpression" : "0 20 2 * * ?",
    "enabled" : true,
    "group" : "management-server",
    "id" : "MINT.RENEW_DEV_RATEPLAN@@@management-server@@@DEFAULT@@@management-server@@@DEFAULT",
    "jobId" : "MINT.RENEW_DEV_RATEPLAN@@@management-server",
    "name" : "MINT.RENEW_DEV_RATEPLAN@@@management-server@@@DEFAULT",
    "priority" : "1",
    "suiteId" : "DEFAULT",
    "triggerDataMap" : {
        "custom_lock_key" : "mint.scheduler.__ORG_ID__.renewydevrateplan@@@management"
    },
    "updatedDate" : 1457924377925
}

Memperbarui tugas terjadwal menggunakan API

Anda dapat memperbarui tugas terjadwal dengan mengubah properti pemicunya. Sebagai contoh, Anda Anda mungkin perlu mengubah jadwal eksekusi pemicu.

Untuk tugas pemicu cron (yaitu, tugas yang menyertakan nilai ekspresi cron), Anda hanya dapat ubah nilai cronExpression dan properti yang diaktifkan. Perubahan lainnya adalah diabaikan. Untuk tugas yang tidak menentukan nilai ekspresi cron, Anda dapat mengubah properti lainnya seperti startTime atau priority.

Untuk memperbarui tugas terjadwal, kirimkan permintaan PUT ke /triggers/{trig_id}, dengan {trig_id} adalah identifikasi pemicu tugas, seperti yang dijelaskan dalam Ringkasan tugas terjadwal. Ketika melakukan pembaruan, Anda perlu menentukan setelan yang diperbarui dan ID pemicu.

Misalnya, permintaan berikut memperbarui ekspresi cron untuk Paket Tarif Developer Baru Tugas perpanjangan untuk dijalankan setiap hari pada pukul 05.00. UTC:

$ curl -H "Content-Type: application/json" -X PUT -d \
 '{
    "cronExpression" : "0 0 5 * * ?",
    "enabled" : true,
    "group" : "management-server", 
    "id" : "MINT.RENEW_DEV_RATEPLAN@@@management-server@@@DEFAULT@@@management-server@@@DEFAULT",
    "jobId" : "MINT.RENEW_DEV_RATEPLAN@@@management-server",
    "name" : "MINT.RENEW_DEV_RATEPLAN@@@management-server@@@DEFAULT",
    "priority" : "1",
    "suiteId" : "DEFAULT",
    "triggerDataMap" : {
        "custom_lock_key" : "mint.scheduler.__ORG_ID__.renewydevrateplan@@@management"
    },
}' \
https://localhost:8080/v1/mint/triggers/MINT.RENEW_DEV_RATEPLAN@@@management-server@@@DEFAULT@@@management-server@@@DEFAULT
\
-u email:password

Menonaktifkan dan mengaktifkan kembali tugas terjadwal menggunakan API

Untuk menonaktifkan tugas terjadwal, tetapkan nilai properti enabled dari pemicunya ke {i>false<i}. Contoh:

$ curl -H "Content-Type: application/json" -X PUT -d \
 '{
    "cronExpression" : "0 0 5 * * ?",
    "enabled" : false,
    "group" : "management-server",
    "id" : "MINT.RENEW_DEV_RATEPLAN@@@management-server@@@DEFAULT@@@management-server@@@DEFAULT",
    "jobId" : "MINT.RENEW_DEV_RATEPLAN@@@management-server",
    "name" : "MINT.RENEW_DEV_RATEPLAN@@@management-server@@@DEFAULT",
    "priority" : "1",
    "suiteId" : "DEFAULT",
    "triggerDataMap" : {
        "custom_lock_key" : "mint.scheduler.__ORG_ID__.renewydevrateplan@@@management"
    },
}' \
https://localhost:8080/v1/mint/triggers/MINT.RENEW_DEV_RATEPLAN@@@management-server@@@DEFAULT@@@management-server@@@DEFAULT
\
-u email:password

Untuk mengaktifkan kembali tugas yang dinonaktifkan, setel nilai properti enabled pemicunya ke benar.

Langkah berikutnya

Sebaiknya sinkronkan ulang secara berkala dengan monetisasi, organisasi Anda, dan pengembang, aplikasi, dan produk yang Anda buat menggunakan Layanan Edge API. Pelajari caranya di Menyinkronkan Data Apigee Edge dengan monetisasi.