Avvio rapido: Creare una connessione al servizio in Funzioni di Azure con l'interfaccia della riga di comando di Azure

Questa guida introduttiva illustra come connettere Funzioni di Azure ad altre risorse cloud usando l'interfaccia della riga di comando di Azure e il Connessione or. Service Connessione or consente di connettere rapidamente i servizi di calcolo ai servizi cloud, gestendo al contempo le impostazioni di autenticazione e rete della connessione.

Se non si ha una sottoscrizione di Azure, creare un account Azure gratuito prima di iniziare.

Prerequisiti

• Usare l'ambiente Bash in Azure Cloud Shell. Per altre informazioni, vedere Avvio rapido per Bash in Azure Cloud Shell.

  

• Se si preferisce eseguire i comandi di riferimento dell'interfaccia della riga di comando in locale, installare l'interfaccia della riga di comando di Azure. Per l'esecuzione in Windows o macOS, è consigliabile eseguire l'interfaccia della riga di comando di Azure in un contenitore Docker. Per altre informazioni, vedere Come eseguire l'interfaccia della riga di comando di Azure in un contenitore Docker.

  • Se si usa un'installazione locale, accedere all'interfaccia della riga di comando di Azure con il comando az login. Per completare il processo di autenticazione, seguire la procedura visualizzata nel terminale. Per altre opzioni di accesso, vedere Accedere con l'interfaccia della riga di comando di Azure.

  • Quando richiesto, installare l'estensione dell'interfaccia della riga di comando di Azure al primo uso. Per altre informazioni sulle estensioni, vedere Usare le estensioni con l'interfaccia della riga di comando di Azure.

  • Eseguire az version per trovare la versione e le librerie dipendenti installate. Per eseguire l'aggiornamento alla versione più recente, eseguire az upgrade.

• Questa guida introduttiva richiede la versione 2.30.0 o successiva dell'interfaccia della riga di comando di Azure. Se si usa Azure Cloud Shell, la versione più recente è già installata.
• Questa guida introduttiva presuppone che sia già disponibile una funzione di Azure. Se non ne è ancora disponibile uno, creare una funzione di Azure.
• Questo argomento di avvio rapido presuppone che l'utente abbia già un account Archiviazione di Azure. Se non ne hai ancora uno, crea un account Archiviazione di Azure.

Configurazione iniziale

1. Se si usa Service Connessione or per la prima volta, iniziare eseguendo il comando az provider register per registrare il provider di risorse service Connessione or.

   az provider register -n Microsoft.ServiceLinker
   

   Suggerimento

   È possibile verificare se il provider di risorse è già stato registrato eseguendo il comando az provider show -n "Microsoft.ServiceLinker" --query registrationState. Se l'output è Registered, service Connessione or è già stato registrato.

2. Facoltativamente, usare il comando az functionapp connection list-support-types dell'interfaccia della riga di comando di Azure per ottenere un elenco dei servizi di destinazione supportati per l'app per le funzioni.

   az functionapp connection list-support-types --output table
   

Creare una connessione al servizio

Uso di una chiave di accesso

Usare il comando az functionapp connection create dell'interfaccia della riga di comando di Azure per creare una connessione al servizio a un Archiviazione BLOB di Azure con una chiave di accesso, fornendo le informazioni seguenti:

• Nome del gruppo di risorse del servizio di calcolo di origine: nome del gruppo di risorse dell'app per le funzioni.
• Nome dell'app per le funzioni: nome dell'app per le funzioni che si connette al servizio di destinazione.
• Nome del gruppo di risorse del servizio di destinazione: nome del gruppo di risorse dell'Archiviazione BLOB.
• Archiviazione nome dell'account: il nome dell'account dell'Archiviazione BLOB.

az functionapp connection create storage-blob --secret

Nota

Se non si dispone di un Archiviazione BLOB, è possibile eseguire az functionapp connection create storage-blob --new --secret per effettuare il provisioning di un nuovo oggetto e connettersi direttamente all'app per le funzioni.

Uso di un'identità gestita

Importante

L'uso dell'identità gestita richiede l'autorizzazione per l'assegnazione di ruolo di Azure AD. Se non si dispone dell'autorizzazione, la creazione della connessione avrà esito negativo. È possibile chiedere al proprietario della sottoscrizione l'autorizzazione o usare una chiave di accesso per creare la connessione.

Usare il comando az functionapp connection dell'interfaccia della riga di comando di Azure per creare una connessione del servizio a un Archiviazione BLOB con un'identità gestita assegnata dal sistema, fornendo le informazioni seguenti:

• Nome del gruppo di risorse del servizio di calcolo di origine: nome del gruppo di risorse dell'app per le funzioni.
• Nome dell'app per le funzioni: nome dell'app functio che si connette al servizio di destinazione.
• Nome del gruppo di risorse del servizio di destinazione: nome del gruppo di risorse dell'Archiviazione BLOB.
• Archiviazione nome dell'account: il nome dell'account dell'Archiviazione BLOB.

az functionapp connection create storage-blob --system-identity

Nota

Se non si dispone di un Archiviazione BLOB, è possibile eseguire az functionapp connection create storage-blob --new --system-identity per effettuare il provisioning di un nuovo oggetto e connettersi direttamente all'app per le funzioni.

Visualizzare le connessioni

Usare il comando az functionapp connection list dell'interfaccia della riga di comando di Azure per elencare le connessioni all'app per le funzioni, fornendo le informazioni seguenti:

• Nome del gruppo di risorse del servizio di calcolo di origine: nome del gruppo di risorse dell'app per le funzioni.
• Nome dell'app per le funzioni: nome dell'app per le funzioni che si connette al servizio di destinazione.

az functionapp connection list -g "<your-function-app-resource-group>" -n "<your-function-app-name>" --output table

Passaggi successivi

Seguire le esercitazioni seguenti per iniziare a creare un'applicazione per le funzioni personalizzata con Service Connessione or.

Esercitazione: Funzione Python con Archiviazione di accodamento di Azure come trigger

Esercitazione: Funzione Python con Archiviazione BLOB di Azure come input

Esercitazione: Funzione Python con Archiviazione tabella di Azure come output