Compartir a través de

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 nueva instancia de API Management mediante cmdlets de Azure PowerShell. Después de crear una instancia, puede usar cmdlets de Azure PowerShell para acciones de administración comunes, como importar API en la instancia de API Management.

Azure API Management ayuda a las organizaciones a publicar API en desarrolladores externos, asociados e internos para desbloquear 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 cuenta de Azure, cree una cuenta gratuita antes de comenzar.

Prerrequisitos

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 comando siguiente 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 del servicio API Management. Cree uno mediante New-AzApiManagement y proporcione un nombre de servicio y detalles del publicador. El nombre del servicio debe ser único en Azure.

En el ejemplo siguiente, myapim se usa para el nombre del servicio. Actualice el nombre a un valor único. Además, actualice el nombre de la organización del publicador de 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 más información sobre los niveles de API Management, consulte Comparación basada en características de los niveles de Azure API Management.

Sugerencia

Este comando puede tardar entre 30 y 40 minutos en crear y activar un servicio API Management en este nivel.

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

Cuando el comando vuelva, 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"

Ejemplo de resultado:

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

Una vez implementada la instancia del servicio API Management, está listo para usarlo. Comience con el tutorial Importación y publicación de la primera API.

Limpieza de recursos

Cuando ya no sea necesario, puede usar el comando Remove-AzResourceGroup para quitar el grupo de recursos y todos los recursos relacionados.

Remove-AzResourceGroup -Name myResourceGroup

Pasos siguientes

Importación y publicación de la primera API

  • Last updated on