Inicio rápido: Creación de una instancia de servicio de Azure API Management mediante la CLI de Azure
Azure API Management (APIM) ayuda a las organizaciones a publicar API para desarrolladores externos, asociados e internos a fin de 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. APIM le permite crear y administrar modernas puertas de enlace de API para los servicios back-end existentes hospedados en cualquier lugar. Para más información, consulte la introducción.
Este inicio rápido describe los pasos que deben seguirse para crear una instancia de API Management mediante los comandos az apim de la CLI de Azure.
Si no tiene una suscripción a Azure, cree una cuenta gratuita antes de empezar.
Requisitos previos
Use el entorno de Bash en Azure Cloud Shell.
Si lo prefiere, instale la CLI de Azure para ejecutar sus comandos de referencia.
Si usa una instalación local, inicie sesión en la CLI de Azure mediante el comando az login. Siga los pasos que se muestran en el terminal para completar el proceso de autenticación. Para ver otras opciones de inicio de sesión, consulte Inicio de sesión con la CLI de Azure.
Cuando se le solicite, instale las extensiones de la CLI de Azure la primera vez que la use. Para más información sobre las extensiones, consulte Uso de extensiones con la CLI de Azure.
Ejecute az version para buscar cuál es la versión y las bibliotecas dependientes que están instaladas. Para realizar la actualización a la versión más reciente, ejecute az upgrade.
- En este artículo se necesita la versión 2.11.1 de la CLI de Azure, o cualquier versión posterior. Si usa Azure Cloud Shell, ya está instalada la versión más reciente.
Crear un grupo de recursos
Las instancias de Azure API Management, al igual que otros recursos de Azure, se deben implementar en un grupo de recursos. Los grupos de recursos le permiten organizar y administrar los recursos relacionados de Azure.
En primer lugar, cree un grupo de recursos denominado myResourceGroup en la ubicación Centro de EE. UU. con el comando az group create siguiente:
az group create --name myResourceGroup --location centralus
Creación de un nuevo servicio
Ahora que tiene un grupo de recursos, puede crear una instancia de servicio de API Management. Cree una mediante el comando az apim create 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 para recibir notificaciones.
az apim create --name myapim --resource-group myResourceGroup \
--publisher-name Contoso --publisher-email admin@contoso.com \
--no-wait
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 el escalado de los niveles de API Management, consulte Actualización y escalado.
Sugerencia
Normalmente, se tarda entre 30 y 40 minutos en crear y activar una instancia del servicio API Management en este nivel. El comando anterior usa la opción --no-wait para que el comando se devuelva inmediatamente mientras se crea el servicio.
Compruebe el estado de la implementación mediante la ejecución del comando az apim show:
az apim show --name myapim --resource-group myResourceGroup --output table
Inicialmente, la salida será parecida a la siguiente, que muestra el estado Activating:
NAME RESOURCE GROUP LOCATION GATEWAY ADDR PUBLIC IP PRIVATE IP STATUS TIER UNITS
----------- ---------------- ---------- -------------- ----------- ------------ ---------- --------- -------
myapim myResourceGroup Central US Activating Developer 1
Después de la activación, el estado es Online y la instancia de servicio tiene una dirección de puerta de enlace y una dirección IP pública. Por ahora, estas direcciones no exponen ningún contenido. Por ejemplo: ;;
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
Cuando la instancia de servicio de API Management está en línea, está listo para usarla. Comience con el tutorial Importación y publicación de la primera API.
Limpieza de recursos
Cuando ya no lo necesite, puede usar el comando az group delete para eliminar el grupo de recursos y la instancia de servicio de API Management.
az group delete --name myResourceGroup