Aracılığıyla paylaş


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ğinize gidin

  1. Azureportalında API Management hizmetleriniarayıp seçin:

    Arama sonuçlarında API Management hizmetlerini gösteren ekran görüntüsü.

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

    API Yönetimi hizmetleri sayfasında bir API Yönetimi örneğini gösteren ekran görüntüsü.

OData meta verilerini içeri aktarma

  1. Sol menüde API API'leri'ni> ve ardından + 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, OData meta veri uç noktası için bir URL girin. Bu değer, genellikle hizmet köküne eklenen /$metadata ile URL'dir. Alternatif olarak, içeri aktaracak yerel bir OData XML dosyası seçin.

    2. API'nizi yapılandırmak için ek 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.

    OData varlık kümelerini ve işlevlerini gösteren 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ğinize gidin.

  2. Sol menüde API'leri ve ardından OData API'nizi seçin.

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

    Düzenle komutunun konumunu gösteren 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.

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

OData API'nizi test edin

  1. Sol menüde API'leri ve ardından OData API'nizi seçin.

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

    Test komutunu gösteren ekran görüntüsü.

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

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

OData API istekleri aracılığıyla saldırılara karşı koruma sağlamak için mevcut kimlik doğrulama ve 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'ler dışında bir API oluşturabilirsiniz, örneğin:

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

Uyarı

Bir API'yi içeri aktardığınızda, işlemler geçerli API'nize eklenir.

Api'yi var olan bir API'ye eklemek için:

  1. Azure portalında Azure API Management örneğine gidin:

    API Management hizmetleri sayfasını gösteren ekran görüntüsü.

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

    Genel Bakış sayfasındaki API'lerin seçimini gösteren ekran görüntüsü.

  3. Eklemek istediğiniz başka bir API'nin yanındaki üç noktayı (...) seçin.

  4. Açılır menüden İçeri Aktar seçeneğini seçin.

    İçeri Aktar komutunu gösteren ekran görüntüsü.

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