Aracılığıyla paylaş

Anahtara göre kullanım kotası ayarlama

  • Makale

ŞUNLAR IÇIN GEÇERLIDIR: Geliştirici | Temel | Standart | Premium

İlke quota-by-key , anahtar temelinde yenilenebilir veya yaşam süresi çağrı hacmi ve/veya bant genişliği kotası uygular. Anahtarın rastgele bir dize değeri olabilir ve genellikle ilke ifadesi kullanılarak sağlanır. Kotaya doğru hangi isteklerin sayılması gerektiğini belirtmek için isteğe bağlı artış koşulu eklenebilir. Birden çok ilke aynı anahtar değerini artıracaksa, istek başına yalnızca bir kez artırılır. Kota aşıldığında, çağıran bir 403 Forbidden yanıt durum kodu alır ve yanıt değeri saniye cinsinden önerilen yeniden deneme aralığı olan bir Retry-After üst bilgi içerir.

Hız sınırları ile kotalar arasındaki farkı anlamak için bkz. Hız sınırları ve kotalar.

Not

Hizmet platformunda temel işlem kaynakları yeniden başlatıldığında API Management, kotaya ulaşıldıktan sonra kısa bir süre için istekleri işlemeye devam edebilir.

Not

İlkenin öğelerini ve alt öğelerini ilke bildiriminde sağlanan sırayla ayarlayın. Portal, bu ilkeyi yapılandırmanıza yardımcı olmak için kılavuzlu, form tabanlı bir düzenleyici sağlar. API Management ilkelerini ayarlama veya düzenleme hakkında daha fazla bilgi edinin.

İlke bildirimi

<quota-by-key calls="number"
              bandwidth="kilobytes"
              renewal-period="seconds"
              increment-condition="condition"
              increment-count="number"
              counter-key="key value"
              first-period-start="date-time" />

Özellikler

Öznitelik Açıklama Zorunlu Varsayılan
bandwidth içinde renewal-periodbelirtilen zaman aralığında izin verilen toplam kilobayt sayısı üst sınırıdır. İlke ifadelerine izin verilmez. , callsbandwidthveya her ikisi birlikte belirtilmelidir. Yok
Aramalar içinde renewal-periodbelirtilen zaman aralığında izin verilen toplam çağrı sayısı üst sınırı. İlke ifadelerine izin verilmez. , callsbandwidthveya her ikisi birlikte belirtilmelidir. Yok
counter-key için quota policykullanılacak anahtar. Her anahtar değeri için, ilkenin yapılandırıldığı tüm kapsamlar için tek bir sayaç kullanılır. İlke ifadelerine izin verilir. Yes Yok
artım koşulu İsteğin kotaya (true ) göre sayılıp sayılmadığını belirten Boole ifadesi. İlke ifadelerine izin verilir. Hayır YOK
artımlı sayı Sayacın istek başına artırıldığı sayı. İlke ifadelerine izin verilir. Hayır 1
yenileme süresi Kotanın sıfırlandığı sabit pencerenin saniye cinsinden uzunluğu. Her dönemin başlangıcı, öğesine first-period-startgöre hesaplanır. Minimum süre: 300 saniye. renewal-period 0 olarak ayarlandığında, nokta sonsuz olarak ayarlanır. İlke ifadelerine izin verilmez. Yes Yok
ilk dönem-başlangıç Kota yenileme dönemlerinin başlangıç tarihi ve saati şu biçimdedir: yyyy-MM-ddTHH:mm:ssZ ISO 8601 standardı tarafından belirtildiği gibi. İlke ifadelerine izin verilmez. Hayır 0001-01-01T00:00:00Z

Kullanım

Kullanım notları

Toplamı diğer API'ler counter-key arasında paylaşmak istemiyorsanız, öznitelik değeri API Management örneğindeki tüm API'ler arasında benzersiz olmalıdır.

Örnek

<policies>
    <inbound>
        <base />
        <quota-by-key calls="10000" bandwidth="40000" renewal-period="3600"
                      increment-condition="@(context.Response.StatusCode >= 200 && context.Response.StatusCode < 400)"
                      counter-key="@(context.Request.IpAddress)" />
    </inbound>
    <outbound>
        <base />
    </outbound>
</policies>

Bu ilke hakkında daha fazla bilgi ve örnek için bkz . Azure API Management ile gelişmiş istek azaltma.

İlgili içerik

İlkelerle çalışma hakkında daha fazla bilgi için bkz: