快速入門：使用 Azure CLI 建立新的 Azure APIM 執行個體
適用於：取用 |開發人員 |基本 |標準 |進階版
此快速入門描述使用 Azure CLI 命令建立新 APIM 執行個體的步驟。 建立執行個體後，您可使用 Azure CLI 來執行常見的管理工作，例如在 APIM 執行個體中匯入 API。
Azure APIM 可協助組織將 API 發佈給外部、合作夥伴及內部開發人員，以發揮其資料與服務的潛力。 「API 管理」提供的核心專長認證，透過開發人員參與、商務洞察力、分析、安全性和保護，可確保 API 程式獲致成功。 APIM 可讓您為裝載於任何位置的現有後端服務，建立和管理新式 API 閘道。
如果您沒有 Azure 訂閱，請在開始之前，先建立 Azure 免費帳戶。
必要條件
在 Azure Cloud Shell 中使用 Bash 環境。 如需詳細資訊，請參閱 Azure Cloud Shell 中的 Bash 快速入門。
若要在本地執行 CLI 參考命令，請安裝 Azure CLI。 若您在 Windows 或 macOS 上執行，請考慮在 Docker 容器中執行 Azure CLI。 如需詳細資訊，請參閱〈如何在 Docker 容器中執行 Azure CLI〉。
如果您使用的是本機安裝，請使用 az login 命令，透過 Azure CLI 來登入。 請遵循您終端機上顯示的步驟，完成驗證程序。 如需其他登入選項，請參閱使用 Azure CLI 登入。
出現提示時，請在第一次使用時安裝 Azure CLI 延伸模組。 如需擴充功能詳細資訊，請參閱使用 Azure CLI 擴充功能。
執行 az version 以尋找已安裝的版本和相依程式庫。 若要升級至最新版本，請執行 az upgrade。
- 本文需要 2.11.1 版或更新版本的 Azure CLI。 如果您是使用 Azure Cloud Shell，就已安裝最新版本。
建立資源群組
Azure APIM 執行個體和所有 Azure 資源相同，都必須部署到資源群組中。 資源群組可讓您組織和管理相關的 Azure 資源。
首先，使用下列 az group create 命令，在「美國中部」位置中建立一個名為 myResourceGroup 的資源群組：
az group create --name myResourceGroup --location centralus
建立 API 管理執行個體
現在您已有資源群組，您可以接著建立 APIM 執行個體。 使用 az apim create 命令建立一個執行個體，並提供服務名稱和發行者詳細資料。 服務名稱必須是 Azure 中唯一的。
在下列範例中，服務名稱會使用 myapim。 將名稱更新為唯一值。 也請更新 API 發行者的組織名稱，以及用來接收通知的電子郵件地址。
az apim create --name myapim --resource-group myResourceGroup \
--publisher-name Contoso --publisher-email admin@contoso.com \
--no-wait
根據預設，此命令會在開發人員層中建立執行個體，以此經濟實惠的選項評估 Azure APIM。 此階層不適用於生產環境。 如需有關調整 API 管理層規模的詳細資訊，請參閱升級和調整規模。
提示
這可能需要 30 到 40 分鐘的時間，才能在此階層中建立及啟用 APIM 服務。 先前的命令會使用 --no-wait 選項，讓此命令在服務建立時立即返回。
執行 az apim show 命令來檢查部署的狀態：
az apim show --name myapim --resource-group myResourceGroup --output table
一開始，輸出會如下所示，並顯示 Activating 狀態：
NAME RESOURCE GROUP LOCATION GATEWAY ADDR PUBLIC IP PRIVATE IP STATUS TIER UNITS
----------- ---------------- ---------- -------------- ----------- ------------ ---------- --------- -------
myapim myResourceGroup Central US Activating Developer 1
啟用之後，狀態會是 Online，而服務執行個體會有閘道位址和公用 IP 位址。 目前，這些位址不會公開任何內容。 例如：
NAME RESOURCE GROUP LOCATION GATEWAY ADDR PUBLIC IP PRIVATE IP STATUS TIER UNITS
----------- ---------------- ---------- --------------------------------- ------------ ------------ -------- --------- -------
myapim myResourceGroup Central US https://myapim.azure-api.net 203.0.113.1 Online Developer 1
當您的 APIM 服務執行個體上線時，您就可以開始使用了。 從匯入和發佈第一個 API 教學課程開始。
清除資源
若不再需要資源群組和 API 管理服務執行個體，您可以使用 az group delete 命令來移除這些項目。
az group delete --name myResourceGroup