Aracılığıyla paylaş

API Yönetimi politika referansı

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 Kendi kendine barındırılan Çalışma alanı
Ç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. Evet Evet Evet Evet Evet
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. Evet Evet Hayı Evet 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. Evet Evet Evet Evet Evet
Anahtara göre kullanım kotasını ayarla Her anahtar bazında yenilenebilir veya yaşam süresi çağrı hacmi ve/veya bant genişliği kotası uygulamanıza olanak tanır. Evet Evet Hayı Evet Evet
Eş zamanlı işlemi sınırla Kapsanan politikaların aynı anda belirtilen sayıdan fazla istek yürütmesini engeller. Evet Evet Evet Evet Evet
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. Evet Evet Hayı Evet Evet
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. Evet Evet Hayı Evet Evet

Kimlik doğrulaması ve yetkilendirme

İlke Açıklama Klasik V2 Tüketim Kendi kendine barındırılan Çalışma alanı
HTTP üst bilgisini denetleme Bir HTTP üst bilgisinin varlığını ve/veya değerini zorlar. Evet Evet Evet Evet Evet
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. Evet Evet Evet Hayı Hayı
Arayan IP'lerini kısıtlama Belirli IP adreslerinden ve/veya adres aralıklarından gelen çağrıları filtreler (izin verir/reddeder). Evet Evet Evet Evet Evet
Microsoft Entra belirtecini doğrulama Belirtilen HTTP üst bilgisi, sorgu parametresi veya belirteç değerinden ayıklanan bir Microsoft Entra (eski adıyla Azure Active Directory) JWT'nin varlığını ve geçerliliğini uygular. Evet Evet Evet Evet Evet
JWT Doğrulama Belirtilen bir HTTP üst bilgisi, sorgu parametresi veya jeton değerinden ayıklanan bir JWT'nin varlığını ve geçerliliğini sağlar. Evet Evet Evet Evet Evet
İ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. Evet Evet Evet Evet Evet
Temel ile Kimlik Doğrula Temel kimlik doğrulamasını kullanarak arka uç hizmetiyle kimlik doğrulaması yapar. Evet Evet Evet Evet Evet
İstemci sertifikasıyla kimlik doğrulaması İstemci sertifikalarını kullanarak arka uç hizmetiyle kimlik doğrulaması yapar. Evet Evet Evet Evet Evet
Yönetilen kimlikle kimlik doğrulaması Yönetilen kimlik kullanarak arka uç hizmetine kimlik doğrulaması yapar. Evet Evet Evet Evet Hayı

İçerik doğrulama

İlke Açıklama Klasik V2 Tüketim Kendi kendine barındırılan Çalışma alanı
LLM isteklerinde içerik güvenliği denetimlerini zorunlu kılma Arka uç LLM'ye göndermeden önce bunları Azure AI content Safety hizmetine ileterek LLM isteklerinde (istemlerde) içerik güvenliği denetimleri uygular. Evet Evet Evet Evet Evet
İç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. Evet Evet Evet Evet Evet
GraphQL isteğini doğrulama GraphQL API'sine yönelik bir isteği doğrular ve yetkilendirir. Evet Evet Evet Evet Hayı
OData isteğini doğrulama OData belirtimine uygun olduğundan emin olmak için OData API'sine yönelik bir isteği doğrular. Evet Evet Evet Evet Evet
Parametreleri doğrulama İstek üst bilgisi, sorgu veya yol parametrelerini API şemasına göre doğrular. Evet Evet Evet Evet Evet
Üst bilgileri doğrulama Yanıt üst bilgilerini API şemasına göre doğrular. Evet Evet Evet Evet Evet
Durum kodunu doğrulama YANıTlardaki HTTP durum kodlarını API şemasına göre doğrular. Evet Evet Evet Evet Evet

Yönlendirme

İlke Açıklama Klasik V2 Tüketim Kendi kendine barındırılan Çalışma alanı
İstek iletme İsteği arka uç hizmetine iletir. Evet Evet Evet Evet Evet
Arka uç hizmetini ayarlama Gelen isteğin arka uç hizmet tabanı URL'sini bir URL'ye veya bir 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 havuzundaki trafiğin yük dengelemesini ve devre kesici kurallarını uygulayın. Evet Evet Evet Evet Evet
HTTP ara sunucusunu ayarlama İletilen istekleri bir HTTP ara sunucusu aracılığıyla yönlendirmenize olanak tanır. Evet Evet Evet Evet Evet

Önbelleğe Alma

İlke Açıklama Klasik V2 Tüketim Kendi kendine barındırılan Çalışma alanı
Ö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. Evet Evet Evet Evet Evet
Önbelleğe almak için depola Yanıtı belirtilen önbellek kontrol yapılandırmasına göre önbelleğe alır. Evet Evet Evet Evet Evet
Önbellekten değer alma Önbelleğe alınmış bir öğeyi anahtara göre alır. Evet Evet Evet Evet Evet
Değeri önbellekte depolama Önbellekteki bir öğeyi anahtara göre depolar. Evet Evet Evet Evet Evet
Önbellekten değer kaldırma Önbellekteki bir öğeyi anahtara göre kaldırır. Evet Evet Evet Evet Evet
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. Evet Evet Evet Evet Hayı
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. Evet Evet Evet Evet Hayı
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. Evet Evet Evet Evet Hayı
Ö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. Evet Evet Evet Evet Hayı

Dönüşüm

İlke Açıklama Klasik V2 Tüketim Kendi kendine barındırılan Çalışma alanı
İstek yöntemini ayarlama İstek için HTTP yöntemini değiştirmenize olanak tanır. Evet Evet Evet Evet Evet
Durum kodunu ayarlama HTTP durum kodunu belirtilen değerle değiştirir. Evet Evet Evet Evet Evet
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. Evet Evet Evet Evet Evet
Gövdeyi ayarla İstek veya yanıt için ileti gövdesini ayarlar. Evet Evet Evet Evet Evet
HTTP üst bilgisini ayarlama Mevcut yanıt ve/veya istek üst bilgisine bir değer atar veya yeni bir yanıt ve/veya istek üst bilgisi ekler. Evet Evet Evet Evet Evet
Sorgu dizesi parametresini ayarlama İstek sorgusu dizesi parametresini ekler, değiştirir veya siler. Evet Evet Evet Evet Evet
URL'yi yeniden yazma İstek URL'sinin genel biçimini web hizmeti tarafından beklenen biçime dönüştürür. Evet Evet Evet Evet Evet
JSON'ı XML'ye dönüştürme İstek veya yanıt gövdesini JSON'dan XML'ye dönüştürür. Evet Evet Evet Evet Evet
XML'yi JSON'a dönüştürme İstek veya yanıt gövdesini XML'den JSON'a dönüştürür. Evet Evet Evet Evet Evet
Gövdedeki dizeyi bulma ve değiştirme İstek veya yanıt alt dizesini bulur ve bunu farklı bir alt dizeyle değiştirir. Evet Evet Evet Evet Evet
İçerikteki URL'leri maskele Yanıt gövdesindeki bağlantılar, ağ geçidi aracılığıyla eşdeğer bağlantıya işaret edecek şekilde yeniden yazılır (maskelenir). Evet Evet Evet Evet Evet
XSLT kullanarak XML dönüştürme İstek veya yanıt gövdesindeki XML'ye bir XSL dönüşümü uygular. Evet Evet Evet Evet Evet
Yanıt döndür İşlem hattı yürütmesini durdurur ve belirtilen yanıtı doğrudan çağırana döndürür. Evet Evet Evet Evet Evet
Sahte yanıt İşlem hattı yürütmesini durdurur ve doğrudan arayana sahte bir yanıt döndürür. Evet Evet Evet Evet Evet

Alanlar arası

İlke Açıklama Klasik V2 Tüketim Kendi kendine barındırılan Çalışma alanı
Etki alanları arası çağrılara izin ver API'yi Adobe Flash ve Microsoft Silverlight tarayıcı tabanlı istemcilerden erişilebilir hale getirir. Evet Evet Evet Evet Evet
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. Evet Evet Evet Evet Evet
JSONP JavaScript tarayıcı tabanlı istemcilerden etki alanları arası çağrılara izin vermek amacıyla bir işlem veya API'ye doldurma destekli JSON (JSONP) ekler. Evet Evet Evet Evet Evet

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

İlke Açıklama Klasik V2 Tüketim Kendi kendine barındırılan Çalışma alanı
İstek gönder Belirtilen URL'ye bir istek gönderir. Evet Evet Evet Evet Evet
Tek yönlü istek gönderme Yanıt beklemeden belirtilen URL'ye bir istek gönderir. Evet Evet Evet Evet Evet
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. Evet Evet Evet Evet Evet
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ı Hayı Hayı Evet Hayı
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ı Hayı Hayı Evet Hayı
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ı Hayı Hayı Evet Hayı

Kayıt Tutma

İlke Açıklama Klasik V2 Tüketim Kendi kendine barındırılan Çalışma alanı
İzleme Test konsolunda, Application Insights telemetrilerinde ve kaynak günlüklerinde istek izleme çıkışına özel izlemeler ekler. Evet Evet1 Evet Evet Evet
Ölçümleri yayma Yürütme sırasında Application Insights'a özel ölçümler gönderir. Evet Evet Evet Evet Evet
Azure OpenAI belirteci ölçümlerini yayınla 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. Evet Evet Hayı Evet 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. Evet Evet Hayı Evet 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 Kendi kendine barındırılan Çalışma alanı
Çö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. Evet Evet Hayı Hayı Hayı
Çözümleyici için Cosmos DB veri kaynağı GraphQL şemasındaki bir nesne türü ve alanı için verileri çözümlemek amacıyla Cosmos DB isteği ve isteğe bağlı yanıtı yapılandırır. Evet Evet Hayı Hayı Hayı
Çö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. Evet Evet Evet Hayı Hayı
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. Evet Evet Evet Hayı Hayı

AI ağ geçidi

İlke Açıklama Klasik V2 Tüketim Kendi kendine barındırılan Çalışma alanı
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. Evet Evet Hayı Evet Evet
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. Evet Evet Hayı Evet Evet
Azure OpenAI belirteci ölçümlerini yayınla 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. Evet Evet Hayı Evet 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. Evet Evet Hayı Evet Evet
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. Evet Evet Evet Evet Hayı
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. Evet Evet Evet Evet Hayı
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. Evet Evet Evet Evet Hayı
Ö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. Evet Evet Evet Evet Hayı
LLM isteklerinde içerik güvenliği denetimlerini zorunlu kılma Arka uç LLM'ye göndermeden önce bunları Azure AI content Safety hizmetine ileterek LLM isteklerinde (istemlerde) içerik güvenliği denetimleri uygular. Evet Evet Evet Evet Evet

İlke denetimi ve akışı

İlke Açıklama Klasik V2 Tüketim Kendi kendine barındırılan Çalışma alanı
Denetim akışı Boole ifadelerinin değerlendirmesinin sonuçlarına göre ilke deyimlerini koşullu olarak uygular. Evet Evet Evet Evet Evet
Parça ekle İlke tanımına bir ilke parçası ekler. Evet Evet Evet Evet Evet
Yeni -den deneme 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. Evet Evet Evet Evet Evet
Beklemek Devam etmeden önce kapalı Gönderme isteği, Önbellekten değer al veya Denetim akışı ilkelerinin tamamlanmasını bekler. Evet Evet Evet Evet Evet

İlgili içerik

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