หน้านี้ได้รับการแปลโดย Cloud Translation API

กําหนดเวลางานการสร้างรายได้

คุณกำลังดูเอกสารประกอบของ Apigee Edge
ไปที่เอกสารประกอบของ Apigee X ข้อมูล

ภาพรวมของงานที่กำหนดเวลาไว้

การสร้างรายได้มีเครื่องจัดตารางเวลางานและชุดงานที่วางกำหนดเวลาล่วงหน้าให้ทำงานตามเวลาที่กำหนด

ตารางด้านล่างแสดงรายการงานที่กำหนดเวลาไว้ล่วงหน้าที่กำหนดโดยการสร้างรายได้และเวลาที่กำหนดให้ทำงาน (เวลาทั้งหมดที่แสดงเป็นเวลา UTC) นอกจากนี้ยังมีรายการทริกเกอร์สำหรับแต่ละงานด้วย

งาน	คำอธิบาย	กำหนดการ (UTC)	ทริกเกอร์
อัตราภาษีนักพัฒนาซอฟต์แวร์รายเดือน	ดึงข้อมูลอัตราภาษีจากเครื่องมือภาษีของนักพัฒนาแอปแต่ละราย แล้วอัปเดตบุคคลของนักพัฒนาแอปด้วยอัตราภาษีที่แก้ไข	วันแรกของทุกเดือน เวลา 5:45 น.	`MINT.MONTHLY_DEV_TAXRATE@@@ management-server@@@DEFAULT@@@ management-server@@@DEFAULT`
ต่ออายุการสมัครใช้บริการ	ใช้ค่าธรรมเนียมตามรอบสำหรับแพ็กเกจราคาที่ใช้งานอยู่หรือค่าธรรมเนียมใหม่สำหรับแพ็กเกจราคาในอนาคตที่เริ่มในวันปัจจุบัน	ทุกวัน เวลา 5 วินาทีหลังเที่ยงคืน	`MINT.RENEW_SUBSCRIPTIONS@@@ management-server@@@DEFAULT@@@ management-server@@@DEFAULT`
โปรแกรมอัปเดต XeFeed	รับอัตราแลกเปลี่ยนในสกุลเงินดอลลาร์สหรัฐสำหรับสกุลเงินที่สนับสนุนแต่ละสกุลเงิน	ทุกวัน เวลา 1 วินาทีหลังเที่ยงคืน	`MINT.XEFEED@@@ management-server@@@DEFAULT@@@ management-server@@@DEFAULT`
ต่ออายุแพ็กเกจราคาสําหรับนักพัฒนาซอฟต์แวร์	เปลี่ยนวันที่ต่ออายุของแพ็กเกจราคาและคำนวณค่าธรรมเนียมการเลิกใช้ก่อนกำหนด	ทุกวัน เวลา 02:20 น.	`MINT.RENEW_DEV_RATEPLAN@@@ management-server@@@DEFAULT@@@ management-server@@@DEFAULT`
ลองส่งต่อธุรกรรมอีกครั้ง	หมายเหตุ: งานนี้เลิกใช้งานแล้วและไม่มีผลต่อการสร้างรายได้	ทุกวัน เวลา 04:30 น.	`MINT.RETRY_TX_RELAY@@@ management-server@@@DEFAULT@@@ management-server@@@DEFAULT`
เครื่องมือทำความสะอาดธุรกรรม	หมายเหตุ: งานนี้เลิกใช้งานแล้วและไม่มีผลต่อการสร้างรายได้	ทุกวัน เวลา 5:30 น.	`MINT.TX_CLEANSER@@@ management-server@@@DEFAULT@@@ management-server@@@DEFAULT`
การตรวจสอบยอดคงเหลือของนักพัฒนาซอฟต์แวร์	ตรวจสอบเงินคงเหลือของบัญชีนักพัฒนาแอป คัดลอกการใช้งานปัจจุบันและยอดเงินคงเหลือที่ชำระล่วงหน้า/วงเงินเครดิตแบบชำระเงินภายหลังไปยังตารางการตรวจสอบ จากนั้นหักการใช้งานปัจจุบันจากบัญชีนักพัฒนาแอปและคืนยอดคงเหลือการใช้งานให้เป็น 0	วันแรกของทุกเดือน เวลา 5 วินาทีหลังเที่ยงคืน	`MINT.DEVELOPER_BALANCE_AUDIT@@@ management-server@@@DEFAULT@@@ management-server@@@DEFAULT`
เอกสารการเรียกเก็บเงินรายเดือน	สร้างเอกสารการเรียกเก็บเงิน หมายเหตุ: Apigee ไม่รองรับการสร้างเอกสารการเรียกเก็บเงินจากการสร้างรายได้ของ Apigee Edge อีกต่อไป โปรดดูการเกษียณอายุ	วันที่ 11 ของทุกเดือน ในเวลา 1 นาทีหลังเที่ยงคืน	`MINT.MONTLY_BILLING_DOCS@@@ management-server@@@DEFAULT@@@ management-server@@@DEFAULT`
ตัวนับแพ็กเกจราคาสำหรับนักพัฒนาซอฟต์แวร์	หมายเหตุ: งานนี้เลิกใช้งานแล้วและไม่มีผลต่อการสร้างรายได้	ทุกวัน เวลา 3 วินาทีหลังเที่ยงคืน	`MINT.RESET_DEVELOPER_RATE_PLAN_COUNTER@@@ management-server@@@DEFAULT@@@ management-server@@@DEFAULT`
ค่าบริการรายวัน	คำนวณยอดรวมธุรกรรมรายชั่วโมงทั้งหมดใหม่ และใช้ในการคำนวณยอดรวมรายวันของวันที่ผ่านมา	ทุกวัน เวลา 1:20 น.	`MINT.CHARGE_DAILY@@@ management-server@@@DEFAULT@@@ management-server@@@DEFAULT`
ค่าบริการรายชั่วโมง	คำนวณยอดรวมธุรกรรมทั้งหมดในแต่ละไตรมาสของชั่วโมง	1 นาทีที่ผ่านไปแล้วแต่ละไตรมาส	`MINT.CHARGE_HOURLY@@@ management-server@@@DEFAULT@@@ management-server@@@DEFAULT`
รีเฟรชการกำหนดค่าการแจ้งเตือน	จัดทำดัชนีเงื่อนไขการแจ้งเตือนทั้งหมดอีกครั้ง	ทุก 5 นาที	`MINT.REFRESH_NOTIFICATION_CONFIG@@@ management-server@@@SYSTEM@@@ management-server@@@SYSTEM`
ส่งอีเมลแจ้งเตือน	ส่งการแจ้งเตือนทางอีเมลสะสม	ทุกชั่วโมง	`MINT.EMAIL_NOTIFICATION@@@ management-server@@@SYSTEM@@@ management-server@@@SYSTEM`
จำกัดการรีเฟรช	หมายเหตุ: งานนี้เลิกใช้งานแล้วและไม่มีผลต่อการสร้างรายได้	ไม่มี (ไม่ดำเนินการ)	`MINT.REFRESH_LIMIT@@@ message-processor@@@SYSTEM@@@ message-processor@@@SYSTEM`

นอกเหนือจากงานในรายการด้านบนแล้ว ยังมีงานที่เปิดใช้ได้ผ่านการแจ้งเตือนเหตุการณ์ดังที่แสดงในตารางต่อไปนี้ ดูข้อมูลเพิ่มเติมได้ที่ตั้งค่าการแจ้งเตือน

งาน	คำอธิบาย	กำหนดการ	ทริกเกอร์
การแจ้งเตือนพัสดุใหม่	ส่งการแจ้งเตือนถึงนักพัฒนาซอฟต์แวร์ทุกคนว่ามีแพ็กเกจ API ใหม่ให้ใช้งานแล้ว	เรียกใช้ครั้งเดียว ในวันที่เปิดใช้งานงานเวลา 21:00 น. หมายเหตุ: ระบบจะส่งการแจ้งเตือนเพียงครั้งเดียว ไม่ว่าคุณจะกำหนดค่า `cronExpression` ที่ส่งผลให้มีการเรียกใช้งานหลายครั้งหรือไม่ก็ตาม	`MINT.NEW_PACKAGE_NOTIFY@@@ management-server@@@DEFAULT@@@ management-server@@@DEFAULT`
การแจ้งเตือน Ad Hoc ใหม่	ส่งการแจ้งเตือนถึงนักพัฒนาแอปทุกรายว่าผลิตภัณฑ์ API ใหม่พร้อมให้บริการในตลาดทางภูมิศาสตร์ที่เฉพาะเจาะจง	เรียกใช้ครั้งเดียว ในวันที่เปิดใช้งานงานเวลา 21:00 น. หมายเหตุ: ระบบจะส่งการแจ้งเตือนเพียงครั้งเดียว ไม่ว่าคุณจะกำหนดค่า `cronExpression` ที่ส่งผลให้มีการเรียกใช้งานหลายครั้งหรือไม่ก็ตาม	`MINT.ADHOC_NOTIFY@@@ management-server@@@DEFAULT@@@ management-server@@@DEFAULT`
การแจ้งเตือนผลิตภัณฑ์ใหม่	ส่งการแจ้งเตือนถึงนักพัฒนาแอปทุกรายว่ามีผลิตภัณฑ์ API ใหม่พร้อมให้บริการ	เรียกใช้ครั้งเดียว ในวันที่เปิดใช้งานงานเวลา 21:00 น. หมายเหตุ: ระบบจะส่งการแจ้งเตือนเพียงครั้งเดียว ไม่ว่าคุณจะกำหนดค่า `cronExpression` ที่ส่งผลให้มีการเรียกใช้งานหลายครั้งหรือไม่ก็ตาม	`MINT.NEW_PRODUCT_NOTIFY@@@ management-server@@@DEFAULT@@@ management-server@@@DEFAULT`
การแจ้งเตือนแพ็กเกจราคาใหม่	ส่งการแจ้งเตือนถึงนักพัฒนาแอปที่ได้รับผลกระทบว่ามีแพ็กเกจราคาใหม่พร้อมให้บริการ นักพัฒนาแอปทุกรายที่สมัครใช้บริการแพ็กเกจราคาหลักจะได้รับการแจ้งเตือนว่าแพ็กเกจราคาใหม่มีการใช้งานอยู่ นอกจากนี้ หากแพ็กเกจราคาเป็นแพ็กเกจมาตรฐาน นักพัฒนาแอปทุกรายจะได้รับการแจ้งเตือน หากเป็นแพ็กเกจราคาในหมวดหมู่นักพัฒนาซอฟต์แวร์ เฉพาะนักพัฒนาซอฟต์แวร์ในหมวดหมู่นั้นเท่านั้นที่จะได้รับการแจ้งเตือน หากเป็นแพ็กเกจราคาสำหรับนักพัฒนาแอป จะมีการแจ้งเตือนเฉพาะนักพัฒนาแอปรายดังกล่าว	เรียกใช้ในวันที่เริ่มต้นของแพ็กเกจราคาใหม่ เวลา 4:30 น.	`MINT.NEW_RATEPLAN_NOTIFY@@@ management-server@@@DEFAULT@@@ management-server@@@DEFAULT`
Tnc ใหม่	ส่งการแจ้งเตือนถึงนักพัฒนาแอปที่ได้รับผลกระทบว่ามีการเผยแพร่ข้อกำหนดและเงื่อนไขฉบับใหม่หรือฉบับแก้ไขแล้ว (และนักพัฒนาแอปยังไม่ได้ยอมรับ)	เรียกใช้ในวันที่ 30, 7 และ 1 วันก่อนวันที่เริ่มต้นของข้อกำหนดและเงื่อนไขฉบับใหม่หรือฉบับแก้ไข เวลา 21:00 น.	`MINT.TNC_ACCEPTANCE_NOTIFY@@@ management-server@@@DEFAULT@@@ management-server@@@DEFAULT`
แพ็กเกจอัตราที่ใกล้หมดอายุ	ส่งการแจ้งเตือนถึงนักพัฒนาแอปที่ได้รับผลกระทบเพื่อแจ้งให้ทราบล่วงหน้าว่าแพ็กเกจราคากำลังจะหมดอายุ	เรียกใช้ในวันที่ 30, 7 และ 1 วันก่อนแผนราคาจะหมดอายุ เวลา 21:00 น.	`MINT.EXPIRING_RATE_PLAN_NOTIFY@@@ management-server@@@DEFAULT@@@ management-server@@@DEFAULT`

การจัดการตารางงานการสร้างรายได้โดยใช้ API

ส่วนต่อไปนี้อธิบายวิธีจัดการกำหนดเวลางานการสร้างรายได้โดยใช้ API

การกำหนดค่าทริกเกอร์
การสร้างนิพจน์ cron
การดูงานที่กำหนดเวลาไว้โดยใช้ API
การอัปเดตงานที่กำหนดเวลาไว้โดยใช้ API
การปิดใช้และเปิดใช้งานงานที่กำหนดเวลาไว้อีกครั้งโดยใช้ API

ดูข้อมูลเพิ่มเติมเกี่ยวกับ API ที่อธิบายไว้ในส่วนนี้ได้ที่งานที่กำหนดเวลาไว้ในข้อมูลอ้างอิงของ API

การกำหนดค่าทริกเกอร์

เครื่องจัดตารางเวลาจะใช้ทริกเกอร์เพื่อเรียกใช้งาน งานที่กำหนดเวลาไว้จะทำงานเมื่อทริกเกอร์ที่เชื่อมโยงทำงาน พร็อพเพอร์ตี้ของทริกเกอร์จะกำหนดค่าการดำเนินการของงาน และด้วยการตั้งค่าพร็อพเพอร์ตี้เหล่านี้ คุณจะควบคุมลักษณะเฉพาะของการปฏิบัติการได้ เช่น เวลาที่งานดำเนินการ และความถี่

ทริกเกอร์ที่พบบ่อยที่สุด 2 ประเภทคือทริกเกอร์ cron และทริกเกอร์แบบง่าย ทริกเกอร์ Cron มีพร็อพเพอร์ตี้ cronExpression ที่ระบุกำหนดการดำเนินการ ทริกเกอร์แบบง่ายไม่มีพร็อพเพอร์ตี้ cronExpression ซึ่งคุณจะระบุ startTime เพื่อระบุว่าทริกเกอร์จะมีผลเมื่อใด และทริกเกอร์ endTime หรือไม่ก็ได้

พร็อพเพอร์ตี้ของทริกเกอร์มีดังนี้ (เวลาทั้งหมดที่แสดงเป็นเวลา UTC)

พร็อพเพอร์ตี้	คำอธิบาย
`cronExpression`	นิพจน์ Cron เพื่อสร้างกำหนดการดำเนินการสำหรับทริกเกอร์ เช่น "เวลา 8:00 น. ทุกวันจันทร์ถึงศุกร์" หรือ "เวลา 1:30 น. ทุกวันศุกร์สุดท้ายของเดือน" โปรดดูรายละเอียดเพิ่มเติมในการสร้างนิพจน์ cron การระบุคุณสมบัตินี้จะกำหนดทริกเกอร์เป็นทริกเกอร์ cron หมายเหตุ: หากระบุทั้ง `cronExpression` และ `startTime`/`endTime` แล้ว `cronExpression` จะมีความสำคัญเหนือกว่า
`enabled`	แฟล็กที่ระบุว่าทริกเกอร์เปิดใช้เพื่อเรียกใช้หรือไม่ ค่าอาจเป็นค่าใดค่าหนึ่งต่อไปนี้ `true` เปิดใช้ทริกเกอร์ให้ปฏิบัติการแล้ว `false`. ทริกเกอร์ปิดใช้อยู่ จึงจะไม่ดำเนินการ
`endTime`	เวลาในรูปแบบ Epoch เมื่อกำหนดเวลาของทริกเกอร์ไม่มีผลแล้ว
`group`	ประเภทของเซิร์ฟเวอร์ที่ทริกเกอร์จะทำงาน เช่น หากทริกเกอร์ควรทำงานในเซิร์ฟเวอร์การจัดการ ค่าควรตั้งเป็น `management-server` หากทริกเกอร์ควรทำงานในเซิร์ฟเวอร์การประมวลผลข้อความ ควรกำหนดค่าเป็น `message-processor`
`id`	การระบุทริกเกอร์
`jobId`	การระบุงานที่จะดำเนินการ
`name`	ชื่อที่ไม่ซ้ำกันซึ่งใช้ในการระบุทริกเกอร์
`priority`	ลำดับความสำคัญของการดำเนินการแบบสัมพัทธ์ของทริกเกอร์หากมีการกำหนดเวลาให้ทริกเกอร์หลายรายการดำเนินการพร้อมกัน ยิ่งค่าต่ำ ลำดับความสำคัญก็ยิ่งสูงขึ้น เช่น หากมีการตั้งเวลาให้ทริกเกอร์ 2 รายการทำงานพร้อมกัน และทริกเกอร์หนึ่งมีลำดับความสำคัญเป็น 1 และอีกทริกเกอร์หนึ่งมีลำดับความสำคัญเป็น 1 ทริกเกอร์ที่มีลำดับความสำคัญ 1 จะทำงานก่อน พร็อพเพอร์ตี้นี้จะมีผลก็ต่อเมื่อทริกเกอร์หลายรายการมีเวลาดำเนินการเหมือนกันเท่านั้น
`startTime`	ใช้กับทริกเกอร์ทั่วไปเท่านั้น เวลาในรูปแบบ Epoch เมื่อกำหนดการของทริกเกอร์มีผล หมายเหตุ: หากระบุทั้ง `cronExpression` และ `startTime`/`endTime` แล้ว `cronExpression` จะมีความสำคัญเหนือกว่า
`suiteId`	แฟล็กที่ระบุว่าส่วนการแจ้งเตือนของชุดการแจ้งเตือนระดับระบบหรือระดับเริ่มต้น ค่าที่ถูกต้องคือ `DEFAULT` หรือ `SYSTEM` หรือคุณจะระบุชื่อห้องที่ไม่ซ้ำของคุณเองก็ได้
`triggerDataMap`	ล็อกคีย์ `custom_lock_key` ที่ป้องกันไม่ให้เซิร์ฟเวอร์หลายเครื่องทำงานเดียวกันพร้อมกัน

การสร้างนิพจน์ Cron

นิพจน์ Cron เป็นสตริงที่ประกอบด้วย 6 หรือ 7 ช่องโดยคั่นด้วยช่องว่าง นิพจน์นี้แสดงชุดเวลา ซึ่งโดยปกติจะเป็นกำหนดการเพื่อเรียกใช้กิจวัตร นิพจน์ Cron ที่ระบุในพร็อพเพอร์ตี้ cronExpression ของทริกเกอร์จะใช้เพื่อกำหนดเวลาการดำเนินการของทริกเกอร์นั้น

นิพจน์ Cron มีรูปแบบต่อไปนี้

s
  m h dm m dw y

โดยที่

ฟิลด์	คำอธิบาย	จำเป็น	ค่าที่อนุญาต	สัญลักษณ์พิเศษที่อนุญาต
`s`	วินาที	มี	0-59	, - * /
`m`	นาที	มี	0-59	, - * /
`h`	เวลาทำการ	มี	0-23	, - * /
`dm`	วันของเดือน	มี	0-31	, - * ? / วัตต์
`m`	เดือน	มี	1-12 หรือ JAN-DEC	, - * /
`dw`	วันในสัปดาห์	มี	1-7 หรือ SUN-SAT	, - * ? / ลิตร #
`y`	ปี	ไม่ได้	ว่างเปล่าหรือ 1970-2099	, - * /

สัญลักษณ์พิเศษมีคำจำกัดความดังต่อไปนี้

สัญลักษณ์พิเศษ	คำอธิบาย
*	ใช้เพื่อเลือกค่าทั้งหมดในช่อง เช่น * ในช่องนาทีหมายถึงทุกนาที
?	ใช้เพื่อระบุบางสิ่งในช่องใดช่องหนึ่งจาก 2 ช่องที่อนุญาตให้ใช้อักขระได้ แต่ระบุอักขระอีกตัวไม่ได้ ตัวอย่างเช่น หากคุณต้องการให้ทริกเกอร์ทำงานในวันใดวันหนึ่งของเดือน (เช่น วันที่ 10) แต่ไม่สนใจวันใดของสัปดาห์ ให้ระบุ 10 ในช่องวันของเดือน และ ? ในช่องวันของสัปดาห์
-	ใช้เพื่อระบุช่วง เช่น 10-12 ในช่องชั่วโมงหมายถึงชั่วโมง 10, 11 และ 12
,	ใช้เพื่อระบุค่าเพิ่มเติม เช่น MON,WED,FRI ในช่องวันในสัปดาห์หมายถึงวันจันทร์ วันพุธ และวันศุกร์
/	ใช้เพื่อระบุการเพิ่มขึ้น เช่น 0/15 ในช่องวินาทีหมายถึงวินาทีที่ 0, 15, 30 และ 45 และ 5/15 ในฟิลด์วินาที หมายถึงวินาทีที่ 5, 20, 35 และ 50 คุณยังระบุ / หลังอักขระ " ได้อีกด้วย การทำแบบนี้เทียบเท่ากับการมี 0 ก่อน / การระบุ 1/3 ในช่องวันของเดือนหมายความว่าจะดำเนินการทุก 3 วันโดยเริ่มจากวันแรกของเดือน
L	มีความหมายที่แตกต่างกันในแต่ละช่องที่อนุญาตให้ใช้ L ในช่องวันของเดือนหมายถึงวันสุดท้ายของเดือน ซึ่งก็คือวันที่ 31 มกราคม หรือวันที่ 28 ของเดือนกุมภาพันธ์ในปีที่มีอธิกสุรทิน ในช่องวันของสัปดาห์ L หมายถึงวันสุดท้ายของสัปดาห์ ซึ่งก็คือ 7 หรือ SAT แต่ถ้าใช้ในช่องวันของสัปดาห์หลังจากค่าอื่น หมายความว่า xxx วันสุดท้ายของเดือน เช่น 6L หมายถึงวันศุกร์สุดท้ายของเดือน หมายเหตุ: ใช้อักขระ L และ W รวมกันในช่องวันของเดือนได้เพื่อให้ได้ LW ซึ่งหมายถึงวันธรรมดาวันสุดท้ายของเดือน
W	ใช้เพื่อระบุวันธรรมดา (วันจันทร์ - วันศุกร์) ที่ใกล้กับวันนั้นมากที่สุด ตัวอย่างเช่น หากคุณระบุ 15W ในช่องวันของเดือน หมายความว่าวันธรรมดาที่ใกล้เคียงวันที่ 15 ของเดือน ดังนั้น หากวันที่ 15 เป็นวันเสาร์ ทริกเกอร์จะทำงานในวันศุกร์ที่ 14 หากวันที่ 15 เป็นวันอาทิตย์ ทริกเกอร์จะทำงานในวันจันทร์ที่ 16 หากวันที่ 15 เป็นวันอังคาร ระบบจะดำเนินการในวันอังคารที่ 15 อย่างไรก็ตาม หากคุณระบุ 1W สำหรับวันของเดือน และครั้งที่ 1 คือวันเสาร์ ทริกเกอร์จะทำงานในวันจันทร์ที่ 3 เนื่องจากจะไม่ "ข้าม" เหนือขอบเขตของวันของเดือน จะระบุอักขระ W ได้ก็ต่อเมื่อวันของเดือนเป็นวันเดียว ไม่ใช่ช่วงหรือรายการวัน หมายเหตุ: ใช้อักขระ L และ W รวมกันในช่องวันของเดือนได้เพื่อให้ได้ LW ซึ่งหมายถึงวันธรรมดาวันสุดท้ายของเดือน
#	ใช้เพื่อระบุวันที่ XXX ที่ n ของเดือน เช่น ค่า 6#3 ในช่องวันของสัปดาห์หมายถึงวันศุกร์ที่ 3 ของเดือน (วันที่ 6 = วันศุกร์และ #3 = วันที่ 3 ของเดือน) ตัวอย่างอื่นๆ: 2#1 = วันจันทร์แรกของเดือน, 4#5 = วันพุธที่ 5 ของเดือน หมายเหตุ: หากคุณระบุ #5 และไม่มีอินสแตนซ์ที่ 5 ของวันในสัปดาห์ที่ระบุในเดือนนั้น จะไม่มีการดำเนินการเกิดขึ้นในเดือนนั้น

ต่อไปนี้เป็นตัวอย่างของนิพจน์ Cron (เวลาทั้งหมดที่แสดงเป็นเวลา UTC)

นิพจน์ Cron	กำหนดการดำเนินการ
0 0 12 * * ?	12:00 น. (เที่ยง) ทุกวัน
0 15 10 * * ? 2013	10:15 น. ของทุกวันตลอดปี 2013
0 10,44 14 ? 3 พ.	14:10 น. และ 14:44 น. ทุกวันพุธในเดือนมีนาคม
0 15 10 * 6L 2013-2015	10:15 น. ในวันศุกร์สุดท้ายของทุกเดือนในช่วงปี 2013, 2014 และ 2015
0 15 10 * 6#3	วันศุกร์ที่ 3 ของทุกเดือน เวลา 10:15 น.

การดูงานที่กำหนดเวลาไว้โดยใช้ API

คุณดูงานที่กำหนดเวลาไว้ทั้งหมดในปัจจุบันได้ด้วยการส่งคำขอ GET ไปยัง /triggers?orgid={org_name}

เช่น

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

ตัวอย่างการตอบกลับมีดังนี้

[ {
  "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
},
...
]

นอกจากนี้ คุณยังดูงานที่กำหนดเวลาไว้ที่เจาะจงได้โดยการส่งคำขอ GET ไปยัง /triggers/{trig_id} โดยที่ {trig_id} คือหมายเลขระบุทริกเกอร์งานตามที่อธิบายไว้ในภาพรวมของงานที่กำหนดเวลาไว้ เช่น

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

ตัวอย่างการตอบกลับมีดังนี้

{
    "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
}

การอัปเดตงานที่กำหนดเวลาไว้โดยใช้ API

คุณอัปเดตงานที่กำหนดเวลาไว้ได้โดยการเปลี่ยนพร็อพเพอร์ตี้ของทริกเกอร์ ตัวอย่างเช่น คุณอาจต้องเปลี่ยนกำหนดการดำเนินการของทริกเกอร์

สำหรับงานทริกเกอร์ cron (ซึ่งก็คืองานที่มีค่านิพจน์ Cron) คุณจะเปลี่ยนได้เฉพาะค่าของ cronExpression และพร็อพเพอร์ตี้ที่เปิดใช้ ระบบจะไม่สนใจการเปลี่ยนแปลงอื่นๆ สำหรับงานที่ไม่ระบุค่านิพจน์ Cron คุณจะเปลี่ยนพร็อพเพอร์ตี้อื่นๆ ได้ เช่น startTime หรือ priority

หมายเหตุ: เมื่ออัปเดตงานที่กำหนดเวลาไว้ คุณต้องส่งพร็อพเพอร์ตี้ที่มีอยู่ทั้งหมดไปยัง API แม้ว่าจะไม่มีการเปลี่ยนแปลงก็ตาม หากปล่อยพร็อพเพอร์ตี้ออกจากเพย์โหลดในการเรียก API นี้ ระบบจะนำพร็อพเพอร์ตี้ดังกล่าวออก หากต้องการยืนยันรายการพร็อพเพอร์ตี้และค่า โปรดดูการดูงานที่กำหนดเวลาไว้โดยใช้ API

หากต้องการอัปเดตงานที่กำหนดเวลาไว้ ให้ส่งคำขอ PUT ไปยัง /triggers/{trig_id} โดยที่ {trig_id} คือตัวระบุทริกเกอร์งานตามที่อธิบายไว้ในภาพรวมของงานที่กำหนดเวลาไว้ เมื่อทำการอัปเดต คุณต้องระบุการตั้งค่าที่อัปเดตและรหัสของทริกเกอร์ลงในเนื้อหาของคำขอ

ตัวอย่างเช่น คำขอต่อไปนี้จะอัปเดตนิพจน์ Cron สำหรับงานการต่ออายุแพ็กเกจราคาสำหรับนักพัฒนาซอฟต์แวร์ใหม่ให้เรียกใช้ทุกวันในเวลา 5.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

การปิดใช้และเปิดใช้งานงานที่กำหนดเวลาไว้อีกครั้งโดยใช้ API

หากต้องการปิดใช้งานที่กำหนดเวลาไว้ ให้ตั้งค่าพร็อพเพอร์ตี้ enabled ของทริกเกอร์เป็น false เช่น

$ 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

หากต้องการเปิดใช้งานที่ปิดใช้อีกครั้ง ให้ตั้งค่าพร็อพเพอร์ตี้ enabled ของทริกเกอร์เป็น "จริง"

ขั้นตอนถัดไป

เราขอแนะนำให้คุณซิงค์ข้อมูลกับการสร้างรายได้ขององค์กรและนักพัฒนาซอฟต์แวร์ แอปพลิเคชัน และผลิตภัณฑ์ที่คุณสร้างขึ้นโดยใช้บริการ Edge API เป็นระยะๆ ดูวิธีการได้ในซิงค์ข้อมูล Apigee Edge กับการสร้างรายได้