Compartir a través de


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

  • 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

Pasos siguientes