Aracılığıyla paylaş

Çağrı oranını aboneliğe göre sınırlama

  • Makale

UYGULANANLAR: Tüm API Management katmanları

İlke, rate-limit çağrı oranını belirli bir zaman aralığı için belirtilen bir numarayla sınırlayarak API kullanımındaki ani artışları abonelik başına engeller. Çağrı oranı aşıldığında, arayan bir 429 Too Many Requests yanıt durum kodu alır.

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

Dikkat

Azaltma mimarisinin dağıtılmış yapısı nedeniyle hız sınırlaması hiçbir zaman tam olarak doğru değildir. Yapılandırılan ve izin verilen gerçek istek sayısı arasındaki fark, istek hacmine ve hızına, arka uç gecikme süresine ve diğer faktörlere göre değişiklik gösterir.

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

<rate-limit calls="number" renewal-period="seconds"  retry-after-header-name="custom header name, replaces default 'Retry-After'" 
        retry-after-variable-name="policy expression variable name"
        remaining-calls-header-name="header name"  
        remaining-calls-variable-name="policy expression variable name"
        total-calls-header-name="header name">
    <api name="API name" id="API id" calls="number" renewal-period="seconds" >
        <operation name="operation name" id="operation id" calls="number" renewal-period="seconds" />
    </api>
</rate-limit>

Özellikler

Öznitelik Açıklama Zorunlu Varsayılan
Aramalar içinde renewal-periodbelirtilen zaman aralığında izin verilen toplam çağrı sayısı üst sınırı. İlke ifadelerine izin verilmez. Yes Yok
yenileme süresi İzin verilen istek sayısının içinde callsbelirtilen değeri aşmaması gereken kayan pencerenin saniye cinsinden uzunluğu. İzin verilen maksimum değer: 300 saniye. İlke ifadelerine izin verilmez. Yes Yok
retry-after-header-name Değeri, belirtilen çağrı hızı aşıldıktan sonra saniye cinsinden önerilen yeniden deneme aralığı olan özel yanıt üst bilgisinin adı. İlke ifadelerine izin verilmez. Hayır Retry-After
retry-after-variable-name Belirtilen çağrı hızı aşıldıktan sonra önerilen yeniden deneme aralığını saniyeler içinde depolayan değişkenin adı. İlke ifadelerine izin verilmez. Hayır YOK
remaining-calls-header-name Her ilke yürütmeden sonraki değeri içinde belirtilen zaman aralığı için izin verilen kalan çağrı sayısı olan yanıt üst bilgisinin renewal-periodadıdır. İlke ifadelerine izin verilmez. Hayır YOK
remaining-calls-variable-name Her ilke yürütmeden sonra içinde belirtilen zaman aralığı için izin verilen çağrıların sayısını depolayan bir değişkenin renewal-periodadı. İlke ifadelerine izin verilmez. Hayır YOK
total-calls-header-name değeri içinde callsbelirtilen değer olan bir yanıt üst bilgisinin adı. İlke ifadelerine izin verilmez. Hayır YOK

Öğeler

Öğe Açıklama Gerekli
api Ürün içindeki API'lere çağrı oranı sınırı uygulamak için bu öğelerden birini veya daha fazlasını ekleyin. Ürün ve API çağrı hızı sınırları 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 Bir API içindeki işlemlere çağrı oranı sınırı uygulamak için bu öğelerden birini veya daha fazlasını ekleyin. Ürün, API ve işlem çağrı hızı sınırları 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ı Hız sınırının uygulanacağı API'nin adı. Veya name id belirtilmelidir. Yok
id Hız sınırının uygulanacağı API'nin kimliği. Veya name id 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. Yes Yok
yenileme süresi İzin verilen istek sayısının içinde callsbelirtilen değeri aşmaması gereken kayan pencerenin saniye cinsinden uzunluğu. İzin verilen maksimum değer: 300 saniye. İlke ifadelerine izin verilmez. Yes Yok

işlem öznitelikleri

Öznitelik Açıklama Zorunlu Varsayılan
Adı Hız sınırının uygulanacağı işlemin adı. Veya name id belirtilmelidir. Yok
id Hız sınırının uygulanacağı işlemin kimliği. Veya name id 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. Yes Yok
yenileme süresi İzin verilen istek sayısının içinde callsbelirtilen değeri aşmaması gereken kayan pencerenin saniye cinsinden uzunluğu. İzin verilen maksimum değer: 300 saniye. İ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.
  • Şirket içinde barındırılan bir ağ geçidindeki hız sınırı sayısı, yerel olarak (küme düğümleri arasındaki ağ geçidi örnekleri arasında), örneğin Kubernetes için Helm grafiği dağıtımı veya Azure portalı dağıtım şablonları kullanılarak eşitlenecek şekilde yapılandırılabilir. Ancak hız sınırı sayıları, buluttaki yönetilen ağ geçidi de dahil olmak üzere API Management örneğinde yapılandırılan diğer ağ geçidi kaynaklarıyla eşitlenmez. Daha fazla bilgi edinin

Örnek

Aşağıdaki örnekte abonelik başına hız sınırı 90 saniyede 20 çağrıdır. Her ilke yürütmeden sonra, zaman aralığında izin verilen kalan çağrılar değişkeninde remainingCallsPerSubscriptiondepolanır.

<policies>
    <inbound>
        <base />
        <rate-limit calls="20" renewal-period="90" remaining-calls-variable-name="remainingCallsPerSubscription"/>
    </inbound>
    <outbound>
        <base />
    </outbound>
</policies>

İlgili içerik

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