Alıştırma - Mevcut API'ye başka bir Azure İşlevleri uygulaması ekleme

  • 10 dakika

Azure İşlevleri ayrı mikro hizmetlerin tümünü tek bir API'de tümleştirmek istediğinizi unutmayın. Products işlev uygulamasını yeni bir API Management örneğine eklediniz. Şimdi bu API'ye başka bir işlev uygulaması eklemek istiyorsunuz.

Bu alıştırmada, Orders işlev uygulamasını API'ye ekleyecek ve aracı kullanarak curl tümleşik sistemi test edin.

OrderDetails işlevini test etme

Orders işlev uygulamasını API'ye eklemeden önce, barındırıcısı olan OrderDetails işlevini test edelim.

  1. Azure kaynak menüsünde veya Giriş sayfasında Tüm kaynaklar'ı seçin. Tüm kaynaklar bölmesi görüntülenir.

  2. Kaynakları Türe göre sıralayın ve ardından adı OrderFunction ile başlayan İşlev Uygulamasını seçin. OrderFunction İşlev Uygulaması'nın Genel Bakış bölmesi görüntülenir.

  3. İşlev uygulamanızın işlevler listesinden OrderDetails'i seçin. OrderDetails İşlevi Genel Bakış bölmesi görüntülenir.

  4. Sipariş Ayrıntıları menüsünde, Geliştirici'nin altında Kod + Test'i seçin. OrderDetails işlevinin Kod + Test bölmesi görüntülenir ve dosyanın içeriği function.json gösterilir.

    OrderDetails JSON code, with Code + Test in menu and Test/Run in command bar highlighted.

  5. Komut çubuğunda Test/Çalıştır'ı seçin. OrderDetails işlevinizin Giriş parametreleri sekmesi görüntülenir.

  6. HTTP yöntemi alanında açılan listeden GET'i seçin ve sorgu altında Parametre ekle'yi seçin ve Ad alanına ad girin ve Değer alanına Chiba (değer büyük/küçük harfe duyarlıdır) yazın ve çalıştır'ı seçin.

  7. Bir günlük konsolu açılır ve isteğin durumunu görüntüler. Çıkış sekmesinde HTTP yanıt kodu ve içeriği JSON biçiminde görüntülenir.

    Add a new function option page appears.

    İsteğe bağlı olarak, farklı müşteri siparişlerini almak için Henri ve Barriclough ad değerlerini kullanarak daha fazla istek çalıştırabilirsiniz.

  8. Test/Çalıştırma için Giriş Çıkışı sekmelerini kapatmak için Kapat'ı seçin.

  9. OrderDetails bölmesinin komut çubuğunda İşlev URL'sini al'ı seçin. URL’nin, azurewebsites.net etki alanının içindeki işlevin adı olduğunu görebilirsiniz.

Mevcut API'ye işlev ekleme

Bu adımda, önceki alıştırmada oluşturduğumuz API Management kaynağına Order işlevini ekleyeceğiz. Bu alıştırmada, işlev uygulaması arabiriminin içinden API Management arabirimini kullandık. Burada, her iki yaklaşımın da kullanılabilir olduğunu göstermek için Azure portalı kaynak menüsü aracılığıyla API Management örneğimize gideriz.

  1. Azure kaynak menüsünde veya Giriş sayfasında Tüm kaynaklar'ı seçin. Tüm kaynaklar bölmesi görüntülenir.

  2. Kaynakları Türe göre sıralayın ve ardından OnlineStore API Management hizmetini seçin. OnlineStore için API Management hizmeti görüntülenir.

  3. Menüde, API'ler'in altında API'ler'i seçin. API'ler bölmesinde yeni API tanımlama seçenekleri gösterilir.

  4. Azure kaynağından oluştur'un altında İşlev Uygulaması'yı seçin.

    Screenshot of the Add a New API screen with a callout highlighting the Azure Function App option.

    İşlev Uygulamasından Oluştur iletişim kutusu görüntülenir.

  5. İşlev uygulamanızı seçmek için Gözat'ı seçin. Azure İşlevleri İçeri Aktar bölmesi görüntülenir.

  6. Gerekli ayarları yapılandır alanında Seç'i seçin.

    Screenshot of the Import Azure Functions dialog box with Configure required settings field and Select button highlighted.(.. /media/5-import-azure-function-app-03-expanded.png#lightbox)

    Azure İşlev Uygulamasını Seç bölmesi görüntülenir.

  7. OrderFunctionNNNNNNN'yi ve ardından Seç'i seçin. Azure İşlevleri İçeri Aktar bölmesi, OrderDetails işlev uygulamanız yapılandırılmış olarak yeniden görünür.

  8. OrderDetails'in işaretli olduğundan emin olun ve ardından işlevi eklemek için sayfanın en altında Seç'i seçin. İşlev Uygulamasından Oluştur iletişim kutusu görüntülenir.

  9. API URL son eki alanındaki değeri siparişlerle değiştirin. Bu değişikliğin Temel URL'yi nasıl güncelleştireceğini unutmayın. API'nizi oluşturmak için Oluştur'u seçin.

    Screenshot of the Create from Function App dialog populated with details of the Orders function.

    OnlineStore API Management hizmeti, OrderDetails için tüm kullanılabilir (GET, POST) API'leri içeren Tasarım sekmesini görüntüler.

Portalda OnlineStore siparişleri uç noktasını test etme

API'mize OrderDetails'i eklediğimize göre, Şimdi Azure portalındaki API Management araçlarını kullanarak test edelim.

  1. OrderFunctionNNNNNNN API'leri Tasarımı sekmesinde, Tüm işlemler'in altında GET OrderDetails'i ve ardından Test sekmesini seçin.

  2. Sorgu parametreleri bölümünde Parametre ekle'yi seçin ve AD alanına, Chiba'ya ve DEĞER alanına ad girin. Gönder'i seçin.

  3. HTTP yanıt iletisi sekmesi, HTTP isteğinin başarılı olduğunu (HTTP/1.1/ 200 Tamam) ve müşteri adı, siparişin toplam fiyatı ve sevkiyat durumuyla birlikte Sipariş Kimliğini gösteren bir JSON nesnesini gösterir.

  4. Http isteği bölümüne kadar kaydırın; isteğin azure-api.net etki alanı içindeki bir alt etki alanına ve alt dizine gönderildiğine dikkat edin. Bu konum, azurewebsites.net ana bilgisayar etki alanından farklıdır.

Birleştirilmiş API'yi test edin

API'mize istekleri göndermek için curl komut satırı aracını kullanabiliriz. cURL, bir istekle doğru abonelik anahtarını ekleyebildiğimiz için idealdir. Bir istek, Azure API Management'ta barındırılan API'nin konumuna da ihtiyaç duyar ve bu durumda Ürünler ve Siparişler işlevlerinden oluşur.

  1. Azure kaynak menüsünde veya Giriş'ten Tüm kaynaklar'ı seçin.

  2. Kaynakları Türe göre sıralayın ve ardından OnlineStore API Management hizmetini seçin. OnlineStore için API Management hizmeti görüntülenir.

  3. Temel Bileşenler bölümünde Ağ Geçidi URL'sinin üzerine gelin ve Panoya kopyala simgesini seçin.

  4. Sağdaki Azure Cloud Shell'de bazı değişkenleri tanımlamanızı sağlar. Aşağıdaki komutu çalıştırın, yer tutucuyu <paste URL here> panonuza kopyaladığınız URL değeriyle değiştirin ve enter tuşuna basın. Bu değer ağ geçidi değişkenini tanımlar.

    GATEWAY_URL=<paste URL here>

  5. Azure'da, OnlineStore API Management hizmeti menüsünde aşağı kaydırarak API'ye gelin ve Abonelikler'i seçin. OnlineStore API Management örneğiniz için Abonelikler bölmesi görüntülenir.

  6. Yerleşik tüm erişim aboneliği için, bu satırın en sağındaki üç noktayı seçin ve ardından bağlam menüsünden Anahtarları göster/gizle'yi seçin. API için birincil anahtar ve ikincil anahtar görüntülenir.

  7. Birincil anahtar alanında Panoya kopyala simgesini seçin.

  8. Cloud Shell'de aşağıdaki komutu çalıştırın, yer tutucuyu panonuzdaki değerle değiştirin ve enter tuşuna basın.

    SUB_KEY=<paste key here>

  9. Artık aynı API Management hizmetini sorgulayarak siparişin ve ürünün ayrıntılarını isteyebiliriz:

    1. Henri adlı bir müşterinin ayrıntılarını istemek için Cloud Shell'de aşağıdaki komutu çalıştırın:

       curl -X GET "$GATEWAY_URL/orders/OrderDetails?name=Henri" -H "Ocp-Apim-Subscription-Key:$SUB_KEY"

      Yanıt, Sipariş 56224'ün Pascale Henri'ye gönderildiğini gösteren sipariş ayrıntılarını içeren bir JSON kod bloğu içerir. Farklı sonuçlar için Chiba ve Barriclough adlarıyla komutu da deneyebilirsiniz.

    2. Kimliği 2 olan bir ürünün ayrıntılarını istemek için Cloud Shell'de aşağıdaki komutu çalıştırın:

       curl -X GET "$GATEWAY_URL/products/ProductDetails?id=2" -H "Ocp-Apim-Subscription-Key:$SUB_KEY"

      Yanıt, bir ürünün ayrıntılarını içeren bir JSON kod bloğu içerir. Farklı sonuçlar için 1 ve 3 kimlik değerlerine sahip komutu da deneyebilirsiniz.

Her iki işlevin de artık Azure API Management tarafından kullanılan etki alanı olan azure-api.net etki alanındaki uç noktalar (GATEWAY_URL tarafından tanımlandığı gibi) aracılığıyla çağrılabildiğine dikkat edin. Diğer Learn modüllerinde, API Management Gateway'deki işlevlere ilkeleri, güvenlik ayarlarını, dış önbellekleri ve diğer özellikleri uygulamayı öğrenebilirsiniz. Ağ geçidi, kodunu değiştirmeden birden çok mikro hizmeti yönetebileceğiniz merkezi bir denetim noktası sağlar.