API Management ilke başvurusu

Makale
04/04/2024

UYGULANANLAR: Tüm API Management katmanları

Bu bölümde, tüm API Management ilkeleri için başvuru makalelerinin kısa açıklamaları ve bağlantıları sağlanır. Her ilkeyi destekleyen API Management ağ geçitleri belirtilir. Ayrıntılı ilke ayarları ve örnekleri için bağlantılı başvuru makalelerine bakın.

İlkeler hakkında daha fazla bilgi:

Ö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.

Hız sınırlama ve kotalar

İlke	Açıklama	Klasik	V2	Tüketim	Şirket içinde barındırılan
Çağrı oranını aboneliğe göre sınırlama	Çağrı oranını abonelik bazında sınırlayarak API kullanımındaki ani artışları önler.	Yes	Evet	Evet	Yes
Arama hızını anahtara göre sınırlama	Çağrı hızını anahtar temelinde sınırlayarak API kullanımındaki ani artışları önler.	Yes	Evet	Hayı	Evet
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ızı sağlar.	Yes	Evet	Evet	Yes
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ıza olanak tanır.	Yes	Hayır	Hayır	Evet
Eşzamanlılığı sınırla	Kapalı ilkelerin bir kerede belirtilen sayıdan daha fazla istek yürütmesini engeller.	Yes	Evet	Evet	Yes

Kimlik doğrulaması ve yetkilendirme

İlke	Açıklama	Klasik	V2	Tüketim	Şirket içinde barındırılan
HTTP üst bilgisini denetleme	BIR HTTP üst bilgisinin varlığını ve/veya değerini zorlar.	Yes	Evet	Evet	Yes
Yetkilendirme bağlamı alma	API Management örneğinde yapılandırılmış bir kimlik bilgisi sağlayıcısına belirtilen bağlantının yetkilendirme bağlamını alır.	Yes	Evet	Evet	Hayır
Arayan IP'lerini kısıtlama	Belirli IP adreslerinden ve/veya adres aralıklarından gelen çağrıları filtreler (izin verir/reddeder).	Yes	Evet	Evet	Yes
Microsoft Entra belirtecini doğrulama	Belirtilen HTTP üst bilgisinden, sorgu parametresinden veya belirteç değerinden ayıklanan bir Microsoft Entra (eski adıYla Azure Active Directory) JWT'nin varlığını ve geçerliliğini zorlar.	Yes	Evet	Evet	Yes
JWT Doğrulama	Belirtilen bir HTTP üst bilgisinden, sorgu parametresinden veya belirteç değerinden ayıklanan bir JWT'nin varlığını ve geçerliliğini zorlar.	Yes	Evet	Evet	Yes
İ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.	Yes	Evet	Evet	Yes
Temel ile kimlik doğrulaması	Temel kimlik doğrulamasını kullanarak arka uç hizmetiyle kimlik doğrulaması yapar.	Yes	Evet	Evet	Yes
İstemci sertifikasıyla kimlik doğrulaması	İstemci sertifikalarını kullanarak arka uç hizmetiyle kimlik doğrulaması yapar.	Yes	Evet	Evet	Yes
Yönetilen kimlikle kimlik doğrulaması	Yönetilen kimlik kullanarak arka uç hizmetiyle kimlik doğrulaması yapar.	Yes	Evet	Evet	Yes

İçerik doğrulama

İlke	Açıklama	Klasik	V2	Tüketim	Şirket içinde barındırılan
İçeriği doğrulama	Bir istek 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.	Yes	Evet	Evet	Yes
GraphQL isteğini doğrulama	GraphQL API'sine yönelik bir isteği doğrular ve yetkilendirir.	Yes	Evet	Evet	Yes
OData isteğini doğrulama	OData belirtimine uygun olduğundan emin olmak için OData API'sine yönelik bir isteği doğrular.	Yes	Evet	Evet	Yes
Parametreleri doğrulama	İstek üst bilgisi, sorgu veya yol parametrelerini API şemasına göre doğrular.	Yes	Evet	Evet	Yes
Üst bilgileri doğrulama	Yanıt üst bilgilerini API şemasına göre doğrular.	Yes	Evet	Evet	Yes
Durum kodunu doğrulama	YANıTlardaki HTTP durum kodlarını API şemasına göre doğrular.	Yes	Evet	Evet	Yes

Yönlendirme

İlke	Açıklama	Klasik	V2	Tüketim	Şirket içinde barındırılan
İstek iletme	İsteği arka uç hizmetine iletir.	Yes	Evet	Evet	Yes
Arka uç hizmetini ayarla	Gelen isteğin arka uç hizmet tabanı URL'sini BIR URL'ye veya arka uça değiştirir. Arka uç kaynağına başvurmak, arka uç hizmet tabanı URL'sini ve diğer ayarları tek bir yerde yönetmenizi sağlar. Ayrıca arka ucu çok fazla istekten korumak için arka uç hizmetleri havuzu ve devre kesici kuralları genelinde trafiğin yük dengelemesini uygulayın.	Yes	Evet	Evet	Yes
HTTP ara sunucusunu ayarlama	İletilen istekleri bir HTTP ara sunucusu aracılığıyla yönlendirmenize olanak tanır.	Yes	Evet	Evet	Yes

Önbelleğe Alma

İlke	Açıklama	Klasik	V2	Tüketim	Şirket içinde barındırılan
Önbellekten alma	Önbellek araması gerçekleştirir ve kullanılabilir olduğunda geçerli bir önbelleğe alınmış yanıt döndürür.	Yes	Evet	Evet	Yes
Önbelleğe almak için depola	Yanıtı belirtilen önbellek denetimi yapılandırmasına göre önbelleğe alır.	Yes	Evet	Evet	Yes
Önbellekten değer alma	Önbelleğe alınmış bir öğeyi anahtara göre alır.	Yes	Evet	Evet	Yes
Değeri önbellekte depolama	Önbellekteki bir öğeyi anahtara göre depolar.	Yes	Evet	Evet	Yes
Önbellekten değer kaldırma	Önbellekteki bir öğeyi anahtara göre kaldırır.	Yes	Evet	Evet	Yes

Dönüşüm

İlke	Açıklama	Klasik	V2	Tüketim	Şirket içinde barındırılan
İstek yöntemini ayarlama	İstek için HTTP yöntemini değiştirmenize olanak tanır.	Yes	Evet	Evet	Yes
Durum kodunu ayarlama	HTTP durum kodunu belirtilen değerle değiştirir.	Yes	Evet	Evet	Yes
Değişken ayarlama	Adlandırılmış bağlam değişkenindeki bir değeri daha sonra erişim için kalıcı hale geçirir.	Yes	Evet	Evet	Yes
Gövdeyi ayarla	İstek veya yanıt için ileti gövdesini ayarlar.	Yes	Evet	Evet	Yes
HTTP üst bilgisini ayarla	Mevcut yanıt ve/veya istek üst bilgisine bir değer atar veya yeni bir yanıt ve/veya istek üst bilgisi ekler.	Yes	Evet	Evet	Yes
Sorgu dizesi parametresini ayarla	İstek sorgusu dizesi parametresini ekler, değiştirir veya siler.	Yes	Evet	Evet	Yes
URL'yi yeniden yaz	İstek URL'sinin genel biçimini web hizmeti tarafından beklenen biçime dönüştürür.	Yes	Evet	Evet	Yes
JSON'u XML'ye dönüştür	İstek veya yanıt gövdesini JSON'dan XML'ye dönüştürür.	Yes	Evet	Evet	Yes
XML'yi JSON'a dönüştür	İstek veya yanıt gövdesini XML'den JSON'a dönüştürür.	Yes	Evet	Evet	Yes
Gövdede dizeyi bul ve değiştir	İstek veya yanıt alt dizesini bulur ve bunu farklı bir alt dizeyle değiştirir.	Yes	Evet	Evet	Yes
İçerikteki URL'leri maskele	Yanıt gövdesindeki bağlantıları yeniden yazar (maskeler), böylece ağ geçidi aracılığıyla eşdeğer bağlantıya işaret eder.	Yes	Evet	Evet	Yes
XSLT kullanarak XML'yi dönüştür	İstek veya yanıt gövdesindeki XML'ye bir XSL dönüşümü uygular.	Yes	Evet	Evet	Yes
Yanıt döndür	İşlem hattı yürütmesini durdurur ve belirtilen yanıtı doğrudan çağırana döndürür.	Yes	Evet	Evet	Yes
Sahte yanıt	İşlem hattı yürütmesini durdurur ve doğrudan çağırana sahte bir yanıt döndürür.	Yes	Evet	Evet	Yes

Etki alanları arası

İlke	Açıklama	Klasik	V2	Tüketim	Şirket içinde barındırılan
Etki alanları arası çağrılara izin ver	API'yi Adobe Flash ve Microsoft Silverlight tarayıcı tabanlı istemcilerden erişilebilir hale getirir.	Yes	Evet	Evet	Yes
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.	Yes	Evet	Evet	Yes
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.	Yes	Evet	Evet	Yes

Tümleştirme ve dış iletişim

İlke	Açıklama	Klasik	V2	Tüketim	Şirket içinde barındırılan
İstek gönder	Belirtilen URL'ye bir istek gönderir.	Yes	Evet	Evet	Yes
Tek yönlü istek gönderme	Yanıt beklemeden belirtilen URL'ye bir istek gönderir.	Yes	Evet	Evet	Yes
Olay hub'ına günlüğe kaydetme	Belirtilen biçimdeki iletileri günlükçü varlığı tarafından tanımlanan bir olay hub'ına gönderir.	Yes	Evet	Evet	Yes
Hizmete istek gönderme (Dapr)	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.	Hayır	Hayır	Hayır	Evet
Pub/Sub konusuna ileti gönderme (Dapr)	Yayımla/Abone Ol konusuna 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.	Hayır	Hayır	Hayır	Evet
Tetikleyici çıkış bağlaması (Dapr)	Çı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.	Hayır	Hayır	Hayır	Evet

Günlük Kaydı

İlke	Açıklama	Klasik	V2	Tüketim	Şirket içinde barındırılan
İzleme	Test konsolunda, Uygulama Analizler telemetrilerinde ve kaynak günlüklerinde istek izleme çıkışına özel izlemeler ekler.	Yes	Evet¹	Yes	Yes
Ölçümleri yayma	Uygulama Analizler yürütme sırasında özel ölçümler gönderir.	Yes	Evet	Evet	Yes

¹ V2 ağ geçidinde trace , ilke şu anda test konsoluna izleme çıkışı eklemez.

GraphQL çözümleyicileri

İlke	Açıklama	Klasik	V2	Tüketim	Şirket içinde barındırılan
Çö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.	Yes	Evet	Hayır	Hayı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.	Yes	Evet	Hayır	Hayı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.	Yes	Evet	Evet	Hayı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.	Yes	Evet	Evet	Hayır

İlke denetimi ve akışı

İlke	Açıklama	Klasik	V2	Tüketim	Şirket içinde barındırılan
Denetim akışı	Boole ifadelerinin değerlendirmesinin sonuçlarına göre ilke deyimlerini koşullu olarak uygular.	Yes	Evet	Evet	Yes
Parça ekle	İlke tanımına bir ilke parçası ekler.	Yes	Evet	Evet	Yes
Yeniden dene	Koşulun karşılanması durumunda ve karşılanana kadar, kapalı ilke deyimlerinin yürütülmesini yeniden denenir. Yürütme, belirtilen zaman aralıklarında ve belirtilen yeniden deneme sayısına kadar yinelenir.	Yes	Evet	Evet	Yes
Wait	Devam etmeden önce kapalı Gönderme isteği, Önbellekten değer al veya Denetim akışı ilkelerinin tamamlanmasını bekler.	Yes	Evet	Evet	Yes

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