你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。
快速入门：使用 PowerShell 创建新的 Azure API 管理实例
适用于：消耗 | 开发人员 | 基本 | 标准 | 高级
在本快速入门中，使用 Azure PowerShell cmdlet 新建 API 管理实例。 创建实例后，可使用 Azure PowerShell cmdlet 执行常见管理操作，例如在 API 管理实例中导入 API。
Azure API 管理可帮助组织将 API 发布给外部、合作伙伴和内部开发人员，以充分发挥其数据和服务的潜力。 API 管理通过开发人员参与、商业洞察力、分析、安全性和保护提供了核心竞争力以确保成功的 API 程序。 使用 API 管理，为托管在任何位置的现有后端服务创建和管理新式 API 网关。
如果没有 Azure 订阅，请在开始之前创建一个 Azure 免费帐户。
先决条件
- 如果选择在本地使用 Azure PowerShell：
- 安装最新版本的 Az PowerShell 模块。
- 使用 Connect-AzAccount cmdlet 连接到 Azure 帐户。
- 如果选择使用 Azure Cloud Shell：
- 有关详细信息，请参阅 Azure Cloud Shell 概述。
创建资源组
使用 New-AzResourceGroup 创建 Azure 资源组。 资源组是在其中部署和管理 Azure 资源的逻辑容器。
以下命令在“美国西部”位置创建一个名为“myResourceGroup”的资源组：
New-AzResourceGroup -Name myResourceGroup -Location WestUS
创建 API 管理实例
现在，你已有了一个资源组，可以创建 API 管理服务实例了。 使用 New-AzApiManagement 创建一个 API 管理服务实例，并提供服务名称和发布者详细信息。 服务名称在 Azure 中必须独一无二。
在下面的示例中，使用“myapim”作为服务名称。 将该名称更新为唯一值。 同时更新 API 发布者的组织名称和管理员电子邮件地址以接收通知。
默认情况下，该命令在“开发人员”层创建实例，这是评估 Azure API 管理的一个经济选择。 此层不用于生产。 有关 API 管理层的详细信息，请参阅 Azure API 管理层的基于功能的比较。
提示
这是一个长时间运行的操作。 在此层中创建和激活 API 管理服务可能需要 30 到 40 分钟。
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 : 9/9/2022 9:07:43 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