Creare una funzione attivata dall'archiviazione BLOB di AzureCreate a function triggered by Azure Blob storage

Informazioni su come creare una funzione attivata nel momento in cui vengono caricati o aggiornati file nell'archiviazione BLOB di Azure.Learn how to create a function triggered when files are uploaded to or updated in Azure Blob storage.

Visualizzare il messaggio nei log.

prerequisitiPrerequisites

Funzioni preferite nel portaleFavorite Functions in the portal

Se non è già stato fatto, aggiungere App per le funzioni ai Preferiti del portale di Azure,If you haven't already done so, add Function Apps to your favorites in the Azure portal. in modo da trovare più facilmente le app per le funzioni.This makes it easier to find your function apps. Se è stato già fatto, passare alla sezione successiva.If you have already done this, skip to the next section.

  1. Accedere al Portale di Azure.Log in to the Azure portal.

  2. Fare clic sulla freccia in basso a sinistra per espandere tutti i servizi, digitare Functions nel campo Filtro e quindi fare clic sulla stella accanto a App per le funzioni.Click the arrow at the bottom left to expand all services, type Functions in the Filter field, and then click the star next to Function Apps.

    Creare un'app per le funzioni nel portale di Azure

    L'icona Funzioni viene aggiunta al menu disponibile nella parte sinistra del portale.This adds the Functions icon to the menu on the left of the portal.

  3. Chiudere il menu e scorrere verso il basso fino a trovare l'icona Funzioni.Close the menu, then scroll down to the bottom to see the Functions icon. Fare clic sull'icona per visualizzare l'elenco di tutte le app per le funzioni.Click this icon to see a list of all your function apps. Fare clic sull'app per le funzioni per eseguire operazioni sulle funzioni all'interno dell'app.Click your function app to work with functions in this app.

    App per le funzioni nei Preferiti

Creare un'app per le funzioni di AzureCreate an Azure Function app

  1. Fare clic sul pulsante Nuovo nell'angolo superiore sinistro del portale di Azure e quindi selezionare Calcolo > App per le funzioni.Click the New button found on the upper left-hand corner of the Azure portal, then select Compute > Function App.

    Creare un'app per le funzioni nel portale di Azure

  2. Usare le impostazioni dell'app per le funzioni come indicato nella tabella sottostante l'immagine.Use the function app settings as specified in the table below the image.

    Definire nuove impostazioni dell'app per le funzioni

    ImpostazioneSetting Valore consigliatoSuggested value DESCRIZIONEDescription
    Nome appApp name Nome globalmente univocoGlobally unique name Nome che identifica la nuova app per le funzioni.Name that identifies your new function app. I caratteri validi sono a-z, 0-9 e -.Valid characters are a-z, 0-9, and -.
    SottoscrizioneSubscription Sottoscrizione in usoYour subscription Sottoscrizione in cui viene creata questa nuova app per le funzioni.The subscription under which this new function app is created.
    Gruppo di risorseResource Group myResourceGroupmyResourceGroup Nome del nuovo gruppo di risorse in cui creare l'app per le funzioni.Name for the new resource group in which to create your function app.
    Sistema operativoOS WindowsWindows L'hosting senza server attualmente è disponibile solo in un ambiente di esecuzione su Windows.Serverless hosting is currently only available when running on Windows. Per l'hosting su Linux, vedere Creare la prima funzione eseguita in Linux usando l'interfaccia della riga di comando di Azure.For Linux hosting, see Create your first function running on Linux using the Azure CLI.
    Piano di hostingHosting plan Piano a consumoConsumption plan Piano di hosting che definisce come vengono allocate le risorse all'app per le funzioni.Hosting plan that defines how resources are allocated to your function app. Nel piano a consumo predefinito le risorse vengono aggiunte dinamicamente in base alle esigenze delle funzioni.In the default Consumption Plan, resources are added dynamically as required by your functions. In questo hosting senza server si paga solo per il periodo in cui le funzioni sono in esecuzione.In this serverless hosting, you only pay for the time your functions run.
    PosizioneLocation Europa occidentaleWest Europe Scegliere un'area nelle vicinanze o vicino ad altri servizi a cui accedono le funzioni.Choose a region near you or near other services your functions access.
    Account di archiviazioneStorage account Nome globalmente univocoGlobally unique name Nome del nuovo account di archiviazione usato dall'app per le funzioni.Name of the new storage account used by your function app. I nomi degli account di archiviazione devono avere una lunghezza compresa tra 3 e 24 caratteri e possono contenere solo numeri e lettere minuscole.Storage account names must be between 3 and 24 characters in length and may contain numbers and lowercase letters only. È possibile anche usare un account esistente.You can also use an existing account.
  3. Fare clic su Crea per effettuare il provisioning della nuova app per le funzioni e distribuirla.Click Create to provision and deploy the new function app. È possibile monitorare lo stato della distribuzione facendo clic sull'icona di notifica nell'angolo superiore destro del portale.You can monitor the status of the deployment by clicking the Notification icon in the upper-right corner of the portal.

    Definire nuove impostazioni dell'app per le funzioni

    Se si fa clic su Vai alla risorsa, viene visualizzata la nuova app di funzione.Clicking Go to resource takes you to your new function app.

App per le funzioni creata correttamente.

Si creerà ora una funzione nella nuova app per le funzioni.Next, you create a function in the new function app.

Creare una funzione attivata dall'archiviazione BLOBCreate a Blob storage triggered function

  1. Espandere l'app per le funzioni e fare clic sul pulsante + accanto a Funzioni.Expand your function app and click the + button next to Functions. Se questa è la prima funzione nell'app per le funzioni, selezionare Funzione personalizzata.If this is the first function in your function app, select Custom function. Verrà visualizzato il set completo di modelli di funzione.This displays the complete set of function templates.

    Pagina della guida introduttiva di Funzioni nel portale di Azure

  2. Nel campo di ricerca digitare blob e quindi scegliere la lingua da usare per il modello di attivazione dell'archiviazione BLOB.In the search field, type blob and then choose your desired language for the Blob storage trigger template.

    Scegliere il modello di attivazione dell'archiviazione BLOB.

  3. Usare le impostazioni specificate nella tabella disponibile sotto l'immagine.Use the settings as specified in the table below the image.

    Creare una funzione attivata dall'archiviazione BLOB.

    ImpostazioneSetting Valore consigliatoSuggested value DescrizioneDescription
    NomeName Univoco nell'app per le funzioniUnique in your function app Nome della funzione attivata dal BLOB.Name of this blob triggered function.
    PercorsoPath samples-workitems/{name}samples-workitems/{name} Percorso da monitorare nell'archiviazione BLOB.Location in Blob storage being monitored. Il nome file del BLOB viene passato nel binding come parametro name.The file name of the blob is passed in the binding as the name parameter.
    Connessione dell'account di archiviazioneStorage account connection AzureWebJobsStorageAzureWebJobsStorage È possibile usare la connessione dell'account di archiviazione già usata dall'app per le funzioni oppure crearne una nuova.You can use the storage account connection already being used by your function app, or create a new one.
  4. Fare clic su Crea per creare la funzione.Click Create to create your function.

Connettersi quindi all'account di archiviazione di Azure e creare il contenitore samples-workitems.Next, you connect to your Azure Storage account and create the samples-workitems container.

Creare il contenitoreCreate the container

  1. Nella funzione fare clic su Integrazione, espandere Documentazione e copiare sia Nome account sia Chiave account.In your function, click Integrate, expand Documentation, and copy both Account name and Account key. Usare queste credenziali per connettersi all'account di archiviazione.You use these credentials to connect to the storage account. Se si è già connessi all'account di archiviazione, andare al passaggio 4.If you have already connected your storage account, skip to step 4.

    Ottenere le credenziali per la connessione all'account di archiviazione.

  2. Eseguire lo strumento Microsoft Azure Storage Explorer, fare clic sull'icona di connessione a sinistra, scegliere Use a storage account name and key (Usare il nome e la chiave di un account di archiviazione) e fare clic su Avanti.Run the Microsoft Azure Storage Explorer tool, click the connect icon on the left, choose Use a storage account name and key, and click Next.

    Eseguire lo strumento di esplorazione dell'account di archiviazione.

  3. Immettere i valori Nome account e Chiave account definiti nel passaggio 1, fare clic su Avanti e quindi su Connetti.Enter the Account name and Account key from step 1, click Next and then Connect.

    Immettere le credenziali di archiviazione ed eseguire la connessione.

  4. Espandere l'account di archiviazione associato, fare doppio clic su Contenitori BLOB, fare clic su Crea contenitore BLOB, digitare samples-workitems e quindi premere INVIO.Expand the attached storage account, right-click Blob containers, click Create blob container, type samples-workitems, and then press enter.

    Creare una coda di archiviazione.

Dopo aver creato un contenitore BLOB, è possibile ora testare la funzione caricando un file nel contenitore.Now that you have a blob container, you can test the function by uploading a file to the container.

Testare la funzioneTest the function

  1. Tornare al portale di Azure, selezionare la funzione, espandere i log nella parte inferiore della pagina e assicurarsi che lo streaming dei log non sia stato interrotto.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.

  2. In Esplora archivi espandere l'account di archiviazione, Contenitori BLOB e samples-workitems.In Storage Explorer, expand your storage account, Blob containers, and samples-workitems. Fare clic su Carica e quindi su Carica file....Click Upload and then Upload files....

    Caricare un file nel contenitore BLOB.

  3. Nella finestra di dialogo Carica file fare clic sul campo File.In the Upload files dialog box, click the Files field. Identificare un file nel computer locale, ad esempio un file di immagine, selezionarlo e fare clic su Apri e quindi su Carica.Browse to a file on your local computer, such as an image file, select it and click Open and then Upload.

  4. Tornare ai log di funzione e verificare che il BLOB sia stato letto.Go back to your function logs and verify that the blob has been read.

    Visualizzare il messaggio nei log.

    Nota

    Se l'app per le funzioni viene eseguita nel piano a consumo predefinito, è possibile che si verifichi un ritardo di alcuni minuti tra il momento in cui il BLOB viene aggiunto o aggiornato e il momento in cui viene attivata la funzione.When your function app runs in the default Consumption plan, there may be a delay of up to several minutes between the blob being added or updated and the function being triggered. Se nelle funzioni attivate dal BLOB è necessaria una bassa latenza, valutare l'opportunità di eseguire l'app per le funzioni in un piano di servizio app.If you need low latency in your blob triggered functions, consider running your function app in an App Service plan.

Pulire le risorseClean up resources

Altre guide introduttive di questa raccolta si basano sui valori di questa guida introduttiva.Other quick starts in this collection build upon this quick start. Se si prevede di continuare a usare le guide introduttive successive o i servizi creati con questa guida introduttiva, non eseguire la pulizia delle risorse.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.

Il termine risorse in Azure si riferisce ad app per le funzioni, funzioni, account di archiviazione e così via.Resources in Azure refers to function apps, functions, storage accounts, and so forth. Le risorse sono raggruppate in gruppi di risorse, ed è possibile eliminare tutti gli elementi in un gruppo eliminando il gruppo.They are grouped into resource groups, and you can delete everything in a group by deleting the group.

Per completare queste guide introduttive sono state create risorse.You created resources to complete these quickstarts. Per tali risorse potrebbero venire addebitati costi, a seconda dello stato dell'account e dei prezzi dei servizi.You may be billed for these resources, depending on your account status and service pricing. Se le risorse non sono più necessarie, ecco come eliminarle:If you don't need the resources anymore, here's how to delete them:

  1. Nel portale di Azure passare alla pagina Gruppo di risorse.In the Azure portal, go to the Resource group page.

    Per visualizzare tale pagina dalla pagina dell'app per le funzioni, selezionare la scheda Panoramica e quindi selezionare il collegamento sotto Gruppo di risorse.To get to that page from the function app page, select the Overview tab and then select the link under Resource group.

    Selezionare il gruppo di risorse da eliminare dalla pagina dell'app per le funzioni.

    Per visualizzare tale pagina dal dashboard, selezionare Gruppi di risorse e quindi selezionare il gruppo di risorse usato nella guida introduttiva.To get to that page from the dashboard, select Resource groups, and then select the resource group that you used for this quickstart.

  2. Nella pagina Gruppo di risorse esaminare l'elenco delle risorse incluse e verificare che siano quelle da eliminare.In the Resource group page, review the list of included resources, and verify that they are the ones you want to delete.

  3. Selezionare Elimina gruppo di risorse e seguire le istruzioni.Select Delete resource group, and follow the instructions.

    L'eliminazione potrebbe richiedere alcuni minuti.Deletion may take a couple of minutes. Al termine, viene visualizzata una notifica per pochi secondi.When it's done, a notification appears for a few seconds. È anche possibile selezionare l'icona a forma di campana nella parte superiore della pagina per visualizzare la notifica.You can also select the bell icon at the top of the page to view the notification.

Passaggi successiviNext steps

È stata creata una funzione che viene eseguita nel momento in cui nell'archiviazione BLOB viene aggiunto o aggiornato un BLOB.You have created a function that runs when a blob is added to or updated in Blob storage.

Informazioni su come creare funzioni con altri tipi di trigger o come integrare funzioni con altri servizi di Azure.Learn how to create functions with other kinds of triggers or how to integrate functions with other Azure services.

Per altre informazioni sui trigger dell'archiviazione BLOB, vedere Binding dell'archiviazione BLOB di Funzioni di Azure.For more information about Blob storage triggers, see Azure Functions Blob storage bindings.