درحال مشاهده اسناد Apigee Edge هستید.
به
اسناد Apigee X بروید. اطلاعات
از خط‌مشی سهمیه برای شمارش تعداد درخواست‌های دریافتی توسط یک پراکسی API استفاده می‌شود. این قابلیت به ارائه‌دهندگان API امکان می‌دهد محدودیت‌هایی را بر تعداد تماس‌های API که برنامه‌ها در یک بازه زمانی برقرار می‌کنند اعمال کنند.
خط‌مشی سهمیه می‌تواند شامل عنصر
identifier باشد که «مخزن» سهمیه‌ای را که هر درخواست در آن
محاسبه می‌شود شناسایی می‌کند.
الگوی بد
هنگام استفاده از خط‌مشی «سهمیه»، از شناسه‌های با تعداد بالا استفاده نکنید.
کاردینالیتی به تعداد مقادیر داده‌های یکتا در یک مجموعه اشاره دارد. شناسه‌ای با کاردینالیتی بالا تعداد زیادی مقدار متمایز ممکن دارد. شناسه‌های با تعداد بالا شامل شناسه‌های درخواست یکتا یا شناسه‌های جلسه است که با هر فراخوانی API تغییر می‌کنند.
استفاده از شناسه‌های با تعداد بالا می‌تواند به‌طور قابل‌توجهی اثربخشی اجرای سهمیه شما را تضعیف کند.
تأثیر
استفاده از شناسه‌های با تعداد بالا برای عنصر شناسه خط‌مشی سهمیه شما باعث موارد زیر می‌شود:
- اجرای سهمیه غیرمؤثر: هر شناسه یکتا به‌عنوان یک شمارنده جداگانه درنظر گرفته می‌شود. اگر هر درخواست شناسه جدید و منحصربه‌فردی داشته باشد، سیستم سهمیه شما اساساً برای هر تماس با میانای برنامه‌سازی کاربردی یک «ظرف» جدید ایجاد می‌کند. این یعنی حد سهمیه کلی شما دربرابر شمارنده‌های یک‌بار مصرف و فردی اندازه‌گیری می‌شود نه براساس گروه‌های واقعی درخواست‌هایی که می‌خواهید محدود کنید، و این باعث می‌شود خط‌مشی برای کنترل ترافیک بی‌فایده باشد.
- افزایش مصرف منابع: تولید و مدیریت تعداد بسیار زیاد شمارنده‌های سهمیه منحصربه‌فرد فشار غیرضروری بر پلاتفرم Apigee وارد می‌کند و منجر به افزایش استفاده از منابع و مشکلات احتمالی عملکرد می‌شود.
- چالش‌های پایش: وقتی داده‌ها در تعداد زیادی شناسه منحصربه‌فرد پراکنده می‌شوند، پایش و درک روندهای مصرف واقعی میانای برنامه‌سازی کاربردی دشوار می‌شود. امکان دیدن اینکه کدام برنامه‌ها، توسعه‌دهندگان، یا محصولات از منابع API شما استفاده می‌کنند را ازدست می‌دهید.
روال مطلوب
شناسه‌هایی با کاردینالیتی پایین تا متوسط را انتخاب کنید که همچنین نشان‌دهنده گروه‌بندی پایدار و معناداری برای اجرای سهمیه باشند. این‌ها به شما کمک می‌کنند استفاده از API را به‌طور مؤثر مدیریت کنید و اطلاعات آماری درباره ترافیک خود دریافت کنید. چند نمونه:
- developer.app.name
- client_id
- apiproduct.name
با شناسه‌های مناسب، خط‌مشی «سهمیه» شما می‌تواند ترافیک میانای برنامه‌سازی کاربردی را به‌طور مؤثرتری مدیریت کند، از هزینه‌های اضافی ناخواسته جلوگیری کند، و اطلاعات آماری واضحی درباره الگوهای استفاده ارائه دهد.