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ư một phút, một giờ, một ngày, một tuần hoặc một tháng. Bạn có thể đặt hạn mức giống nhau cho tất 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 để bảo vệ khỏi tình trạng lưu lượng truy cập tăng đột biến tổng thể. Để làm việc đó, hãy sử dụng chính sách Ngăn chặn sự cố tăng đột biến. Xem Chính sách về hành vi tăng đột biến.

Video

Những video này giới thiệu cách quản lý hạn mức theo Chính sách về 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 khoảng thời gian hạn mức theo:

<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 mức phân bổ các thông báo yêu cầu mà 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 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 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ụ: 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 tin nhắn mỗi tháng, thì việc giới hạn tốc độ sẽ bắt đầu sau tin nhắn thứ 10.000. Không quan trọng là 10.000 thư đượ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 được phép có thêm yêu cầu nào 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 ngăn chặn sự gia tăng đột biến (hoặc bùng nổ) lưu lượng truy cập có thể xảy ra do mức sử dụng tăng đột biến, ứng dụng 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, hãy xem Chính sách về SpikeArrest.

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 sẽ không được chia sẻ trên cả 3 proxy API, ngay cả khi cả 3 proxy API đề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à thời điểm đặt lại, như 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 "cửa sổ" lăn hoạt động bằng cách đặt kích thước của "cửa sổ" hạn mức, chẳng hạn như cửa sổ một giờ hoặc một ngày. Khi một yêu cầu mới đến, chính sách 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 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 được gửi vào lúc 4:45 chiều.Chính sách này tính số lượng hạn mức trong 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 bạn chưa vượt quá hạn mức trong khoảng thời gian 2 giờ đó, thì yêu cầu sẽ được chấp nhận.

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

Đối với loại rollingwindow, bộ đếm không bao giờ đặt lại mà đượ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, bất kể bạn tham chiếu 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 đó 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 lớp này vẫn duy trì một bộ đếm duy nhất được cập nhật bởi tất cả các thực thể của chính sách:

• Flow A được thực thi -> MyQuotaPolicy được thực thi và bộ đếm = 1
• Flow B được thực thi -> MyQuotaPolicy được thực thi và bộ đếm = 2
• Flow A được thực thi -> MyQuotaPolicy được thực thi và bộ đếm = 3
• Flow C được thực thi -> MyQuotaPolicy được thực thi và bộ đếm = 4
• Flow A được thực thi -> MyQuotaPolicy được thực thi và bộ đếm = 5

Yêu cầu tiếp theo đối với bất kỳ luồng nào trong số ba luồng này sẽ 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 vị trí trong luồng 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 nhau trong mỗi luồng. Mỗi chính sách Hạn mức 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. Bằng cách sử dụng các phần tử này, một chính sách 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 hoặc giá trị nhận dạng ứng dụng 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 thành múi giờ Giờ phối hợp quốc tế (UTC).

Cách ghi thời gian hạn mức tuân theo cách ghi 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, ở đị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 một giây trước nửa đêm.

Xin lưu ý rằng có hai ký hiệu, 00:00:00 và 24:00:00, để phân biệt hai 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 là ký hiệu được ưu tiên.

Lấy 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 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 chế độ cài đặt hạn mức sản phẩm trong chính sách hạn mức. Sau đây là một số ưu điểm của việc đặt hạn mức cho sản phẩm để các chính sách hạn mức tham chiếu:

• Chính sách hạn mức có thể sử dụng chế độ cài đặt thống nhất trên tất cả proxy API trong sản phẩm API.
• Bạn có thể thực hiện các thay đổi về 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 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 sản phẩm API có hạn mức hạn mức, hãy xem bài viết 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ử 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. 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 Lấy 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> (Cho phép)

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, 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 thiết lập 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 điều kiện hoá giá trị của phần tử <Allow> dựa trên giá trị của biến flow. Đối với mỗi thẻ con <Allow> khác nhau của <Class>, chính sách 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 flow 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 flow để 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 flow 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 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 giới hạn 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 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ì hai bộ đếm hạn mức có tên là peak_time và off_peak_time.

Thuộc tính

Phần tử <Interval>

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

Sử 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ãy chỉ định ngày và giờ mà bộ đếm hạn mức sẽ bắt đầu đếm, bất kể ứng dụng nào có nhận được yêu cầu hay không.

Ví dụ:

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

Phần tử <Distributed>

Một lượt 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ả Trình xử lý thông báo. Bộ xử lý thông báo có thể nằm trên các vùng và/hoặc khu vực có sẵn.

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 để đồng bộ cập nhật bộ đếm hạn mức được phân phối. Đ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 việc kiểm tra hạn mức trên một yêu cầu gửi đến API. Đặt thành true nếu 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 không đồng bộ. Điều này có nghĩa là một số lệnh gọi API vượt quá hạn mức có thể 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 phải đối mặt vớ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 được phân phối 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 số lượng thông báo bằng cách sử dụng phần tử con SyncIntervalInSeconds hoặc SyncMessageCount. Các giá trị này loại trừ lẫn nhau. Ví dụ:

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

hoặc

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

Phần tử <AsynchronousConfiguration>/<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 >= 10 giây như mô tả trong chủ đề Giới hạn.

<AsynchronousConfiguration>/<SyncMessageCount> element

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 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 duy nhất dựa trên biến flow.

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: 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 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, chẳng hạn như tiêu thụ nhiều tài nguyên tính toán hơn so với các thông báo khác.

Ví dụ: bạn muốn tính các 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 một POST và 1 cho một 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 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 bất kỳ khoảng thời gian 10 phút nào. Mọi yêu cầu bổ sung, POST hoặc GET, trước khi bộ đếm đặt lại sẽ bị từ chối.

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

<MessageWeight ref="message_weight"/>

Biến flow

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ề biến Flow, hãy xem phần Tham khảo 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 về ResetQuota

Chính sách về SpikeArrest

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