इस्तेमाल करने की सीमा

Google Vault API एक शेयर की गई सेवा है. इसलिए, हम इस पर कोटा और सीमाएं लागू करते हैं. इससे यह पक्का किया जा सकता है कि सभी उपयोगकर्ता इसका सही तरीके से इस्तेमाल करें. साथ ही, Google Workspace सिस्टम को सुरक्षित रखा जा सकता है.

प्रॉडक्ट की सीमाएं

आपके संगठन में, 20 से ज़्यादा एक्सपोर्ट प्रोसेस नहीं चल सकतीं.

एपीआई अनुरोधों के कोटे

हर संगठन को हर मिनट में 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 		एक मामले को पढ़ने की अनुमति
एक मामले में बदलाव करने की अनुमति
एक मामले की अनुमतियों में बदलाव करने की अनुमति
matters.exports.create 1 एक्सपोर्ट पढ़ा गया
10 एक्सपोर्ट लिखे गए
matters.exports.delete एक बार एक्सपोर्ट करने की सुविधा
matters.exports.get एक एक्सपोर्ट पढ़ा गया
matters.exports.list एक्सपोर्ट किए गए डेटा को पांच बार पढ़ा जा सकता है
matters.holds.addHeldAccounts
matters.holds.create
matters.holds.delete
matters.holds.removeHeldAccounts
matters.holds.update 		1 मामले को पढ़ने की अनुमति
1 मामले में लिखने की अनुमति
1 होल्ड को पढ़ने की अनुमति
1 होल्ड में लिखने की अनुमति
matters.holds.list एक मामला पढ़ा गया
तीन होल्ड पढ़े गए
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 ज़्यादा समय तक चलने वाली कार्रवाई का डेटा पढ़ने की अनुमति

समय के हिसाब से तय किए गए कोटे से जुड़ी गड़बड़ियां ठीक करना

अगर आपने हर मिनट या हर संगठन के लिए तय किए गए कोटे से ज़्यादा अनुरोध किए हैं, तो आपको आम तौर पर 429: Too many requests एचटीटीपी स्टेटस कोड वाला जवाब मिलता है.

समय के आधार पर होने वाली सभी गड़बड़ियों (हर X मिनट में ज़्यादा से ज़्यादा N अनुरोध) के लिए, हमारा सुझाव है कि आपका कोड अपवाद को पकड़ ले और ट्रंकेटेड एक्सपोनेंशियल बैकऑफ़ का इस्तेमाल करे. इससे यह पक्का किया जा सकेगा कि आपके डिवाइस ज़्यादा लोड जनरेट न करें.

एक्सपोनेंशियल बैकऑफ़, नेटवर्क ऐप्लिकेशन के लिए गड़बड़ी ठीक करने की एक स्टैंडर्ड रणनीति है. एक्सपोनेंशियल बैकऑफ़ एल्गोरिदम, अनुरोधों को फिर से भेजने की कोशिश करता है. इसके लिए, अनुरोधों के बीच इंतज़ार का समय तेज़ी से बढ़ता जाता है. यह इंतज़ार का ज़्यादा से ज़्यादा समय तक होता है. अगर अनुरोध अब भी पूरा नहीं होता है, तो यह ज़रूरी है कि अनुरोधों के बीच का समय धीरे-धीरे बढ़ता जाए, ताकि अनुरोध पूरा हो सके.

एल्गोरिदम का उदाहरण

एक्सपोनेंशियल बैकऑफ़ एल्गोरिदम, अनुरोधों को बार-बार भेजता है. इससे, अनुरोधों के बीच इंतज़ार का समय बढ़ता जाता है. यह इंतज़ार का समय, बैकऑफ़ के ज़्यादा से ज़्यादा समय तक बढ़ सकता है. उदाहरण के लिए:

  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 बार कोशिश करने के बाद भी फिर से कोशिश कर सकता है. इस पॉइंट के बाद, फिर से कोशिश करने पर बैकऑफ़ टाइम को बढ़ाने की ज़रूरत नहीं होती. उदाहरण के लिए, अगर कोई क्लाइंट 64 सेकंड का maximum_backoff इस्तेमाल करता है, तो इस वैल्यू तक पहुंचने के बाद, क्लाइंट हर 64 सेकंड में फिर से कोशिश कर सकता है. किसी समय, क्लाइंट को बार-बार कोशिश करने से रोकना चाहिए.

फिर से कोशिश करने के बीच का इंतज़ार का समय और फिर से कोशिश करने की संख्या, आपके इस्तेमाल के उदाहरण और नेटवर्क की स्थितियों पर निर्भर करती है.

कोटा बढ़ाने का अनुरोध करना

प्रोजेक्ट में इस्तेमाल किए गए संसाधनों के आधार पर, कोटा में बदलाव करने का अनुरोध किया जा सकता है. सेवा खाते से किए गए एपीआई कॉल को, एक ही खाते से किए गए कॉल माना जाता है. बदले गए कोटे के लिए आवेदन करने से, मंज़ूरी मिलने की गारंटी नहीं मिलती. कोटा अडजस्ट करने के ऐसे अनुरोधों को मंज़ूरी मिलने में ज़्यादा समय लग सकता है जिनसे कोटा वैल्यू में काफ़ी बढ़ोतरी होती है.

सभी प्रोजेक्ट के लिए, एक जैसे कोटा उपलब्ध नहीं होते. समय के साथ-साथ, Google Cloud का इस्तेमाल बढ़ने पर, आपको कोटा की वैल्यू बढ़ाने की ज़रूरत पड़ सकती है. अगर आपको लगता है कि आने वाले समय में, इस्तेमाल में काफ़ी बढ़ोतरी हो सकती है, तो Google Cloud Console में कोटा पेज पर जाकर, कोटा में बदलाव करने का अनुरोध करें.

ज़्यादा जानने के लिए, यहां दिए गए संसाधन देखें:

कीमत

Google Workspace के ग्राहकों के लिए, Google Vault API का इस्तेमाल बिना किसी अतिरिक्त शुल्क के किया जा सकता है.