#งาน
คุณลักษณะงานกำหนดหน่วยคิวปฏิบัติการที่ได้รับมาจากงานและเหตุการณ์ของผู้ให้บริการ โดยช่วยให้คุณควบคุมการปฏิบัติงานโดยตรงในการลองใหม่ การทริกเกอร์ด้วยตนเอง และการแก้ไขเมื่องานอะซิงก์ล้มเหลว
ทำไมเรื่องนี้ถึงสำคัญ
คุณลักษณะนี้ทำให้สามารถสังเกตการดำเนินการคิวได้ในรายละเอียดของแต่ละงาน ดังนั้นความล้มเหลวจึงสามารถวินิจฉัยและกู้คืนได้โดยไม่ต้องคาดเดา รองรับการกู้คืนตัวดำเนินการที่กำหนดผ่านการลองซ้ำ ทริกเกอร์ และแก้ไขการดำเนินการอย่างชัดเจน ขณะเดียวกันก็รักษาการดำเนินการล้างข้อมูลโดยเจตนาและกำหนดขอบเขต
คอร์โฟลว์
งานหรือเหตุการณ์ของผู้ให้บริการจะสร้างงานที่ผู้ปฏิบัติงานดำเนินการและใส่คำอธิบายประกอบพร้อมรายละเอียดสถานะ ความพยายาม และความล้มเหลว ผู้ปฏิบัติงานตรวจสอบงานที่ล้มเหลวหรือหยุดชะงักในมุมมองคิวบัญชี ดำเนินการลองใหม่/แก้ไข/ทริกเกอร์อย่างชัดเจน และใช้สถานะงานผลลัพธ์เพื่อติดตามวงจรการใช้งานและการติดตามการตรวจสอบ
การดำเนินงาน
| การดำเนินงาน | จุดสิ้นสุด | วัตถุประสงค์ |
|---|---|---|
| รายการงาน | GET /api/accounts/:account_id/jobs | ดึงคิวงานบัญชี |
| ค้นหางาน | POST /api/accounts/:account_id/jobs/search | ค้นหางานด้วยตัวกรอง |
| ลบงานด้วยการค้นหา | POST /api/accounts/:account_id/jobs/search-delete | ลบงานที่ตรงกันจำนวนมาก |
| รับงาน | GET /api/jobs/:job_id | รับหนึ่งงาน |
| อัพเดทงาน | PATCH /api/jobs/:job_id | แก้ไขฟิลด์งานที่ไม่แน่นอน |
| ลบงาน | DELETE /api/jobs/:job_id | ลบหนึ่งงาน |
| ลองงานอีกครั้ง | POST /api/jobs/:job_id/retry | การจัดคิวงานล้มเหลว |
| แก้งาน | POST /api/jobs/:job_id/resolve | ทำเครื่องหมายสถานะการจัดการเทอร์มินัล |
| งานทริกเกอร์ | POST /api/jobs/:job_id/trigger | บังคับให้ทริกเกอร์ดำเนินการ |
ข้อมูลสำคัญและสถานะ
{
id: "job_...",
account_id: "acc_...",
task_id: "tsk_...",
action: "imap_sync_messages",
attempt_count: 2,
last_error_code: "provider_timeout",
last_error_detail: "IMAP connection timed out"
}โหมดความล้มเหลวและการควบคุม
การดำเนินการที่ล้มเหลวจะรักษารายละเอียดข้อผิดพลาดที่ชัดเจนไว้สำหรับการจัดการตามที่กำหนด การลองใหม่ ทริกเกอร์ และการแก้ไขเป็นการดำเนินการในรูปแบบคำสั่งมากกว่าผลข้างเคียงจากการอ่านโดยนัย และขอบเขตรายการในขอบเขตบัญชี/ขอบเขตการค้นหาจะป้องกันการมองเห็นคิวข้ามบัญชี