az logicapp connection

Note

Questo riferimento fa parte dell'estensione logicapp per il interfaccia della riga di comando di Azure (versione 2.67.0 o successiva). L'estensione installerà automaticamente la prima volta che si esegue un comando az logicapp connection . Altre informazioni sulle estensioni.

Creare connessioni standard di App per la logica distribuite ed esaminarne le versioni.

Comandi

Nome Descrizione Tipo Status
az logicapp connection acl

Gestire i criteri di accesso in una connessione API gestita.

Extension GA
az logicapp connection acl add

Concedere a un'identità Entra l'accesso a una connessione API gestita.

Extension GA
az logicapp connection acl list

Elencare i criteri di accesso in una connessione API gestita.

Extension GA
az logicapp connection acl remove

Rimuovere un criterio di accesso da una connessione API gestita.

Extension GA
az logicapp connection acl show

Visualizzare un criterio di accesso in una connessione API gestita.

Extension GA
az logicapp connection create

Aggiungere una connessione del provider di servizi a un progetto locale o a una connessione API gestita a un'app distribuita.

Extension GA
az logicapp connection delete

Rimuovere una connessione da un'app per la logica distribuita.

Extension GA
az logicapp connection list

Elencare le connessioni cablate in un'app standard di app per la logica distribuita.

Extension GA
az logicapp connection managed

Creare Azure connessioni API gestite per progetti locali o siti Standard distribuiti.

Extension GA
az logicapp connection managed create

Creare una connessione API gestita Azure e collegare un progetto locale o un'app distribuita.

Extension GA
az logicapp connection show

Visualizzare una connessione cablata in un'app standard dell'app per la logica distribuita.

Extension GA
az logicapp connection test

Testare una connessione Standard di App per la logica configurata.

Extension GA

az logicapp connection create

Aggiungere una connessione del provider di servizi a un progetto locale o a una connessione API gestita a un'app distribuita.

Due modalità. Per impostazione predefinita, questa operazione scrive una connessione del provider di servizi in un progetto locale. Con --managed-api crea invece una connessione API gestita Azure per un'app per la logica distribuita e --name indica l'app per la logica anziché la connessione, assegnare un nome alla connessione con --connection-name.

Modalità locale: scrive la connessione in connections.json e in qualsiasi valore del segreto in local.settings.json, che il pacchetto di distribuzione esclude. Un segreto non viene mai accettato nella riga di comando: --secret assegna un nome all'impostazione dell'app e il valore viene letto dall'input standard. Per le connessioni basate su identità omettere completamente --secret e fornire --parameter NAME=VALUE; dots nest values, quindi authProvider.Type diventa un oggetto annidato, che è ciò che il runtime richiede. I parametri originati dalla configurazione dell'app richiedono una corrispondenza --app-setting. local.settings.json viene aggiunto a .gitignore a meno che non venga specificato --no-gitignore. Non idempotente: ha esito negativo se l'impostazione della connessione o dell'app esiste già, quindi è possibile riprovare solo con --force.

Modalità API gestita (-managed-api): crea tre elementi accoppiati, perché il primo è inutilizzabile: il Microsoft ARM. Risorsa Web/connessioni, criteri di accesso che denominano l'identità gestita dell'app e una voce managedApiConnections nel connections.jsondell'app. La connessione viene sempre creata con il tipo V2, poiché le connessioni V1 rifiutano i criteri di accesso e il tipo non può essere modificato in seguito. L'app deve avere già un'identità gestita; senza un comando si arresta prima di creare nulla. Prima delle mutazioni ARM è necessario anche un connections.json valido esistente con un ETag VFS forte. I file mancanti o le revisioni nonversioni/deboli hanno esito negativo; L'interfaccia della riga di comando non tenta operazioni di scrittura di file di sola creazione non qualificate. Il ripristino della pubblicazione e dell'immissione di file utilizza l'ETag appena letto, mai un carattere jolly. I conflitti di revisione non vengono ritentati; le guardie file non sono una transazione ARM. --auth-mode oauth apre un browser in modo da poter approvare la connessione. L'interfaccia della riga di comando è in ascolto su una porta di loopback per il reindirizzamento, ovvero il modo in cui apprende il consenso è terminato; il servizio di consenso riscatta il codice di autorizzazione stesso, quindi il callback in genere non contiene codice e non viene confermato altro. Usare --no-browser in un computer headless per stampare l'URL anziché avviarne uno. Se il consenso, la creazione di criteri di accesso o connections.json collegamento non riesce, le risorse arm e i criteri di accesso vengono conservati per l'ispezione manuale. Un PUT incondizionato può aggiornare la risorsa di un altro writer anche dopo l'assenza preliminare; non autorizza l'eliminazione automatica o il ripristino dei criteri. Le proprietà, le credenziali o l'accesso concesso potrebbero essere state modificate. Ispezionare e ripristinare deliberatamente lo stato conservato prima di riprovare; --force non è una garanzia di concorrenza. Viene eseguito solo un tentativo di ripristino delle voci di file sorvegliate. Le credenziali esistenti non possono essere sempre recuperate dal readback arm. Un connections.json esistente in formato non leggibile o non valido non viene sostituito con un file vuoto.

In Windows PowerShell, un @appsetting(valore 'NAME') deve raggiungere az intact. PowerShell inoltra le parentesi senza virgoole a cmd.exe, che termina il blocco IF EXIST all'interno di az.cmd e ha esito negativo con "-parameter was unexpected at this time". Inserire il token di interruzione dell'analisi di PowerShell immediatamente prima del primo --parametro per passare il resto della riga tramite non analizzato.

az logicapp connection create --connector
                              --name
                              [--acquire-policy-token]
                              [--app-setting]
                              [--auth-mode {managed-identity, oauth, raw, service-principal}]
                              [--change-reference]
                              [--connection-name]
                              [--consent-timeout]
                              [--context]
                              [--display-name]
                              [--force]
                              [--location]
                              [--managed-api]
                              [--no-browser]
                              [--no-gitignore]
                              [--parameter]
                              [--parameter-set]
                              [--path]
                              [--resource-group]
                              [--secret]
                              [--secret-parameter]
                              [--user-assigned-identity]

Esempio

Aggiungere una connessione bus di servizio, valore inviato tramite pipe in (PowerShell).

$env:SB_CONNECTION | az logicapp connection create --path .\orders --name serviceBus --connector serviceBus --secret serviceBus_connectionString

Aggiungere una connessione bus di servizio, valore piped in (bash).

printf '%s' "$SB_CONNECTION" | az logicapp connection create --path ./orders --name serviceBus --connector serviceBus --secret serviceBus_connectionString

Aggiungere una connessione bus di servizio che usa l'identità gestita, senza alcun segreto.

az logicapp connection create --path ./orders --name serviceBus --connector serviceBus --parameter-set ManagedServiceIdentity --parameter "fullyQualifiedNamespace=@appsetting('serviceBus_fullyQualifiedNamespace')" authProvider.Type=ManagedServiceIdentity --app-setting serviceBus_fullyQualifiedNamespace=contoso.servicebus.windows.net

Creare una connessione API gestita Azure BLOB che esegue l'autenticazione come identità dell'app.

az logicapp connection create --managed-api -g rg-lacli-ri2bg8 -n la-cli-pilot-ri2bg8 --connection-name blobProd --connector azureblob -l eastus --auth-mode managed-identity

Creare una connessione Office 365 e approvarla in un browser.

az logicapp connection create --managed-api -g rg-lacli-ri2bg8 -n la-cli-pilot-ri2bg8 --connection-name outlook --connector office365 -l eastus --auth-mode oauth

Stesso, in un computer headless: stampare l'URL di consenso anziché aprire un browser.

az logicapp connection create --managed-api -g rg-lacli-ri2bg8 -n la-cli-pilot-ri2bg8 --connection-name outlook --connector office365 -l eastus --auth-mode oauth --no-browser

Parametri necessari

--connector

Connettore del provider di servizi, ad esempio 'serviceBus'.

--name -n

Nome della connessione a cui fanno riferimento i flussi di lavoro. Con --managed-api si tratta invece del nome dell'app per la logica e la connessione è denominata da --connection-name.

Parametri facoltativi

I seguenti parametri sono facoltativi, ma a seconda del contesto, uno o più di questi potrebbero diventare necessari per l'esecuzione corretta del comando.

--acquire-policy-token

Acquisizione automatica di un token Criteri di Azure per questa operazione di risorsa.

Proprietà Valore
Gruppo di parametri: Global Policy Arguments
--app-setting

Impostazione dell'app non segreta come NAME=VALUE, ripetibile. Scritto in local.settings.json per i parametri originati dalla configurazione dell'app.

--auth-mode

Autenticazione utilizzata dalla connessione. oauth apre un browser per il consenso. Obbligatorio con --managed-api.

Proprietà Valore
Valori accettati: managed-identity, oauth, raw, service-principal
--change-reference

ID riferimento di modifica correlato per questa operazione di risorsa.

Proprietà Valore
Gruppo di parametri: Global Policy Arguments
--connection-name

Nome della connessione API gestita da creare. Obbligatorio con --managed-api.

--consent-timeout

Secondi di attesa del consenso del browser prima dell'esito negativo. Impostazione predefinita: 300. È possibile conservare le risorse di connessione/criteri di accesso; esaminarli prima di riprovare. Solo con oauth in modalità --auth.

Proprietà Valore
Gruppo di parametri: OAuth consent Arguments
--context

Contesto del progetto locale denominato. I contesti cloud vengono rifiutati; non disponibile in modalità legacy --managed-api.

--display-name

Nome visualizzato per la connessione. Il valore predefinito è --connection-name.

--force

Sostituire un'impostazione di connessione o app esistente.

Proprietà Valore
Valore predefinito: False
--location -l

Azure percorso per la connessione e l'API gestita. Obbligatorio con --managed-api.

--managed-api

Modalità di compatibilità deprecata. Preferisce la creazione gestita di connessione --name CONNECTION --logic-app-name APP. Legacy --name indica comunque l'app.

Proprietà Valore
Valore predefinito: False
--no-browser

Stampare l'URL di consenso anziché avviare un browser. Il comando rimane in ascolto del reindirizzamento, quindi il browser deve essere in grado di raggiungere il computer nel loopback. Solo con oauth in modalità --auth.

Proprietà Valore
Gruppo di parametri: OAuth consent Arguments
Valore predefinito: False
--no-gitignore

Non aggiungere local.settings.json a .gitignore.

Proprietà Valore
Valore predefinito: False
--parameter

Parametro di connessione come NAME=VALUE, ripetibile. Usare i punti per annidare, ad esempio authProvider.Type=ManagedServiceIdentity. I valori non devono essere segreti.

--parameter-set

Nome del set di parametri del connettore. Il valore predefinito è connectionString.

--path

Radice del progetto esistente. Per impostazione predefinita, il percorso del contesto locale o la directory corrente.

--resource-group -g

Gruppo di risorse dell'app per la logica. Obbligatorio con --managed-api.

--secret

Nome dell'impostazione dell'app che conterrà un segreto. Il valore viene letto dall'input standard e mai dalla riga di comando. Omettere per le connessioni basate su identità.

--secret-parameter

Percorso del parametro a cui viene associato il segreto. Il valore predefinito è connectionString.

--user-assigned-identity

ID risorsa di un'identità assegnata dall'utente già assegnata all'app. L'impostazione predefinita è l'identità assegnata dal sistema.

Parametri globali
--debug

Aumentare la verbosità dei log per visualizzare tutti i log di debug.

Proprietà Valore
Valore predefinito: False
--help -h

Mostra questo messaggio Guida, esci.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

Proprietà Valore
Valore predefinito: False
--output -o

Formato dell'output.

Proprietà Valore
Valore predefinito: json
Valori accettati: json, jsonc, none, table, tsv, yaml, yamlc
--query

Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID.

--verbose

Aumentare il livello di dettaglio della registrazione. Usare --debug per log di debug completi.

Proprietà Valore
Valore predefinito: False

az logicapp connection delete

Rimuovere una connessione da un'app per la logica distribuita.

Rimuove la voce connections.json. Per una connessione API gestita, è possibile rimuovere solo i criteri di accesso corrispondenti all'identità assegnata dal sistema di proprietà esclusiva della voce e la risorsa viene eliminata solo quando viene stabilita la proprietà esclusiva. Le identità assegnate dall'utente possono essere condivise da più app, quindi i criteri e le risorse di connessione vengono mantenute, con un motivo segnalato. Le identità semplicemente assegnate a questa app non sono prove della proprietà della connessione. Passare --keep-resource per mantenere la risorsa anche per criteri di proprietà esclusiva; questo flag non revoca l'accesso all'identità assegnata dall'utente condiviso. Le impostazioni dell'app a cui fa riferimento una connessione del provider di servizi non vengono mai eliminate, ma vengono segnalate solo perché altre connessioni possono comunque leggerle. La rimozione richiede un ETag sicuro dal connections.json corrente riread e invia tale revisione esatta. Gli ETag mancanti/deboli o un conflitto di revisione arrestano il comando senza la pulizia arm o un nuovo tentativo incondizionato. I controlli di ricezione/readback VFS rimangono obbligatori; non si tratta di una transazione tra risorse. L'ID connessione gestita creata deve essere un ID risorsa relativo canonico nella sottoscrizione e nel gruppo di risorse selezionato. Gli ID assoluti, in formato non valido o tra ambiti si rifiutano prima dell'accesso arm alle risorse di connessione o scollegamento, incluso con --keep-resource. Gestire le risorse tra ambiti in modo esplicito.

az logicapp connection delete --connection
                              --name
                              --resource-group
                              [--acquire-policy-token]
                              [--change-reference]
                              [--class {managedApiConnections, serviceProviderConnections}]
                              [--keep-resource]
                              [--yes]

Esempio

Rimuovere una connessione da un'app, senza chiedere conferma.

az logicapp connection delete -g rg-lacli-ri2bg8 -n la-cli-pilot-ri2bg8 --connection cliPilotBlob --yes

Rimuovere l'immissione dell'app e i criteri di proprietà esclusiva, mantenendo la risorsa.

az logicapp connection delete -g rg-lacli-ri2bg8 -n la-cli-pilot-ri2bg8 --connection sharedBlob --keep-resource --yes

Disambiguare un nome esistente in entrambe le classi di connessione.

az logicapp connection delete -g rg-lacli-ri2bg8 -n la-cli-pilot-ri2bg8 --connection blob --class managedApiConnections --yes

Parametri necessari

--connection

Nome della connessione in connections.json.

--name -n

Nome del sito Standard dell'app per la logica.

--resource-group -g

Nome del gruppo di risorse contenente il sito Standard dell'app per la logica.

Parametri facoltativi

I seguenti parametri sono facoltativi, ma a seconda del contesto, uno o più di questi potrebbero diventare necessari per l'esecuzione corretta del comando.

--acquire-policy-token

Acquisizione automatica di un token Criteri di Azure per questa operazione di risorsa.

Proprietà Valore
Gruppo di parametri: Global Policy Arguments
--change-reference

ID riferimento di modifica correlato per questa operazione di risorsa.

Proprietà Valore
Gruppo di parametri: Global Policy Arguments
--class

Classe di connessione da cercare. Obbligatorio solo quando lo stesso nome esiste in entrambe le classi.

Proprietà Valore
Valori accettati: managedApiConnections, serviceProviderConnections
--keep-resource

Mantenere la risorsa di connessione ARM. Rimuovere solo i criteri di accesso di proprietà esclusiva di questa app; i criteri di identità assegnati dall'utente condiviso vengono mantenuti. Solo connessioni API gestite.

Proprietà Valore
Valore predefinito: False
--yes -y

Non richiedere conferma.

Proprietà Valore
Valore predefinito: False
Parametri globali
--debug

Aumentare la verbosità dei log per visualizzare tutti i log di debug.

Proprietà Valore
Valore predefinito: False
--help -h

Mostra questo messaggio Guida, esci.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

Proprietà Valore
Valore predefinito: False
--output -o

Formato dell'output.

Proprietà Valore
Valore predefinito: json
Valori accettati: json, jsonc, none, table, tsv, yaml, yamlc
--query

Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID.

--verbose

Aumentare il livello di dettaglio della registrazione. Usare --debug per log di debug completi.

Proprietà Valore
Valore predefinito: False

az logicapp connection list

Elencare le connessioni cablate in un'app standard di app per la logica distribuita.

Legge solo il file connections.json dell'app tramite il proxy VFS arm. Si tratta del cablaggio del piano file che i flussi di lavoro possono usare; non si riconcilia con arm Microsoft. Le risorse Web/connessioni, quindi le connessioni ARM create ma non cablate e i riferimenti ai file incerti non vengono visualizzati. parameterValues e GLI URL di runtime vengono rideattiti per impostazione predefinita.

az logicapp connection list --name
                            --resource-group
                            [--continuation-token --next-token]
                            [--max-items]
                            [--show-runtime-urls]

Esempio

Elencare le connessioni cablate per le app.

az logicapp connection list --resource-group rg-lacli-ri2bg8 --name la-cli-pilot-ri2bg8

Elencare le connessioni cablate per le app, inclusi gli URL di runtime.

az logicapp connection list -g rg-lacli-ri2bg8 -n la-cli-pilot-ri2bg8 --show-runtime-urls

Parametri necessari

--name -n

Nome del sito Standard dell'app per la logica.

--resource-group -g

Nome del gruppo di risorse contenente il sito Standard dell'app per la logica.

Parametri facoltativi

I seguenti parametri sono facoltativi, ma a seconda del contesto, uno o più di questi potrebbero diventare necessari per l'esecuzione corretta del comando.

--continuation-token --next-token

Token restituito come nextContinuationToken da una chiamata precedente, per recuperare la pagina successiva.

Proprietà Valore
Gruppo di parametri: Pagination Arguments
--max-items

Numero massimo di connessioni da restituire in questa pagina.

Proprietà Valore
Gruppo di parametri: Pagination Arguments
--show-runtime-urls

Visualizzare gli URL del runtime di connessione. L'impostazione predefinita li redigirà.

Proprietà Valore
Valore predefinito: False
Parametri globali
--debug

Aumentare la verbosità dei log per visualizzare tutti i log di debug.

Proprietà Valore
Valore predefinito: False
--help -h

Mostra questo messaggio Guida, esci.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

Proprietà Valore
Valore predefinito: False
--output -o

Formato dell'output.

Proprietà Valore
Valore predefinito: json
Valori accettati: json, jsonc, none, table, tsv, yaml, yamlc
--query

Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID.

--verbose

Aumentare il livello di dettaglio della registrazione. Usare --debug per log di debug completi.

Proprietà Valore
Valore predefinito: False

az logicapp connection show

Visualizzare una connessione cablata in un'app standard dell'app per la logica distribuita.

Legge solo connections.json tramite il proxy VFS arm. Questa visualizzazione del piano di file può essere diversa da arm Microsoft. Inventario web/connessioni. parameterValues e GLI URL di runtime vengono elaborati per impostazione predefinita; usare --show-runtime-urls solo quando è necessario l'URL di runtime nella shell corrente.

az logicapp connection show --connection
                            --name
                            --resource-group
                            [--class {managedApiConnections, serviceProviderConnections}]
                            [--show-runtime-urls]

Esempio

Mostra una connessione cablata per l'app.

az logicapp connection show --resource-group rg-lacli-ri2bg8 --name la-cli-pilot-ri2bg8 --connection cliPilotBlob

Mostra una connessione API gestita dalla classe gestita.

az logicapp connection show -g rg-lacli-ri2bg8 -n la-cli-pilot-ri2bg8 --connection office365-prod --class managedApiConnections

Parametri necessari

--connection

Nome della connessione in connections.json.

--name -n

Nome del sito Standard dell'app per la logica.

--resource-group -g

Nome del gruppo di risorse contenente il sito Standard dell'app per la logica.

Parametri facoltativi

I seguenti parametri sono facoltativi, ma a seconda del contesto, uno o più di questi potrebbero diventare necessari per l'esecuzione corretta del comando.

--class

Classe di connessione da cercare.

Proprietà Valore
Valori accettati: managedApiConnections, serviceProviderConnections
--show-runtime-urls

Visualizzare gli URL del runtime di connessione. L'impostazione predefinita li redigirà.

Proprietà Valore
Valore predefinito: False
Parametri globali
--debug

Aumentare la verbosità dei log per visualizzare tutti i log di debug.

Proprietà Valore
Valore predefinito: False
--help -h

Mostra questo messaggio Guida, esci.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

Proprietà Valore
Valore predefinito: False
--output -o

Formato dell'output.

Proprietà Valore
Valore predefinito: json
Valori accettati: json, jsonc, none, table, tsv, yaml, yamlc
--query

Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID.

--verbose

Aumentare il livello di dettaglio della registrazione. Usare --debug per log di debug completi.

Proprietà Valore
Valore predefinito: False

az logicapp connection test

Testare una connessione Standard di App per la logica configurata.

Verifica una connessione del provider di servizi cablata tramite app, una connessione API gestita cablata tramite app o un Microsoft ARM. ID risorsa Web/connections. Un connettore senza endpoint di test pubblicizzato non viene considerato integro: il comando segnala il risultato noTestAvailable, indica che la connessione non è stata verificata e termina 3. Le risposte 5xx restituite sono errori e 429 risposte sono possibiliNotReach con retryAfter conservato quando specificato.

az logicapp connection test --connection
                            --name
                            --resource-group
                            [--acquire-policy-token]
                            [--change-reference]
                            [--class {managedApiConnections, serviceProviderConnections}]

Esempio

Testare una connessione cablata per app in base al nome.

az logicapp connection test --resource-group rg-lacli-ri2bg8 --name la-cli-pilot-ri2bg8 --connection cliPilotBlob

Testare una risorsa di connessione ARM gestita in base all'ID.

az logicapp connection test -g rg-lacli-ri2bg8 -n la-cli-pilot-ri2bg8 --connection /subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg-lacli-ri2bg8/providers/Microsoft.Web/connections/office365-prod

Parametri necessari

--connection

Nome della connessione o Microsoft ARM. ID Web/connections.

--name -n

Nome del sito Standard dell'app per la logica.

--resource-group -g

Nome del gruppo di risorse contenente il sito Standard dell'app per la logica.

Parametri facoltativi

I seguenti parametri sono facoltativi, ma a seconda del contesto, uno o più di questi potrebbero diventare necessari per l'esecuzione corretta del comando.

--acquire-policy-token

Acquisizione automatica di un token Criteri di Azure per questa operazione di risorsa.

Proprietà Valore
Gruppo di parametri: Global Policy Arguments
--change-reference

ID riferimento di modifica correlato per questa operazione di risorsa.

Proprietà Valore
Gruppo di parametri: Global Policy Arguments
--class

Classe di connessione da cercare quando --connection è un nome.

Proprietà Valore
Valori accettati: managedApiConnections, serviceProviderConnections
Parametri globali
--debug

Aumentare la verbosità dei log per visualizzare tutti i log di debug.

Proprietà Valore
Valore predefinito: False
--help -h

Mostra questo messaggio Guida, esci.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

Proprietà Valore
Valore predefinito: False
--output -o

Formato dell'output.

Proprietà Valore
Valore predefinito: json
Valori accettati: json, jsonc, none, table, tsv, yaml, yamlc
--query

Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID.

--verbose

Aumentare il livello di dettaglio della registrazione. Usare --debug per log di debug completi.

Proprietà Valore
Valore predefinito: False