Visual Studio Code'da Azure API Management ilkelerinin hatalarını ayıklama

ŞUNLAR IÇIN GEÇERLIDIR: Geliştirici

Azure API Management'taki ilkeler , API yayımcılarının kimlik doğrulaması, yetkilendirme, azaltma, önbelleğe alma ve dönüştürme gibi çapraz kesme sorunlarını gidermelerine yardımcı olan güçlü özellikler sağlar. İlkeler, bir API isteği veya yanıtı üzerinde sırayla yürütülen deyimlerin bir koleksiyonudur.

Bu makalede Visual Studio Code için Azure API Management Uzantısı kullanılarak API Management ilkelerinde hata ayıklama işlemi açıklanır.

Önkoşullar

• İlk olarak bu hızlı başlangıcı izleyerek BIR API Management Geliştirici katmanı örneği oluşturun.

• Visual Studio Code'u ve Visual Studio Code için Azure API Management Uzantısı'nın en son sürümünü yükleyin.

• API Management örneğine bir API içeri aktarma. Örnek adımlar için bkz . Öğretici: API'leri içeri aktarmak ve yönetmek için Visual Studio Code için API Management Uzantısı'nı kullanma.

Kısıtlamalar ve sınırlamalar

• Bu özellik, hata ayıklama için yerleşik (hizmet düzeyi) tüm erişimli aboneliği ("Yerleşik tüm erişimli abonelik" görünen adı) kullanır.

Önemli

• API Management istek izlemesi, istekteki Ocp-Apim-Trace üst bilgisini kullanarak ve Ocp-Apim-Trace-Location yanıt üst bilgisinin değerini kullanarak kullanım dışı bırakılıyor.
• Güvenliği geliştirmek için artık API Management REST API'sini kullanarak zaman sınırlı bir belirteç elde edilerek ve belirteci ağ geçidine bir istekte geçirerek izleme tek bir API düzeyinde etkinleştirilebilir. Ayrıntılar için bkz . API izlemeyi etkinleştirme.
• İzleme verilerindeki hassas bilgileri açığa çıkaraabildiği için izlemeyi etkinleştirirken dikkatli olun. İzleme verilerini korumak için uygun güvenlik önlemlerine sahip olduğunuzdan emin olun.

Hata ayıklama oturumu başlatma

1. Visual Studio Code'u başlatma
2. Azure uzantıları altında API Management uzantısına gidin
3. Hata ayıklamak için API Management örneğini bulma
4. Hata ayıklamak için API'yi ve işlemi bulma
5. İşleme sağ tıklayın ve İlke hata ayıklamasını başlat'ı seçin

Bu noktada uzantı, API Management ağ geçidiyle bir hata ayıklama oturumu başlatmayı ve oluşturmayı dener.

Test isteği gönderme

Hata ayıklama oturumu oluşturulduğunda uzantı, REST İstemci uzantısından yararlanarak bu işleme bir test HTTP isteği oluşturmamıza ve göndermemize olanak tanıyan yeni bir düzenleyici açar.

Ocp-Apim-Debug üst bilgisinin isteğe zaten eklendiğini göreceksiniz. Bu üst bilgi gereklidir ve API Management ağ geçidinde hata ayıklama işlevini tetikleyebilmek için değerin hizmet düzeyi, tüm erişimli abonelik anahtarına ayarlanması gerekir.

Düzenleyicideki HTTP isteğini test senaryonuza göre değiştirin. Ardından, test isteğini API Management ağ geçidine göndermek için İstek gönder'e tıklayın.

Hata ayıklama ilkeleri

Test HTTP isteği gönderildikten sonra uzantı, bu işlemin etkili ilkelerini gösteren hata ayıklama penceresini açar ve ilk etkili ilkede durur.

İlke işlem hattını izlemek için tek tek ilkeler arasında tek adım ilerleyebilir veya ilkede bir kesme noktası ayarlayabilir ve doğrudan bu ilkeye adım atabilirsiniz.

Değişkenler panelinde, sistem tarafından oluşturulan ve kullanıcı tarafından oluşturulan değişkenlerin değerlerini inceleyebilirsiniz. Kesme Noktaları panelinde, ayarlanmış tüm kesme noktalarının listesini görebilirsiniz. Çağrı Yığını panelinde geçerli geçerli ilke kapsamını görebilirsiniz.

İlke yürütme sırasında bir hata varsa, hatanın ayrıntılarını oluştuğu ilkede görürsünüz.

İpucu

İşiniz bittiğinde Durdur düğmesine tıklayarak hata ayıklama oturumundan çıkmayı unutmayın.

Sonraki adımlar

• Visual Studio Code için API Management uzantısı hakkında daha fazla bilgi edinin.
• GitHub deposundaki sorunları bildirme