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

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

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

अगर आपने हर मिनट या हर संगठन के लिए तय किए गए कोटे से ज़्यादा अनुरोध किए हैं, तो आपको आम तौर पर 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 का इस्तेमाल बिना किसी अतिरिक्त शुल्क के किया जा सकता है.