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

Bạn đang xem tài liệu về Apigee Edge.
Truy cập vào tài liệu 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à một proxy API cho phép trong một khoảng thời gian, chẳng hạn như một phút, giờ, ngày, tuần hoặc tháng. Bạn có thể đặt hạn mức giống nhau cho tất cả các ứng dụng truy cập vào 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

Đừng sử dụng Hạn mức để ngăn chặn tình trạng lưu lượng truy cập tăng đột biến nói chung. Để làm việc đó, hãy sử dụng chính sách Chặn đột biến. Xem Chính sách về tính năng Chặn đột biến.

Video

Những video nà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

Các mã mẫu chính sách này minh hoạ cách bắt đầu và kết thúc cá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à số lượng 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 để tính tổng số 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 các giới hạn về số lượng lệnh gọi API mà ứng dụng thực hiện trong một khoảng thời gian. Ví dụ: bằng cách sử dụng chính sách về hạn mức, bạn có thể giới hạn số lượng yêu cầu của ứ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 tin nhắn mỗi tháng, thì việc điều chỉnh tốc độ sẽ bắt đầu sau tin nhắn thứ 10.000. Không quan trọng là 10.000 thông báo được tính vào ngày đầu tiên hay ngày cuối cùng của khoảng thời gian đó; bạn không được phép gửi thêm yêu cầu 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 rõ ràng bằng cách sử dụng Chính sách đặt lại hạn mức.

Một biến thể của 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 (hoặc tăng vọt) có thể do mức sử dụng tăng đột ngột, ứng dụng gặp lỗi hoặc các cuộc tấn công độc hại. Để biết thêm thông tin về SpikeArrest, hãy xem Chính sách về Spike Arrest.

Hạn mức áp dụng cho từng proxy API và không được phân phối giữa các proxy API. Ví dụ: nếu bạn có 3 proxy API trong một sản phẩm API, thì một hạn mức duy nhất sẽ không được chia sẻ trên cả 3 proxy, ngay cả khi cả 3 proxy đề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ợ nhiều 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ắt đầu và thời điểm đặt lại bộ đếm hạn mức, như minh hoạ trong bảng sau:

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

Bảng này không liệt kê giá trị cho loại rollingwindow. Hạn mức theo khoảng thời gian cố định hoạt động bằng cách đặt kích thước của "khoảng thời gian" 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ó một yêu cầu mới, chính sách sẽ xác định xem hạn mức có bị vượt quá trong "khoảng thời gian" trước đó hay không.

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

Một phút sau, lúc 4:46 chiều, một yêu cầu khác xuất hiện. Giờ đây, chính sách này sẽ tính số lượng hạn mức kể từ 14:46 để xác định xem bạn có vượt quá giới hạn hay không.

Đối với loại rollingwindow, bộ đếm sẽ không bao giờ đặt lại, nhưng sẽ được tính toán lại trên mỗi 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 duy trì một bộ đếm duy nhất, bất kể bạn tham chiếu bộ đếm đó bao nhiêu lần trong một 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 là 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 dùng trong nhiều luồng, nhưng nó vẫn duy trì một bộ đếm duy nhất được cập nhật bởi tất cả các phiên bản của chính sách:

• Quy trình A được thực thi -> MyQuotaPolicy được thực thi và bộ đếm của quy trình này = 1
• Quy trình B được thực thi -> MyQuotaPolicy được thực thi và bộ đếm của quy trình này = 2
• Quy trình A được thực thi -> MyQuotaPolicy được thực thi và bộ đếm của quy trình này = 3
• Quy trình C được thực thi -> MyQuotaPolicy được thực thi và bộ đếm của quy trình này = 4
• Quy trình A được thực thi -> MyQuotaPolicy được thực thi và bộ đếm của quy trình này = 5

Yêu cầu tiếp theo đối với bất kỳ luồng nào trong số 3 luồng này đều bị từ chối vì bộ đếm hạn mức đã đạt đến giới hạn.

Việc sử dụng cùng một chính sách Hạn mức ở nhiều nơi trong một quy trình proxy API (có thể vô tình khiến Hạn mức hết nhanh hơn dự kiến) là một mô hình phản tác dụng được mô tả trong The Book of Apigee Edge Antipatterns (Sách về các mô hình phản tác dụng của Apigee Edge).

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

Hoặc sử dụng các phần tử <Class> hoặc <Identifier> trong chính sách Hạn mức để xác định nhiều bộ đếm riêng biệt trong một chính sách duy nhất. 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 giá trị 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 trong 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 theo 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 biểu thị 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 biểu thị thời gian một giây trước nửa đêm.

Xin lưu ý rằng có 2 ký hiệu là 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. Cách sau thường được ưu tiên hơ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 chiếu các chế độ cài đặt hạn mức sản phẩm trong một chính sách hạn mức. Sau đây là một số lợi ích của việc đặt hạn mức cho sản phẩm để chính sách hạn mức tham chiếu:

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

Để 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ụ "Hạn mức động" ở trên..

Để biết thông tin về cách định cấu hình các 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ử

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

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

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

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

&lt;DisplayName&gt; phần tử

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

<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 cho chính sách đạt đến giá trị giới hạn này, các lệnh gọi tiếp theo sẽ bị từ chối cho đến khi bộ đếm được đặt lại.

Sau đâ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ẽ được ưu tiên. Nếu countRef không phân giải được 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 đặt điều kiện cho giá trị của phần tử <Allow> dựa trên giá trị của một biến luồng. Đối với mỗi thẻ con <Allow> khác nhau của <Class>, chính sách này duy trì một bộ đếm khác.

Để 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ẽ 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 theo từng yêu cầu. Biến đó có thể có giá trị peak_time hoặc off_peak_time. Nếu tham số truy vấn chứa một 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 hạn mức cho bộ đếm hạn mức do phần tử <Class> xác định. Đối với mỗi thẻ con <Allow> khác nhau của <Class>, chính sách này duy trì một bộ đếm riêng.

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 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 ngạch.

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

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

Thuộc tính

Phần tử <TimeUnit>

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

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

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

Thuộc tính

Phần tử <StartTime>

Khi type được đặt 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ể có yêu cầu nào được nhận từ bất kỳ ứng dụng nào hay không.

Ví dụ:

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

Phần tử <Distributed>

Một bản cài đặt Edge có thể sử dụng một hoặc nhiều Trình xử lý thông báo để xử lý các yêu cầu. Đặt phần tử này thành true để chỉ định rằng chính sách phải duy trì một bộ đếm trung tâm và liên tục đồng bộ hoá bộ đếm đó trên tất cả các Trình xử lý thông báo. Các trình xử lý thông báo có thể nằm trên nhiều vùng có thể truy cập và/hoặc khu vực.

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 cho mỗi Trình xử lý thông báo không được chia sẻ:

<Distributed>true</Distributed>

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

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

Phần tử <Synchronous>

Đặt thành true để cập nhật đồng bộ bộ đếm hạn mức phân tán. Điều này có nghĩa là quá trình cập nhật bộ đếm được thực hiện đồng thời với quá trình kiểm tra hạn mức đối với một yêu cầu gửi đến API. Đặt thành true nếu bạn không được phép thực hiện 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 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ẽ được thực hiện, 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 những tác động tiềm ẩn đến hiệu suất liên quan đến các bản cập nhật đồng bộ.

Khoảng thời gian cập nhật không đồng bộ mặc định 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ử <AsynchronousConfiguration>

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

Bạn có thể đồng bộ hoá sau một khoảng thời gian hoặc một số lượng tin nhắn, bằng cách sử dụng 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>

<AsynchronousConfiguration>/<SyncIntervalInSeconds> phần tử

Sử dụng phương thức 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 >= 10 giây như mô tả trong chủ đề Giới hạn.

Phần tử <AsynchronousConfiguration>/<SyncMessageCount>

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

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

Ví dụ này chỉ định rằng số lượng hạn mức được cập nhật sau mỗi 5 yêu cầu trên mỗi trình xử lý thông báo 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 riêng biệt dựa trên một biến luồng.

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

Phần tử này cũng được thảo luận trong bài đăng sau đây trên Cộng đồng Apigee: Quota identifier across different policies (Giá trị nhận dạng hạn mức trên nhiều chính sách).

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

Thuộc tính

Phần tử <MessageWeight>

Dùng để chỉ định trọng số được chỉ định cho mỗi thông báo. Sử dụng trọng số thông báo để tăng tác động của các thông báo yêu cầu. Ví dụ: các thông báo này tiêu thụ 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 các thông báo POST nặng gấp đôi hoặc tốn kém gấp đôi so với các thông báo GET. Do đó, bạn đặt MessageWeight thành 2 cho POST và 1 cho GET. Bạn thậm chí 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 thông báo mỗi phút và MessageWeight cho 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 bộ đếm đặt lại đều bị từ chối.

Bạn phải chỉ định một giá trị đại diện cho MessageWeight bằng một biến luồng và có thể trích xuất giá trị đó từ 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 mã này trong một tiêu đề có tên là weight:

<MessageWeight ref="message_weight"/>

Biến luồng

Các biến Flow được xác định trước sau đây sẽ tự động được điền khi một chính sách Hạn mức thực thi. Để biết thêm thông tin về các biến trong luồng, hãy xem phần 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 rất quan trọng nếu bạn đang phát triển các quy tắc lỗi để xử lý lỗi. Để tìm hiểu thêm, hãy xem bài viết 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 chính sách này thực thi.

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 bài viết Những điều bạn cần biết về lỗi chính sách.

Ví dụ về phản hồi khi gặp 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 ResetQuota

Chính sách SpikeArrest

So sánh các chính sách về Hạn mức, Ngăn chặn đột biến và Giới hạn tốc độ đồng thời