מדיניות איפוס QQota

כרגע מוצג התיעוד של Apigee Edge.
כניסה למסמכי התיעוד של Apigee X. מידע

מה

אפשר להשתמש בו כדי לשנות באופן דינמי את מספר הבקשות שנותר שמותר לפי המדיניות בנושא מכסת יעד. בדרך כלל משתמשים במדיניות הזו כדי להקטין את מספר המכסות הנוכחי של מדיניות המכסה, במקום להמתין שהמכסות יתאפסו.

לדוגמה, מדיניות מכסת היעד מגבילה מפתח ל-1,000 בקשות בשבוע. עד היום השני בשבוע, המפתח כבר הגיע למגבלה הזו. אפשר להשתמש במדיניות איפוס המכסה כדי לנכות 500 בקשות ממונה המכסות, וכך לאפשר 500 בקשות נוספות בשארית השבוע. בסוף השבוע, מדיניות המכסה תתאפס והמפתח יחזור ל-1, 000 בקשות בשבוע.

מידע נוסף על מדיניות המכסה זמין במאמר מדיניות המכסה. כדאי גם לקרוא את הפוסט הזה בקהילה לגבי שימוש במדיניות איפוס המכסה.

טעימות

דוגמאות קוד המדיניות הבאות ממחישות איך לאפס מוני מכסות:

<ResetQuota name="resetQuota">
   <Quota name="MyQuotaPolicy">
      <Identifier name="_default">
         <Allow>100</Allow>
      </Identifier>
   </Quota>
</ResetQuota>

<Quota name="MyQuotaPolicy">
  <Interval>5</Interval>
  <TimeUnit>hour</TimeUnit>
  <Allow count="100"/>
</Quota>

<ResetQuota name="resetQuota">
   <Quota ref="request.header.quotapolicy">
      <Identifier name="_default">
         <Allow ref="request.header.allowquota" />
      </Identifier>
   </Quota>
</ResetQuota>

<ResetQuota name="resetQuota">
   <Quota name="QuotaPolicy">
      <Identifier ref="request.header.clientId">
         <Allow>100</Allow>
      </Identifier>
   </Quota>
</ResetQuota>

<Quota name="QuotaPolicy">
  <Identifier ref="request.header.clientId"/> 
  <Interval>5</Interval>
  <TimeUnit>hour</TimeUnit>
  <Allow count="100"/>
</Quota>

הפניה לרכיב

ההפניה לרכיבים מתארת את הרכיבים והתכונות של המדיניות בנושא איפוס המכסה.

<ResetQuota async="false" continueOnError="false" enabled="true" name="Reset-Quota-1">
   <DisplayName>Reset Quota 1</DisplayName>
   <Quota name="quotaName" ref="request.header.quotapolicy">
      <Identifier name="identifierName" ref="request.header.identifier">
         <Class ref="request.header.classIdentifier" />
         <Allow>100</Allow>
      </Identifier>
   </Quota>
</ResetQuota>

מאפייני <ResetQuota>

<ResetQuota async="false" continueOnError="false" enabled="true" name="Reset-Quota-1"> 

בטבלה הבאה מפורטים המאפיינים שמשותפים לכל רכיבי ההורה של המדיניות:

רכיב <DisplayName>

יש להשתמש במאפיין הזה בנוסף למאפיין name כדי להוסיף למדיניות בכלי לעריכת שרת ה-proxy לניהול ממשק משתמש עם שם אחר בשפה טבעית.

<DisplayName>Policy Display Name</DisplayName>

רכיב <Quota>

מזהה את המדיניות בנושא מכסת יעד שצריך לעדכן את המונה שלה.

<Quota name="quotaName"  ref="request.header.quotapolicy">
   <Identifier name="identifierName" ref="request.header.identifier">
      <Allow>100</Allow>
   </Identifier>
</Quota>

מאפיינים

רכיב <Quota>/<Identifier>

משתנה שמשמש לזיהוי ייחודי של המונה אם במדיניות target Quota צוין התג <Identifier>.

<Quota name="quotaName">
   <Identifier name="identifierName" ref="request.header.identifier">
      <Allow>100</Allow>
   </Identifier>
</Quota>

מאפיינים

אלמנט <Quota>/<Identifier>/<Allow>

מציין את הסכום להקטנת המונה. צריך לציין <Allow>, אחרת המדיניות לא תשנה את המכסה.

<Identifier name="identifierName" ref="request.header.identifier">
   <Allow ref="request.header.allowquota">100</Allow>
</Identifier>

מאפיינים

אלמנט <Quota>/<Identifier>/<Class>

מציין את המחלקה שבה יתעדכן מונה המכסות. מידע נוסף על השימוש במחלקה יחד עם מדיניות Quota זמין במדיניות המכסה.

<Identifier name="_default">
   <Class ref="request.header.classIdentifier">
     <Allow>200</Allow>
   </Class>
</Identifier>

מאפיינים

הפניה לשגיאות

בקטע הזה מתוארים קודי התקלות והודעות השגיאה שמוחזרים, ומשתני השגיאה שמוגדרים על ידי Edge כשהמדיניות הזו גורמת לשגיאה. חשוב לדעת אם אתם מפתחים כללים לתיקון תקלות. מידע נוסף זמין במאמר מה צריך לדעת על שגיאות מדיניות ועל טיפול בפגמים.

שגיאות בזמן ריצה

השגיאות האלה יכולות להתרחש כשהמדיניות מופעלת.

שגיאות בפריסה

השגיאות האלה יכולות להתרחש כשפורסים שרת proxy שכולל את המדיניות הזו.

סכימות

נושאים קשורים

מדיניות בנושא מכסות