教學:建立或連接 API 中心到 API 管理

這個教學展示了如何將 Azure API Management 實例與 Azure API 中心整合(連結)。 連結時,API 管理實例的 API 和選擇性 API 定義會持續同步至 API 中心目錄。 API Center 是 API 和相關成品的中央目錄和治理中樞,API 管理 客戶會使用它來探索和重複使用 API、跨小組共用定義,以及套用一致的治理和生命週期原則。

備註

只有一個 API Center 可以連結至單一 API 管理 執行個體。

備註

API Center Standard 現在只要連結到 Standard、Standard v2、Premium 或 Premium v2 層級的 API 管理實例,即可無需額外費用使用。 欲了解更多資訊,請參閱 API 中心的計畫與功能

在本教學課程中,您會:

  • 建立新的 API 中心,並將它連結至 API 管理 實例
  • 連結現有的 API 中心並同步 API
  • 檢視同步處理的 API,並視需要移除連結

先決條件

開始之前,請確保您符合以下要求。

  • 需要一個具有有效訂閱的 Azure 帳戶。 若您還沒有帳戶,可以免費建立帳戶
  • 訂用帳戶中您要管理 API 的現有 API 管理 服務
  • API 管理 資源的參與者 (或擁有者) 權限,以及在資源群組中建立資源的權限

這些步驟示範如何建立新的 API 中心,並將它連結至 API 管理 執行個體,以便同步處理 API。

  1. Azure 入口網站 開啟您的 API 管理 服務。

  2. 在左側功能表中,前往 API>API 中心 Azure 入口網站中的 APIM 執行個體,其中 [API 中心] 在左側功能表中受到強調。

  3. 在中央窗格中,在 [使用 API 中心進行 API 探索、重複使用和治理] 下,選取 [新建]

  4. [建立 API Center ] 頁面上,選取 [ 建立新連結]。

  5. 提供下列欄位的值︰

    領域 詳細資訊
    資源群組 選取現有的資源群組或建立新群組。
    地點 選擇區域。 API Center 可用的區域可能與 API 管理 執行個體的區域不同。
    名稱 提供 API Center 執行個體的唯一名稱。
    定價方案 選取方案。
    Lifecycle 選取在同步處理時要與 API 相關聯的生命週期狀態。 此中繼資料稍後可以變更。
  6. 選取 建立。

    • 作業完成時,您應該會看到 [要求成功] 訊息,並確認您的 API 管理 服務和 API Center 已同步處理。

使用現有的 API Center

這些步驟示範如何將 API 管理 執行個體連結至已存在的 API Center。

  1. 從 API 管理服務的 API Center 區段中,選取 [ 使用現有的 API Center]。
  2. 從下拉式清單中,選擇您要連結的 API Center。
  3. 選取 [ 同步處理 API] ,以開始 API 管理 服務與所選 API Center 之間的同步處理。

檢視連結的 API Center 和同步處理的 API

請使用本節來驗證整合狀態,並檢視從 API 管理同步的 API。

  1. Azure 入口網站,前往 API 中心資源。
  2. 在 API 中心側邊欄選單中,前往 平台>整合。 與 API 管理 整合的狀態應該顯示 [連結和同步處理]。
  3. 要查看同步的 API,請前往 庫存>資產
    會出現一個圖示,指出 API 已連結。 截圖顯示 Azure 入口網站中的 API Center 實例,側邊欄選單中標示資產,主面板強調連結圖示

請遵循下列步驟來移除 API 管理 與 API Center 之間的連結,或刪除 API Center 資源。

  1. 在 API 中心資源中,請前往 平台>整合
  2. 找到連結的 API Management 實例。
  3. 選取垃圾桶圖示以刪除連結。

清理資源

刪除您為本教學課程建立的任何資源,以避免產生費用。

如果您為本教學課程建立 API 中心,但不再需要它,請刪除 API Center 資源和您建立的任何資源群組,以避免產生費用。

從 API 管理執行個體中同步 API