Alıştırma - API Management'ta işlev uygulamasından yeni API oluşturma

  • 15 dakika

Azure İşlevleri kullanıcılara tek bir API'nin parçası olarak sunmak için bunları Azure API Management'a ekleyebilirsiniz.

Çevrimiçi mağaza şirketinizde geliştiricileriniz mikro hizmet olarak birden çok Azure İşlevleri oluşturdu. Her işlev mağazanın işlevselliğinin küçük bir parçasını uyguluyordu. Bu işlevleri tek bir API'de birleştirmek istiyorsunuz.

Bu alıştırmada, yeni bir API Management örneği oluşturacak ve ardından buna bir Ürün Ayrıntıları işlevi ekleyacaksınız.

İşlev oluşturma

Aşağıdaki adımlarda, Azure API Management'a bir Azure İşlevi uygulaması eklersiniz. Daha sonra, birden çok işlevden tek bir sunucusuz API oluşturmak için aynı API Management örneğine ikinci bir işlev uygulaması eklersiniz. Başlangıç olarak işlevleri oluşturmak için bir betik kullanalım:

  1. İşlevler projesini kopyalamak için sağdaki Azure Cloud Shell'de aşağıdaki komutu çalıştırın.

    git clone https://github.com/MicrosoftDocs/mslearn-apim-and-functions.git ~/OnlineStoreFuncs

  2. Bu alıştırma için ihtiyacımız olan Azure kaynaklarını ayarlamak için Cloud Shell'de aşağıdaki komutları çalıştırın.

    cd ~/OnlineStoreFuncs
bash setup.sh

    Betik, setup.sh bu modül için etkinleştirilen korumalı alan kaynak grubunda iki işlev uygulaması oluşturur. Aşağıdaki grafikte gösterildiği gibi her uygulama tek bir işlev barındırır: OrderDetails ve ProductDetails. Betik ayrıca işlevler için bir depolama hesabı ayarlar. İşlevlerin ikisinin de azurewebsites.net etki alanında URL'leri vardır. İşlev adları benzersizlik sağlamak için rastgele sayılar içerir. Betiğin tamamlanması birkaç dakika sürer.

    Diagram illustrating the results of the setup.sh script and how the functions relate to the overall application's design.

ProductDetails işlevini test etme

Şimdi, API Management'a eklemeden önce ProductDetails işlevini test edelim ve nasıl davrandığını görelim.

  1. Korumalı alanı etkinleştirmek için kullandığınız aynı hesapla Azure portalında oturum açın.

  2. Azure portalı menüsünde veya Giriş sayfasında Tüm kaynaklar seçeneğini belirleyin. Tüm kaynaklar bölmesi görüntülenir.

  3. Adı ProductFunction ile başlayan İşlev Uygulamasını seçin. İşlev Uygulaması bölmesi, Genel Bakış sekmesi seçili olarak görüntülenir.

    Screenshot of menu selections to open ProductDetails function.

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

  5. Ürün Ayrıntıları menüsünde, Geliştirici'nin altında Kod + Test'i seçin. Dosyanın içeriğini function.json gösteren ProductDetails işlevinin Kod + Test bölmesi görüntülenir.

    Screenshot of the ProductDetails Code and Test pane, with Test/Run selected in the command bar.

  6. Komut çubuğunda Test/Çalıştır'ı seçin. HTTP isteğinizi test için Giriş/Çıkış bölmesi görüntülenir.

  7. Giriş sekmesindeki HTTP yöntemi alanı açılan listesinde GET'i seçin.

  8. Sorgu altında Parametre ekle'yi seçin

  9. Ad alanına id girin ve Değer alanına 3 girin ve çalıştır'ı seçin.

    Screenshot of the input pane for Test + Run, with the input parameter for the HTTP GET method highlighted.

  10. İsteği bağlamak için bir günlük bölmesi görüntülenir. Çıkış sekmesinde, veritabanındaki 3. öğenin HTTP yanıt kodu (200 Tamam) ve içeriği görüntülenir.

    Screenshot of the output of a pane for Test + Run with response results of running the GET method.

    İsteğe bağlı olarak, 1 ve 2 kimlik değerlerini girerek işlevi de test edebilirsiniz.

  11. Kod + Test giriş çıkış sekmelerini kapatmak için Kapat'ı seçin.

  12. ProductDetails Code + Test bölmesinin komut çubuğunda İşlev URL'sini al'ı seçin. URL alt etki alanının işlev uygulamanızın adı ve ardından azurewebsites.net etki alanı olduğuna dikkat edin.

Dekont

Bu URL'yi kullanarak tarayıcınızda işlevi test edebilirsiniz. URL bir giriş gerektirir; ürün koleksiyonunuzdaki ilk öğeyle ilgili ayrıntıları istemek için sorgu dizesini &id=1 ekleyin.

Azure API Management kullanarak işlev uygulamasını API olarak kullanıma sunma

İşlev uygulaması dağıtılıp test edildikten sonra, diğer uygulama ve hizmetlerden çağrılabilmesi için Azure API Management'ı kullanarak api olarak dışarı aktaralım.

  1. Kaynak menüsünde Tüm kaynaklar'ı seçin. Tüm kaynaklar bölmesi görüntülenir.

  2. Kaynak listesini türe göre sıralayın. Bir OrderFunction uygulamanız ve ProductFunction uygulamanız olduğunu fark edin.

  3. ProductFunction işlev uygulamasını seçin.

  4. İşlev Uygulaması menüsünde API kategorisine kaydırın ve ARDıNDAN API Management'ı seçin. ProductFunction işlev uygulamasının API Management bölmesi görüntülenir.

    Screenshot showing menu selection to open the API Management app service.

  5. API Management alanının altında Yeni oluştur'u seçin. API Management ağ geçidini yükle bölmesi görüntülenir.

    Screenshot showing settings for an API Management service.

  6. Her ayar için aşağıdaki değerleri girin.

    Ayar Değer
    Abonelik Concierge Aboneliği
    Kaynak grubu [sandbox resource group name]
    Bölge Tüketim Planını destekleyen bir konum seçin: (ABD) Batı ABD, Orta Kuzey ABD, Batı Avrupa, Kuzey Avrupa, Güneydoğu Asya, Doğu Avustralya
    Kaynak adı OnlineStore
    Kuruluş adı OnlineStore
    Yönetici e-postası Bir e-posta adresi girin.
    Fiyatlandırma katmanı Tüketim (%99,95 SLA)

  7. İleri: İzleme'yiseçin ve Uygulama Analizler seçeneğini temizleyin.

  8. Gözden geçir + Oluştur’u seçin. Doğrulama tamamlandığında, bağlantılı API Management örneği oluşturmak için Oluştur'u seçin. Dışarı aktarma işleminin tamamlanması için birkaç dakika bekleyin.

  9. API Management örneği dağıtıldığında API'yi bağla'yı seçin.

    Screenshot of API Management highlighting the Link API button.

    Azure İşlevleri API Management hizmeti içeri aktar bölmesi, ProductDetails işlevi vurgulanmış olarak görüntülenir.

    Screenshot showing the Import Azure Functions API Management service pane.

  10. Devam etmek için Seç'i seçin. İşlev Uygulamasından Oluştur iletişim kutusu görüntülenir.

    Screenshot showing the Create from Function app dialog box.

  11. API URL'si soneki değerini ürünler olarak değiştirin ve oluştur'u seçin. Azure, ProductDetails işlevi için API'yi oluşturur. İşlev uygulamanızın API Management bölmesinin Tasarım sekmesi görüntülenir.

Bu alıştırmada API'nizi tanımlayabileceğiniz ve bunların tümünü Azure İşlevi Uygulama hizmeti içinden gerçekleştirebileceğiniz gösterilmektedir.

OnlineStore ürünleri uç noktasını test etme

Artık oluşturduğunuz API Management örneğinde bir ProductDetails API'niz var. Şimdi bu API'yi Azure'daki API Management araçlarıyla test edelim.

  1. İşlev uygulamanızın API Management bölmesinde Test sekmesini seçin. API'niz için kullanılabilir işlemler sol sütunda görünür.

  2. GET ProductDetails'i seçin. ProductDetails Konsolu bölmesi görüntülenir.

  3. Sorgu parametreleri'nin altında Parametre ekle'yi seçin.

    Screenshot showing ProductDetails Console with query parameter values highlighted for the GET HTTP request.

  4. AD alanına id girin ve VALUE alanına 1 girin ve sonra gönder'i seçerek bir GET isteği oluşturun.

    Konsolun HTTP yanıt bölümünde İleti ve İzleme şeklinde iki sekme vardır. İleti sekmesi HTTP yanıtıyla doldurulur. Ürün ayrıntıları yanıtın sonunda JSON biçiminde görünür. HTTP isteği bölümüne kadar kaydırın ve isteğin biçimine dikkat edin. İstek azure-api.net etki alanındaki bir hedefe gönderildi. Bu konum, işlev uygulamasının barındırıldığı azurewebsites.net etki alanından farklıdır. Bu API'yi id=2 veya id=3 gibi diğer sorgu parametreleriyle test edebilirsiniz.

    Screenshot showing the **Http request** and **HTTP response** message.