Crear una función desencadenada por Azure Queue StorageCreate a function triggered by Azure Queue storage

Obtenga información sobre cómo crear una función que se desencadena cuando se envían mensajes a una cola de Azure Storage.Learn how to create a function that is triggered when messages are submitted to an Azure Storage queue.

Requisitos previosPrerequisites

  • Suscripción a Azure.An Azure subscription. Si no tiene una, cree una cuenta gratuita antes de empezar.If you don't have one, create a free account before you begin.

Creación de una Function App de AzureCreate an Azure Function app

  1. En el menú de Azure Portal o en la página Principal, seleccione Crear un recurso.From the Azure portal menu or the Home page, select Create a resource.

  2. En la página Nuevo, seleccione Compute > Function App.In the New page, select Compute > Function App.

  3. En la página Básico, utilice la configuración de la aplicación de funciones que se especifica en la tabla siguiente.On the Basics page, use the function app settings as specified in the following table.

    ConfiguraciónSetting Valor sugeridoSuggested value DescripciónDescription
    SuscripciónSubscription Su suscripciónYour subscription Suscripción en la que se creará esta nueva aplicación de función.The subscription under which this new function app is created.
    Grupo de recursosResource Group myResourceGroupmyResourceGroup Nombre para el nuevo grupo de recursos en el que se va a crear la Function App.Name for the new resource group in which to create your function app.
    Nombre de la aplicación de funciónFunction App name Nombre único globalmenteGlobally unique name Nombre que identifica la nueva Function App.Name that identifies your new function app. Los caracteres válidos son a-z (no distingue mayúsculas de minúsculas), 0-9 y -.Valid characters are a-z (case insensitive), 0-9, and -.
    PublicarPublish CódigoCode Opción para publicar archivos de código o un contenedor de Docker.Option to publish code files or a Docker container.
    Pila en tiempo de ejecuciónRuntime stack Lenguaje preferidoPreferred language Elija un tiempo de ejecución que admita su lenguaje de programación de funciones preferido.Choose a runtime that supports your favorite function programming language. Elija .NET Core para las funciones de C# y F#.Choose .NET Core for C# and F# functions.
    VersiónVersion Número de la versiónVersion number Elija la versión del entorno de ejecución instalado.Choose the version of your installed runtime.
    RegiónRegion Región preferidaPreferred region Elija una región cerca de usted o cerca de otros servicios a los que tendrán acceso las funciones.Choose a region near you or near other services your functions access.

    Aspectos básicos

  4. Seleccione Siguiente: Hospedaje.Select Next : Hosting. En la página Hospedaje, escriba la siguiente configuración.On the Hosting page, enter the following settings.

    ConfiguraciónSetting Valor sugeridoSuggested value DescripciónDescription
    Cuenta de almacenamientoStorage account Nombre único globalmenteGlobally unique name Cree una cuenta de almacenamiento que use la aplicación de función.Create a storage account used by your function app. Los nombres de las cuentas de almacenamiento deben tener entre 3 y 24 caracteres y solo pueden incluir números y letras en minúscula.Storage account names must be between 3 and 24 characters in length and can contain numbers and lowercase letters only. También puede usar una cuenta existente que debe cumplir los requisitos de la cuenta de almacenamiento.You can also use an existing account, which must meet the storage account requirements.
    Sistema operativoOperating system Sistema operativo preferidoPreferred operating system Se preselecciona un sistema operativo en función de la selección de pila en tiempo de ejecución, pero puede cambiar esta configuración si es necesario.An operating system is pre-selected for you based on your runtime stack selection, but you can change the setting if necessary.
    PlanPlan Consumo (sin servidor)Consumption (Serverless) Plan de hospedaje que define cómo se asignan los recursos a la Function App.Hosting plan that defines how resources are allocated to your function app. En el plan de Consumo predeterminado, los recursos se agregan dinámicamente según lo requieran sus funciones.In the default Consumption plan, resources are added dynamically as required by your functions. En este hospedaje sin servidor, solo paga por el tiempo durante el cual se ejecutan las funciones.In this serverless hosting, you pay only for the time your functions run. Si ejecuta un plan de App Service, debe administrar el escalado de la aplicación de función.When you run in an App Service plan, you must manage the scaling of your function app.

    Hosting

  5. Seleccione Siguiente: Supervisión.Select Next : Monitoring. En la página Supervisión, escriba la siguiente configuración.On the Monitoring page, enter the following settings.

    ConfiguraciónSetting Valor sugeridoSuggested value DescripciónDescription
    Application InsightsApplication Insights Valor predeterminadoDefault Crea un recurso de Application Insights con el mismo nombre de aplicación en la región más cercana que lo admita.Creates an Application Insights resource of the same App name in the nearest supported region. Si expande esta configuración o selecciona Crear nuevo puede cambiar el nombre de Application Insights o elegir otra región de una geografía de Azure en la que quiera almacenar los datos.By expanding this setting or selecting Create new, you can change the Application Insights name or choose a different region in an Azure geography where you want to store your data.

    Supervisión

  6. Seleccione Revisar y crear para revisar las selecciones de configuración de la aplicación.Select Review + create to review the app configuration selections.

  7. En la página Revisar y crear, revise la configuración y, a continuación, seleccione Crear para aprovisionar e implementar la aplicación de función.On the Review + create page, review your settings, and then select Create to provision and deploy the function app.

  8. Seleccione el icono Notificaciones de la esquina superior derecha del portal y observe el mensaje Implementación correcta.Select the Notifications icon in the upper-right corner of the portal and watch for the Deployment succeeded message.

  9. Seleccione Ir al recurso para ver la nueva aplicación de función.Select Go to resource to view your new function app. También puede seleccionar Anclar al panel.You can also select Pin to dashboard. Dicho anclaje facilita la vuelta a este recurso de aplicación de función desde el panel.Pinning makes it easier to return to this function app resource from your dashboard.

    Notificación de implementación

La aplicación de funciones se creó correctamente.

Después, cree una función en la nueva Function App.Next, you create a function in the new function app.

Creación de una función desencadenada por el servicio QueueCreate a Queue triggered function

  1. Seleccione Functions y, a continuación, + Agregar para agregar una función nueva.Select Functions, and then select + Add to add a new function.

    Elija una plantilla de función en Azure Portal.

  2. Elija la plantilla Azure Queue Storage trigger (Desencadenador de Azure Queue Storage).Choose the Azure Queue Storage trigger template.

  3. Utilice la configuración que se especifica en la tabla debajo de la imagen.Use the settings as specified in the table below the image.

    Asignar un nombre y configurar la función desencadenada de Queue Storage

    ConfiguraciónSetting Valor sugeridoSuggested value DescripciónDescription
    NombreName Único en la Function AppUnique in your function app Nombre de la función desencadenada por la cola.Name of this queue triggered function.
    Nombre de la colaQueue name myqueue-itemsmyqueue-items Nombre de la cola a la que se va a conectar en la cuenta de almacenamiento.Name of the queue to connect to in your Storage account.
    Conexión de la cuenta de almacenamientoStorage account connection AzureWebJobsStorageAzureWebJobsStorage Puede usar la conexión de cuenta de almacenamiento que ya usa la Function App o crear una nueva.You can use the storage account connection already being used by your function app, or create a new one.
  4. Seleccione Crear función para crear la función.Select Create Function to create your function.

    Cree la función desencadenada por Queue Storage.

Después, conéctese a su cuenta de Azure Storage y cree la cola de almacenamiento myqueue-items.Next, you connect to your Azure storage account and create the myqueue-items storage queue.

Creación de la colaCreate the queue

  1. En la función, en la página Información general, seleccione el grupo de recursos.In your function, on the Overview page, select your resource group.

    Seleccione el grupo de recursos de Azure Portal.

  2. Busque y seleccione la cuenta de almacenamiento del grupo de recursos.Find and select your resource group's storage account.

    Acceda a la cuenta de almacenamiento.

  3. Elija Colas y, a continuación, elija + Cola.Choose Queues, and then choose + Queue.

    Agregue una cola a la cuenta de almacenamiento en Azure Portal.

  4. En el campo Nombre, escriba myqueue-items y seleccione Crear.In the Name field, type myqueue-items, and then select Create.

    Asigne un nombre al contenedor de Queue Storage.

Ahora que tiene una cola de almacenamiento, puede probar la función. Para ello, agregue un mensaje a la cola.Now that you have a storage queue, you can test the function by adding a message to the queue.

Prueba de la funciónTest the function

  1. De nuevo en Azure Portal, vaya a la función. Expanda Registros en la parte inferior de la página y asegúrese de que el streaming de registros no está en pausa.Back in the Azure portal, browse to your function expand the Logs at the bottom of the page and make sure that log streaming isn't paused.

    Expanda el inicio de sesión en Azure Portal .

  2. En una ventana del explorador independiente, vaya al grupo de recursos de Azure Portal y seleccione la cuenta de almacenamiento.In a separate browser window, go to your resource group in the Azure portal, and select the storage account.

  3. Seleccione Colas y, a continuación, el contenedor myqueue-items.Select Queues, and then select the myqueue-items container.

    Vaya a la cola myqueue-items en Azure Portal.

  4. Seleccione Agregar mensaje y escriba "¡Hola mundo!".Select Add message, and type "Hello World!" en Texto del mensaje.in Message text. Seleccione Aceptar.Select OK.

    Vaya a la cola myqueue-items en Azure Portal.

  5. Espere unos segundos y, después, vuelva a los registros de función para comprobar que se ha leído el mensaje nuevo de la cola.Wait for a few seconds, then go back to your function logs and verify that the new message has been read from the queue.

    Vea el mensaje en los registros.

  6. En Storage Queue, seleccione Actualizar y verifique que el mensaje se haya procesado y ya no esté en la cola.Back in your storage queue, select Refresh and verify that the message has been processed and is no longer in the queue.

Limpieza de recursosClean up resources

Otras guías de inicio rápido de esta colección se basan en los valores de esta.Other quickstarts in this collection build upon this quickstart. Si tiene previsto trabajar con las siguientes guías de inicio rápido, tutoriales o con cualquiera de los servicios que haya creado en esta guía de inicio rápido, no elimine los recursos.If you plan to work with subsequent quickstarts, tutorials, or with any of the services you have created in this quickstart, do not clean up the resources.

En Azure, los recursos son aplicaciones de función, funciones o cuentas de almacenamiento, entre otros.Resources in Azure refer to function apps, functions, storage accounts, and so forth. Se agrupan en grupos de recursos y se puede eliminar todo el contenido de un grupo si este se elimina.They're grouped into resource groups, and you can delete everything in a group by deleting the group.

Ha creado recursos para completar estas guías de inicio rápido.You created resources to complete these quickstarts. Se le pueden facturar por estos recursos, dependiendo del estado de la cuentade los y precios de los servicios.You may be billed for these resources, depending on your account status and service pricing. Si ya no necesita los recursos, aquí se indica cómo eliminarlos:If you don't need the resources anymore, here's how to delete them:

  1. En Azure Portal, vaya a la página Grupo de recursos.In the Azure portal, go to the Resource group page.

    Para llegar a esa página desde la página de aplicación de función, seleccione la pestaña Información general y, después, seleccione el vínculo situado bajo Grupo de recursos.To get to that page from the function app page, select the Overview tab and then select the link under Resource group.

    Seleccione el grupo de recursos que se va a eliminar de la página de la aplicación de función.

    Para llegar a esa página desde el panel, seleccione Grupos de recursos y, después, seleccione el grupo que ha utilizado para esta guía de inicio rápido.To get to that page from the dashboard, select Resource groups, and then select the resource group that you used for this quickstart.

  2. En la página Grupo de recursos, revise la lista de recursos incluidos y compruebe que son los que desea eliminar.In the Resource group page, review the list of included resources, and verify that they're the ones you want to delete.

  3. Seleccione Eliminar grupo de recursos y siga las instrucciones.Select Delete resource group, and follow the instructions.

    El proceso de eliminación tardará un par de minutos.Deletion may take a couple of minutes. Cuando termine, aparece una notificación durante unos segundos.When it's done, a notification appears for a few seconds. También puede seleccionar el icono de campana en la parte superior de la página para ver la notificación.You can also select the bell icon at the top of the page to view the notification.

Pasos siguientesNext steps

Ha creado una función que se ejecuta cuando se agrega un mensaje a una cola de almacenamiento.You have created a function that runs when a message is added to a storage queue. Para obtener más información sobre los desencadenadores de Queue Storage, vea Enlaces de colas de Storage en Azure Functions.For more information about Queue storage triggers, see Azure Functions Storage queue bindings.

Ahora que ha creado su primera función, vamos a agregar un enlace de salida a la función que escribe un mensaje en otra cola.Now that you have a created your first function, let's add an output binding to the function that writes a message back to another queue.