Compartir a través de

Tutorial: Activar Azure Functions en contenedores de blobs usando una suscripción de eventos

Las versiones anteriores del desencadenador de Azure Functions Blob Storage sondean el contenedor de almacenamiento para ver los cambios. En su lugar, las versiones más recientes de la extensión blob Storage (5.x+) usan una suscripción de eventos de Event Grid en el contenedor. Esta suscripción a eventos reduce la latencia desencadenando la función al instante a medida que se producen cambios en el contenedor suscrito.

En este artículo se muestra cómo crear una función que se ejecute en función de los eventos que se produzcan cuando se agregue un blob a un contenedor. Puede usar Visual Studio Code para el desarrollo local y validar el código antes de implementar el proyecto en Azure.

  • Cree una función desencadenada por Blob Storage basada en eventos en un nuevo proyecto.
  • Valide localmente en Visual Studio Code mediante el emulador de Azurite.
  • Cree un contenedor de Blob Storage en una nueva cuenta de almacenamiento en Azure.
  • Cree una aplicación de función en el plan de consumo flexible.
  • Cree una suscripción de eventos al nuevo contenedor de blobs.
  • Implemente y valide el código de función en Azure.

En este artículo se admite la versión 4 del modelo de programación de Node.js para Azure Functions.

En este artículo se admite la versión 2 del modelo de programación de Python para Azure Functions.

En este artículo se crea una aplicación de C# que se ejecuta en modo de trabajo aislado, que admite .NET 8.0.

Sugerencia

En este tutorial, se muestra cómo crear una aplicación que se ejecute en el Plan de consumo flexible. El plan de Consumo flexible solo admite la versión basada en eventos del desencadenador de Blob Storage.

Requisitos previos

Nota:

La extensión de Azure Storage para Visual Studio Code está en versión preliminar.

Creación de una función desencadenada de Blob

Al crear una función de desencadenador de Blob Storage mediante Visual Studio Code, también se crea un proyecto. Debe editar la función para consumir una suscripción de eventos como origen, en lugar de usar el contenedor de sondeo normal.

  1. En Visual Studio Code, presione F1 para abrir la paleta de comandos, escriba Azure Functions: Create Function... y seleccione Crear nuevo proyecto.

  2. En el área de trabajo del proyecto, seleccione una ubicación de directorio. Asegúrese de que crea una nueva carpeta o elige una carpeta vacía en la que ubicar el área de trabajo del proyecto.

    No elija una carpeta de proyecto que ya forme parte de un área de trabajo.

  3. Escriba la siguiente información cuando se le indique:

    Prompt Acción
    Seleccione un lenguaje Seleccione C#.
    Seleccione un entorno de ejecución .NET. Seleccione .NET 8.0 Isolated LTS.
    Seleccionar una plantilla para la primera función del proyecto Seleccione Azure Blob Storage trigger (using Event Grid).
    Proporcionar un nombre de función Escriba EventGridBlobTrigger.
    Especifique un espacio de nombres Escriba My.Functions.
    Seleccione la configuración en "local.settings.json" Seleccione Create new local app setting.
    Selección de la suscripción Seleccione la suscripción, si es necesario.
    Seleccione una cuenta de almacenamiento Use el emulador de Azurite para el almacenamiento local.
    La ruta de acceso dentro de la cuenta de almacenamiento que el desencadenador supervisará Acepte el valor predeterminado, samples-workitems.
    Seleccionar cómo desea abrir el proyecto Seleccione Open in current window.
    Prompt Acción
    Seleccione un lenguaje Seleccione Python.
    Seleccionar un modelo de programación de Python Seleccione Model V2.
    Seleccionar el intérprete de Python para crear un entorno virtual Seleccione el intérprete de Python que prefiera usar. Si no se muestra una opción, escriba la ruta de acceso completa al archivo binario de Python.
    Seleccionar una plantilla para la primera función del proyecto Seleccione Blob trigger. (La plantilla basada en eventos aún no está disponible).
    Proporcionar un nombre de función Escriba EventGridBlobTrigger.
    La ruta de acceso dentro de la cuenta de almacenamiento que el desencadenador supervisará Acepte el valor predeterminado, samples-workitems.
    Seleccione la configuración en "local.settings.json" Seleccione Create new local app setting.
    Selección de la suscripción Seleccione la suscripción, si es necesario.
    Seleccione una cuenta de almacenamiento Use el emulador de Azurite para el almacenamiento local.
    Seleccionar cómo desea abrir el proyecto Seleccione Open in current window.
    Prompt Acción
    Seleccione un lenguaje Seleccione Java.
    Seleccione una versión de Java Seleccione Java 11 o Java 8, la versión de Java en la que se ejecutan las funciones en Azure y que ha comprobado localmente.
    Proporcione un id. de grupo Seleccione com.function.
    Proporcione un id. de artefacto Seleccione EventGridBlobTrigger (o el valor predeterminado).
    Proporcione una versión Seleccione 1.0-SNAPSHOT.
    Proporcione un nombre de paquete Seleccione com.function.
    Proporcione un nombre de aplicación Acepte el nombre generado que empieza por EventGridBlobTrigger.
    Seleccione la herramienta de compilación para el proyecto de Java Seleccione Maven.
    Seleccionar cómo desea abrir el proyecto Seleccione Open in current window.

    Se crea automáticamente una función desencadenada por HTTP (HttpExample). Sin embargo, no usará esta función y debe crear una nueva.

    Prompt Acción
    Seleccionar un lenguaje para el proyecto de funciones Seleccione TypeScript.
    Selección de un modelo de programación de TypeScript Seleccione Model V4.
    Seleccionar una plantilla para la primera función del proyecto Seleccione Azure Blob Storage trigger (using Event Grid).
    Proporcionar un nombre de función Escriba EventGridBlobTrigger.
    Seleccione la configuración en "local.settings.json" Seleccione Create new local app setting.
    Selección de la suscripción Seleccione la suscripción, si es necesario.
    Seleccione una cuenta de almacenamiento Use el emulador de Azurite para el almacenamiento local.
    La ruta de acceso dentro de la cuenta de almacenamiento que el desencadenador supervisará Acepte el valor predeterminado, samples-workitems.
    Seleccionar cómo desea abrir el proyecto Seleccione Open in current window.
    Prompt Acción
    Seleccionar un lenguaje para el proyecto de funciones Seleccione JavaScript.
    Selección de un modelo de programación de JavaScript Seleccione Model V4.
    Seleccionar una plantilla para la primera función del proyecto Seleccione Azure Blob Storage trigger (using Event Grid).
    Proporcionar un nombre de función Escriba eventGridBlobTrigger.
    Seleccione la configuración en "local.settings.json" Seleccione Create new local app setting.
    Selección de la suscripción Seleccione la suscripción, si es necesario.
    Seleccione una cuenta de almacenamiento Use el emulador de Azurite para el almacenamiento local.
    La ruta de acceso dentro de la cuenta de almacenamiento que el desencadenador supervisará Acepte el valor predeterminado, samples-workitems.
    Seleccionar cómo desea abrir el proyecto Seleccione Open in current window.
    Prompt Acción
    Seleccionar un lenguaje para el proyecto de funciones Seleccione PowerShell.
    Seleccionar una plantilla para la primera función del proyecto Seleccione Azure Blob Storage trigger (using Event Grid).
    Proporcionar un nombre de función Escriba EventGridBlobTrigger.
    Seleccione la configuración en "local.settings.json" Seleccione Create new local app setting.
    Selección de la suscripción Seleccione la suscripción, si es necesario.
    Seleccione una cuenta de almacenamiento Use el emulador de Azurite para el almacenamiento local.
    La ruta de acceso dentro de la cuenta de almacenamiento que el desencadenador supervisará Acepte el valor predeterminado, samples-workitems.
    Seleccionar cómo desea abrir el proyecto Seleccione Open in current window.

  1. En la paleta de comandos, escriba Azure Functions: Create Function... y seleccione EventGridBlobTrigger. Si no ve esta plantilla, seleccione primero filtro Cambiar plantilla>Todas.

  2. Escriba la siguiente información cuando se le indique:

    Prompt Acción
    Proporcione un nombre de paquete Seleccione com.function.
    Proporcionar un nombre de función Escriba EventGridBlobTrigger.
    Seleccione la configuración en "local.settings.json" Seleccione Create new local app setting.
    Selección de la suscripción Seleccione su suscripción.
    Seleccione una cuenta de almacenamiento Use el emulador de Azurite para el almacenamiento local.
    La ruta de acceso dentro de la cuenta de almacenamiento que el desencadenador supervisará Acepte el valor predeterminado, samples-workitems.

Ahora tiene una función que se puede desencadenar mediante eventos en un contenedor de Blob Storage.

Actualización del origen del desencadenador

Debe cambiar el origen del desencadenador del origen del desencadenador de blobs predeterminado (sondeo de contenedor) a un origen de suscripción de eventos.

  1. Abra el archivo de proyecto function_app.py. Verá una definición de la función EventGridBlobTrigger con el decorador blob_trigger aplicado.

  2. Actualice el decorador agregando source = "EventGrid". La función debería tener ahora un aspecto similar al siguiente:

    @app.blob_trigger(arg_name="myblob", source="EventGrid", path="samples-workitems",
                           connection="<STORAGE_ACCOUNT>") 
def EventGridBlobTrigger(myblob: func.InputStream):
logging.info(f"Python blob trigger function processed blob"
            f"Name: {myblob.name}"
            f"Blob Size: {myblob.length} bytes")

    En esta definición, source = "EventGrid" indica que una suscripción de eventos al contenedor de blobs samples-workitems se utiliza como origen del evento que activa el disparador.

(Opcional) Revisión del código

Abra el archivo generado EventGridBlobTrigger.cs . Verá una definición de una EventGridBlobTrigger función similar a la siguiente:

[Function(nameof(EventGridBlobTriggerCSharp))]
public async Task Run([BlobTrigger("PathValue/{name}", Source = BlobTriggerSource.EventGrid, Connection = "ConnectionValue")] Stream stream, string name)
{
    using var blobStreamReader = new StreamReader(stream);
    var content = await blobStreamReader.ReadToEndAsync();
    _logger.LogInformation("C# Blob Trigger (using Event Grid) processed blob\n Name: {name} \n Data: {content}", name, content);
}

En esta definición, Source = BlobTriggerSource.EventGrid indica que una suscripción de eventos al contenedor de blobs (en el ejemplo PathValue) es el origen del evento que inicia el desencadenador.

Abra el archivo generado EventGridBlobTrigger.java . Verá una definición de una EventGridBlobTrigger función similar a la siguiente:

    @FunctionName("EventGridBlobTrigger")
    @StorageAccount("<STORAGE_ACCOUNT>")
    public void run(
        @BlobTrigger(name = "content", source = "EventGrid", path = "samples-workitems/{name}", dataType = "binary") byte[] content,
        @BindingName("name") String name,
        final ExecutionContext context
    ) {
        context.getLogger().info("Java Blob trigger function processed a blob. Name: " + name + "\n  Size: " + content.length + " Bytes");
    }

En esta definición, source = EventGrid indica que una suscripción de eventos al contenedor de blobs samples-workitems es el origen del evento que inicia el desencadenador.

En la carpeta EventGridBlobTrigger, abra el archivo function.json y busque una definición de enlace como esta con un type de blobTrigger y un source de EventGrid:

{
    "bindings": [
        {
            "name": "InputBlob",
            "type": "blobTrigger",
            "direction": "in",
            "path": "samples-workitems/{name}",
            "source": "EventGrid",
            "connection":""
        }
    ]
}

El path indica que el contenedor de blobs samples-workitems es el origen del evento que inicia el desencadenador.

Abra el archivo generado EventGridBlobTrigger.js . Verá una definición de una función similar a la siguiente:

const { app } = require('@azure/functions');

app.storageBlob('storageBlobTrigger1', {
    path: 'samples-workitems/{name}',
    connection: 'MyStorageAccountAppSetting',
    source: 'EventGrid',
    handler: (blob, context) => {
        context.log(
            `Storage blob function processed blob "${context.triggerMetadata.name}" with size ${blob.length} bytes`
        );
    },
});

En esta definición, un source de EventGrid indica que una suscripción de eventos al contenedor de blobs samples-workitems es el origen del evento que inicia el desencadenador.

Abra el archivo generado EventGridBlobTrigger.ts . Verá una definición de una función similar a la siguiente:

import { app, InvocationContext } from '@azure/functions';

export async function storageBlobTrigger1(blob: Buffer, context: InvocationContext): Promise<void> {
    context.log(
        `Storage blob function processed blob "${context.triggerMetadata.name}" with size ${blob.length} bytes`
    );
}

app.storageBlob('storageBlobTrigger1', {
    path: 'samples-workitems/{name}',
    connection: 'MyStorageAccountAppSetting',
    source: 'EventGrid',
    handler: storageBlobTrigger1,
});

En esta definición, un source de EventGrid indica que una suscripción de eventos al contenedor de blobs samples-workitems es el origen del evento que inicia el desencadenador.

Actualización de la extensión de Storage

Para usar el desencadenador de Blob Storage basado en Event Grid, necesita la versión 5.x o posterior de la extensión de Azure Functions Storage.

Para actualizar el proyecto a la versión de extensión necesaria, ejecute este dotnet add package comando en la ventana Terminal:

dotnet add package Microsoft.Azure.Functions.Worker.Extensions.Storage.Blobs

  1. Abra el archivo del host.json proyecto y revise el extensionBundle elemento .

  2. Si extensionBundle.version no es al menos 3.3.0, reemplace el extensionBundle elemento por esta versión:

    "extensionBundle": {
    "id": "Microsoft.Azure.Functions.ExtensionBundle",
    "version": "[4.0.0, 5.0.0)"
}

Preparación de la emulación del almacenamiento local

Visual Studio Code usa Azurite para emular los servicios de Azure Storage cuando se ejecutan localmente. Use Azurite para emular el servicio Azure Blob Storage durante el desarrollo y las pruebas locales.

  1. Si aún no lo ha hecho, instale la extensión Azurite v3 para Visual Studio Code.

  2. Compruebe que el archivo local.settings.json ha "UseDevelopmentStorage=true" establecido para AzureWebJobsStorage. Esta configuración indica a Core Tools que use Azurite en lugar de una conexión de cuenta de almacenamiento real cuando se ejecute localmente.

  3. Presione F1 para abrir la paleta de comandos, escriba Azurite: Start Blob Servicey presione ENTRAR. Esta acción inicia el emulador del servicio Azurite Blob Storage.

  4. Seleccione el icono de Azure en la barra actividad, expanda Área de trabajo>Cuentas de almacenamiento asociadas>Emulador local, haga clic con el botón derecho en Contenedores de blobs, seleccione Crear contenedor de blobs..., escriba el nombre samples-workitems y presione Entrar.

    Captura de pantalla que muestra cómo seleccionar Crear contenedor de blobs en la emulación local en Visual Studio Code.

  5. Expanda Ejemplos de contenedores>de blobs-workitems y seleccione Cargar archivos.....

    Captura de pantalla que muestra cómo seleccionar Cargar archivos en el contenedor samples-workitems en la emulación local en Visual Studio Code.

  6. Elija un archivo para cargarlo en el contenedor emulado localmente. La función procesa este archivo más adelante para comprobar y depurar el código de la función. Un archivo de texto puede funcionar mejor con el código de plantilla del desencadenador de blobs.

Ejecución local de la función

Con un archivo en almacenamiento emulado, puede ejecutar la función para simular un evento generado por una suscripción de Event Grid. La información de evento pasada al desencadenador depende del archivo que agregó al contenedor local.

  1. Establezca los puntos de interrupción y presione F5 para iniciar el proyecto para la depuración local. Azure Functions Core Tools debe ejecutarse en la ventana Terminal.

  2. De nuevo en el área de Azure, expanda Funciones> de proyecto local del >área de trabajo, haga clic con el botón derecho en la función y seleccione Ejecutar función ahora....

    Captura de pantalla que muestra cómo seleccionar el botón Ejecutar función ahora de la función en el área de trabajo del proyecto local en Visual Studio Code.

  3. En el cuadro de diálogo cuerpo de la solicitud, escriba samples-workitems/<TEST_FILE_NAME>, reemplazando <TEST_FILE_NAME> por el nombre del archivo que cargó en el emulador de almacenamiento local.

  4. Presione Introducir para ejecutar la función. El valor proporcionado es la ruta de acceso al blob en el emulador local. Esta cadena se pasa al desencadenador en la carga de solicitud, que simula la carga cuando una suscripción de eventos llama a la función para informar de que se agrega un blob al contenedor.

  5. Revise la salida de esta ejecución de función. Debería ver en la salida el nombre del archivo y su contenido registrado. Si establece puntos de interrupción, es posible que tenga que continuar con la ejecución.

Ahora que ha validado correctamente el código de la función de manera local, es el momento de publicar el proyecto en una nueva aplicación de funciones de Azure.

Preparación de la cuenta de Azure Storage

Las suscripciones de eventos a Azure Storage requieren una cuenta de almacenamiento de uso general v2. Puede usar la extensión de Azure Storage para Visual Studio Code para crear esta cuenta de almacenamiento.

  1. En Visual Studio Code, presione F1 para abrir la paleta de comandos y escriba Azure Storage: Create Storage Account.... Proporcione esta información cuando se le solicite:

    Prompt Acción
    Escriba el nombre de la nueva cuenta de almacenamiento Proporcione un nombre único global. Los nombres de cuenta de almacenamiento deben tener entre 3 y 24 caracteres de longitud con solo letras minúsculas y números. Para facilitar la identificación, use el mismo nombre para el grupo de recursos y el nombre de la aplicación de funciones.
    Seleccionar una ubicación para los nuevos recursos Para mejorar el rendimiento, elija una región cercana a la suya.

    La extensión crea una cuenta de almacenamiento de uso general v2 con el nombre que proporcione. El mismo nombre también se usa para el grupo de recursos que contiene la cuenta de almacenamiento. El desencadenador de Blob Storage basado en Event Grid requiere una cuenta de almacenamiento de uso general v2.

  2. Presione F1 de nuevo y, en la paleta de comandos, escriba Azure Storage: Create Blob Container.... Proporcione esta información cuando se le solicite:

    Prompt Acción
    Selección de un recurso Seleccione la cuenta de almacenamiento de uso general v2 que creó.
    Escriba un nombre para el nuevo contenedor de blobs Escriba samples-workitems, que es el nombre del contenedor al que se hace referencia en el proyecto de código.

La aplicación de funciones también necesita una cuenta de almacenamiento para ejecutarse. Para simplificar, en este tutorial se usa la misma cuenta de almacenamiento para el desencadenador de blobs y la aplicación de funciones. No obstante, en producción, es posible que quiera usar una cuenta de almacenamiento independiente con la aplicación de funciones. Para obtener más información, vea Consideraciones de almacenamiento de Azure Functions.

Crear la aplicación de función

Siga estos pasos para crear una aplicación de funciones en el plan de consumo flexible. Al hospedar la aplicación en un plan de consumo flexible, los desencadenadores de Blob Storage deben usar suscripciones de eventos.

  1. En la paleta de comandos, introduzca Azure Functions: Crear aplicación de funciones en Azure... (Avanzado).

  2. Siga las indicaciones y proporcione esta información:

    Prompt Número de selección
    Escriba un nombre único global para la nueva aplicación de funciones. En esta solicitud, escriba un nombre único global con el que identificar a la nueva aplicación de funciones y presione la tecla ENTRAR. Los siguientes son caracteres válidos para un nombre de aplicación de función: a-z, 0-9 y -.
    Selección de un plan de hospedaje Elija Consumo flexible, que es el plan de hospedaje recomendado para el hospedaje sin servidor.
    Seleccionar una ubicación para los nuevos recursos Seleccione una ubicación en una región próxima a usted o a otros servicios a los que accedan las funciones.
    Seleccione una pila en tiempo de ejecución Seleccione la versión de idioma que se ejecuta actualmente localmente.
    Selección de un tamaño de instancia Seleccione 512. Siempre puede cambiar la configuración de tamaño de instancia a un tamaño mayor más adelante.
    Escriba el número máximo de instancias. Seleccione el valor predeterminado de 100, que limita el escalado horizontal total de la aplicación. También puede elegir un valor diferente entre 40 y 1000.
    Seleccionar un grupo de recursos Seleccione Crear nuevo grupo de recursos y acepte el valor predeterminado o escriba otro nombre para el nuevo grupo que sea único en la suscripción.
    Selección del tipo de autenticación de recursos Seleccione Identidad administrada para que la aplicación se conecte a recursos remotos mediante la autenticación de Id. de Entra de Microsoft en lugar de usar secretos compartidos (cadenas de conexión y claves), que son menos seguros.
    Selección de una identidad asignada por el usuario Seleccione Crear nueva identidad asignada por el usuario.
    Seleccionar una ubicación para los nuevos recursos Seleccione la misma región que la cuenta de almacenamiento que creó. Si por alguna razón esta región no es compatible con la reproducción Flex Consumption, no se muestra. En ese caso, elija una región cercana en su lugar. Para más información, consulte Visualización de regiones admitidas actualmente.
    Seleccione una cuenta de almacenamiento Elija el nombre de la cuenta de almacenamiento que ha creado.
    Selección de un recurso de Application Insights para la aplicación En esta solicitud, elija la opción Crear nuevo recurso de Application Insights y proporcione el nombre para la instancia que se usará para almacenar los datos correspondientes al tiempo de ejecución de las funciones.

    Se muestra una notificación después de crear la aplicación de funciones. Seleccione Ver salida en esta notificación para ver los resultados de creación, incluidos los recursos de Azure que creó.

Implementar el código de función

Importante

Los procesos de implementación en aplicaciones de funciones existentes siempre sobrescriben el contenido de esas aplicaciones en Azure.

  1. En la paleta de comandos, escriba y seleccione Azure Functions: implementar la aplicación de funciones.

  2. Seleccione la aplicación de funciones que acaba de crear. Cuando se le solicite sobrescribir las implementaciones anteriores, seleccione Implementar para implementar el código de función en el nuevo recurso de aplicación de funciones.

  3. Cuando se complete la implementación, seleccione Ver la salida para ver los resultados de creación e implementación, incluidos los recursos de Azure que creó. Si se pierde la notificación, seleccione el icono de campana en la esquina inferior derecha para verlo de nuevo.

    Recorte de pantalla de la ventana Ver salida.

Actualización de la configuración de la aplicación

Dado que el proceso de publicación no carga automáticamente la configuración de aplicación necesaria desde el local.settings.json archivo, debe cargarlos en la aplicación de funciones para que la función se ejecute correctamente en Azure.

  1. En la paleta de comandos, escriba Azure Functions: Download Remote Settings... y, en el aviso Seleccionar un recurso, elija el nombre de su aplicación de función.

  2. Cuando se le pida que la configuración AzureWebJobsStorage ya existe, seleccione Sí para sobrescribir la configuración del emulador local con la cadena de conexión de la cuenta de almacenamiento real de Azure.

  3. En el archivo local.settings.json, reemplace la configuración del emulador local por la misma cadena de conexión usada paraAzureWebJobsStorage.

  4. Quite la entrada FUNCTIONS_WORKER_RUNTIME, que no se admite en un plan de consumo flexible.

  5. En la paleta de comandos, introduzca Azure Functions: Upload Local Settings... y, en el aviso Seleccionar un recurso, elija el nombre de su aplicación de funciones.

Ahora, tanto el host de Functions como el desencadenador comparten la misma cuenta de almacenamiento.

Compilación de la dirección URL del punto de conexión

Para crear una suscripción a eventos, debe proporcionar a Event Grid la dirección URL del punto de conexión específico para notificar eventos de Blob Storage. Esta dirección URL de extensión de blob se compone de estas partes:

Parte Ejemplo
Dirección URL de la aplicación de funciones base https://<FUNCTION_APP_NAME>.azurewebsites.net
Ruta de acceso específica del blob /runtime/webhooks/blobs
Cadena de consulta de función ?functionName=Host.Functions.<FUNCTION_NAME>
Clave de acceso de extensión de blob &code=<BLOB_EXTENSION_KEY>

Mientras su aplicación se conecta a la cuenta de almacenamiento mediante la autenticación de Microsoft Entra ID, la clave de acceso de la extensión de blob ayuda a proteger su webhook de extensión de blob frente al acceso no autorizado. Para encontrar la clave de acceso de la extensión de blob:

  1. En Visual Studio Code, seleccione el icono de Azure en la barra actividad. En Recursos, expanda la suscripción, expanda Aplicación de funciones, haga clic con el botón derecho en la aplicación de funciones que ha creado y seleccione Abrir en el portal.

  2. En Funciones, en el menú de la izquierda, seleccione Claves de aplicación.

  3. En Claves del sistema, seleccione la clave denominada blobs_extension y copie el valor de la clave.

    Incluya este valor en la cadena de consulta de la nueva dirección URL del punto de conexión.

  4. Cree una dirección URL de punto de conexión para el desencadenador de Blob Storage en función del ejemplo siguiente:

    https://<FUNCTION_APP_NAME>.azurewebsites.net/runtime/webhooks/blobs?functionName=Host.Functions.EventGridBlobTrigger&code=<BLOB_EXTENSION_KEY>

    En este ejemplo, reemplace <FUNCTION_APP_NAME> por el nombre de la aplicación de funciones y <BLOB_EXTENSION_KEY> por el valor que ha obtenido del portal. Si usó un nombre diferente para la función, reemplace EventGridBlobTrigger por ese nombre de función.

Ahora puede usar esta dirección URL de punto de conexión para crear una suscripción de eventos.

Creación de la suscripción de eventos

Una suscripción de eventos, con tecnología de Azure Event Grid, genera eventos en función de los cambios en el contenedor de blobs suscritos. A continuación, este evento se envía al punto de conexión de la extensión de blob para la función. Después de crear una suscripción de eventos, no puede actualizar la dirección URL del punto de conexión.

  1. En Visual Studio Code, seleccione el icono de Azure en la barra de actividades. En Recursos, expanda la suscripción, expanda Cuentas de almacenamiento, haga clic con el botón derecho en la cuenta de almacenamiento que creó anteriormente y seleccione Abrir en el portal.

  2. Inicie sesión en Azure Portal y anote el Grupo de recursos de la cuenta de almacenamiento. Cree los demás recursos en el mismo grupo para facilitar la limpieza de los recursos cuando haya terminado.

  3. Seleccione la opción Eventos en el menú de la izquierda.

    Agregar un evento de cuenta de almacenamiento

  4. En la ventana Eventos, seleccione el botón + Suscripción de eventos y proporcione los valores de la tabla siguiente en la pestaña Básico:

    Configuración Valor sugerido Descripción
    Nombre myBlobEventSub Nombre que identifica la suscripción de eventos. Use el nombre para buscar rápidamente la suscripción de eventos.
    Esquema del evento Esquema de Event Grid Use el esquema predeterminado para los eventos.
    Nombre del tema del sistema samples-workitems-blobs Nombre del tema, que representa el contenedor. El tema se crea con la primera suscripción y lo usará para las futuras suscripciones de eventos.
    Filtro para tipos de evento Blob Created (Creados por el blob)
    Tipo de punto de conexión Webhook El desencadenador de Blob Storage usa un punto de conexión de webhook.
    Punto de conexión Punto de conexión de dirección URL basado en Azure Use el punto de conexión de dirección URL que ha creado, que incluye el valor de clave.

  5. Seleccione Confirmar la selección para validar la dirección URL del punto de conexión.

  6. Seleccione la pestaña Filtros y proporcione la siguiente información a las indicaciones:

    Configuración Valor sugerido Descripción
    Habilitar el filtrado de blobs Enabled Permite filtrar qué blobs pueden desencadenar la función.
    El blob comienza por /blobServices/default/containers/<CONTAINER_NAME>/blobs/<BLOB_PREFIX> Reemplace <CONTAINER_NAME y <BLOB_PREFIX> por los valores que elija. Esta configuración desencadena la suscripción solo para blobs que comienzan por BLOB_PREFIX y están en el CONTAINER_NAME contenedor.
    El blob termina con .txt Garantiza que la función solo se desencadena mediante blobs que terminan con .txt.

    Para más información sobre el filtrado para blobs específicos, consulte Filtrado de eventos para Azure Event Hubs.

  7. Seleccione Crear para crear la suscripción de eventos.

Carga de un archivo al contenedor

Puede cargar un archivo desde el equipo al contenedor de Blob Storage mediante Visual Studio Code.

  1. En Visual Studio Code, presione F1 para abrir la paleta de comandos y escriba Azure Storage: Upload Files....

  2. En el cuadro de diálogo Abrir , elija un archivo, preferiblemente un archivo de texto y seleccione Cargar .

  3. Escriba la siguiente información cuando se le indique:

    Configuración Valor sugerido Descripción
    Escriba el directorio de destino de esta carga default Acepte el valor predeterminado de /, que es la raíz del contenedor.
    Selección de un recurso Nombre de la cuenta de almacenamiento Elija el nombre de la cuenta de almacenamiento que creó en un paso anterior.
    Seleccione de un tipo de recursos Contenedores de blobs Va a cargar en un contenedor de blobs.
    Seleccione el contenedor de blobs samples-workitems Este valor es el nombre del contenedor que creó en un paso anterior.

Examine el sistema de archivos local para buscar un archivo que se va a cargar y, a continuación, seleccione el botón Cargar para cargar el archivo.

Comprobación de la función en Azure

Al cargar un archivo en el contenedor samples-workitems , la función se desencadena. Puede comprobar la función comprobando los siguientes elementos en Azure Portal:

  1. En la cuenta de almacenamiento, vaya a la página eventos, seleccione Suscripciones de eventos y debería ver que se entregó un evento. Puede haber hasta un retraso de cinco minutos para que el evento aparezca en el gráfico.

  2. De nuevo en la página de la aplicación de funciones del portal, en Funciones, busque la función y seleccione Invocaciones y mucho más. Debería ver los seguimientos escritos a partir de la ejecución correcta de la función.

Limpieza de recursos

Si va al paso siguiente y agrega un enlace de cola de Azure Storage a una función, tendrá que conservar todos los recursos intactos para basarse en lo que ya ha hecho.

De lo contrario, puede usar los pasos siguientes para eliminar la aplicación de funciones y sus recursos relacionados para evitar incurrir en costos adicionales.

  1. En Visual Studio Code, presione F1 para abrir la paleta de comandos. En la paleta de comandos, busque y seleccione Azure: Open in portal.

  2. Elija una aplicación de funciones y presione la tecla ENTRAR. La página de la aplicación de funciones se abre en Azure Portal.

  3. En la pestaña Información general, seleccione el vínculo con nombre junto a Grupo de recursos.

    Captura de pantalla de la selección del grupo de recursos que se va a eliminar de la página de la aplicación de funciones.

  4. En la página Grupo de recursos, revise la lista de recursos incluidos y compruebe que estos sean los que desea eliminar.

  5. Seleccione Eliminar grupo de recursos y siga las instrucciones.

    El proceso de eliminación tardará un par de minutos. Cuando termine, aparece una notificación durante unos segundos. También puede seleccionar el icono de campana en la parte superior de la página para ver la notificación.

Para más información sobre los costos de Functions, consulte Estimación de los costos según el plan de consumo.

Pasos siguientes

  • Last updated on