API Management ilke başvurusu

  • Makale

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
Azure OpenAI Hizmeti belirteci kullanımını sınırlama Hesaplanmış anahtar başına büyük dil modeli belirteçlerini sınırlayarak Azure OpenAI API'sinde ani artışları önler. Yes Evet Hayır Hayır
Büyük dil modeli API belirteci kullanımını sınırlama Hesaplanmış anahtar başına LLM belirteçlerini sınırlayarak büyük dil modeli (LLM) API kullanımı artışlarını önler. Yes Evet Hayır Hayır

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
Azure OpenAI API isteklerinin önbelleğe alınmış yanıtlarını alma Semantik arama kullanarak Azure OpenAI API önbelleğinde arama 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
Azure OpenAI API isteklerinin önbelleğe alma yanıtlarını depolama Yanıtı Azure OpenAI API önbellek yapılandırmasına göre önbelleğe alır. Yes Evet Evet Yes
Büyük dil modeli API isteklerinin önbelleğe alınmış yanıtlarını alma Anlamsal arama kullanarak büyük dil modeli API önbelleğinde arama 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 büyük dil modeli API isteklerinin yanıtlarını depolama Yanıtı büyük dil modeli API önbellek yapılandırmasına göre önbelleğe alı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 , Application Insights telemetrilerinde ve kaynak günlüklerinde istek izleme çıkışına özel izlemeler ekler. Yes Evet1 Yes Yes
Ölçümleri yayma Yürütme sırasında Application Insights'a özel ölçümler gönderir. Yes Evet Evet Yes
Azure OpenAI belirteci ölçümlerini yayma Azure OpenAI hizmeti API'leri aracılığıyla büyük dil modeli belirteçlerinin tüketimi için application insights'a ölçümler gönderir. Yes Evet Hayı Evet
Büyük dil modeli API belirteci ölçümlerini yayma LLM API'leri aracılığıyla büyük dil modeli (LLM) belirteçlerinin tüketimi için ölçümleri Application Insights'a gönderir. Yes Evet Hayı Evet

1 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

İlgili içerik

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