Inicio rápido: Creación de una conexión de servicio en Azure Functions con la CLI de Azure

En este inicio rápido se muestra cómo conectar Azure Functions a otros recursos en la nube mediante la CLI de Azure y un conector de servicio. Service Connector permite conectar con rapidez los servicios de proceso a los servicios en la nube, a la vez que administra la autenticación y la configuración de red de la conexión.

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.

• Para realizar este inicio rápido es necesaria la versión 2.30.0 o posterior de la CLI de Azure. Si usa Azure Cloud Shell, ya está instalada la versión más reciente.
• En este tutorial se supone que ya tiene una instancia de Azure Functions. Si no es así, cree una.
• En este tutorial se supone que ya tiene una cuenta de Azure Storage. Cree una cuenta de Azure Storage si no tiene una.

Configuración inicial

1. Si usa Service Connector por primera vez, empiece ejecutando el comando az provider register para registrar el proveedor de recursos de Service Connector.

   az provider register -n Microsoft.ServiceLinker
   

   Sugerencia

   Es posible comprobar si el proveedor de recursos ya se ha registrado ejecutando el comando az provider show -n "Microsoft.ServiceLinker" --query registrationState. Si la salida fuera Registered, el conector de servicio ya se habrá registrado.

2. Opcionalmente, use el comando az functionapp connection list-support-types de la CLI de Azure para obtener una lista de los servicios de destino que admite la aplicación de funciones.

   az functionapp connection list-support-types --output table
   

Creación de una conexión de servicio

Uso de una identidad administrada

Importante

El uso de una identidad administrada requiere que tenga el permiso para la asignación de roles de Azure AD. Si no tiene el permiso, se producirá un error en la creación de la conexión. Puede pedir al propietario de la suscripción el permiso o usar una clave de acceso para crear la conexión.

Use el comando az functionapp connection de la CLI de Azure para crear una conexión de servicio a una instancia de Blob Storage con una identidad administrada asignada por el sistema, proporcionando la siguiente información:

• Nombre del grupo de recursos del servicio de proceso de origen: el nombre del grupo de recursos de la aplicación de funciones.
• Nombre de la aplicación de funciones: el nombre de la aplicación de funciones que se conecta al servicio de destino.
• Nombre del grupo de recursos del servicio de destino: el nombre del grupo de recursos de la aplicación del almacenamiento de blobs.
• Nombre de cuenta de almacenamiento: el nombre de la cuenta de Blob Storage.

az functionapp connection create storage-blob --system-identity

Nota:

Si no tiene una instancia de Blob Storage, puede ejecutar az functionapp connection create storage-blob --new --system-identity para aprovisionar una nueva y conectarse directamente a la aplicación de funciones.

Uso de una clave de acceso

Advertencia

Microsoft recomienda usar el flujo de autenticación más seguro disponible. El flujo de autenticación que se describe en este procedimiento requiere un alto grado de confianza en la aplicación y conlleva riesgos que no están presentes en otros flujos. Solo debe usar este flujo cuando otros flujos más seguros, como las identidades administradas, no sean viables.

Use el comando az functionapp connection create de la CLI de Azure para crear una conexión de servicio a Azure Blob Storage con una clave de acceso, proporcionando la siguiente información:

• Nombre del grupo de recursos del servicio de proceso de origen: el nombre del grupo de recursos de la aplicación de funciones.
• Nombre de la aplicación de funciones: el nombre de la aplicación de funciones que se conecta al servicio de destino.
• Nombre del grupo de recursos del servicio de destino: el nombre del grupo de recursos de la aplicación del almacenamiento de blobs.
• Nombre de cuenta de almacenamiento: el nombre de la cuenta de Blob Storage.

az functionapp connection create storage-blob --secret

Nota:

Si no tiene una instancia de Blob Storage, puede ejecutar az functionapp connection create storage-blob --new --secret para aprovisionar una nueva y conectarse directamente a la aplicación de funciones.

Ver conexiones

Use el comando az functionapp connection list de la CLI de Azure para mostrar una conexión a la aplicación de funciones, proporcionando la siguiente información:

• Nombre del grupo de recursos del servicio de proceso de origen: el nombre del grupo de recursos de la aplicación de funciones.
• Nombre de la aplicación de funciones: el nombre de la aplicación de funciones que se conecta al servicio de destino.

az functionapp connection list -g "<your-function-app-resource-group>" -n "<your-function-app-name>" --output table

Pasos siguientes

Complete los siguientes tutoriales para empezar a crear su propia aplicación de funciones con el conector de servicio.

Tutorial: Función de Python con Azure Queue Storage como desencadenador

Tutorial: Función de Python con Azure Blob Storage como entrada

Tutorial: Función de Python con Azure Table Storage como salida