محدودیت های استفاده

از آنجایی که 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 دقیقه)، توصیه می‌کنیم کد شما استثنا باشد و از یک عقب‌نشینی نمایی کوتاه‌شده استفاده کند تا مطمئن شود دستگاه‌های شما بار بیش از حد تولید نمی‌کنند.

عقب نشینی نمایی یک استراتژی مدیریت خطای استاندارد برای برنامه های شبکه است. یک الگوریتم عقب‌نشینی نمایی، درخواست‌ها را با استفاده از افزایش تصاعدی زمان انتظار بین درخواست‌ها، تا حداکثر زمان عقب‌نشینی، دوباره امتحان می‌کند. اگر درخواست‌ها همچنان ناموفق هستند، مهم است که تأخیر بین درخواست‌ها در طول زمان افزایش یابد تا درخواست موفقیت‌آمیز شود.

الگوریتم نمونه

یک الگوریتم عقب‌نشینی نمایی، درخواست‌ها را به‌صورت تصاعدی دوباره امتحان می‌کند، و زمان انتظار بین تلاش‌های مجدد را تا حداکثر زمان عقب‌نشینی افزایش می‌دهد. به عنوان مثال:

  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 تعداد تصادفی میلی ثانیه کمتر یا مساوی 1000 است. این به جلوگیری از مواردی کمک می کند که در آن بسیاری از مشتریان با برخی موقعیت ها همگام می شوند و همه یکباره دوباره تلاش می کنند و درخواست ها را در امواج همگام ارسال می کنند. مقدار random_number_milliseconds پس از هر درخواست مجدد محاسبه می شود.
  • maximum_backoff معمولاً 32 یا 64 ثانیه است. مقدار مناسب بستگی به مورد استفاده دارد.

مشتری می تواند پس از رسیدن به maximum_backoff زمان بازگشت مجدد به تلاش مجدد ادامه دهد. تلاش مجدد بعد از این مرحله نیازی به افزایش زمان عقب نشینی ندارد. به عنوان مثال، اگر یک کلاینت از maximum_backoff زمان بازگشت 64 ثانیه استفاده کند، پس از رسیدن به این مقدار، مشتری می تواند هر 64 ثانیه یکبار دوباره امتحان کند. در برخی موارد، مشتریان باید از تلاش مجدد به طور نامحدود جلوگیری شوند.

زمان انتظار بین تلاش های مجدد و تعداد دفعات مجدد بستگی به حالت استفاده و شرایط شبکه شما دارد.

درخواست افزایش سهمیه

بسته به میزان استفاده از منابع پروژه شما، ممکن است بخواهید یک تنظیم سهمیه درخواست کنید. تماس‌های API توسط یک حساب سرویس به عنوان استفاده از یک حساب واحد در نظر گرفته می‌شود. درخواست برای سهمیه تعدیل شده تأییدیه ای را تضمین نمی کند. درخواست‌های تعدیل سهمیه که به میزان قابل توجهی مقدار سهمیه را افزایش می‌دهند، ممکن است مدت بیشتری طول بکشد تا تأیید شوند.

همه پروژه ها سهمیه یکسانی ندارند. از آنجایی که در طول زمان به طور فزاینده ای از Google Cloud استفاده می کنید، ممکن است نیاز باشد مقادیر سهمیه شما افزایش یابد. اگر انتظار افزایش چشمگیر استفاده در آینده را دارید، می‌توانید به طور فعالانه از صفحه سهمیه‌ها در کنسول Google Cloud درخواست تنظیمات سهمیه کنید .

برای کسب اطلاعات بیشتر به منابع زیر مراجعه کنید:

قیمت گذاری

تمام استفاده از Google Vault API بدون هزینه اضافی برای مشتریان Google Workspace در دسترس است.