ทรัพยากร: การดำเนินการ
ทรัพยากรนี้แสดงการดำเนินการที่ใช้เวลานานซึ่งเป็นผลจากการเรียก API ของเครือข่าย
การแสดง JSON |
---|
{ "name": string, "metadata": { "@type": string, field1: ..., ... }, "done": boolean, // Union field |
ช่อง | |
---|---|
name |
ชื่อที่เซิร์ฟเวอร์กำหนด ซึ่งจะไม่ซ้ำกันภายในบริการเดียวกันที่ส่งชื่อกลับมาในตอนแรก หากคุณใช้การแมป HTTP เริ่มต้น |
metadata |
ข้อมูลเมตาเฉพาะบริการที่เชื่อมโยงกับการดำเนินการ ซึ่งมักจะมีข้อมูลความคืบหน้าและข้อมูลเมตาทั่วไป เช่น เวลาที่สร้าง บริการบางอย่างอาจไม่ให้ข้อมูลเมตาดังกล่าว วิธีการที่แสดงผลการดำเนินการที่ใช้เวลานานควรบันทึกประเภทข้อมูลเมตา (หากมี) ออบเจ็กต์ที่มีช่องประเภทที่กำหนดเอง ช่องเพิ่มเติม |
done |
หากค่าเป็น |
ฟิลด์การรวม result ผลการดำเนินการ ซึ่งอาจเป็น error หรือ response ที่ถูกต้องก็ได้ หาก done == false ไม่ได้ตั้งค่าทั้ง error และ response หาก done == true คุณจะตั้งค่า error หรือ response ได้อย่างใดอย่างหนึ่ง บริการบางอย่างอาจไม่แสดงผลลัพธ์ result ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้เท่านั้น |
|
error |
ข้อผิดพลาดจากการดำเนินการในกรณีที่ไม่สำเร็จหรือการยกเลิก |
response |
การตอบสนองปกติที่ประสบความสำเร็จของการดำเนินการ หากวิธีการดั้งเดิมไม่แสดงข้อมูลเกี่ยวกับความสำเร็จ เช่น ออบเจ็กต์ที่มีช่องประเภทที่กำหนดเอง ช่องเพิ่มเติม |
วิธีการ |
|
---|---|
|
เริ่มการยกเลิกแบบไม่พร้อมกันในการดำเนินการที่ใช้เวลานาน |
|
ลบการดำเนินการที่ใช้เวลานาน |
|
รับสถานะล่าสุดของการดำเนินการที่ใช้เวลานาน |
|
แสดงรายการการดำเนินการที่ตรงกับตัวกรองที่ระบุในคำขอ |
|
รอจนการดำเนินการที่ใช้เวลานานที่ระบุเสร็จหรือถึงระยะหมดเวลาที่ระบุไว้ไม่เกินไม่เกินที่กำหนด และส่งคืนสถานะล่าสุด |