سیاست سهمیه بندی

شما در حال مشاهده اسناد Apigee Edge هستید.
به مستندات Apigee X بروید . اطلاعات

چی

از خط مشی Quota برای پیکربندی تعداد پیام های درخواستی که یک پروکسی API در یک دوره زمانی مجاز می دهد، مانند دقیقه، ساعت، روز، هفته یا ماه استفاده کنید. می‌توانید سهمیه را برای همه برنامه‌هایی که به پراکسی API دسترسی دارند یکسان تنظیم کنید، یا می‌توانید سهمیه را بر اساس:

• محصولی که حاوی پروکسی API است
• برنامه درخواست کننده API
• توسعه دهنده برنامه
• خیلی معیارهای دیگه

از Quota برای محافظت در برابر افزایش ترافیک کلی استفاده نکنید. برای آن، از خط مشی Spike Arrest استفاده کنید. به سیاست دستگیری Spike مراجعه کنید.

ویدیوها

این ویدیوها مدیریت سهمیه را با خط مشی سهمیه معرفی می کنند:

نمونه ها

این نمونه‌های کد خط‌مشی نحوه شروع و پایان دوره‌های سهمیه را به شرح زیر نشان می‌دهند:

<Quota name="CheckQuota"> 
  <Interval ref="verifyapikey.verify-api-key.apiproduct.developer.quota.interval">1</Interval>
  <TimeUnit ref="verifyapikey.verify-api-key.apiproduct.developer.quota.timeunit">hour</TimeUnit>
  <Allow count="200" countRef="verifyapikey.verify-api-key.apiproduct.developer.quota.limit"/>
</Quota>

<Quota name="DeveloperQuota"> 
  <Identifier ref="verifyapikey.verify-api-key.client_id"/> 
  <Interval ref="verifyapikey.verify-api-key.developer.timeInterval"/> 
  <TimeUnit ref="verifyapikey.verify-api-key.developer.timeUnit"/> 
  <Allow countRef="verifyapikey.verify-api-key.developer.limit"/> 
</Quota>

<Quota name="QuotaPolicy" type="calendar">
  <StartTime>2017-02-18 10:30:00</StartTime>
  <Interval>5</Interval>
  <TimeUnit>hour</TimeUnit>
  <Allow count="99"/>
</Quota>

<Quota name="QuotaPolicy">
  <Interval>5</Interval>
  <TimeUnit>hour</TimeUnit>
  <Allow count="99"/>
</Quota>

<AssignMessage async="false" continueOnError="false" enabled="true" name="ReturnQuotaVars">
    <AssignTo createNew="false" type="response"/>
    <Set>
        <Headers>
            <Header name="QuotaLimit">{ratelimit.QuotaPolicy.allowed.count}</Header>
            <Header name="QuotaUsed">{ratelimit.QuotaPolicy.used.count}</Header>
            <Header name="QuotaResetUTC">{ratelimit.QuotaPolicy.expiry.time}</Header>
        </Headers>
    </Set>
    <IgnoreUnresolvedVariables>false</IgnoreUnresolvedVariables>
</AssignMessage>

<Quota name="MyQuota">
  <Interval>1</Interval>
  <TimeUnit>hour</TimeUnit>
  <Allow count="10000"/>
</Quota>

<Quota name="QuotaPolicy" type="calendar">
  <Identifier ref="request.header.clientId"/> 
  <StartTime>2017-02-18 10:00:00</StartTime>
  <Interval>5</Interval>
  <TimeUnit>hour</TimeUnit>
  <Allow count="99"/>
</Quota>

<Identifier ref="request.queryparam.id"/>

<Identifier ref="verifyapikey.verify-api-key.client_id"></Identifier>

<Quota name="QuotaPolicy">
  <Interval>1</Interval>
  <TimeUnit>day</TimeUnit>
  <Allow>
    <Class ref="request.header.developer_segment">
      <Allow class="platinum" count="10000"/>
      <Allow class="silver" count="1000" />
    </Class>
  </Allow>
</Quota>

درباره سیاست سهمیه بندی

Quota مجموعه ای از پیام های درخواستی است که یک پروکسی API می تواند در یک بازه زمانی مانند دقیقه، ساعت، روز، هفته یا ماه مدیریت کند. این خط‌مشی شمارنده‌هایی دارد که تعداد درخواست‌های دریافت‌شده توسط پراکسی API را محاسبه می‌کند. این قابلیت به ارائه‌دهندگان API امکان می‌دهد محدودیت‌هایی را بر تعداد تماس‌های API برقرار شده توسط برنامه‌ها در یک بازه زمانی اعمال کنند. برای مثال، با استفاده از خط‌مشی‌های سهمیه، می‌توانید برنامه‌ها را به 1 درخواست در دقیقه یا به 10000 درخواست در ماه محدود کنید.

به عنوان مثال، اگر یک سهمیه به عنوان 10000 پیام در ماه تعریف شود، محدودیت نرخ پس از پیام 10000 شروع می شود. مهم نیست که 10000 پیام در روز اول آن دوره حساب شده باشد یا آخرین روز. تا زمانی که شمارشگر سهمیه به طور خودکار در پایان بازه زمانی مشخص شده بازنشانی شود، یا تا زمانی که سهمیه به صراحت با استفاده از سیاست بازنشانی سهمیه بازنشانی شود، هیچ منطقه درخواست اضافی مجاز نیست.

تغییری در Quota به نام SpikeArrest از افزایش ناگهانی ترافیک (یا انفجار) که می تواند ناشی از افزایش ناگهانی استفاده، کلاینت های باگ یا حملات مخرب باشد، جلوگیری می کند. برای اطلاعات بیشتر در مورد SpikeArrest، به سیاست Spike Arrest مراجعه کنید.

سهمیه ها برای پراکسی های API منفرد اعمال می شود و بین پراکسی های API توزیع نمی شود. به عنوان مثال، اگر سه پراکسی API در یک محصول API دارید، یک سهمیه واحد بین هر سه به اشتراک گذاشته نمی‌شود، حتی اگر هر سه از یک پیکربندی خط مشی سهمیه استفاده کنند.

انواع خط مشی سهمیه

خط مشی Quota از چندین نوع مختلف خط مشی پشتیبانی می کند: پیش فرض، calendar ، flexi ، و rollingwindow . همانطور که در جدول زیر نشان داده شده است، هر نوع مشخص می کند که شمارنده سهمیه چه زمانی شروع می شود و چه زمانی بازنشانی می شود:

برای type="calendar" ، باید مقدار <StartTime> را مشخص کنید.

جدول مقدار نوع rollingwindow را فهرست نمی کند. سهمیه های پنجره نورد با تنظیم اندازه یک سهمیه "پنجره" مانند پنجره یک ساعته یا یک روزه کار می کنند. هنگامی که یک درخواست جدید وارد می شود، خط مشی تعیین می کند که آیا از سهمیه در "پنجره" زمانی گذشته فراتر رفته است یا خیر.

به عنوان مثال، شما یک پنجره دو ساعته تعریف می کنید که اجازه 1000 درخواست را می دهد. یک درخواست جدید در ساعت 4:45 بعد از ظهر وارد می‌شود. این خط‌مشی تعداد سهمیه را برای پنجره دو ساعت گذشته محاسبه می‌کند، یعنی تعداد درخواست‌ها از ساعت 2:45 بعد از ظهر. اگر در آن پنجره دو ساعته از حد نصاب تجاوز نکرده باشد، درخواست مجاز است.

یک دقیقه بعد، در ساعت 4:46 بعد از ظهر، درخواست دیگری وارد می‌شود. اکنون این خط‌مشی تعداد سهمیه را از ساعت 2:46 بعد از ظهر محاسبه می‌کند تا تعیین کند که آیا از حد مجاز فراتر رفته است یا خیر.

برای نوع rollingwindow ، شمارنده هرگز بازنشانی نمی‌شود، اما در هر درخواست مجدداً محاسبه می‌شود.

درک سهمیه شمار

به طور پیش‌فرض، یک خط‌مشی Quota یک شمارنده واحد را حفظ می‌کند، صرف نظر از اینکه چند بار به آن در یک پراکسی API ارجاع می‌دهید. نام شمارنده سهمیه بر اساس ویژگی name سیاست است.

به عنوان مثال، شما یک خط مشی Quota به نام MyQuotaPolicy با محدودیت 5 درخواست ایجاد می کنید و آن را روی چندین جریان (جریان A، B و C) در پروکسی API قرار می دهید. حتی اگر در جریان‌های متعدد استفاده می‌شود، یک شمارنده واحد را حفظ می‌کند که توسط همه موارد سیاست به‌روزرسانی می‌شود:

• جریان A اجرا می شود -> MyQuotaPolicy اجرا می شود و شمارنده آن = 1
• جریان B اجرا می شود -> MyQuotaPolicy اجرا می شود و شمارنده آن = 2
• جریان A اجرا می شود -> MyQuotaPolicy اجرا می شود و شمارنده آن = 3
• جریان C اجرا می شود -> MyQuotaPolicy اجرا می شود و شمارنده آن = 4
• جریان A اجرا می شود -> MyQuotaPolicy اجرا می شود و شمارنده آن = 5

درخواست بعدی برای هر یک از سه جریان رد می شود زیرا شمارنده سهمیه به حد مجاز خود رسیده است.

استفاده از یک خط مشی Quota در بیش از یک مکان در یک جریان پراکسی API، که می تواند ناخواسته باعث شود تا Quota سریعتر از آنچه انتظار داشتید تمام شود، یک ضدالگو است که در The Book of Apigee Edge Antipatterns توضیح داده شده است.

از طرف دیگر، می توانید چندین خط مشی Quota را در پروکسی API خود تعریف کنید و از یک خط مشی متفاوت در هر جریان استفاده کنید. هر خط مشی سهمیه شمارنده خود را بر اساس ویژگی name خط مشی حفظ می کند.

یا از عناصر <Class> یا <Identifier> در خط مشی Quota برای تعریف شمارنده های متعدد و منحصر به فرد در یک خط مشی واحد استفاده کنید. با استفاده از این عناصر، یک خط‌مشی واحد می‌تواند شمارنده‌های مختلفی را بر اساس برنامه‌ای که درخواست می‌کند، توسعه‌دهنده برنامه درخواست‌کننده، شناسه مشتری یا شناسه مشتری دیگر و موارد دیگر را حفظ کند. برای اطلاعات بیشتر در مورد استفاده از عناصر <Class> یا <Identifier> به مثال های بالا مراجعه کنید.

نمادگذاری زمان

همه زمان‌های سهمیه بر روی منطقه زمانی هماهنگ جهانی (UTC) تنظیم شده‌اند.

نماد زمان سهمیه از نماد تاریخ استاندارد بین المللی تعریف شده در استاندارد بین المللی ISO 8601 پیروی می کند.

تاریخ ها به صورت سال، ماه و روز در قالب زیر تعریف می شوند: YYYY-MM-DD . به عنوان مثال، 2015-02-04 نشان دهنده 4 فوریه 2015 است.

زمان روز به صورت ساعت، دقیقه و ثانیه در قالب زیر تعریف می شود: hours:minutes:seconds . به عنوان مثال، 23:59:59 نشان دهنده زمان یک ثانیه قبل از نیمه شب است.

توجه داشته باشید که دو نماد 00:00:00 و 24:00:00 برای تشخیص دو نیمه شبی که می توانند با یک تاریخ مرتبط شوند در دسترس هستند. بنابراین 2015-02-04 24:00:00 همان تاریخ و ساعت 2015-02-05 00:00:00 است. دومی معمولاً نماد ترجیحی است.

دریافت تنظیمات سهمیه از پیکربندی محصول API

می‌توانید محدودیت‌های سهمیه را در تنظیمات محصول API تنظیم کنید. این محدودیت ها به طور خودکار سهمیه را اعمال نمی کنند. در عوض، می‌توانید به تنظیمات سهمیه محصول در خط‌مشی سهمیه اشاره کنید. در اینجا برخی از مزایای تعیین سهمیه روی محصول برای مرجع سیاست های سهمیه آورده شده است:

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

برای اطلاعات بیشتر در مورد استفاده از تنظیمات سهمیه از یک محصول API، به مثال "سهمیه پویا" در بالا مراجعه کنید. .

برای اطلاعات در مورد پیکربندی محصولات API با محدودیت های سهمیه، به ایجاد محصولات API مراجعه کنید.

مرجع عنصر

در زیر عناصر و ویژگی هایی وجود دارد که می توانید در این خط مشی پیکربندی کنید. توجه داشته باشید که برخی از ترکیبات عناصر متقابلاً منحصر به فرد هستند یا مورد نیاز نیستند. برای استفاده خاص به نمونه ها مراجعه کنید. متغیرهای verifyapikey.VerifyAPIKey.apiproduct.* زیر به‌طور پیش‌فرض در دسترس هستند زمانی که از یک خط‌مشی Verify API Key به نام «VerifyAPIKey» برای بررسی کلید API برنامه در درخواست استفاده می‌شود. مقادیر متغیر از تنظیمات سهمیه روی محصول API می آیند که کلید با آن مرتبط است، همانطور که در دریافت تنظیمات سهمیه از پیکربندی محصول API توضیح داده شده است.

<Quota async="false" continueOnError="false" enabled="true" name="Quota-3" type="calendar">
   <DisplayName>Quota 3</DisplayName>
   <Allow count="2000" countRef="verifyapikey.VerifyAPIKey.apiproduct.developer.quota.limit"/>
   <Allow>
      <Class ref="request.queryparam.time_variable">
        <Allow class="peak_time" count="5000"/>
        <Allow class="off_peak_time" count="1000"/>
      </Class>
   </Allow>
   <Interval ref="verifyapikey.VerifyAPIKey.apiproduct.developer.quota.interval">1</Interval> 
   <TimeUnit ref="verifyapikey.VerifyAPIKey.apiproduct.developer.quota.timeunit">month</TimeUnit>
   <StartTime>2017-7-16 12:00:00</StartTime> 
   <Distributed>false</Distributed> 
   <Synchronous>false</Synchronous> 
   <AsynchronousConfiguration> 
      <SyncIntervalInSeconds>20</SyncIntervalInSeconds> 
      <SyncMessageCount>5</SyncMessageCount> 
   </AsynchronousConfiguration> 
   <Identifier/> 
   <MessageWeight/> 
</Quota>

ویژگی های <Quota>

<Quota async="false" continueOnError="false" enabled="true" name="Quota-3" type="calendar">

ویژگی های زیر مختص این سیاست است.

جدول زیر ویژگی هایی را توصیف می کند که برای همه عناصر اصلی خط مشی مشترک هستند:

عنصر <DisplayName>

علاوه بر ویژگی name برای برچسب‌گذاری خط‌مشی در ویرایشگر پروکسی رابط کاربری مدیریت با نامی متفاوت و به زبان طبیعی، از آن استفاده کنید.

<DisplayName>Policy Display Name</DisplayName>

عنصر <Allow>

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

در زیر سه راه برای تنظیم عنصر <Allow> نشان داده شده است:

<Allow count="2000"/> 

<Allow countRef="verifyapikey.VerifyAPIKey.apiproduct.developer.quota.limit"/> 

<Allow count="2000" countRef="verifyapikey.VerifyAPIKey.apiproduct.developer.quota.limit"/> 

اگر هم count و هم countRef را مشخص کنید، countRef اولویت را دریافت می کند. اگر countRef در زمان اجرا حل نشود، از مقدار count استفاده می شود.

صفات

عنصر <Allow>/<Class>

عنصر <Class> به شما امکان می دهد مقدار عنصر <Allow> را بر اساس مقدار متغیر جریان شرطی کنید. برای هر تگ فرزند متفاوت <Allow> <Class> ، این خط مشی یک شمارنده متفاوت دارد.

برای استفاده از عنصر <Class> ، یک متغیر جریان را با استفاده از ویژگی ref به تگ <Class> مشخص کنید. سپس Edge از مقدار متغیر جریان برای انتخاب یکی از تگ‌های فرزند <Allow> برای تعیین تعداد مجاز خط مشی استفاده می‌کند. Edge مقدار متغیر جریان را با ویژگی class تگ <Allow> مطابقت می دهد، همانطور که در زیر نشان داده شده است:

<Allow>
  <Class ref="request.queryparam.time_variable">
    <Allow class="peak_time" count="5000"/>
    <Allow class="off_peak_time" count="1000"/>
  </Class>
</Allow>

در این مثال، شمارنده سهمیه فعلی با مقدار پارامتر query time_variable که با هر درخواست ارسال می شود، تعیین می شود. آن متغیر می تواند مقدار peak_time یا off_peak_time داشته باشد. اگر پارامتر پرس و جو حاوی یک مقدار نامعتبر باشد، خط مشی یک خطای نقض سهمیه را برمی گرداند.

صفات

عنصر <Allow>/<Class>/<Allow>

عنصر <Allow> حدی را برای یک شمارنده سهمیه تعریف شده توسط عنصر <Class> مشخص می کند. برای هر تگ فرزند متفاوت <Allow> <Class> ، این خط مشی یک شمارنده متفاوت دارد.

به عنوان مثال:

<Allow>
  <Class ref="request.queryparam.time_variable">
    <Allow class="peak_time" count="5000"/>
    <Allow class="off_peak_time" count="1000"/>
  </Class>
</Allow>

در این مثال، خط مشی Quota دو شمارنده سهمیه به نام‌های peak_time و off_peak_time را حفظ می‌کند.

صفات

عنصر <Interval>

برای تعیین یک عدد صحیح (مثلاً 1، 2، 5، 60 و غیره) استفاده کنید که با TimeUnit که مشخص کرده اید (دقیقه، ساعت، روز، هفته یا ماه) جفت می شود تا دوره زمانی تعیین شود که Edge استفاده از سهمیه را محاسبه می کند.

به عنوان مثال، Interval 24 با TimeUnit hour به این معنی است که سهمیه در طول 24 ساعت محاسبه می شود.

<Interval ref="verifyapikey.VerifyAPIKey.apiproduct.developer.quota.interval">1</Interval>

صفات

عنصر <TimeUnit>

برای تعیین واحد زمان قابل اعمال برای سهمیه استفاده کنید.

به عنوان مثال، Interval 24 با TimeUnit hour به این معنی است که سهمیه در طول 24 ساعت محاسبه می شود.

<TimeUnit ref="verifyapikey.VerifyAPIKey.apiproduct.developer.quota.timeunit">month</TimeUnit>

صفات

عنصر <StartTime>

وقتی type روی calendar, تاریخ و زمانی را مشخص می کند که شمارشگر سهمیه شروع به شمارش می کند، صرف نظر از اینکه درخواستی از هر برنامه ای دریافت شده باشد یا خیر.

هنگامی که type به طور صریح روی calendar, تنظیم شده است، باید یک StartTime صریح ارائه دهید، نمی توانید از یک مرجع برای متغیر جریان استفاده کنید، اگر مقدار StartTime را زمانی که مقدار type تنظیم نشده است تعیین کنید، یک خطا دریافت می کنید.

به عنوان مثال:

<StartTime>2017-7-16 12:00:00</StartTime>

عنصر <Distributed>

نصب Edge می تواند از یک یا چند پردازشگر پیام برای پردازش درخواست ها استفاده کند. این عنصر را روی true تنظیم کنید تا مشخص کنید که خط مشی باید یک شمارنده مرکزی داشته باشد و به طور مداوم آن را در همه پردازشگرهای پیام همگام سازی کند. پردازشگرهای پیام می توانند در مناطق و/یا مناطق در دسترس باشند.

اگر از مقدار پیش‌فرض false استفاده می‌کنید، ممکن است از سهمیه خود فراتر بروید زیرا تعداد هر پردازشگر پیام به اشتراک گذاشته نمی‌شود:

<Distributed>true</Distributed>

برای تضمین همگام سازی شمارنده ها و به روز رسانی در هر درخواست، <Distributed> و <Synchronous> را روی true تنظیم کنید:

<Distributed>true</Distributed>
<Synchronous>true</Synchronous>

عنصر <همگام>

برای به روز رسانی همزمان شمارنده سهمیه توزیع شده روی true تنظیم کنید. این بدان معنی است که به روز رسانی پیشخوان همزمان با بررسی سهمیه در یک درخواست به API انجام می شود. اگر ضروری است اجازه ندهید هیچ تماس API بیش از حد مجاز نباشد، روی true تنظیم کنید.

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

فاصله به روز رسانی ناهمزمان پیش فرض 10 ثانیه است. از عنصر AsynchronousConfiguration برای پیکربندی این رفتار ناهمزمان استفاده کنید.

<Synchronous>false</Synchronous>

عنصر <AsynchronousConfiguration>

زمانی که عنصر پیکربندی خط مشی <Synchronous> موجود نباشد یا وجود داشته باشد و روی false تنظیم شده باشد، فاصله همگام‌سازی را در میان شمارنده‌های سهمیه توزیع شده پیکربندی می‌کند.

می‌توانید با استفاده از عناصر فرزند SyncIntervalInSeconds یا SyncMessageCount ، پس از یک دوره زمانی یا تعداد پیام‌ها همگام‌سازی کنید. آنها متقابلاً منحصر به فرد هستند. به عنوان مثال،

<AsynchronousConfiguration>
   <SyncIntervalInSeconds>20</SyncIntervalInSeconds>
</AsynchronousConfiguration>

یا

<AsynchronousConfiguration>
   <SyncMessageCount>5</SyncMessageCount>
</AsynchronousConfiguration>

عنصر <AsynchronousConfiguration>/<SyncIntervalInSeconds>

از این برای نادیده گرفتن رفتار پیش‌فرض که در آن به‌روزرسانی‌های ناهمزمان پس از یک فاصله زمانی 10 ثانیه انجام می‌شود، استفاده کنید.

<AsynchronousConfiguration>
   <SyncIntervalInSeconds>20</SyncIntervalInSeconds>
</AsynchronousConfiguration>

فاصله همگام سازی باید >= 10 ثانیه باشد که در مبحث Limits توضیح داده شده است.

عنصر <AsynchronousConfiguration>/<SyncMessageCount>

تعداد درخواست‌ها را در تمام پردازنده‌های پیام Apigee بین به‌روزرسانی‌های سهمیه مشخص می‌کند.

<AsynchronousConfiguration>
   <SyncMessageCount>5</SyncMessageCount>
</AsynchronousConfiguration>

این مثال مشخص می کند که تعداد سهمیه هر 5 درخواست در هر پردازشگر پیام Apigee Edge به روز می شود.

عنصر <Identifier>

از عنصر <Identifier> برای پیکربندی خط مشی برای ایجاد شمارنده های منحصر به فرد بر اساس یک متغیر جریان استفاده کنید.

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

این عنصر همچنین در پست انجمن Apigee زیر مورد بحث قرار گرفته است: http://community.apigee.com/questions/2807/how-does-the-edge-quota-policy-work-when-no-identi.html .

<Identifier ref="verifyapikey.verify-api-key.client_id"/>

صفات

عنصر <MessageWeight>

برای تعیین وزن اختصاص داده شده به هر پیام استفاده کنید. از وزن پیام برای افزایش تأثیر پیام های درخواستی استفاده کنید که به عنوان مثال، منابع محاسباتی بیشتری را نسبت به سایرین مصرف می کنند.

برای مثال، می‌خواهید پیام‌های POST را دو برابر «سنگین» یا گران‌تر از پیام‌های GET بشمارید. بنابراین، شما MessageWeight را روی 2 برای POST و 1 برای GET قرار می دهید. حتی می‌توانید MessageWeight را روی 0 تنظیم کنید تا درخواست روی شمارنده تأثیری نداشته باشد. در این مثال، اگر سهمیه 10 پیام در دقیقه و MessageWeight برای درخواست‌های POST 2 باشد، سهمیه اجازه 5 درخواست POST را در هر فاصله 10 دقیقه‌ای می‌دهد. هرگونه درخواست اضافی، POST یا GET، قبل از رد شدن مجدد شمارنده.

مقداری که MessageWeight را نشان می‌دهد باید توسط یک متغیر جریان مشخص شود و می‌تواند از سرصفحه‌های HTTP، پارامترهای پرس و جو، بار درخواست XML یا JSON یا هر متغیر جریان دیگری استخراج شود. به عنوان مثال، شما آن را در یک هدر به نام weight تنظیم می کنید:

<MessageWeight ref="message_weight"/>

متغیرهای جریان

متغیرهای جریان از پیش تعریف شده زیر به طور خودکار در هنگام اجرای یک خط مشی Quota پر می شوند. برای اطلاعات بیشتر در مورد متغیرهای جریان، به مرجع متغیرها مراجعه کنید.

مرجع خطا

این بخش کدهای خطا و پیام‌های خطایی را که برگردانده می‌شوند و متغیرهای خطا را که توسط Edge تنظیم می‌شوند، هنگامی که این خط‌مشی خطا را راه‌اندازی می‌کند، توضیح می‌دهد. این اطلاعات برای دانستن اینکه آیا در حال توسعه قوانین خطا برای رسیدگی به خطاها هستید، مهم است. برای کسب اطلاعات بیشتر، آنچه را که باید در مورد خطاهای خط مشی و مدیریت خطاها بدانید را ببینید.

خطاهای زمان اجرا

این خطاها ممکن است هنگام اجرای سیاست رخ دهند.

خطاهای استقرار

متغیرهای خطا

این متغیرها زمانی تنظیم می شوند که این خط مشی خطایی را ایجاد کند. برای اطلاعات بیشتر، به آنچه باید در مورد خطاهای خط مشی بدانید مراجعه کنید.

نمونه پاسخ خطا

{  
   "fault":{  
      "detail":{  
         "errorcode":"policies.ratelimit.QuotaViolation"
      },
      "faultstring":"Rate limit quota violation. Quota limit  exceeded. Identifier : _default"
   }
}

مثال قانون خطا

<FaultRules>
    <FaultRule name="Quota Errors">
        <Step>
            <Name>JavaScript-1</Name>
            <Condition>(fault.name Matches "QuotaViolation") </Condition>
        </Step>
        <Condition>ratelimit.Quota-1.failed=true</Condition>
    </FaultRule>
</FaultRules>

طرحواره ها

موضوعات مرتبط

سیاست ResetQuota

سیاست SpikeArrest

مقایسه سهمیه، دستگیری سنبله، و خط مشی های محدودیت نرخ همزمان