Inicio rápido: Creación de una nueva instancia de Azure API Management mediante la CLI de Azure
SE APLICA A: Consumo | Desarrollador | Básico | Estándar | Premium
En este inicio rápido se describen los pasos que deben seguirse para crear una instancia de API Management mediante comandos de la CLI de Azure. Después de crear una instancia, puede usar la CLI de Azure para tareas 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
Use el entorno de Bash en Azure Cloud Shell. Para más información, consulte Inicio rápido para Bash en Azure Cloud Shell.
Si prefiere ejecutar comandos de referencia de la CLI localmente, instale la CLI de Azure. Si utiliza Windows o macOS, considere la posibilidad de ejecutar la CLI de Azure en un contenedor Docker. Para más información, vea Ejecución de la CLI de Azure en un contenedor de Docker.
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.
En caso de que 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 una instancia de API Management
Ahora que tiene un grupo de recursos, puede crear una instancia 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
Puede usar el comando az group delete para eliminar el grupo de recursos y la instancia de servicio de API Management cuando ya no los necesite.
az group delete --name myResourceGroup