ขีดจำกัดการใช้งาน

เนื่องจาก Google Vault API เป็นบริการที่ใช้ร่วมกัน เราจึงใช้โควต้าและข้อจำกัดเพื่อให้มั่นใจว่าผู้ใช้ทุกคนใช้งานอย่างเป็นธรรมและเพื่อปกป้องประสิทธิภาพโดยรวมของระบบ Google Workspace

ขีดจำกัดผลิตภัณฑ์

คุณมีการส่งออกที่กำลังดำเนินการอยู่ได้ไม่เกิน 20 รายการทั่วทั้งองค์กร

โควต้าคําขอ API

แต่ละองค์กรมีการอนุญาตการอ่านกรณี 600 รายการต่อนาทีในทุกโปรเจ็กต์และผู้ใช้ทั้งหมด รวมถึงคำขอผ่าน Vault API และ vault.google.com

ตารางต่อไปนี้แสดงรายการขีดจำกัดคำขอต่อนาทีต่อโปรเจ็กต์

คำขอการอ่านต่อนาทีต่อโปรเจ็กต์
ส่งออก กรณี และการค้นหาที่บันทึกไว้ 120
เกาะ 228
การดำเนินการที่ใช้เวลานาน 300
เขียนคำขอต่อนาทีต่อโปรเจ็กต์
ส่งออก 20
เกาะ 60
สิทธิ์ Matter 30
Matter 60
การค้นหาที่บันทึก 45
ค้นหา (จำนวน) คำขอต่อนาทีต่อโปรเจ็กต์
จำนวนการค้นหา 20

การใช้โควต้าตามวิธี

โควต้าที่คำขอใช้จะขึ้นอยู่กับเมธอดที่เรียกใช้ ตารางต่อไปนี้แสดงการใช้โควต้าต่อวิธีการ

วิธีการ ต้นทุนโควต้า
matters.close
matters.create
matters.delete
matters.reopen
matters.update
matters.undelete 		อ่าน 1 กรณี
เขียน 1 กรณี
matters.count 1 รายการ
matters.get อ่านแล้ว 1 กรณี
matters.list การอ่าน 10 กรณี
matters.addPermissions
matters.removePermissions 		อ่าน 1 กรณี
เขียน 1 กรณี
การเขียนสิทธิ์สำหรับกรณี 1 รายการ
matters.exports.create การอ่านการส่งออก 1 รายการ
การเขียนการส่งออก 10 รายการ
matters.exports.delete เขียนส่งออก 1 รายการ
matters.exports.get การอ่านการส่งออก 1 รายการ
matters.exports.list การอ่านการส่งออก 5 ครั้ง
matters.holds.addHeldAccounts
matters.holds.create
matters.holds.delete
matters.holds.removeHeldAccounts
matters.holds.update 		อ่านแล้ว 1 กรณี
เขียน 1 กรณี
อ่านแล้ว 1 กรณี
อ่านแล้ว 1 กรณี
matters.holds.list อ่านแล้ว 1 กรณี
อ่านการคงไว้ชั่วคราว 3 ครั้ง
matters.holds.accounts.create
matters.holds.accounts.delete
matters.holds.accounts.list 		อ่านแล้ว 1 กรณี
เขียน 1 กรณี
อ่านแล้ว 1 กรณี
อ่านแล้ว 1 กรณี
matters.savedQueries.create
matters.savedQueries.delete 		อ่านแล้ว 1 กรณี
เขียน 1 กรณี
อ่านการค้นหาที่บันทึกไว้ 1 รายการ
เขียนการค้นหาที่บันทึกไว้ 1 รายการ
matters.savedQueries.get อ่านกรณี 1 รายการ
อ่านการค้นหาที่บันทึกไว้ 1 รายการ
matters.savedQueries.list อ่านกรณี 1 รายการ
การอ่านการค้นหาที่บันทึกไว้ 3 รายการ
operations.get การอ่านการดำเนินการที่ใช้เวลานาน 1 รายการ

แก้ไขข้อผิดพลาดด้านโควต้าตามเวลา

หากใช้งานเกินโควต้าต่อนาทีหรือต่อองค์กร โดยปกติคุณจะได้รับการตอบกลับรหัสสถานะ HTTP 429: Too many requests

สำหรับข้อผิดพลาดที่อิงตามเวลาทั้งหมด (ไม่เกิน N คำขอต่อ X นาที) เราขอแนะนำให้โค้ดจับข้อยกเว้นได้และใช้ Exponential Backoff ที่ถูกตัดออกเพื่อให้มั่นใจว่าอุปกรณ์จะไม่สร้างภาระงานมากเกินไป

Exponential Backoff เป็นกลยุทธ์การจัดการข้อผิดพลาดมาตรฐานสำหรับแอปพลิเคชันเครือข่าย อัลกอริทึม Backoff แบบเอ็กซ์โพเนนเชียลจะพยายามส่งคำขอซ้ำโดยใช้เวลารอระหว่างคำขอที่เพิ่มขึ้นแบบทวีคูณ จนถึงเวลาย้อนกลับสูงสุด หากคำขอยังคงไม่สำเร็จ ความล่าช้าระหว่างคำขอจะเพิ่มขึ้นเมื่อเวลาผ่านไป จนกว่าคำขอจะสำเร็จ

ตัวอย่างอัลกอริทึม

อัลกอริทึม Backoff แบบเอ็กซ์โพเนนเชียลจะพยายามส่งคำขอซ้ำเป็นทวีคูณ ทำให้ใช้เวลารอระหว่างการดำเนินการซ้ำจนถึงเวลา Backoff สูงสุด เช่น

  1. ส่งคำขอไปยัง Google Vault API
  2. หากคำขอล้มเหลว โปรดรอ 1 + random_number_milliseconds แล้วลองส่งคำขออีกครั้ง
  3. หากคำขอล้มเหลว โปรดรอ 2 + random_number_milliseconds แล้วลองส่งคำขออีกครั้ง
  4. หากคำขอล้มเหลว โปรดรอ 4 + random_number_milliseconds แล้วลองส่งคำขออีกครั้ง
  5. และอื่นๆ ไม่เกิน maximum_backoff ครั้ง
  6. รอต่อไปและพยายามลองใหม่ให้ครบจำนวนครั้งสูงสุดที่กำหนด แต่อย่าเพิ่มระยะเวลารอระหว่างที่รอ

ที่ไหน

  • เวลารอคือ min(((2^n)+random_number_milliseconds), maximum_backoff) โดย n เพิ่มขึ้น 1 สำหรับการทำซ้ำแต่ละครั้ง (คำขอ)
  • random_number_milliseconds เป็นจำนวนมิลลิวินาทีแบบสุ่มซึ่งน้อยกว่าหรือเท่ากับ 1,000 วิธีนี้จะช่วยป้องกันไม่ให้เกิดกรณีที่ไคลเอ็นต์จำนวนมากซิงค์ข้อมูลกันตามสถานการณ์บางอย่างและจะพยายามอีกครั้งพร้อมกันโดยส่งคำขอแบบระลอกคลื่นที่ซิงค์กัน ระบบจะคำนวณค่าของ random_number_milliseconds ใหม่หลังจากคำขอลองอีกครั้งแต่ละครั้ง
  • maximum_backoff โดยทั่วไปจะมีระยะเวลา 32 หรือ 64 วินาที ค่าที่เหมาะสมจะขึ้นอยู่กับกรณีการใช้งาน

ไคลเอ็นต์จะลองอีกครั้งได้หลังจากครบ maximum_backoff ครั้งแล้ว ลองอีกครั้งหลังจากจุดนี้ไม่จำเป็นต้องเพิ่มเวลา Backoff อีก ตัวอย่างเช่น หากไคลเอ็นต์ใช้เวลา maximum_backoff ที่ 64 วินาที หลังจากถึงค่านี้ ลูกค้าจะลองซ้ำได้ทุกๆ 64 วินาที ในบางสถานการณ์ ควรป้องกันไม่ให้ไคลเอ็นต์ลองอีกครั้งอย่างไม่มีกำหนด

เวลารอระหว่างการลองใหม่และจำนวนการทดลองซ้ำจะขึ้นอยู่กับกรณีการใช้งานและเงื่อนไขของเครือข่าย

ขอเพิ่มโควต้า

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

บางโปรเจ็กต์ไม่มีโควต้าเหมือนกัน เมื่อใช้ Google Cloud ไปเรื่อยๆ โควต้าของคุณอาจต้องเพิ่มขึ้น หากคุณคาดว่าจะมีการใช้งานเพิ่มขึ้นอย่างเห็นได้ชัด คุณสามารถขอปรับโควต้าได้ทันทีจากหน้าโควต้าในคอนโซล Google Cloud

ดูข้อมูลเพิ่มเติมได้ในแหล่งข้อมูลต่อไปนี้

การกำหนดราคา

ลูกค้า Google Workspace จะใช้ Google Vault API ทั้งหมดได้โดยไม่มีค่าใช้จ่ายเพิ่มเติม