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 La sottoscrizione in cui verrà creata questa nuova app per le funzioni.The subscription under which this new function app will be 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 una località nelle vicinanze o vicino ad altri servizi a cui accederanno le funzioni.Choose a location near you or near other services your functions will 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.

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. Selezionare il modello BlobTrigger per la lingua desiderata e usare le impostazioni specificate nella tabella.Select the BlobTrigger template for your desired language, and use the settings as specified in the table.

    Creare una funzione attivata dall'archiviazione BLOB.

    ImpostazioneSetting Valore consigliatoSuggested value DescrizioneDescription
    PercorsoPath mycontainer/{name}mycontainer/{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 AzureWebJobStorageAzureWebJobStorage È 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.
    Dare un nome alla funzioneName your function Univoco nell'app per le funzioniUnique in your function app Nome della funzione attivata dal BLOB.Name of this blob triggered function.
  3. 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 mycontainer.Next, you connect to your Azure Storage account and create the mycontainer 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 mycontainer e quindi premere INVIO.Expand the attached storage account, right-click Blob containers, click Create blob container, type mycontainer, 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 mycontainer.In Storage Explorer, expand your storage account, Blob containers, and mycontainer. 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 le esercitazioni, non eliminare le risorse create in questa guida introduttiva.If you plan to continue on to work with subsequent quick starts or with the tutorials, do not clean up the resources created in this quick start.

Se non si prevede di continuare, fare clic su Gruppo di risorse per l'app per le funzioni nel portale e quindi fare clic su Elimina.If you do not plan to continue, click the Resource group for the function app in the portal, and then click Delete.

Selezionare il gruppo di risorse da eliminare dall'app per le funzioni.

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.