本教學課程說明如何新增 API 環境和部署的相關資訊,以擴充 API 中心中的庫存。
- 環境代表可以部署 API 執行階段的位置,例如 API 管理平台。
- 部署是使用者可以存取 API 的位置或位址。
如需您可以在 Azure API Center 清查的 API、部署和其他實體的詳細資訊,請參閱 重要概念。
在本教學課程中,您會了解如何使用入口網站執行下列動作:
- 新增 API 環境的相關資訊
- 新增 API 部署的相關資訊
先決條件
- Azure 訂用帳戶中的 API 中心。 若要建立一個,請參閱 快速入門:建立您的 API 中心。
- 在您的 API 中心註冊一或多個 API。 如果您沒有任何已註冊的 API,請參閱 教學課程:在 API 庫存中註冊 API。 本教學課程使用您從上一個教學課程新增的範例 API。
新增環境
使用您的 API 中心來追蹤真實世界的 API 環境。 例如,您可以使用 Azure API 管理或其他解決方案來散發、保護及監視部分 API。 或者,您可以使用計算服務或 Kubernetes 叢集直接提供某些 API。
在這裡,您會將虛構的 Azure API 管理環境的相關資訊新增至 API 中心。 如果您想要的話,新增您其中一個現有環境的相關資訊。 設定您的內建中繼資料,以及您在上一個教學課程中定義的任何自訂中繼資料。
登入 Azure 入口網站,然後流覽至您的 API 中心。
在側邊欄功能表的 資產 下,選取 環境>+ 新環境。
在 [新環境] 頁面上,新增下列資訊。 如果您先前定義了自訂 企業營運 中繼資料或指派給環境的其他中繼資料,您會在頁面底部看到它們。
Setting 價值觀 Description 環境標題 輸入我的測試。 您為環境選擇的名稱 識別 輸入上述標題之後,Azure API 中心會產生此識別碼,您可加以覆寫。 Azure 環境的資源名稱 環境類型 從下拉式清單中選取 [測試]。 API 的環境類型 說明 或者,輸入描述。 環境說明 伺服器 Type 或者,從下拉式清單中選取 [Azure API 管理]。 使用的 API 管理解決方案類型 管理入口網站 URL 選擇性地輸入管理介面的 URL,例如 https://admin.contoso.com環境管理介面的 URL 上架 開發入口網站 URL 或者,輸入開發人員入口網站的 URL,例如 https://developer.contoso.com環境中開發人員上線的介面 URL 指示 或者,選取 [編輯] ,然後在標準 Markdown 中輸入上線指示。 從環境導入 API 的指引 企業營運 如果您新增此自訂中繼資料,可以選擇性地從下拉式清單中選取項目,例如 IT。 自訂可識別會管理環境的業務單位的中繼資料
選取 ,創建。 環境會出現在環境清單中。
新增部署
API 中心也可協助您編目 API 部署,即部署您追蹤的 API 的執行階段環境。
在這裡,您會將其中一個 API 與您在上一節中建立的環境相關聯,以新增部署。 您可以設定內建中繼資料和您定義的任何自訂中繼資料。
在 Azure 入口網站中,流覽至您的 API 中心。
在側邊欄功能表的 資產 下,選取 API。
選取 API,例如 Conference API。
在 [Conference API] 頁面的 [詳細資料] 下,選取 [部署]> [+ 新增部署]。
在 [新增部署] 頁面中,新增下列資訊。 如果您先前定義了自訂 企業營運 中繼資料或指派給環境的其他中繼資料,則可以在頁面底部看到它們。
Setting 價值觀 Description 標題 輸入 v1 部署。 您為部署選擇的名稱 識別 輸入上述標題之後,Azure API 中心會產生此識別碼,您可加以覆寫。 部署的 Azure 資源名稱 說明 或者,輸入描述。 部署說明 環境 從下拉式清單中選取項目,例如我的測試,或選擇性地選取 [新建]。 部署 API 版本的新環境或現有環境 Definition 選取或新增 Conference API 版本的定義檔。 API 定義檔案 執行階段 URL 輸入基底 URL,例如 https://api.contoso.com。環境中 API 的基本執行階段 URL 企業營運 如果您新增此自訂中繼資料,可以選擇性地從下拉式清單中選取項目,例如 IT。 自訂中繼資料,用以識別在環境中管理 API 的業務單位
選取 ,創建。 部署會出現在部署清單中。
在本教學課程中,您已了解如何使用入口網站來執行下列動作:
- 新增 API 環境的相關資訊
- 新增 API 部署的相關資訊
相關內容
- 深入了解 Azure API 中心 (部分機器翻譯)
- 追蹤 API 資源相依性