از آنجایی که Google Vault API یک سرویس مشترک است، برای اطمینان از استفاده منصفانه توسط همه کاربران و محافظت از سلامت کلی سیستم Google Workspace، سهمیهها و محدودیتهایی اعمال میکنیم.
محدودیت های محصول
شما نمی توانید بیش از 20 صادرات در سراسر سازمان خود داشته باشید.
سهمیه درخواست API
هر سازمان مجاز به خواندن 600 مطلب در دقیقه، در همه پروژهها و کاربران، از جمله درخواستها از طریق Vault API و vault.google.com است.
جداول زیر محدودیتهای درخواستی هر دقیقه در هر دقیقه را فهرست میکنند:
خواندن درخواست ها در دقیقه در هر پروژه | |
---|---|
صادر کردن، اهمیت دادن، و پرس و جو ذخیره شده | 120 |
نگه دارید | 228 |
عملیات طولانی مدت | 300 |
در هر دقیقه در هر پروژه درخواست بنویسید | |
---|---|
صادرات | 20 |
نگه دارید | 60 |
مجوزهای موضوع | 30 |
موضوع | 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 دقیقه)، توصیه میکنیم کد شما استثنا باشد و از یک عقبنشینی نمایی کوتاهشده استفاده کند تا مطمئن شود دستگاههای شما بار بیش از حد تولید نمیکنند.
عقب نشینی نمایی یک استراتژی مدیریت خطای استاندارد برای برنامه های شبکه است. یک الگوریتم عقبنشینی نمایی، درخواستها را با استفاده از افزایش تصاعدی زمان انتظار بین درخواستها، تا حداکثر زمان عقبنشینی، دوباره امتحان میکند. اگر درخواستها همچنان ناموفق هستند، مهم است که تأخیر بین درخواستها در طول زمان افزایش یابد تا درخواست موفقیتآمیز شود.
الگوریتم نمونه
یک الگوریتم عقبنشینی نمایی، درخواستها را بهصورت تصاعدی دوباره امتحان میکند، و زمان انتظار بین تلاشهای مجدد را تا حداکثر زمان عقبنشینی افزایش میدهد. مثلا:
- به Google Vault API درخواست دهید.
- اگر درخواست ناموفق بود، 1 +
random_number_milliseconds
صبر کنید و درخواست را دوباره امتحان کنید. - اگر درخواست ناموفق بود، 2 +
random_number_milliseconds
صبر کنید و دوباره درخواست را امتحان کنید. - اگر درخواست ناموفق بود، 4 +
random_number_milliseconds
صبر کنید و دوباره درخواست را امتحان کنید. - و به همین ترتیب، تا
maximum_backoff
. - به انتظار و تلاش مجدد تا حداکثر تعداد دفعات مجدد ادامه دهید، اما دوره انتظار بین تلاش های مجدد را افزایش ندهید.
جایی که:
- زمان انتظار
min(((2^n)+random_number_milliseconds), maximum_backoff)
، کهn
برای هر تکرار (درخواست) 1 افزایش می یابد. -
random_number_milliseconds
تعداد تصادفی میلی ثانیه کمتر یا مساوی 1000 است. این به جلوگیری از مواردی کمک می کند که در آن بسیاری از مشتریان با برخی موقعیت ها همگام می شوند و همه یکباره دوباره تلاش می کنند و درخواست ها را در امواج همگام ارسال می کنند. مقدارrandom_number_milliseconds
پس از هر درخواست مجدد محاسبه می شود. -
maximum_backoff
معمولاً 32 یا 64 ثانیه است. مقدار مناسب بستگی به مورد استفاده دارد.
مشتری می تواند پس از رسیدن به maximum_backoff
زمان بازگشت مجدد به تلاش مجدد ادامه دهد. تلاش مجدد بعد از این مرحله نیازی به افزایش زمان عقب نشینی ندارد. به عنوان مثال، اگر یک کلاینت از maximum_backoff
زمان بازگشت 64 ثانیه استفاده کند، پس از رسیدن به این مقدار، مشتری می تواند هر 64 ثانیه یکبار دوباره امتحان کند. در برخی موارد، مشتریان باید از تلاش مجدد به طور نامحدود جلوگیری شوند.
زمان انتظار بین تلاش های مجدد و تعداد دفعات مجدد بستگی به حالت استفاده و شرایط شبکه شما دارد.
درخواست افزایش سهمیه
بسته به میزان استفاده از منابع پروژه شما، ممکن است بخواهید درخواست افزایش سهمیه کنید. تماسهای API توسط یک حساب سرویس به عنوان استفاده از یک حساب واحد در نظر گرفته میشود. درخواست برای افزایش سهمیه تضمینی برای تایید نیست. افزایش سهمیه های بزرگ ممکن است مدت بیشتری طول بکشد تا تصویب شود.
همه پروژه ها سهمیه یکسانی ندارند. از آنجایی که در طول زمان به طور فزاینده ای از Google Cloud استفاده می کنید، ممکن است نیاز باشد که سهمیه های شما افزایش یابد. اگر انتظار افزایش چشمگیر استفاده در آینده را دارید، میتوانید به طور فعالانه از صفحه سهمیهها در کنسول Google Cloud درخواست تنظیمات سهمیه کنید .
برای کسب اطلاعات بیشتر به منابع زیر مراجعه کنید:
- درباره درخواست های افزایش سهمیه
- میزان استفاده و محدودیت های فعلی خود را مشاهده کنید
- درخواست محدودیت سهمیه بالاتر
قیمت گذاری
تمام استفاده از Google Vault API بدون هزینه اضافی برای مشتریان Google Workspace در دسترس است.