Aboneliğe göre kullanım kotası ayarlama

  • Makale

UYGULANANLAR: Tüm API Management katmanları

İlke, quota abonelik başına yenilenebilir veya yaşam süresi çağrı hacmi ve/veya bant genişliği kotası uygular. 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. API Management ilkelerini ayarlama veya düzenleme hakkında daha fazla bilgi edinin.

İlke bildirimi

<quota calls="number" bandwidth="kilobytes" renewal-period="seconds">
    <api name="API name" id="API id" calls="number">
        <operation name="operation name" id="operation id" calls="number" />
    </api>
</quota>

Ö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
yenileme süresi Kotanın sıfırlandığı sabit pencerenin saniye cinsinden uzunluğu. Her dönemin başlangıcı, aboneliğin başlangıç zamanına göre hesaplanır. renewal-period olarak ayarlandığında0, nokta sonsuz olarak ayarlanır. İlke ifadelerine izin verilmez. Yes Yok

Öğeler

Öğe Açıklama Gerekli
api Ürün içindeki API'lere çağrı kotası uygulamak için bu öğelerden birini veya daha fazlasını ekleyin. Ürün ve API çağrı kotaları bağımsız olarak uygulanır. API'ye veya idaracılığıyla name başvurulabilir. Her iki öznitelik de sağlanmışsa id kullanılır ve name yoksayılır. Hayır
operation Api içindeki işlemlere çağrı kotası uygulamak için bu öğelerden birini veya daha fazlasını ekleyin. Ürün, API ve işlem çağrısı kotaları bağımsız olarak uygulanır. İşleme veya idaracılığıyla name başvurulabilir. Her iki öznitelik de sağlanmışsa id kullanılır ve name yoksayılır. Hayır

api öznitelikleri

Öznitelik Açıklama Zorunlu Varsayılan
Adı Çağrı kotası sınırının uygulanacağı API'nin adı. Veya name id belirtilmelidir. Yok
id Çağrı kotası sınırının uygulanacağı API'nin kimliği. Veya name id belirtilmelidir. Yok
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
yenileme süresi Kotanın sıfırlandığı sabit pencerenin saniye cinsinden uzunluğu. Her dönemin başlangıcı, aboneliğin başlangıç zamanına göre hesaplanır. renewal-period olarak ayarlandığında0, nokta sonsuz olarak ayarlanır. İlke ifadelerine izin verilmez. Yes Yok

işlem öznitelikleri

Öznitelik Açıklama Zorunlu Varsayılan
Adı Çağrı kotası sınırının uygulanacağı işlemin adı. Veya name id belirtilmelidir. Yok
id Çağrı kotası sınırının uygulanacağı işlemin kimliği. Veya name id belirtilmelidir. Yok
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
yenileme süresi Kotanın sıfırlandığı sabit pencerenin saniye cinsinden uzunluğu. Her dönemin başlangıcı, aboneliğin başlangıç zamanına göre hesaplanır. renewal-period olarak ayarlandığında0, nokta sonsuz olarak ayarlanır. İlke ifadelerine izin verilmez. Yes Yok

Kullanım

Kullanım notları

  • Bu ilke, ilke tanımı başına yalnızca bir kez kullanılabilir.
  • Bu ilke yalnızca bir API'ye abonelik anahtarı kullanılarak erişildiğinde uygulanır.

Örnek

<policies>
    <inbound>
        <base />
        <quota calls="10000" bandwidth="40000" renewal-period="3600" />
    </inbound>
    <outbound>
        <base />
    </outbound>
</policies>

İlgili içerik

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