OData API'sini içeri aktarma

UYGULANANLAR: Tüm API Management katmanları

Bu makalede, OData uyumlu bir hizmetin API Management'ta API olarak nasıl içeri aktarılacağını gösterir.

Bu makalede şunları öğreneceksiniz:

  • Azure portalını kullanarak OData meta veri açıklamasını içeri aktarma
  • Portalda OData şemasını yönetme
  • OData API'sinin güvenliğini sağlama

Önkoşullar

  • Api Management örneği. Henüz bir örneğiniz yoksa şu hızlı başlangıcı tamamlayın: Azure API Management örneği oluşturma.

  • OData v2 veya v4 olarak kullanıma sunulan bir hizmet.

API Management örneğinize gidin

  1. Azure portalında API Management hizmetlerini arayın ve seçin.

    API Management hizmetlerini seçme

  2. API Management hizmetleri sayfasında API Management örneğinizi seçin.

    API Management örneğinizi seçin

OData meta verilerini içeri aktarma

  1. Sol menüde API'ler>+ API Ekle'yi seçin.

  2. Tanımdan oluştur'un altında OData'yı seçin.

    Portaldaki OData açıklamasından API oluşturma işleminin ekran görüntüsü.

  3. API ayarlarını girin. Daha sonra API'nin Ayarlar sekmesine giderek ayarlarınızı güncelleştirebilirsiniz.

    1. OData belirtiminde, bir OData meta veri uç noktasının URL'sini girin( genellikle ile ekli hizmet kökü URL'si)./$metadata Alternatif olarak, içeri aktaracak yerel bir OData XML dosyası seçin.

    2. API'nizi yapılandırmak için kalan ayarları girin. Bu ayarlar, İlk API'nizi içeri aktarma ve yayımlama öğreticisinde açıklanmıştır.

  4. Oluştur'u belirleyin.

    API, API listesine eklenir. OData meta veri açıklamasında gösterilen varlık kümeleri ve işlevleri, API'nin Varlık kümeleri ve işlevleri sekmesinde görünür.

    Portaldaki OData varlık kümelerinin ve işlevlerinin ekran görüntüsü.

OData şemasını güncelleştirme

API'nizin OData şemasını görüntülemek için portaldaki bir düzenleyiciye erişebilirsiniz. API değişirse, API Management'taki şemayı bir dosyadan veya OData hizmet uç noktasından da güncelleştirebilirsiniz.

  1. Portalda API Management örneğine gidin.

  2. Sol menüdeN OData API'nizin API'lerini> seçin.

  3. Varlık kümeleri ve işlevler sekmesinde, bir varlık kümesinin veya işlevin yanındaki bağlam menüsünü (...) ve ardından Düzenle'yi seçin.

    Portalda ayarlanmış bir OData varlığı için bağlam menüsünün ekran görüntüsü.

  4. Şemayı gözden geçirin. Güncelleştirmek istiyorsanız Dosyadan güncelleştir'i veya Uç noktadan şemayı güncelleştir'i seçin.

    Portalda OData API'sinin şema düzenleyicisinin ekran görüntüsü.

OData API'nizi test edin

  1. Sol menüdeN OData API'nizin API'lerini> seçin.

  2. Varlık kümeleri ve işlevler sekmesinde, bir varlık kümesinin veya işlevin yanındaki bağlam menüsünü (...) ve ardından Test'i seçin.

    Portalda bir OData varlık kümesi için bağlam menüsündeki Test seçeneğinin ekran görüntüsü.

  3. Test konsolunda, testinizin şablon parametrelerini, sorgu parametrelerini ve üst bilgilerini girin ve Test'i seçin. Portalda API'yi test etme hakkında daha fazla bilgi edinin.

OData API'nizin güvenliğini sağlama

OData API istekleri aracılığıyla saldırılara karşı koruma sağlamak için hem mevcut kimlik doğrulama hem de yetkilendirme ilkelerini ve OData doğrulama ilkesini uygulayarak OData API'nizin güvenliğini sağlayın.

İpucu

Portalda, API ilkeleri sekmesinde OData API'niz için ilkeleri yapılandırın.

Diğer API'leri ekleme

Farklı hizmetler tarafından kullanıma sunulan API'lerden oluşan bir API oluşturabilirsiniz, örneğin:

  • OpenAPI belirtimi
  • SOAP API'si
  • GraphQL API'si
  • Azure Uygulaması Hizmetinde barındırılan bir Web Uygulaması
  • Azure İşlev Uygulaması
  • Azure Logic Apps
  • Azure Service Fabric

Aşağıdaki adımları kullanarak mevcut API'nize farklı bir API ekleyin.

Not

Başka bir API'yi içeri aktardığınızda işlemler geçerli API'nize eklenir.

  1. Azure portal'da Azure API Management kurulumunuza gidin.

    Azure API Mgmt örneğine gidin

  2. Genel Bakış sayfasında veya soldaki menüden API'ler'i seçin.

    Özel API'ler

  3. Başka bir API eklemek istediğiniz API'nin yanındaki ... simgesine tıklayın.

  4. Açılan menüden İçeri aktar'ı seçin.

    İçe aktar'ı seçin

  5. API'nin içeri aktarılacağı hizmeti seçin.

    Hizmet seç