Not
Bu sayfaya erişim yetkilendirme gerektiriyor. Oturum açmayı veya dizinleri değiştirmeyi deneyebilirsiniz.
Bu sayfaya erişim yetkilendirme gerektiriyor. Dizinleri değiştirmeyi deneyebilirsiniz.
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 |
|---|---|---|---|
| bant genişliği | 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. |
Evet | Yok |
Öğeler
| Öğe | Açıklama | Zorunlu |
|---|---|---|
| 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 namearacılığıyla id başvurulabilir. Her iki öznitelik de sağlanmışsa id kullanılır ve name yoksayılır. |
Hayır |
| Operasyon | 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 namearacılığıyla id 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 nameid belirtilmelidir. |
Yok |
| kimlik | Çağrı kotası sınırının uygulanacağı API'nin kimliği. | Veya nameid belirtilmelidir. |
Yok |
| bant genişliği | 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. |
Evet | Yok |
işlem öznitelikleri
| Öznitelik | Açıklama | Zorunlu | Varsayılan |
|---|---|---|---|
| Adı | Çağrı kotası sınırının uygulanacağı işlemin adı. | Veya nameid belirtilmelidir. |
Yok |
| kimlik | Çağrı kotası sınırının uygulanacağı işlemin kimliği. | Veya nameid belirtilmelidir. |
Yok |
| bant genişliği | 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. |
Evet | Yok |
Kullanım
- İlke bölümleri: gelen
- İlke kapsamları: ürün
- Ağ geçitleri: klasik, v2, tüketim, şirket içinde barındırılan, çalışma alanı
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 ilkeler
İlgili içerik
İlkelerle çalışma hakkında daha fazla bilgi için bkz:
- Öğretici: API'nizi dönüştürme ve koruma
- İlke deyimlerinin ve ayarlarının tam listesi için ilke başvurusu
- İlke ifadeleri
- İlkeleri ayarlama veya düzenleme
- İlke yapılandırmalarını yeniden kullanma
- İlke kod parçacıkları deposu
- İlke oyun alanı deposu
- Azure API Management ilke araç seti
- Politikalar oluşturmak, açıklamak ve sorun gidermek için Copilot yardımı alın