Guida introduttiva: creare una connessione al servizio in Funzioni di Azure con l'interfaccia della riga di comando di Azure

Articolo
10/16/2024

Questa guida introduttiva illustra come connettere Funzioni di Azure ad altre risorse cloud usando l'interfaccia della riga di comando di Azure e Il connettore di servizi. Il connettore di servizi 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 su 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 tramite l'interfaccia della riga di comando di Azure.
- Quando richiesto, al primo utilizzo installare l'estensione dell'interfaccia della riga di comando di Azure. 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 una, creare una funzione di Azure.
Questa guida introduttiva presuppone che si disponga già di un account di archiviazione di Azure. Se non ne è ancora disponibile uno, creare un account di archiviazione di Azure.

Configurazione iniziale

Se si usa il connettore di servizi per la prima volta, iniziare eseguendo il comando az provider register per registrare il provider di risorse del connettore di servizi.
```
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, il connettore di servizi è già stato registrato.
Facoltativamente, usare il comando dell'interfaccia della riga di comando di Azure az functionapp connection list-support-types per ottenere un elenco dei servizi di destinazione supportati per l'app per le funzioni.
```
az functionapp connection list-support-types --output table
```

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 utilizzare una chiave di accesso per creare la connessione.

Usare il comando dell'interfaccia della riga di comando di Azure az functionapp connection 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: il 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: il nome del gruppo di risorse dell'archiviazione BLOB.
Nome dell'account di archiviazione: 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 effettuarne il provisioning e connettersi direttamente all'app per le funzioni.

Avviso

Microsoft consiglia di usare il flusso di autenticazione più sicuro disponibile. Il flusso di autenticazione descritto in questa procedura richiede un livello di attendibilità molto elevato nell'applicazione e comporta rischi che non sono presenti in altri flussi. Si consiglia di usare questo flusso solo quando altri flussi più sicuri, come le identità gestite, non sono validi.

Usare il comando dell'interfaccia della riga di comando di Azure az functionapp connection create per creare una connessione del 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: il nome del gruppo di risorse dell'app per le funzioni.
Nome dell'app per le funzioni: il nome dell'app per le funzioni che si connette al servizio di destinazione.
Nome del gruppo di risorse del servizio di destinazione: il nome del gruppo di risorse dell'archiviazione BLOB.
Nome dell'account di archiviazione: 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 effettuarne il provisioning e connettersi direttamente all'app per le funzioni.

Visualizzare le connessioni

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

Nome del gruppo di risorse del servizio di calcolo di origine: il nome del gruppo di risorse dell'app per le funzioni.
Nome dell'app per le funzioni: il 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

Per iniziare a creare un'applicazione per le funzioni personalizzata con il connettore di servizi, consultare le esercitazioni seguenti.

Esercitazione: Funzione Python con archiviazione code di Azure come trigger

Esercitazione: Funzione Python con Archiviazione BLOB di Azure come input

Esercitazione: Funzione Python con archiviazione tabelle di Azure come output

Condividi tramite