共用方式為


快速入門:使用 PowerShell 建立新的 Azure API 管理實例

適用於:消費 | 開發人員 | 基本 | 標準 | 進階

在本快速入門中,您會使用 Azure PowerShell Cmdlet 建立新的 API 管理實例。 建立實例之後,您可以使用 Azure PowerShell Cmdlet 來執行常見的管理動作,例如在 API 管理實例中匯入 API。

Azure API 管理 可協助組織將 API 發布至外部、合作夥伴和內部開發人員,以釋放其數據和服務的潛力。 「API 管理」提供的核心專長認證,透過開發人員參與、商務洞察力、分析、安全性和保護,可確保 API 程式獲致成功。 APIM 可讓您為裝載於任何位置的現有後端服務,建立和管理新式 API 閘道。

如果您沒有 Azure 帳戶,請在開始之前建立 免費帳戶

先決條件

建立資源群組

使用 New-AzResourceGroup 來建立 Azure 資源群組。 資源群組是在其中部署與管理 Azure 資源的邏輯容器。

下列命令會在美國西部位置建立名為 myResourceGroup 的資源群組:

New-AzResourceGroup -Name myResourceGroup -Location WestUS

建立 API 管理實例

現在您已擁有資源群組,您可以建立 API 管理服務實例。 使用 New-AzApiManagement 建立一個,並提供服務名稱和發行者詳細數據。 服務名稱在 Azure 內必須是唯一的。

在下列範例中, myapim 會用於服務名稱。 將名稱更新為唯一值。 此外,請更新 API 發行者和系統管理員電子郵件地址的組織名稱,以接收通知。

根據預設,命令會在開發人員層中建立實例,這是評估 Azure API 管理的經濟選項。 此層不適用於生產用途。 如需 API 管理層的詳細資訊,請參閱 Azure API 管理層的功能型比較

小提示

此命令可能需要 30 到 40 分鐘的時間,才能在此層中建立和啟用 API 管理 服務。

New-AzApiManagement -Name "myapim" -ResourceGroupName "myResourceGroup" `
  -Location "West US" -Organization "Contoso" -AdminEmail "admin@contoso.com" 

當命令傳回時,請執行 Get-AzApiManagement 來檢視 Azure API 管理服務的屬性。 啟用之後,ProvisioningState 會啟動成功,並且實例有數個相關的 URL。 例如:

Get-AzApiManagement -Name "myapim" -ResourceGroupName "myResourceGroup" 

範例輸出:

PublicIPAddresses                     : {203.0.113.1}
PrivateIPAddresses                    :
Id                                    : /subscriptions/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourceGroups/myResourceGroup/providers/Microsoft.ApiManagement/service/myapim
Name                                  : myapim
Location                              : West US
Sku                                   : Developer
Capacity                              : 1
CreatedTimeUtc                        : 10/13/2025 9:54:18 PM
ProvisioningState                     : Succeeded
RuntimeUrl                            : https://myapim.azure-api.net
RuntimeRegionalUrl                    : https://myapi-westus-01.regional.azure-api.net
PortalUrl                             : https://myapim.portal.azure-api.net
DeveloperPortalUrl                    : https://myapim.developer.azure-api.net
ManagementApiUrl                      : https://myapim.management.azure-api.net
ScmUrl                                : https://myapim.scm.azure-api.net
PublisherEmail                        : admin@contoso.com
OrganizationName                      : Contoso
NotificationSenderEmail               : apimgmt-noreply@mail.windowsazure.com
VirtualNetwork                        :
VpnType                               : None
PortalCustomHostnameConfiguration     :
ProxyCustomHostnameConfiguration      : {myapim.azure-api.net}
ManagementCustomHostnameConfiguration :
ScmCustomHostnameConfiguration        :
DeveloperPortalHostnameConfiguration  :
SystemCertificates                    :
Tags                                  : {}
AdditionalRegions                     : {}
SslSetting                            : Microsoft.Azure.Commands.ApiManagement.Models.PsApiManagementSslSetting
Identity                              :
EnableClientCertificate               :
EnableClientCertificate               :
Zone                                  :
DisableGateway                        : False
MinimalControlPlaneApiVersion         :
PublicIpAddressId                     :
PlatformVersion                       : stv2
PublicNetworkAccess                   : Enabled
PrivateEndpointConnections            :
ResourceGroupName                     : myResourceGroup

部署 API 管理服務實例之後,您就可以使用它。 從匯入和發佈第一個 API 教學課程開始。

清理資源

不再需要時,您可以使用 Remove-AzResourceGroup 命令來移除資源群組和所有相關資源。

Remove-AzResourceGroup -Name myResourceGroup

後續步驟