API Management ilke başvurusu
Bu bölüm, tüm API Management ilkeleri için başvuru makalelerinin bağlantılarını sağlar.
İlkeler hakkında daha fazla bilgi:
- İlkeye genel bakış
- İlkeleri ayarlama veya düzenleme
- İlke ifadeleri
- Azure için Microsoft Copilot kullanarak ilke yazma
Önemli
Çağrı oranını aboneliğe göre sınırlayın ve Kullanım kotasını aboneliğe göre ayarla seçeneğinin abonelik anahtarına bağımlılığı vardır. Diğer ilkeler uygulandığında abonelik anahtarı gerekmez.
Erişimi kısıtlama ilkeleri
- HTTP üst bilgisini denetleme - HTTP Üst Bilgisinin varlığını ve/veya değerini zorlar.
- Yetkilendirme bağlamını alma - API Management örneğinde yapılandırılmış bir kimlik bilgisi sağlayıcısıyla belirtilen bağlantının yetkilendirme bağlamını alır.
- Çağrı oranını aboneliğe göre sınırla - Çağrı oranını abonelik temelinde sınırlayarak API kullanımındaki ani artışları önler.
- Arama hızını anahtara göre sınırla - Çağrı hızını anahtar temelinde sınırlayarak API kullanımındaki ani artışları önler.
- Arayan IP'lerini kısıtla - Belirli IP adreslerinden ve/veya adres aralıklarından gelen çağrıları filtreler (izin verir/reddeder).
- Aboneliğe göre kullanım kotası ayarlama - Abonelik temelinde yenilenebilir veya yaşam süresi çağrı hacmini ve/veya bant genişliği kotasını zorunlu kılmanıza olanak tanır.
- Anahtara göre kullanım kotası ayarlama - Anahtar temelinde yenilenebilir veya yaşam süresi çağrı hacmini ve/veya bant genişliği kotasını zorunlu kılmanızı sağlar.
- Microsoft Entra belirtecini doğrulama - Belirtilen http üst bilgisinden, sorgu parametresinden veya belirteç değerinden ayıklanan bir Microsoft Entra JWT'nin varlığını ve geçerliliğini zorlar.
- JWT'yi doğrulama - Belirtilen http üst bilgisinden, sorgu parametresinden veya belirteç değerinden ayıklanan bir JWT'nin varlığını ve geçerliliğini zorlar.
- İstemci sertifikasını doğrulama - İstemci tarafından bir API Management örneğine sunulan bir sertifikanın belirtilen doğrulama kuralları ve talepleriyle eşleşmesini zorlar.
Gelişmiş ilkeler
- Denetim akışı - Boole ifadelerinin değerlendirmesinin sonuçlarına göre ilke deyimlerini koşullu olarak uygular.
- Ölçümleri yay - Uygulama Analizler yürütme sırasında özel ölçümler gönderir.
- İstek iletme - İsteği arka uç hizmetine iletir.
- Parça ekle - İlke tanımına bir ilke parçası ekler.
- Eşzamanlılığı sınırla - Kapsayan ilkelerin bir kerede belirtilen istek sayısından fazla yürütülmesini engeller.
- Olay hub'ına günlük kaydı - Günlükçü varlığı tarafından tanımlanan bir olay hub'ına belirtilen biçimde iletiler gönderir.
- Sahte yanıt - İşlem hattı yürütmesini durdurur ve doğrudan arayana sahte bir yanıt döndürür.
- Yeniden Deneme - Koşul karşılanana kadar ve koşul karşılanana kadar, kapalı ilke deyimlerinin yürütülmesini yeniden dener. Yürütme, belirtilen zaman aralıklarında ve belirtilen yeniden deneme sayısına kadar yinelenir.
- Dönüş yanıtı - İşlem hattı yürütmesini durdurur ve belirtilen yanıtı doğrudan çağırana döndürür.
- Tek yönlü istek gönder - Yanıt beklemeden belirtilen URL'ye istek gönderir.
- İstek gönder - Belirtilen URL'ye bir istek gönderir.
- HTTP proxy'sini ayarla - İletilen istekleri bir HTTP ara sunucusu aracılığıyla yönlendirmenize olanak tanır.
- İstek yöntemini ayarlama - İstek için HTTP yöntemini değiştirmenize izin verir.
- Durum kodunu ayarla - HTTP durum kodunu belirtilen değerle değiştirir.
- Set variable - Daha sonra erişmek için adlandırılmış bağlam değişkenindeki bir değeri kalıcı hale ekler.
- İzleme - Test konsolunda, Uygulama Analizler telemetrilerinde ve kaynak günlüklerinde istek izleme çıkışına özel izlemeler ekler.
- Bekle - Devam etmeden önce kapalı Gönderme isteği, Önbellekten değer alma veya Denetim akışı ilkelerinin tamamlanmasını bekler.
Kimlik doğrulama ilkeleri
- Temel kimlik doğrulaması ile kimlik doğrulaması - Temel kimlik doğrulamasını kullanarak arka uç hizmetiyle kimlik doğrulaması.
- İstemci sertifikasıyla kimlik doğrulaması - İstemci sertifikalarını kullanarak arka uç hizmetiyle kimlik doğrulaması yapın.
- Yönetilen kimlikle kimlik doğrulaması - Yönetilen kimlik kullanarak arka uç hizmetiyle kimlik doğrulaması.
Önbelleğe alma ilkeleri
- Önbellekten al - Önbellek araması gerçekleştirin ve kullanılabilir olduğunda geçerli bir önbelleğe alınmış yanıt döndürebilirsiniz.
- Önbelleğe depola - Yanıtı belirtilen önbellek denetimi yapılandırmasına göre önbelleğe alır.
- Önbellekten değer alma - Önbelleğe alınmış bir öğeyi anahtara göre alma.
- Değeri önbellekte depolama - Önbellekteki bir öğeyi anahtara göre depolayın.
- Önbellekten değer kaldırma - Önbellekteki bir öğeyi anahtara göre kaldırın.
Etki alanları arası ilkeler
- Etki alanları arası çağrılara izin ver - API'yi Adobe Flash ve Microsoft Silverlight tarayıcı tabanlı istemcilerden erişilebilir hale getirir.
- CORS - Tarayıcı tabanlı istemcilerden etki alanları arası çağrılara izin vermek için bir işleme veya API'ye çıkış noktaları arası kaynak paylaşımı (CORS) desteği ekler.
- JSONP - JavaScript tarayıcı tabanlı istemcilerden etki alanları arası çağrılara izin vermek için bir işleme veya API'ye doldurma (JSONP) desteğine sahip JSON ekler.
Dapr tümleştirme ilkeleri
- Bir hizmete istek gönderme: Dapr mikro hizmetini bulmak ve güvenilir bir şekilde iletişim kurmak için Dapr çalışma zamanını kullanır. Dapr'da hizmet çağırma hakkında daha fazla bilgi edinmek için bu BENİOKU dosyasındaki açıklamaya bakın.
- Pub/Sub konusuna ileti gönderme: Yayımla/Abone Ol konusunda ileti yayımlamak için Dapr çalışma zamanını kullanır. Dapr'da mesajlaşmayı yayımlama/abone olma hakkında daha fazla bilgi edinmek için bu BENİOKU dosyasındaki açıklamaya bakın.
- Çıkış bağlamasını tetikleme: Çıkış bağlaması aracılığıyla bir dış sistemi çağırmak için Dapr çalışma zamanını kullanır. Dapr'daki bağlamalar hakkında daha fazla bilgi edinmek için bu BENİOKU dosyasındaki açıklamaya bakın.
GraphQL çözümleyici ilkeleri
- Çözümleyici için Azure SQL veri kaynağı - GraphQL şemasındaki bir nesne türü ve alanı için verileri çözümlemek için Azure SQL isteğini ve isteğe bağlı yanıtı yapılandırılır.
- Çözümleyici için Cosmos DB veri kaynağı - GraphQL şemasındaki bir nesne türü ve alanı için verileri çözümlemek için Cosmos DB isteğini ve isteğe bağlı yanıtı yapılandırılır.
- Çözümleyici için HTTP veri kaynağı - GraphQL şemasındaki bir nesne türü ve alanı için verileri çözümlemek için HTTP isteğini ve isteğe bağlı olarak HTTP yanıtını yapılandırılır.
- Olayı GraphQL aboneliğine yayımlama - GraphQL API şemasında belirtilen bir veya daha fazla aboneliğe olay yayımlar. Şemadaki ilgili bir alan için GraphQL çözümleyicisindeki ilkeyi mutasyon gibi başka bir işlem türü için yapılandırın.
Dönüştürme ilkeleri
- JSON'ı XML'ye dönüştürme - İstek veya yanıt gövdesini JSON'dan XML'ye dönüştürür.
- XML'yi JSON'a dönüştürme - İstek veya yanıt gövdesini XML'den JSON'a dönüştürür.
- Gövdedeki dizeyi bulma ve değiştirme - bir istek veya yanıt alt dizesi bulur ve bunu farklı bir alt dizeyle değiştirir.
- İçerikteki URL'leri maskele - Yanıt gövdesindeki bağlantıları ağ geçidi üzerinden eşdeğer bağlantıya işaret etmek için yeniden yazar (maskeler).
- Arka uç hizmetini ayarlama - Gelen istek için arka uç hizmetini değiştirir.
- Gövdeyi ayarla - İstek veya yanıt için ileti gövdesini ayarlar.
- HTTP üst bilgisini ayarlama - Var olan bir yanıta ve/veya istek üst bilgisine bir değer atar ya da yeni bir yanıt ve/veya istek üst bilgisi ekler.
- Sorgu dizesi parametresini ayarla - İstek sorgu dizesi parametresini ekler, değerini değiştirir veya siler.
- URL'yi yeniden yazma - İstek URL'sini genel biçiminden web hizmeti tarafından beklenen forma dönüştürür.
- XSLT kullanarak XML Dönüştürme - İstek veya yanıt gövdesinde XML'ye XSL dönüşümü uygular.
Doğrulama ilkeleri
- İçeriği doğrulama - bir isteğin veya yanıt gövdesinin boyutunu veya içeriğini bir veya daha fazla API şemasına göre doğrular. Desteklenen şema biçimleri JSON ve XML'dir.
- GraphQL isteğini doğrulama - GraphQL API'sine yönelik bir isteği doğrular ve yetkilendirir.
- OData isteğini doğrulama - OData belirtimine uygun olduğundan emin olmak için OData API'sine yönelik bir isteği doğrular.
- Parametreleri doğrulama - İstek üst bilgisini, sorguyu veya yol parametrelerini API şemasına göre doğrular.
- Üst bilgileri doğrulama - Yanıt üst bilgilerini API şemasına göre doğrular.
- Durum kodunu doğrulama - YANıTlardaki HTTP durum kodlarını API şemasına göre doğrular.
İlgili içerik
İlkelerle çalışma hakkında daha fazla bilgi için bkz: