นโยบายโควต้า

คุณกำลังดูเอกสารประกอบ Apigee Edge
ไปที่ เอกสารประกอบเกี่ยวกับ Apigee X. ข้อมูล

อะไร

ใช้นโยบายโควต้าเพื่อกำหนดค่าจำนวนข้อความคำขอที่พร็อกซี API อนุญาต ช่วงเวลา เช่น นาที ชั่วโมง วัน สัปดาห์ หรือเดือน คุณสามารถตั้งค่าโควต้าเป็น เหมือนกันสำหรับแอปทั้งหมดที่เข้าถึงพร็อกซี API หรือคุณอาจตั้งค่าโควต้าตามข้อมูลต่อไปนี้

• ผลิตภัณฑ์ที่มีพร็อกซี API
• แอปที่ขอ API
• นักพัฒนาแอป
• เกณฑ์อื่นๆ อีกมากมาย

อย่าใช้โควต้าเพื่อป้องกันการเพิ่มขึ้นของการเข้าชมโดยรวม สำหรับการเล่นแบบนั้น ให้ใช้เครื่องหมาย Spike Arrest ดู Spike Arrest

วิดีโอ

วิดีโอเหล่านี้จะแนะนำการจัดการโควต้าด้วยนโยบายโควต้า

ตัวอย่าง

ตัวอย่างโค้ดนโยบายเหล่านี้จะแสดงวิธีเริ่มต้นและสิ้นสุดระยะเวลาโควต้าโดยแยกตามสิ่งต่อไปนี้

<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>

เกี่ยวกับนโยบายโควต้า

โควต้าคือข้อความคำขอทั้งหมดที่พร็อกซี API สามารถจัดการได้ในช่วงเวลาหนึ่ง เช่น นาที ชั่วโมง วัน สัปดาห์ หรือเดือน นโยบายจะรักษาเคาน์เตอร์ที่นับจำนวน คำขอที่พร็อกซี API ได้รับ ซึ่งความสามารถนี้ช่วยให้ผู้ให้บริการ API บังคับใช้ขีดจำกัด จำนวนการเรียก API โดยแอปในช่วงเวลาหนึ่ง การใช้นโยบายโควต้าที่คุณสามารถทำ ตัวอย่างเช่น จำกัดแอปไว้ที่ 1 คำขอต่อนาที หรือไม่เกิน 10,000 คำขอต่อเดือน

เช่น หากกำหนดโควต้าเป็น 10,000 ข้อความต่อเดือน การจำกัดอัตราจะเริ่มหลังจาก ข้อความที่ 10,000 ไม่ว่าจะมี 10,000 ข้อความหรือไม่ก็ตาม วันหรือวันสุดท้ายของระยะเวลานั้น ไม่อนุญาตให้มีพื้นที่คำขอเพิ่มเติมจนกว่าจะถึงตัวนับโควต้า จะรีเซ็ตโดยอัตโนมัติเมื่อสิ้นสุดช่วงเวลาที่ระบุ หรือจนกว่าจะมีการกำหนดโควต้าอย่างชัดเจน รีเซ็ตโดยใช้รีเซ็ตโควต้า

รูปแบบของโควต้าที่เรียกว่า SpikeArrest ช่วยป้องกันการเพิ่มขึ้นของการเข้าชม (หรือจำนวนพุ่งสูงขึ้น) ที่อาจเป็นไปได้ เกิดจากการใช้งานที่เพิ่มขึ้นอย่างฉับพลัน ไคลเอ็นต์ที่มีข้อบกพร่อง หรือการโจมตีที่เป็นอันตราย สำหรับข้อมูลเพิ่มเติม ข้อมูลเกี่ยวกับ SpikeArrest โปรดดูนโยบายเกี่ยวกับ SpikeArrest

โควต้าจะมีผลกับพร็อกซี API แต่ละรายการ และจะไม่กระจายไปยังพร็อกซี API ตัวอย่างเช่น หากคุณมีพร็อกซี API 3 รายการในผลิตภัณฑ์ API โควต้าเดียวจะไม่มีการใช้ร่วมกันในทั้ง 3 รายการ แม้ว่าผลิตภัณฑ์ทั้ง 3 ประเภทจะใช้การกำหนดค่านโยบายโควต้าเดียวกัน

ประเภทนโยบายโควต้า

นโยบายโควต้ารองรับนโยบายหลายประเภท ได้แก่ ค่าเริ่มต้น calendar flexi และ rollingwindow แต่ละประเภทจะกำหนดเวลาที่ตัวนับโควต้า จะเริ่มต้นและรีเซ็ตเมื่อใด ดังที่แสดงในตารางต่อไปนี้

สำหรับ type="calendar" คุณต้องระบุค่าของ <StartTime>

ตารางไม่แสดงค่าสำหรับประเภท rollingwindow หน้าต่างหมุนได้ โควต้าจะทำงานโดยการตั้งค่าขนาดของ "กรอบเวลา" ของโควต้า เช่น กรอบเวลา 1 ชั่วโมงหรือ 1 วัน เมื่อ มีคำขอใหม่ โดยนโยบายจะพิจารณาว่าเคยมีการใช้เกินโควต้าหรือไม่ "หน้าต่าง"

เช่น คุณกำหนดกรอบเวลา 2 ชั่วโมงที่อนุญาตให้ส่งคำขอได้ 1, 000 รายการ คำขอใหม่ มาส่งในเวลา 16:45 น.โดยนโยบายจะคำนวณจำนวนโควต้าสำหรับกรอบเวลา 2 ชั่วโมงที่ผ่านมา หมายถึงจำนวนคำขอตั้งแต่ 14:45 น. หากไม่ได้เกินขีดจำกัดโควต้า สองชั่วโมง คำขอจะได้รับอนุญาต

1 นาทีต่อมา เวลา 16:46 น. คำขอใหม่เข้ามา ตอนนี้นโยบายจะคำนวณ จำนวนโควต้าตั้งแต่ 14:46 น. เพื่อดูว่าเกินขีดจำกัดหรือไม่

สำหรับประเภท rollingwindow ตัวนับจะไม่รีเซ็ต แต่ ระบบจะคำนวณใหม่ในคำขอแต่ละรายการ

การทำความเข้าใจตัวนับโควต้า

โดยค่าเริ่มต้น นโยบายโควต้าจะใช้ตัวนับเพียงตัวเดียว โดยไม่คำนึงถึงจำนวนครั้งที่ อ้างอิงในพร็อกซี API ชื่อของตัวนับโควต้าจะอิงตาม แอตทริบิวต์ name ของนโยบาย

เช่น คุณสร้างนโยบายโควต้าชื่อ MyQuotaPolicy ที่มีขีดจำกัด 5 แล้วนำไปวางในหลายโฟลว์ (โฟลว์ A, B และ C) ในพร็อกซี API แม้ว่าจะเป็น ซึ่งใช้ในหลายๆ ขั้นตอน ตัวนับจะเป็นตัวเดียวที่มีการอัปเดตโดยอินสแตนซ์ทุกรายการ นโยบาย:

• ดำเนินการโฟลว์ A แล้ว -> ดำเนินการ MyBidPolicy ดําเนินการและตัวนับ = 1
• ดำเนินการขั้นตอน B -> ดำเนินการตาม MyBidPolicy แล้วตัวนับ = 2
• ดำเนินการโฟลว์ A แล้ว -> ดำเนินการตาม MyBidPolicy ดําเนินการและตัวนับ = 3
• ดำเนินการโฟลว์ C แล้ว -> ดำเนินการ MyBidPolicy ดําเนินการและตัวนับ = 4
• ดำเนินการโฟลว์ A แล้ว -> ดำเนินการ MyBidPolicy ดําเนินการและตัวนับ = 5

คำขอถัดไปจาก 3 ขั้นตอนถูกปฏิเสธเนื่องจากใช้ตัวนับโควต้าแล้ว ขีดจำกัด

การใช้นโยบายโควต้าเดียวกันมากกว่า 1 ที่ในขั้นตอนพร็อกซี API ซึ่งสามารถ ทำให้โควต้าหมดเร็วกว่าที่คาดไว้โดยไม่ได้ตั้งใจ ซึ่งเป็นรูปแบบที่แก้ไขไม่ได้ที่อธิบายไว้ใน หนังสือของ Apigee Edge Antipatterns

หรือจะกำหนดนโยบายโควต้าหลายรายการในพร็อกซี API และใช้ ในแต่ละขั้นตอน นโยบายโควต้าแต่ละรายการจะรักษาตัวนับของตนเอง โดยขึ้นอยู่กับ แอตทริบิวต์ name ของนโยบาย

หรือใช้ องค์ประกอบ <Class> หรือ <Identifier> ใน นโยบายโควต้าเพื่อกำหนดตัวนับที่ไม่ซ้ำกันหลายรายการในนโยบายเดียว ด้วยการใช้สิ่งเหล่านี้ แต่ละนโยบายจะมีตัวนับ 1 ตัวที่แตกต่างกันตามแอปที่ส่งคำขอ นักพัฒนาแอปที่ส่งคำขอ รหัสไคลเอ็นต์ หรือตัวระบุไคลเอ็นต์อื่นๆ และอื่นๆ โปรดดู ตัวอย่างด้านบนสำหรับข้อมูลเพิ่มเติมเกี่ยวกับการใช้ องค์ประกอบ <Class> หรือ <Identifier>

หมายเหตุเวลา

กำหนดเวลาของโควต้าทั้งหมดเป็นสากลเชิงพิกัด เขตเวลา (UTC)

ค่าเวลาของโควต้าเป็นไปตามค่าวันที่มาตรฐานสากลที่กำหนดไว้ใน International มาตรฐาน ISO 8601

วันที่จะกำหนดเป็นปี เดือน และวันในรูปแบบต่อไปนี้: YYYY-MM-DD เช่น 2015-02-04 แสดงถึงวันที่ 4 กุมภาพันธ์ 2015

เวลาของวันระบุเป็นชั่วโมง นาที และวินาทีในรูปแบบต่อไปนี้ hours:minutes:seconds เช่น 23:59:59 จะแสดงเวลาหนึ่ง วินาที ก่อนเที่ยงคืน

โปรดทราบว่าสัญกรณ์ 2 ประเภทคือ 00:00:00 และ 24:00:00 มีไว้สำหรับ แยกความแตกต่างของเวลาเที่ยงคืน 2 วันดังกล่าวที่เชื่อมโยงกับวันที่หนึ่งๆ ได้ ดังนั้น 2015-02-04 24:00:00 จะมีวันที่และเวลาเดียวกับ 2015-02-05 00:00:00 วิธีหลังคือ มักจะเป็นสัญลักษณ์ที่ต้องการ

การรับการตั้งค่าโควต้าจากการกำหนดค่าผลิตภัณฑ์ API

คุณกำหนดขีดจำกัดโควต้าในการกำหนดค่าผลิตภัณฑ์ API ได้ ขีดจำกัดดังกล่าวจะไม่ส่งผลโดยอัตโนมัติ บังคับใช้โควต้า คุณสามารถอ้างอิงการตั้งค่าโควต้าผลิตภัณฑ์ในนโยบายโควต้าแทนได้ นี่คือบางส่วน ข้อดีของการตั้งค่าโควต้าในผลิตภัณฑ์สำหรับนโยบายโควต้าเพื่อใช้อ้างอิง

• นโยบายโควต้าสามารถใช้การตั้งค่าแบบเดียวกันในพร็อกซี API ทั้งหมดในผลิตภัณฑ์ API
• คุณเปลี่ยนแปลงการตั้งค่าโควต้าในผลิตภัณฑ์ API และนโยบายโควต้าได้ ที่อ้างอิงค่าดังกล่าวจะมีค่าโควต้าที่อัปเดตแล้วโดยอัตโนมัติ

ดูข้อมูลเพิ่มเติมเกี่ยวกับการใช้การตั้งค่าโควต้าจากผลิตภัณฑ์ API ได้ที่ "โควต้าแบบไดนามิก" ดังตัวอย่างข้างต้น

โปรดดูข้อมูลเกี่ยวกับการกำหนดค่าผลิตภัณฑ์ API ที่มีขีดจำกัดโควต้าได้ที่สร้างผลิตภัณฑ์ API

การอ้างอิงองค์ประกอบ

องค์ประกอบและแอตทริบิวต์ที่คุณกำหนดค่าได้ในนโยบายนี้มีดังนี้ โปรดทราบว่าบางองค์ประกอบ ค่าผสมนั้นไม่เกี่ยวข้องหรือไม่จำเป็น ดูตัวอย่างสำหรับการใช้งานที่เฉพาะเจาะจง verifyapikey.VerifyAPIKey.apiproduct.* ตัวแปรด้านล่างจะใช้งานได้โดยค่าเริ่มต้นเมื่อ นโยบายคีย์ API การยืนยันที่ชื่อ "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 เพื่อติดป้ายกำกับนโยบายใน เครื่องมือแก้ไขพร็อกซี UI การจัดการด้วยชื่อที่เป็นภาษาธรรมชาติต่างกัน

<DisplayName>Policy Display Name</DisplayName>

<Allow> องค์ประกอบ

ระบุขีดจำกัดจำนวนโควต้า หากการยื่นเรื่องโต้แย้งสำหรับนโยบายถึงขีดจำกัดนี้ การเรียกครั้งต่อๆ มาจะถูกปฏิเสธจนกว่าตัวนับจะรีเซ็ต

ด้านล่างนี้คือ 3 วิธีในการตั้งค่าองค์ประกอบ <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

Attributes

<Allow>/<Class> องค์ประกอบ

องค์ประกอบ <Class> ช่วยให้คุณกำหนดเงื่อนไขค่าได้ ขององค์ประกอบ <Allow> ตามค่าของตัวแปรโฟลว์ สำหรับ แท็กย่อย <Allow> แต่ละรายการของ <Class> นโยบายนั้นมีการโต้แย้งที่ต่างกัน

หากต้องการใช้เอลิเมนต์ <Class> ให้ระบุตัวแปรโฟลว์โดยใช้ ref ลงในแท็ก <Class> จากนั้น Edge จะใช้ค่าของแอตทริบิวต์ เพื่อเลือกแท็กย่อย 1 จาก <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>

ในตัวอย่างนี้ ตัวนับโควต้าปัจจุบันจะกำหนดโดยค่าของฟิลด์ มีการส่งพารามิเตอร์การค้นหา time_variable รายการพร้อมกับคำขอแต่ละรายการ ตัวแปรนั้นสามารถมีค่า ของ peak_time หรือ off_peak_time หากพารามิเตอร์ข้อความค้นหามี ค่า นโยบายจะแสดงข้อผิดพลาดการละเมิดโควต้า

Attributes

<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>

ในตัวอย่างนี้ นโยบายโควต้าจะมีตัวนับโควต้า 2 รายการชื่อ ของ peak_time และ off_peak_time

Attributes

<Interval> องค์ประกอบ

ใช้เพื่อระบุจำนวนเต็ม (เช่น 1, 2, 5, 60 เป็นต้น) ที่จะจับคู่กับ TimeUnit ที่คุณระบุ (นาที ชั่วโมง วัน สัปดาห์ หรือเดือน) เพื่อกำหนดเวลา ช่วงที่ Edge คำนวณการใช้โควต้า

ตัวอย่างเช่น Interval ของ 24 ที่มี TimeUnit ของ hour หมายความว่าโควต้าจะเท่ากับ ได้รับการคำนวณภายใน 24 ชั่วโมง

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

Attributes

<TimeUnit> องค์ประกอบ

ใช้เพื่อระบุหน่วยเวลาที่ใช้กับโควต้า

ตัวอย่างเช่น Interval ของ 24 ที่มี TimeUnit ของ hour หมายความว่าโควต้าจะเท่ากับ ได้รับการคำนวณภายใน 24 ชั่วโมง

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

Attributes

<StartTime> องค์ประกอบ

เมื่อตั้งค่า type เป็น calendar, จะเป็นการระบุวันที่ และเวลาที่ตัวนับโควต้าจะเริ่มนับ ไม่ว่าจะมีคำขอใดๆ ที่ได้รับจากแอปใดๆ

คุณต้องระบุ StartTime อย่างชัดแจ้งเมื่อมีการตั้งค่า type อย่างชัดแจ้ง ไปยัง calendar, คุณไม่สามารถใช้การอ้างอิงตัวแปรโฟลว์ได้ หากระบุ ค่า StartTime เมื่อไม่ได้ตั้งค่า type คุณจะได้รับ

เช่น

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

<เผยแพร่แล้ว> องค์ประกอบ

การติดตั้ง Edge จะใช้ตัวประมวลผลข้อความ (Message Processor) อย่างน้อย 1 ตัวเพื่อประมวลผลคำขอได้ ตั้งค่าสิ่งนี้ เป็น true เพื่อระบุว่านโยบายควรรักษา และซิงค์ข้อมูลอย่างต่อเนื่องกับตัวประมวลผลข้อความ (Message Processor) ทั้งหมดอย่างต่อเนื่อง โปรเซสเซอร์ข้อความ จะอยู่ในโซนและ/หรือภูมิภาคที่พร้อมใช้งานได้

หากใช้ค่าเริ่มต้น false อาจทำให้เกินโควต้าเนื่องจาก จำนวนของผู้ประมวลผลข้อความแต่ละรายที่จะไม่ถูกแชร์ ได้แก่

<Distributed>true</Distributed>

เพื่อรับประกันว่าตัวนับจะซิงค์และอัปเดตในทุกคำขอ ให้ตั้งค่า <Distributed> และ <Synchronous> เป็นจริง:

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

&lt;Synchronous&gt; องค์ประกอบ

ตั้งค่าเป็น true เพื่ออัปเดตตัวนับโควต้าแบบกระจายแบบพร้อมกัน ช่วงเวลานี้ หมายความว่าจะมีการอัปเดตตัวนับพร้อมกับการตรวจสอบโควต้าในคำขอ กับ API ตั้งค่าเป็น true หากคุณไม่ได้รับอนุญาตให้ใช้ API ใดๆ เกินโควต้าที่กำหนด

ตั้งค่าเป็น false เพื่ออัปเดตตัวนับโควต้าแบบไม่พร้อมกัน ซึ่งหมายความว่า อาจเป็นไปได้ที่การเรียก API บางรายการที่เกินโควต้าจะผ่านไปแล้ว โดยขึ้นอยู่กับว่า ตัวนับโควต้าในที่เก็บส่วนกลางจะมีการอัปเดตแบบไม่พร้อมกัน แต่คุณจะไม่ได้รับ ผลกระทบด้านประสิทธิภาพที่อาจเกิดขึ้นกับการอัปเดตแบบซิงโครนัส

ช่วงเวลาการอัปเดตแบบไม่พร้อมกันเริ่มต้นคือ 10 วินาที ใช้เมนู AsynchronousConfiguration ที่จะกำหนดค่าลักษณะการทำงานแบบไม่พร้อมกันนี้

<Synchronous>false</Synchronous>

&lt;AsynchronousConfiguration&gt; องค์ประกอบ

กำหนดค่าช่วงเวลาการซิงค์ข้อมูลระหว่างตัวนับโควต้าแบบกระจายเมื่อนโยบาย องค์ประกอบการกำหนดค่า <Synchronous> ไม่มีอยู่ หรือไม่มีอยู่และตั้งค่าเป็น ไปยัง false

คุณสามารถซิงค์ข้อมูลหลังจากช่วงเวลาหนึ่งหรือจำนวนข้อความ โดยใช้ องค์ประกอบย่อย SyncIntervalInSeconds หรือ SyncMessageCount ผลิตภัณฑ์ทั้งสองแยกกันต่างหาก ตัวอย่างเช่น

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

หรือ

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

&lt;AsynchronousConfiguration&gt;/&lt;SyncIntervalInSeconds&gt; องค์ประกอบ

ใช้เพื่อลบล้างลักษณะการทำงานเริ่มต้นเมื่อมีการอัปเดตแบบไม่พร้อมกันหลังจาก เป็นช่วง 10 วินาที

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

ช่วงเวลาการซิงค์ต้อง >= 10 วินาที ตามที่อธิบายไว้ใน หัวข้อขีดจำกัด

&lt;AsynchronousConfiguration&gt;/&lt;SyncMessageCount&gt; องค์ประกอบ

ระบุจำนวนคำขอจากผู้ประมวลผลข้อมูลข้อความ Apigee ทั้งหมดระหว่างโควต้า อัปเดต

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

ตัวอย่างนี้ระบุว่าจำนวนโควต้าจะได้รับการอัปเดตทุกๆ 5 คำขอใน Apigee แต่ละรายการ ระบบประมวลผลข้อความ Edge

&lt;Identifier&gt; องค์ประกอบ

ใช้องค์ประกอบ <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"/>

Attributes

&lt;MessageWeight&gt; องค์ประกอบ

ใช้เพื่อระบุน้ำหนักที่กำหนดให้แต่ละข้อความ ใช้น้ำหนักข้อความเพื่อเพิ่มผลลัพธ์ของ เช่น จะขอข้อความที่ใช้ทรัพยากรในการคำนวณมากกว่าทรัพยากรอื่นๆ

เช่น คุณต้องการนับข้อความ POST ว่ามีขนาด "หนัก" เป็น 2 เท่า หรือแพงๆ อย่าง GET ข้อความ คุณจึงตั้งค่า MessageWeight เป็น 2 สำหรับ POST และ 1 สำหรับ ดาวน์โหลด คุณยังตั้งค่า MessageWeight เป็น 0 ได้เพื่อไม่ให้คำขอ มีผลต่อตัวนับ ในตัวอย่างนี้ หากโควต้าคือ 10 ข้อความต่อนาทีและ MessageWeight สำหรับคำขอ POST คือ 2 ดังนั้นโควต้าจะ อนุญาตให้มีคำขอ POST 5 รายการในช่วง 10 นาทีใดก็ได้ คำขอเพิ่มเติม เช่น POST หรือ GET ก่อนที่การรีเซ็ตตัวนับจะถูกปฏิเสธ

ต้องระบุค่าที่แสดงถึง MessageWeight โดยโฟลว์ และสามารถดึงข้อมูลจากส่วนหัว HTTP พารามิเตอร์การค้นหา คำขอ XML หรือ JSON เพย์โหลด หรือตัวแปรโฟลว์อื่นๆ ตัวอย่างเช่น คุณตั้งค่าไว้ในส่วนหัวชื่อ weight:

<MessageWeight ref="message_weight"/>

ตัวแปรโฟลว์

ระบบจะป้อนข้อมูลตัวแปรโฟลว์ที่กำหนดไว้ล่วงหน้าต่อไปนี้โดยอัตโนมัติเมื่อนโยบายโควต้า ในการดำเนินการ ดูข้อมูลเพิ่มเติมเกี่ยวกับตัวแปรโฟลว์ได้ที่ข้อมูลอ้างอิงตัวแปร

ข้อมูลอ้างอิงข้อผิดพลาด

ส่วนนี้จะอธิบายรหัสข้อผิดพลาดและข้อความแสดงข้อผิดพลาดที่แสดงกลับมา และตัวแปรข้อผิดพลาดที่ 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>

สคีมา

หัวข้อที่เกี่ยวข้อง

นโยบายรีเซ็ตโควต้า

SpikeArrest นโยบาย

การเปรียบเทียบ นโยบายโควต้า การจํากัดปริมาณสูงสุด และขีดจำกัดอัตราคำขอพร้อมกัน