Chính sách định mức

Bạn đang xem tài liệu về Apigee Edge.
Chuyển đến tài liệu về Apigee X. thông tin

Nội dung

Sử dụng chính sách Hạn mức để định cấu hình số lượng thông báo yêu cầu mà proxy API cho phép trong một khoảng thời gian, chẳng hạn như phút, giờ, ngày, tuần hoặc tháng. Bạn có thể đặt hạn mức là như nhau cho tất cả các ứng dụng truy cập proxy API, hoặc bạn có thể đặt hạn mức dựa trên:

• Sản phẩm chứa proxy API
• Ứng dụng yêu cầu API
• Nhà phát triển ứng dụng
• Nhiều tiêu chí khác

Không sử dụng Hạn mức để tránh tăng đột biến lưu lượng truy cập tổng thể. Để làm được việc đó, hãy sử dụng chính sách Tăng đột biến. Vui lòng xem chính sách về việc Bắt giữ người trượt ván.

Video

Những video sau đây giới thiệu về việc quản lý hạn mức bằng chính sách Hạn mức:

Mẫu

Mã mẫu chính sách này minh hoạ cách bắt đầu và kết thúc khoảng thời gian hạn mức bằng cách:

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

Giới thiệu về chính sách Hạn mức

Hạn mức là một tập hợp các thông báo yêu cầu mà một proxy API có thể xử lý trong một khoảng thời gian, chẳng hạn như phút, giờ, ngày, tuần hoặc tháng. Chính sách này duy trì các bộ đếm đếm số lượng yêu cầu mà proxy API nhận được. Khả năng này cho phép nhà cung cấp API thực thi giới hạn về số lượng lệnh gọi API do các ứng dụng thực hiện trong một khoảng thời gian. Ví dụ: Khi sử dụng chính sách Hạn mức, bạn có thể giới hạn ứng dụng ở mức 1 yêu cầu mỗi phút hoặc 10.000 yêu cầu mỗi tháng.

Ví dụ: nếu Hạn mức được xác định là 10.000 thông báo mỗi tháng, thì việc giới hạn tốc độ sẽ bắt đầu sau thông báo thứ 10.000. Không quan trọng là 10.000 tin nhắn được tính vào ngày đầu tiên hay ngày cuối cùng của khoảng thời gian đó; không cho phép khu vực yêu cầu bổ sung nào được phép cho đến khi bộ đếm Hạn mức tự động đặt lại vào cuối khoảng thời gian đã chỉ định hoặc cho đến khi Hạn mức được đặt lại một cách rõ ràng bằng chính sách Đặt lại hạn mức.

Một thay đổi về Hạn mức có tên là SpikeArrest giúp ngăn chặn tình trạng lưu lượng truy cập tăng đột biến (hay đột biến) có thể do mức sử dụng tăng đột ngột, máy khách bị lỗi hoặc các cuộc tấn công độc hại. Để biết thêm thông tin về SpikeArrest, vui lòng xem chính sách về SpikeArrest.

Hạn mức áp dụng cho các proxy API riêng lẻ và không được phân phối giữa các proxy API. Ví dụ: nếu bạn có ba proxy API trong một sản phẩm API, thì một hạn mức duy nhất không được chia sẻ cho cả ba ngay cả khi cả ba đều sử dụng cùng một cấu hình chính sách hạn mức.

Các loại chính sách về hạn mức

Chính sách Hạn mức hỗ trợ một số loại chính sách: mặc định, calendar, flexi và rollingwindow. Mỗi loại xác định thời điểm bộ đếm hạn mức bắt đầu và đặt lại, như minh hoạ trong bảng sau:

Đối với type="calendar", bạn phải chỉ định giá trị <StartTime>.

Bảng này không liệt kê giá trị cho loại rollingwindow. Hạn mức thời hạn chuyển đổi hoạt động bằng cách đặt kích thước của một "thời hạn" hạn mức, chẳng hạn như khoảng thời gian một giờ hoặc một ngày. Khi có yêu cầu mới được gửi đến, chính sách này sẽ xác định xem hạn mức đã bị vượt quá trong "khoảng thời gian" trước đó hay chưa.

Ví dụ: bạn xác định khoảng thời gian là 2 giờ cho phép 1.000 yêu cầu. Một yêu cầu mới được gửi đến lúc 4:45 chiều.Chính sách này tính toán hạn mức cho khoảng thời gian 2 giờ qua, nghĩa là số lượng yêu cầu kể từ 2:45 chiều. Nếu chưa vượt quá giới hạn trong khoảng thời gian 2 giờ đó, thì hệ thống sẽ cho phép yêu cầu.

Một phút sau, vào lúc 4:46 chiều, lại nhận được một yêu cầu khác. Hiện tại, chính sách này sẽ tính số lượng hạn mức kể từ 2:46 chiều để xác định xem đã vượt quá giới hạn hay chưa.

Đối với loại rollingwindow, bộ đếm không bao giờ đặt lại, nhưng sẽ được tính toán lại mỗi khi có yêu cầu.

Tìm hiểu về bộ đếm hạn mức

Theo mặc định, chính sách Hạn mức vẫn duy trì một bộ đếm duy nhất, bất kể bạn tham chiếu bao nhiêu lần chính sách đó trong proxy API. Tên của bộ đếm hạn mức dựa trên thuộc tính name của chính sách.

Ví dụ: bạn tạo một chính sách Hạn mức có tên là MyQuotaPolicy với giới hạn 5 yêu cầu và đặt chính sách này trên nhiều luồng (Luồng A, B và C) trong proxy API. Mặc dù được sử dụng trong nhiều luồng, nhưng phương thức này vẫn duy trì một bộ đếm duy nhất được cập nhật cho mọi thực thể của chính sách:

• Luồng A được thực thi -> MyQuotaPolicy được thực thi và bộ đếm của luồng = 1
• Luồng B được thực thi -> MyQuotaPolicy được thực thi và bộ đếm của luồng B = 2
• Luồng A được thực thi -> MyQuotaPolicy được thực thi và bộ đếm của luồng = 3
• Luồng C được thực thi -> MyQuotaPolicy được thực thi và bộ đếm của luồng C = 4
• Luồng A được thực thi -> MyQuotaPolicy được thực thi và bộ đếm của luồng = 5

Yêu cầu tiếp theo đến một trong 3 quy trình bất kỳ trong số 3 quy trình đó đều bị từ chối vì bộ đếm hạn mức đã đạt đến giới hạn.

Việc dùng cùng một chính sách Hạn mức ở nhiều nơi trong luồng proxy API. Việc này có thể vô tình khiến Hạn mức hết nhanh hơn dự kiến. Đây là cách chống mẫu được mô tả trong Sách về Apigee Edge Antipatterns.

Ngoài ra, bạn có thể xác định nhiều chính sách Hạn mức trong proxy API và dùng một chính sách khác nhau trong mỗi quy trình. Mỗi chính sách Hạn mức sẽ có bộ đếm riêng, dựa trên thuộc tính name của chính sách.

Bạn cũng có thể sử dụng phần tử <Class> hoặc <Identifier> trong chính sách Hạn mức để xác định nhiều bộ đếm duy nhất trong một chính sách. Bằng cách sử dụng các phần tử này, một chính sách duy nhất có thể duy trì nhiều bộ đếm dựa trên ứng dụng đưa ra yêu cầu, nhà phát triển ứng dụng đưa ra yêu cầu, mã ứng dụng khách hoặc mã nhận dạng ứng dụng khách khác, v.v. Hãy xem các ví dụ ở trên để biết thêm thông tin về cách sử dụng phần tử <Class> hoặc <Identifier>.

Ký hiệu thời gian

Tất cả thời gian của Hạn mức đều được đặt theo múi giờ Giờ phối hợp quốc tế (UTC).

Ký hiệu thời gian hạn mức tuân theo ký hiệu ngày tiêu chuẩn quốc tế được xác định trong Tiêu chuẩn quốc tế ISO 8601.

Ngày được xác định là năm, tháng và ngày theo định dạng sau: YYYY-MM-DD. Ví dụ: 2015-02-04 đại diện cho ngày 4 tháng 2 năm 2015.

Thời gian trong ngày được xác định là giờ, phút và giây theo định dạng sau: hours:minutes:seconds. Ví dụ: 23:59:59 đại diện cho thời gian 1 giây trước nửa đêm.

Xin lưu ý rằng bạn có thể dùng 2 ký hiệu 00:00:00 và 24:00:00 để phân biệt 2 thời điểm nửa đêm có thể liên kết với một ngày. Do đó, 2015-02-04 24:00:00 có cùng ngày và giờ với 2015-02-05 00:00:00. Ký tự sau thường là ký hiệu ưu tiên.

Nhận chế độ cài đặt hạn mức từ cấu hình sản phẩm API

Bạn có thể đặt hạn mức trong cấu hình sản phẩm API. Những giới hạn đó không tự động thực thi hạn mức. Thay vào đó, bạn có thể tham khảo chế độ cài đặt hạn mức sản phẩm trong chính sách về hạn mức. Dưới đây là một số lợi ích của việc đặt hạn mức cho sản phẩm để tham khảo chính sách hạn mức:

• Chính sách về hạn mức có thể sử dụng một chế độ cài đặt đồng nhất trên tất cả các proxy API trong sản phẩm API.
• Bạn có thể thay đổi chế độ cài đặt hạn mức cho một sản phẩm API trong thời gian chạy và thay đổi chính sách hạn mức tham chiếu đến giá trị đó tự động có giá trị hạn mức được cập nhật.

Để biết thêm thông tin về cách sử dụng chế độ cài đặt hạn mức từ một sản phẩm API, hãy xem ví dụ về "Hạn mức động" ở trên..

Để biết thông tin về cách định cấu hình sản phẩm API có giới hạn hạn mức, hãy xem phần Tạo sản phẩm API.

Tham chiếu phần tử

Dưới đây là các phần tử và thuộc tính mà bạn có thể thiết lập trong chính sách này. Xin lưu ý rằng một số tổ hợp phần tử mang tính loại trừ lẫn nhau hoặc không bắt buộc. Hãy xem ví dụ để biết cách sử dụng cụ thể. Theo mặc định, các biến verifyapikey.VerifyAPIKey.apiproduct.* dưới đây có sẵn khi dùng chính sách Xác minh khoá API có tên là "VerifyAPIKey" để kiểm tra khoá API của ứng dụng trong yêu cầu. Giá trị biến được lấy từ chế độ cài đặt hạn mức trên sản phẩm API liên kết với khoá, như mô tả trong phần Cách tải chế độ cài đặt hạn mức từ cấu hình sản phẩm 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>

Thuộc tính <Hạn mức>

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

Sau đây là các thuộc tính dành riêng cho chính sách này.

Bảng sau đây mô tả các thuộc tính chung cho tất cả phần tử mẹ của chính sách:

Phần tử <DisplayName>

Sử dụng cùng với thuộc tính name để gắn nhãn cho chính sách trong trình chỉnh sửa proxy giao diện người dùng quản lý bằng tên khác theo ngôn ngữ tự nhiên.

<DisplayName>Policy Display Name</DisplayName>

Phần tử <Allow>

Chỉ định giới hạn số lượng cho hạn mức. Nếu bộ đếm của chính sách đạt đến giá trị giới hạn này, thì các lệnh gọi tiếp theo sẽ bị từ chối cho đến khi bộ đếm đặt lại.

Dưới đây là 3 cách để đặt phần tử <Allow>:

<Allow count="2000"/> 

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

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

Nếu bạn chỉ định cả count và countRef, thì countRef sẽ nhận được mức độ ưu tiên. Nếu countRef không phân giải trong thời gian chạy, thì giá trị của count sẽ được sử dụng.

Thuộc tính

Phần tử <Allow>/<Class>

Phần tử <Class> cho phép bạn điều chỉnh giá trị của phần tử <Allow> dựa trên giá trị của biến luồng. Đối với mỗi thẻ con <Allow> của <Class>, chính sách này sẽ duy trì một bộ đếm khác nhau.

Để sử dụng phần tử <Class>, hãy chỉ định một biến luồng bằng cách sử dụng thuộc tính ref cho thẻ <Class>. Sau đó, Edge sử dụng giá trị của biến luồng để chọn một trong các thẻ con <Allow> nhằm xác định số lượng được phép của chính sách. Edge so khớp giá trị của biến luồng với thuộc tính class của thẻ <Allow>, như minh hoạ dưới đây:

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

Trong ví dụ này, bộ đếm hạn mức hiện tại được xác định bằng giá trị của tham số truy vấn time_variable được truyền cùng với mỗi yêu cầu. Biến đó có thể có giá trị là peak_time hoặc off_peak_time. Nếu tham số truy vấn chứa giá trị không hợp lệ, thì chính sách sẽ trả về lỗi vi phạm hạn mức.

Thuộc tính

Phần tử <Allow>/<Class>/<Allow>

Phần tử <Allow> chỉ định giới hạn của bộ đếm hạn mức do phần tử <Class> xác định. Đối với mỗi thẻ con <Allow> của <Class>, chính sách này sẽ duy trì một bộ đếm khác nhau.

Ví dụ:

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

Trong ví dụ này, chính sách Hạn mức duy trì 2 bộ đếm hạn mức có tên là peak_time và off_peak_time.

Thuộc tính

Phần tử <Interval>

Dùng để chỉ định một số nguyên (ví dụ: 1, 2, 5, 60, v.v.) sẽ được ghép nối với TimeUnit mà bạn chỉ định (phút, giờ, ngày, tuần hoặc tháng) để xác định khoảng thời gian mà Edge tính toán mức sử dụng hạn mức.

Ví dụ: Interval của 24 với TimeUnit là hour có nghĩa là hạn mức sẽ được tính trong 24 giờ.

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

Thuộc tính

Phần tử <TimeUnit>

Sử dụng để chỉ định đơn vị thời gian áp dụng cho hạn mức.

Ví dụ: Interval của 24 với TimeUnit là hour có nghĩa là hạn mức sẽ được tính trong 24 giờ.

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

Thuộc tính

Phần tử <StartTime>

Khi bạn đặt type thành calendar,, hệ thống sẽ chỉ định ngày và giờ mà bộ đếm hạn mức sẽ bắt đầu đếm, bất kể ứng dụng có nhận được yêu cầu nào hay không.

Bạn phải cung cấp StartTime rõ ràng khi type được đặt rõ ràng là calendar,, bạn không thể sử dụng tham chiếu đến biến luồng. Nếu bạn chỉ định giá trị StartTime khi không có giá trị type nào được đặt, thì bạn sẽ gặp lỗi.

Ví dụ:

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

Phần tử <Phân phối>

Khi cài đặt Edge, bạn có thể sử dụng một hoặc nhiều Bộ xử lý tin nhắn để xử lý yêu cầu. Đặt phần tử này thành true để chỉ định rằng chính sách nên duy trì một bộ đếm trung tâm và liên tục đồng bộ hoá bộ đếm đó trên mọi Bộ xử lý thông báo. Trình xử lý thông báo có thể ở nhiều khu vực và/hoặc khu vực hỗ trợ hoạt động.

Nếu sử dụng giá trị mặc định là false, thì bạn có thể vượt quá hạn mức vì số lượng của mỗi Bên xử lý thư không được chia sẻ:

<Distributed>true</Distributed>

Để đảm bảo rằng các bộ đếm được đồng bộ hoá và được cập nhật trong mọi yêu cầu, hãy đặt <Distributed> và <Synchronous> thành true:

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

Phần tử <Đồng bộ>

Đặt thành true để cập nhật bộ đếm hạn mức phân phối một cách đồng bộ. Điều này có nghĩa là việc cập nhật bộ đếm được thực hiện cùng lúc với hạn mức được kiểm tra theo yêu cầu đối với API. Hãy đặt thành true nếu cần thiết rằng bạn không cho phép bất kỳ lệnh gọi API nào vượt quá hạn mức.

Đặt thành false để cập nhật bộ đếm hạn mức một cách không đồng bộ. Điều này có nghĩa là có thể một số lệnh gọi API vượt quá hạn mức sẽ trải qua, tuỳ thuộc vào thời điểm bộ đếm hạn mức trong kho lưu trữ trung tâm được cập nhật không đồng bộ. Tuy nhiên, bạn sẽ không gặp phải các tác động tiềm ẩn về hiệu suất liên quan đến các bản cập nhật đồng bộ.

Khoảng thời gian mặc định cho việc cập nhật không đồng bộ là 10 giây. Sử dụng phần tử AsynchronousConfiguration để định cấu hình hành vi không đồng bộ này.

<Synchronous>false</Synchronous>

Phần tử <không đồng bộ>

Định cấu hình khoảng thời gian đồng bộ hoá giữa các bộ đếm hạn mức được phân phối khi phần tử cấu hình chính sách <Synchronous> không có hoặc được đặt thành false.

Bạn có thể đồng bộ hoá sau một khoảng thời gian hoặc số lượng thông báo, bằng cách sử dụng các phần tử con SyncIntervalInSeconds hoặc SyncMessageCount. Chúng loại trừ lẫn nhau. Ví dụ:

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

hoặc

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

Phần tử <asyncConfiguration>/<SyncIntervalInSeconds>

Sử dụng thuộc tính này để ghi đè hành vi mặc định, trong đó các bản cập nhật không đồng bộ được thực hiện sau khoảng thời gian 10 giây.

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

Khoảng thời gian đồng bộ hoá phải lớn hơn 10 giây như mô tả trong chủ đề Giới hạn.

Phần tử <không đồng bộ>/<SyncMessageCount>

Chỉ định số lượng yêu cầu trên tất cả các trình xử lý tin nhắn Apigee giữa các lần cập nhật hạn mức.

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

Ví dụ này cho biết rằng hạn mức sẽ được cập nhật sau mỗi 5 yêu cầu trên từng trình xử lý tin nhắn Apigee Edge.

Phần tử <Identifier>

Sử dụng phần tử <Identifier> để định cấu hình chính sách nhằm tạo các bộ đếm duy nhất dựa trên biến luồng.

Nếu bạn không sử dụng phần tử này, thì chính sách sẽ sử dụng một bộ đếm duy nhất được áp dụng cho hạn mức.

Yếu tố này cũng được thảo luận trong bài đăng sau đây trên thẻ Cộng đồng 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"/>

Thuộc tính

Phần tử <MessageWeight>

Sử dụng để chỉ định trọng lượng gán cho mỗi tin nhắn. Sử dụng trọng số của thông báo để tăng tác động của các thông báo yêu cầu, chẳng hạn như sử dụng nhiều tài nguyên điện toán hơn những thông báo khác.

Ví dụ: bạn muốn tính số lượng thông báo POST là "nặng" hoặc tốn kém gấp đôi so với thông báo GET. Do đó, bạn đặt MessageWeight thành 2 cho yêu cầu POST và 1 cho yêu cầu GET. Thậm chí bạn có thể đặt MessageWeight thành 0 để yêu cầu không ảnh hưởng đến bộ đếm. Trong ví dụ này, nếu hạn mức là 10 tin nhắn mỗi phút và MessageWeight cho các yêu cầu POST là 2, thì hạn mức sẽ cho phép 5 yêu cầu POST trong khoảng thời gian 10 phút bất kỳ. Mọi yêu cầu bổ sung, POST hoặc GET, trước khi yêu cầu đặt lại bộ đếm bị từ chối.

Giá trị biểu thị MessageWeight phải được chỉ định bằng một biến luồng và có thể được trích xuất từ các tiêu đề HTTP, tham số truy vấn, tải trọng yêu cầu XML hoặc JSON hoặc bất kỳ biến luồng nào khác. Ví dụ: bạn đặt trong tiêu đề có tên weight:

<MessageWeight ref="message_weight"/>

Biến luồng

Các biến Luồng (Flow) được xác định trước sau đây sẽ được tự động điền sẵn khi thực thi chính sách Hạn mức. Để biết thêm thông tin về biến Flow, hãy xem bài viết Tài liệu tham khảo về biến.

Tham chiếu lỗi

Phần này mô tả các mã lỗi và thông báo lỗi được trả về, cũng như các biến lỗi do Edge đặt khi chính sách này kích hoạt lỗi. Thông tin này đóng vai trò quan trọng trong việc phát triển các quy tắc lỗi để xử lý lỗi. Để tìm hiểu thêm, hãy xem Những điều bạn cần biết về lỗi chính sách và Xử lý lỗi.

Lỗi thời gian chạy

Những lỗi này có thể xảy ra khi thực thi chính sách.

Lỗi triển khai

Biến lỗi

Các biến này được đặt khi chính sách này kích hoạt lỗi. Để biết thêm thông tin, hãy xem Những điều bạn cần biết về lỗi chính sách.

Ví dụ về phản hồi lỗi

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

Ví dụ về quy tắc lỗi

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

Giản đồ

Chủ đề có liên quan

Chính sách Đặt lại hạn mức

Chính sách của SpikeArrest

So sánh các chính sách về Hạn mức, Hạn chế tăng đột biến và Giới hạn số lượng yêu cầu đồng thời