分享方式：

匯入 OData API

  • 文章

適用於：所有 API 管理層

本文將說明如何將符合 OData 規範的服務以 API 形式匯入 APIM。

在本文中，您將學會如何：

  • 利用 Azure 入口網站匯入 OData 中繼資料描述
  • 在入口網站內管理 OData 結構描述
  • 保護 OData API

必要條件

移至您的 API 管理執行個體

  1. 在 Azure 入口網站中，搜尋並選取 [API 管理服務]。

    選取 [API 管理服務]

  2. 在 [API 管理服務] 頁面中，選取您的 API 管理執行個體。

    選取您的 API 管理執行個體

匯入 OData 中繼資料

  1. 在左側功能表中，選取 [API] > [+ 新增 API]。

  2. 在 [從定義建立] 下，選取 [OData]。

    從入口網站中的 OData 描述建立 API 的螢幕擷取畫面。

  3. 輸入 API 設定。 您稍後可以移至 API 的 [設定] 索引標籤來更新設定。

    1. 在 [OData 規格] 中，輸入 OData 中繼資料端點的 URL，通常是服務根目錄的 URL，後面再附上 /$metadata。 或者，選取要匯入的本機 OData XML 檔案。

    2. 輸入其餘設定來設定您的 API。 這些設定會在匯入和發佈您的第一個 API 教學課程中說明。

  4. 選取 建立。

    API 會新增至 [API] 清單。 OData 中繼資料描述中公開的實體集和函式，會顯示在 API 的 [實體集和函式] 索引標籤上。

    入口網站中 OData 實體集和函式的螢幕擷取畫面。

更新 OData 結構描述

您可以在入口網站中存取編輯器，以檢視 API 的 OData 結構描述。 如果 API 變更，您也可以從檔案或 OData 服務端點更新 APIM 中的結構描述。

  1. 在入口網站中，瀏覽至您的 API 管理執行個體。

  2. 在左側功能表中，選取 [API]>[您的 OData API]。

  3. 在 [實體集和函式] 索引標籤上，選取實體集或函式旁邊的捷徑功能表 (...)，然後選取 [編輯]。

    入口網站中 OData 實體集捷徑功能表的螢幕擷取畫面。

  4. 檢閱結構描述。 若要更新，請選取 [從檔案更新] 或 [從端點更新結構描述]。

    入口網站中 OData API 結構描述編輯器的螢幕擷取畫面。

測試 OData API

  1. 在左側功能表中，選取 [API]>[您的 OData API]。

  2. 在 [實體集和函式] 索引標籤上，選取實體集或函式旁邊的捷徑功能表 (...)，然後選取 [測試]。

    入口網站中 OData 實體集捷徑功能表上 [測試] 選項的螢幕擷取畫面。

  3. 在測試主控台，輸入測試的範本參數、查詢參數和標頭，然後選取 [測試]。 深入了解如何在入口網站中測試 API。

保護 OData API

透過套用現有的驗證和授權原則和 OData 驗證原則來保護您的 OData API，以防止透過 OData API 要求進行攻擊。

提示

在入口網站中，於 [API 原則] 索引標籤上設定 OData API 的原則。

附加其他 API

您可撰寫由不同服務所公開 API 的 API，包含：

  • OpenAPI 規格
  • SOAP API
  • GraphQL API
  • 在 Azure App Service 中託管的 Web 應用程式
  • Azure 函數應用程式
  • Azure Logic 應用程式
  • Azure Service Fabric

使用下列步驟，將不同的 API 附加至您現有的 API。

注意

在您匯入另一個 API 後，作業就會附加至目前的 API。

  1. 移至 Azure 入口網站中的 Azure API 管理執行個體。

    前往 Azure API 管理執行個體

  2. 在 [概觀] 頁面上，或從左側功能表，選取 [API]。

    選取 API

  3. 在您要附加另一個 API 的 API 旁，按一下 ...。

  4. 從下拉式功能表中選取 [匯入]。

    選取匯入

  5. 選取要從中匯入 API 的服務。

    選取服務