Inicio rápido: Creación de una nueva instancia de Azure API Management mediante PowerShell
SE APLICA A: Consumo | Desarrollador | Básico | Estándar | Premium
En este inicio rápido, creará una instancia de API Management mediante cmdlets de Azure PowerShell. Después de crear una instancia, puede usar los cmdlets de Azure PowerShell para acciones comunes de administración, como importar API en la instancia de API Management.
Azure API Management ayuda a las organizaciones a publicar API para desarrolladores externos, asociados e internos para liberar el potencial de sus datos y servicios. API Management proporciona las competencias esenciales para garantizar un programa de API de éxito mediante compromisos con desarrolladores, información detallada empresarial, análisis, seguridad y protección. Con API Management, cree y administre puertas de enlace de API modernas para los servicios back-end existentes hospedados en cualquier lugar.
Si no tiene una suscripción a Azure, cree una cuenta gratuita de Azure antes de empezar.
Requisitos previos
- Si opta por usar Azure PowerShell en un entorno local:
- Instale la versión más reciente del módulo Az de PowerShell.
- Conéctese a su cuenta de Azure mediante el cmdlet Connect-AzAccount.
- Si decide usar Azure Cloud Shell:
- Para más información, consulte Introducción a Azure Cloud Shell.
Creación de un grupo de recursos
Cree un grupo de recursos de Azure con New-AzResourceGroup. Un grupo de recursos es un contenedor lógico en el que se implementan y se administran los recursos de Azure.
El siguiente comando crea un grupo de recursos denominado myResourceGroup en la ubicación Oeste de EE. UU:
New-AzResourceGroup -Name myResourceGroup -Location WestUS
Creación de una instancia de API Management
Ahora que tiene un grupo de recursos, puede crear una instancia de servicio de API Management. Cree una mediante el comando New-AzApiManagement y proporcione un nombre de servicio y los detalles del editor. El nombre de servicio debe ser único en Azure.
En el ejemplo siguiente, se utiliza myapim para el nombre del servicio. Actualice el nombre a un valor único. Actualice también el nombre de la organización del editor de la API y la dirección de correo electrónico del administrador para recibir notificaciones.
De forma predeterminada, el comando crea la instancia en el nivel Desarrollador, una opción económica para evaluar Azure API Management. Este nivel no puede utilizarse en producción. Para obtener más información sobre los niveles de API Management, vea Comparación basada en características de los niveles de Azure API Management.
Sugerencia
Se trata de una acción de larga duración. Normalmente, se tarda entre 30 y 40 minutos en crear y activar una instancia del servicio API Management en este nivel.
New-AzApiManagement -Name "myapim" -ResourceGroupName "myResourceGroup" `
-Location "West US" -Organization "Contoso" -AdminEmail "admin@contoso.com"
Cuando el comando devuelva un resultado, ejecute Get-AzApiManagement para ver las propiedades del servicio Azure API Management. Después de la activación, el ProvisioningState es Correcto y la instancia tiene varias direcciones URL asociadas. Por ejemplo:
Get-AzApiManagement -Name "myapim" -ResourceGroupName "myResourceGroup"
Salida de ejemplo:
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
Una vez que la instancia de servicio de API Management esté en línea, estará listo para usarla. Comience con el tutorial Importación y publicación de la primera API.
Limpieza de recursos
Cuando ya no se necesiten, puede usar el comando Remove-AzResourceGroup para quitar el grupo de recursos y todos los recursos relacionados.
Remove-AzResourceGroup -Name myResourceGroup