Azure API Management'ta dış Redis uyumlu önbellek kullanma

UYGULANANLAR: Tüm API Management katmanları

Azure API Management, yerleşik önbelleğin yanı sıra Yanıtların Azure Yönetilen Redis gibi dış Redis uyumlu bir önbellekte önbelleğe alınmasını sağlar.

Dış önbellek kullanmak, yerleşik önbellekle ilgili birkaç sınırlamanın üstesinden gelmenizi sağlar:

• API Management güncelleştirmeleri sırasında önbelleğinizin düzenli aralıklarla temizlenmesini önlemek
• Önbellek yapılandırmanız üzerinde daha fazla denetim sahibi olmanız
• API Management katmanınızın izin verdiğinden daha fazla veri önbelleğe alma
• API Management'ın Tüketim katmanında önbellek kullanımı
• API Management kendi kendine barındırılan ağ geçidinde önbelleğe almayı etkinleştirme

Arka plan ve önbelleğe alma senaryoları için bkz Önbelleğe Almanın Genel Görünümü.

Önbelleğe alma hakkında daha ayrıntılı bilgi için bkz. API Management önbelleğe alma ilkeleri ve Azure API Management'te özel önbelleğe alma.

Not

Şu anda bu özellik çalışma alanlarında kullanılamaz.

Öğrenecekleriniz:

• API Management'ta dış önbellek ekleme

Önkoşullar

Bu öğreticiyi tamamlamak için aşağıdakileri yapmanız gerekir:

• Azure API Management örneği oluşturma

• Azure API Management'ta önbelleğe almayı anlama

• Bir Azure Yönetilen Redis veya başka bir Redis uyumlu önbelleğin mevcut olması.

  Önemli

  Azure API Management, önbelleğe bağlanmak için redis bağlantı dizesi kullanır. Azure Yönetilen Redis kullanıyorsanız, bağlantı dizesi kullanmak için önbelleğinizde erişim anahtarı kimlik doğrulamasını etkinleştirin. Şu anda Azure API Management'ı Azure Yönetilen Redis'e bağlamak için Microsoft Entra kimlik doğrulamasını kullanamazsınız.

Kubernetes için Redis önbelleği

API Management kendinden barındırmalı bir ağ geçidi için önbelleğe alma, harici bir önbellek gerektirir. Önbelleğe alma işleminin etkili olabilmesi için, arama ve depolama gecikmelerini en aza indirmek amacıyla, kendi kendine barındırılan bir ağ geçidi ile ona bağlı önbelleğin birbirine yakın bir konumda bulunması gerekmektedir. Redis önbelleğini aynı Kubernetes kümesine veya yakındaki ayrı bir kümeye dağıtmak en iyi seçeneklerdir. Redis önbelleğini kubernetes kümesine dağıtmayı öğrenin.

Dış önbellek ekleme

Azure API Management'ta dış Redis uyumlu önbellek eklemek için aşağıdaki adımları izleyin. Önbelleği API Management örneğinizdeki belirli bir ağ geçidiyle sınırlayabilirsiniz.

Şu ayardan kullan:

Yapılandırmadaki Kullanım yeri ayarı, önbelleği kullanacak API Management örneğinizin konumunu belirtir. Aşağıdakilerden birini seçin:

• API Management örneğinin barındırıldığı Azure bölgesi (veya çok bölgeli bir dağıtımınız varsa yapılandırılmış konumlardan biri)

• Kendi kendine barındırılan ağ geçidi konumu

• Varsayılan, önbelleği API Management örneğindeki tüm ağ geçidi konumları için varsayılan olarak yapılandırmak için

  Varsayılan için kullanılan önbellek, belirli bir eşleşen bölge veya konum için kullanılan bir önbellek tarafından geçersiz kılınır.

  Örneğin, Doğu ABD, Güneydoğu Asya ve Batı Avrupa bölgelerinde barındırılan bir API Management örneği düşünün. Biri Varsayılan, diğeri Güneydoğu Asya için olmak üzere iki önbellek yapılandırılmıştır. Bu örnekte, Güneydoğu Asya'daki API Management kendi önbelleğini, diğer iki bölge ise Varsayılan önbellek girdisini kullanır.

Not

Aynı dış önbelleği birden fazla API Management örneği için yapılandırabilirsiniz. API Management örnekleri aynı veya farklı bölgelerde olabilir. Birden fazla örnek için önbelleği paylaşırken, Kullanım alanı ayarında Varsayılan'ı seçmeniz gerekir.

Aynı abonelikten Azure Yönetilen Redis örneği ekleme

1. Azure portalında API Management örneğinize göz atın.
2. Soldaki menüde, Dağıtım ve altyapı altında Dış önbellek'i seçin.
3. + Ekle'yi seçin.
4. Önbellek örneği açılan listesinde önbelleğinizi seçin.
5. Kullanılacak yer açılır listesinden Varsayılan'ı seçin veya istediğiniz bölgeyi belirtin. Bağlantı dizesi otomatik olarak doldurulur.
6. Kaydet'i seçin.

Not

Varsayılan bağlantı dizesi biçimindedir <cache-name>:10000,password=<cache-access-key>,ssl=True,abortConnect=False. API Management, dizeyi bir sır olarak adlandırılmış bir değer olarak depolar. Erişim anahtarını döndürmek veya bağlantı sorunlarını gidermek için dizeyi görüntülemeniz veya düzenlemeniz gerekiyorsa Adlandırılmış değerler dikey penceresine gidin.

Geçerli Azure aboneliğinin veya genel olarak Azure'ın dışında barındırılan Redis uyumlu bir önbellek ekleme

1. Azure portalında API Management örneğinize göz atın.
2. Soldaki menüde, Dağıtım ve altyapı altında Dış önbellek'i seçin.
3. + Ekle'yi seçin.
4. Önbellek örneği açılan listesinde Özel'i seçin.
5. Kullanım kaynağı açılan listesinde Varsayılan'ı seçin veya istediğiniz bölgeyi belirtin.
6. Azure Yönetilen Redis veya Redis uyumlu önbellek bağlantı dizesini Bağlantı dizesi alanına girin.
7. Kaydet'i seçin.

Kendi kendine barındırılan ağ geçidine Redis önbelleği ekle

1. Soldaki menüde, Dağıtım ve altyapı altında Dış önbellek'i seçin.
2. + Ekle'yi seçin.
3. Önbellek örneği açılan listesinde Özel'i seçin.
4. Bu kaydı kullanaçılır listesinden Varsayılan seçeneğini seçin veya istediğiniz bölgeyi belirtin.
5. Redis önbellek bağlantı dizesini Bağlantı dizesi alanına girin.
6. Kaydet'i seçin.

Dış önbelleği kullanma

Redis uyumlu bir önbellek ekledikten sonra, dış önbellekte yanıt önbelleğe almayı veya anahtara göre değerleri önbelleğe almayı etkinleştirmek için önbelleğe alma ilkelerini yapılandırın.

Ayrıntılı bir örnek için, bkz. Azure API Management'ta performansı geliştirmek için önbelleğe alma ekleme.

İlgili içerik

• Önbelleğe alma ilkeleri hakkında daha fazla bilgi için Önbelleğe alma ilkeleriAPI Yönetimi ilke başvurusuna bakın.
• İlke ifadelerini kullanarak öğeleri anahtara göre önbelleğe almak için Azure API Management'ta özel önbelleğe alma bölümüne bakın.
• LLM API'leri için anlamsal önbelleğe almayı etkinleştirmeyi öğrenin.