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

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 		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 मामला पढ़ा गया
सेव की गई तीन क्वेरी को पढ़ा गया
operations.get लंबे समय तक चलने वाली 1 कार्रवाई पढ़ी गई

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

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

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

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

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

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

  1. Google Vault API से कनेक्ट करने के लिए अनुरोध करें.
  2. अगर अनुरोध पूरा नहीं हो पाता, तो एक और random_number_milliseconds इंतज़ार करें और फिर से कोशिश करें.
  3. अगर अनुरोध पूरा नहीं हो पाता है, तो दो और random_number_milliseconds इंतज़ार करें और फिर से अनुरोध करें.
  4. अगर अनुरोध पूरा नहीं हो पाता है, तो चार और random_number_milliseconds इंतज़ार करें और फिर से अनुरोध करें.
  5. इसकी तरह, maximum_backoff बार तक.
  6. ज़्यादा से ज़्यादा संख्या तक इंतज़ार करें और फिर से कोशिश करें. हालांकि, बार-बार की जाने वाली कोशिशों के बीच इंतज़ार की अवधि को न बढ़ाएं.

कहां:

  • इंतज़ार का समय min(((2^n)+random_number_milliseconds), maximum_backoff) है. हर बार दोहराए जाने (अनुरोध) के लिए, n में एक की बढ़ोतरी हुई है.
  • 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 के किसी भी तरह के इस्तेमाल के लिए, अलग से पैसे नहीं देने पड़ते.