Nota:
El acceso a esta página requiere autorización. Puede intentar iniciar sesión o cambiar directorios.
El acceso a esta página requiere autorización. Puede intentar cambiar los directorios.
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 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
Use el entorno de Bash en Azure Cloud Shell. Para más información, consulte Introducción a Azure Cloud Shell.
Si prefieres ejecutar comandos de referencia CLI localmente, instala la CLI de Azure. Si estás utilizando Windows o macOS, considera ejecutar Azure CLI en un contenedor Docker. Para obtener más información, consulte Cómo ejecutar el Azure CLI en un contenedor de Docker.
Si estás utilizando una instalación local, inicia sesión en Azure CLI utilizando el comando az login. Para finalizar el proceso de autenticación, siga los pasos que se muestran en el terminal. Para ver otras opciones de inicio de sesión, consulte Autenticación en Azure mediante la CLI de Azure.
Cuando se le solicite, instale la extensión de la CLI de Azure en el primer uso. Para obtener más información sobre las extensiones, consulte Uso y administración de extensiones con la CLI de Azure.
Ejecute az version para ver la versión y las bibliotecas dependientes que están instaladas. Para actualizar 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, la versión más reciente ya está instalada.
Creación de 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 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. Actualice también el nombre de la organización del publicador de API y para recibir notificaciones, actualice la dirección de correo electrónico.
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
Puede tardar entre 30 y 40 minutos en crear y activar un servicio de 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