Creación de su primera función en Azure PortalCreate your first function in the Azure portal

Azure Functions permite ejecutar el código en un entorno sin servidor sin necesidad de crear una máquina virtual o publicar una aplicación web.Azure Functions lets you execute your code in a serverless environment without having to first create a VM or publish a web application. En este artículo, aprenderá a usar Functions para crear una función "Hola mundo" en Azure Portal.In this article, learn how to use Functions to create a "hello world" function in the Azure portal.

Creación de una aplicación de función en Azure Portal

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

Nota

Los desarrolladores de C# deben considerar la creación de la primera función en Visual Studio 2019 en lugar de en el portal.C# developers should consider creating your first function in Visual Studio 2019 instead of in the portal.

Inicio de sesión en AzureLog in to Azure

Inicie sesión en Azure Portal en https://portal.azure.com con su cuenta de Azure.Sign in to the Azure portal at https://portal.azure.com with your Azure account.

Creación de una aplicación de funciónCreate a function app

Debe tener una Function App para hospedar la ejecución de las funciones.You must have a function app to host the execution of your functions. Una Function App permite agrupar funciones como una unidad lógica para facilitar la administración, la implementación y el uso compartido de recursos.A function app lets you group functions as a logic unit for easier management, deployment, and sharing of resources.

  1. Seleccione el botón Crear un recurso de la esquina superior izquierda de Azure Portal y, después, Proceso > Function App.Select the Create a resource button found on the upper left-hand corner of the Azure portal, then select Compute > Function App.

    Creación de una aplicación de función en Azure Portal

  2. Use la configuración de Function App especificada en la tabla debajo de la imagen.Use the function app settings as specified in the table below the image.

    Definir nueva configuración de Function App

    ConfiguraciónSetting Valor sugeridoSuggested value DESCRIPCIÓNDescription
    Nombre de la aplicaciónApp 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, 0-9 y -.Valid characters are a-z, 0-9, and -.
    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.
    SISTEMA OPERATIVOOS WindowsWindows Las opciones de idioma disponibles dependen del sistema operativo de la aplicación de función.The language options available depend on the OS of the function app. Por ejemplo, Python requiere Linux.For example, Python requires Linux.
    Plan de hospedajeHosting plan Plan de consumoConsumption plan 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 only pay 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.
    UbicaciónLocation Europa occidentalWest Europe 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.
    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 para funciones de C# y F#.Choose .NET for C# and F# functions.
    StorageStorage 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 may 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 meets the storage account requirements.
    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, puede cambiar el valor de Nuevo nombre de recurso o elegir otro valor en Ubicación en la ubicación geográfica de Azure donde desee almacenar los datos.By expanding this setting, you can change the New resource name or choose a different Location in an Azure geography where you want to store your data.
  3. Seleccione Crear para aprovisionar e implementar la aplicación de función.Select Create to provision and deploy the function app.

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

    Definir nueva configuración de Function App

  5. 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.

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

Crear una función desencadenada por HTTPCreate an HTTP triggered function

  1. Expanda la nueva aplicación de función, después, seleccione el botón + situado junto a Functions, elija En el portal y seleccione Continuar.Expand your new function app, then select the + button next to Functions, choose In-portal, and select Continue.

    Inicio rápido de Functions para elegir una plataforma.

  2. Elija WebHook y API y, a continuación, seleccione Crear.Choose WebHook + API and then select Create.

    Inicio rápido de funciones en Azure Portal.

Se crea una función mediante una plantilla específica del idioma para una función desencadenada por HTTP.A function is created using a language-specific template for an HTTP triggered function.

Ahora, puede ejecutar la nueva función mediante el envío de una solicitud HTTP.Now, you can run the new function by sending an HTTP request.

Prueba de la funciónTest the function

  1. En la nueva función, haga clic en </> Obtener la dirección URL de la función en la parte superior derecha, seleccione default (Function key) y, después, haga clic en Copiar.In your new function, click </> Get function URL at the top right, select default (Function key), and then click Copy.

    Copiar la dirección URL de la función desde Azure Portal

  2. Pegue la dirección URL de la función en la barra de direcciones de su explorador.Paste the function URL into your browser's address bar. Anexe el valor &name=<yourname> de la cadena de consulta al final de esta dirección URL y presione la tecla Enter en el teclado para ejecutar la solicitud.Add the query string value &name=<yourname> to the end of this URL and press the Enter key on your keyboard to execute the request. Debería ver la respuesta devuelta por la función mostrada en el explorador.You should see the response returned by the function displayed in the browser.

    El ejemplo siguiente muestra la respuesta en el explorador:The following example shows the response in the browser:

    Respuesta de la función en el explorador.

    La dirección URL de la solicitud incluye una clave que, de forma predeterminada, es necesaria para tener acceso a la función a través de HTTP.The request URL includes a key that is required, by default, to access your function over HTTP.

  3. Cuando se ejecuta la función, se escribe información de seguimiento en los registros.When your function runs, trace information is written to the logs. Para ver el resultado del seguimiento de la ejecución anterior, vuelva a la función en el portal y haga clic en la flecha que encontrará en la parte inferior de la pantalla para expandir Registros.To see the trace output from the previous execution, return to your function in the portal and click the arrow at the bottom of the screen to expand the Logs.

    Visor de registros de las funciones en Azure Portal.

Limpieza de recursosClean up resources

Otras guías de inicio rápido de esta colección se basan en los valores de esta.Other quick starts in this collection build upon this quick start. 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 quick starts, tutorials, or with any of the services you have created in this quick start, 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 refers 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 se elimina el grupo.They are 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 are 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 aplicación de función con una función simple desencadenada por HTTP.You've created a function app with a simple HTTP triggered function.

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

Para más información, consulte Enlaces HTTP de Azure Functions.For more information, see Azure Functions HTTP bindings.