Guida introduttiva: Creare e gestire flussi di lavoro con l'interfaccia della riga di comando di Azure in App per la logica di Azure
Si applica a: App per la logica di Azure (A consumo)
Questa guida introduttiva illustra come creare e gestire flussi di lavoro automatizzati eseguiti in App per la logica di Azure usando l'estensione App per la logica dell'interfaccia della riga di comando di Azure (az logic
). Dalla riga di comando è possibile creare un'app per la logica a consumo in App per la logica di Azure multi-tenant usando il file JSON per una definizione del flusso di lavoro dell'app per la logica. È quindi possibile gestire l'app per la logica eseguendo operazioni come list
, show
(get
), update
e delete
dalla riga di comando.
Avviso
L'estensione app per la logica dell'interfaccia della riga di comando di Azure è attualmente sperimentale e non è coperta dall'assistenza clienti. Usare questa estensione dell'interfaccia della riga di comando con cautela, soprattutto se si sceglie di usare l'estensione negli ambienti di produzione.
Questo argomento di avvio rapido si applica attualmente solo ai flussi di lavoro dell'app per la logica a consumo eseguiti in App per la logica di Azure multi-tenant. L'interfaccia della riga di comando di Azure non è attualmente disponibile per i flussi di lavoro dell'app per la logica Standard eseguiti in App per la logica di Azure a tenant singolo. Per altre informazioni, vedere Differenze tra tipo di risorsa e host in App per la logica di Azure.
Se non si ha familiarità con App per la logica di Azure, informazioni su come creare il primo flusso di lavoro dell'app per la logica a consumo nel portale di Azure o in Visual Studio Code.
Prerequisiti
Un account Azure con una sottoscrizione attiva. Se non hai una sottoscrizione di Azure, crea un account gratuito.
L'interfaccia della riga di comando di Azure installata nel computer locale.
Estensione dell'interfaccia della riga di comando di App per la logica di Azure installata nel computer. Per installare questa estensione, usare il comando seguente:
az extension add --name logic
Un gruppo di risorse di Azure in cui creare un'app per la logica.
Verifica dei prerequisiti
Prima di iniziare, convalidare l'ambiente:
Accedere al portale di Azure e verificare che la sottoscrizione sia attiva eseguendo
az login
.Controllare la versione dell'interfaccia della riga di comando di Azure in una finestra terminale o di comando eseguendo
az --version
. Per la versione più recente, vedere le ultime note sulla versione.Se non si dispone della versione più recente, aggiornare l'installazione seguendo la guida all'installazione per il sistema operativo o la piattaforma in uso.
Esempio - Creare un gruppo di risorse
Se non si dispone già di un gruppo di risorse per l'app per la logica, crearlo con il comando az group create
. Il comando seguente ad esempio crea un gruppo di risorse denominato testResourceGroup
nella posizione westus
.
az group create --name testResourceGroup --location westus
L'output mostra provisioningState
come Succeeded
quando il gruppo di risorse viene creato correttamente:
<...>
"name": "testResourceGroup",
"properties": {
"provisioningState": "Succeeded"
},
<...>
Definizione flusso di lavoro
Prima di creare una nuova app per la logica o di aggiornare un'app per la logica esistente usando l'interfaccia della riga di comando di Azure, è necessaria una definizione flusso di lavoro per l'app per la logica. Nel portale di Azure è possibile visualizzare la definizione flusso di lavoro sottostante dell'app per la logica in formato JSON passando dalla visualizzazione Finestra di progettazione a Visualizzazione codice.
Quando si eseguono i comandi per creare o aggiornare l'app per la logica, la definizione flusso di lavoro viene caricata come parametro obbligatorio (--definition
). È necessario creare la definizione flusso di lavoro come file JSON che segue lo schema del linguaggio di definizione flusso di lavoro.
Creare app per la logica dall'interfaccia della riga di comando
Per creare un flusso di lavoro dell'app per la logica dall'interfaccia della riga di comando di Azure, usare il comando az logic workflow create
con un file JSON per la definizione.
az logic workflow create --definition
--location
--name
--resource-group
[--access-control]
[--endpoints-configuration]
[--integration-account]
[--state {Completed, Deleted, Disabled, Enabled, NotSpecified, Suspended}]
[--tags]
Il comando deve includere i parametri obbligatori seguenti:
Parametro | valore | Descrizione |
---|---|---|
Definizione flusso di lavoro | --definition |
File JSON con la definizione flusso di lavoro dell'app per la logica. |
Ufficio | --location -l |
Area di Azure in cui si trova l'app per la logica. |
Nome | --name -n |
Nome dell'app per la logica. Il nome può contenere solo lettere, numeri, trattini (- ), caratteri di sottolineatura (_ ), parentesi (() ) e punti (. ). Il nome inoltre deve essere univoco tra le aree. |
Nome del gruppo di risorse | --resource-group -g |
Gruppo di risorse di Azure in cui si intende creare un'app per la logica. Prima di iniziare, creare un gruppo di risorse se non ne è già presente uno per l'app per la logica. |
È anche possibile includere parametri facoltativi aggiuntivi per configurare i controlli di accesso, gli endpoint, l'account di integrazione, lo stato e i tag delle risorse dell'app per la logica.
Esempio - Creare un'app per la logica
In questo esempio viene creato un flusso di lavoro denominato testLogicApp
nel gruppo di risorse testResourceGroup
nella posizione westus
. Il file JSON testDefinition.json
contiene la definizione flusso di lavoro.
az logic workflow create --resource-group "testResourceGroup" --location "westus" --name "testLogicApp" --definition "testDefinition.json"
Quando il flusso di lavoro viene creato correttamente, l'interfaccia della riga di comando mostra il codice JSON della nuova definizione flusso di lavoro. Se la creazione del flusso di lavoro non riesce, vedere l'elenco dei possibili errori.
Aggiornare app per la logica dall'interfaccia della riga di comando
Per aggiornare il flusso di lavoro di un'app per la logica dall'interfaccia della riga di comando di Azure, usare il comando az logic workflow create
.
Il comando deve includere gli stessi parametri obbligatori usati quando si crea un'app per la logica. È anche possibile aggiungere gli stessi parametri facoltativi usati per la creazione di un'app per la logica.
az logic workflow create --definition
--location
--name
--resource-group
[--access-control]
[--endpoints-configuration]
[--integration-account]
[--integration-service-environment]
[--state {Completed, Deleted, Disabled, Enabled, NotSpecified, Suspended}]
[--tags]
Esempio - Aggiornare l'app per la logica
In questo esempio il flusso di lavoro di esempio creato nella sezione precedente viene aggiornato in modo da usare un file di definizione JSON diverso, newTestDefinition.json
, e aggiungere due tag di risorsa testTag1
e testTag2
con valori di descrizione.
az logic workflow create --resource-group "testResourceGroup" --location "westus" --name "testLogicApp" --definition "newTestDefinition.json" --tags "testTag1=testTagValue1" "testTag2=testTagValue"
Quando il flusso di lavoro viene aggiornato correttamente, l'interfaccia della riga di comando mostra la definizione flusso di lavoro aggiornata dell'app per la logica. Se l'aggiornamento non riesce, vedere l'elenco dei possibili errori.
Eliminare app per la logica dall'interfaccia della riga di comando
Per eliminare il flusso di lavoro di un'app per la logica dall'interfaccia della riga di comando di Azure, usare il comando az logic workflow delete
.
Il comando deve includere i parametri obbligatori seguenti:
Parametro | valore | Descrizione |
---|---|---|
Nome | --name -n |
Nome dell'app per la logica. |
Nome del gruppo di risorse | -resource-group -g |
Gruppo di risorse in cui si trova l'app per la logica. |
È anche possibile includere un parametro facoltativo, --yes -y
, per ignorare le richieste di conferma.
az logic workflow delete --name
--resource-group
[--yes]
L'interfaccia della riga di comando chiede quindi di confermare l'eliminazione dell'app per la logica. È possibile ignorare la richiesta di conferma usando con il comando il parametro facoltativo --yes -y
.
Are you sure you want to perform this operation? (y/n):
Per confermare l'eliminazione di un'app per la logica, elencare le app per la logica nell'interfaccia della riga di comando o visualizzare le app per la logica nel portale di Azure.
Esempio - Eliminare un'app per la logica
In questo esempio viene eliminato il flusso di lavoro di esempio creato in una sezione precedente.
az logic workflow delete --resource-group "testResourceGroup" --name "testLogicApp"
Dopo aver risposto alla richiesta di conferma con y
, l'app per la logica viene eliminata.
Considerazioni - Eliminare l'app per la logica
L'eliminazione di un'app per la logica influisce sulle istanze del flusso di lavoro nei modi seguenti:
App per la logica di Azure fa il massimo sforzo per annullare le esecuzioni in corso e in sospeso.
Anche con un volume o un backlog di grandi dimensioni, la maggior parte delle esecuzioni viene annullata prima del completamento o dell'avvio. Tuttavia, il processo di annullamento potrebbe richiedere tempo. Nel frattempo, alcune esecuzioni potrebbero essere prelevate per l'esecuzione mentre il runtime funziona tramite il processo di annullamento.
App per la logica di Azure non crea o esegue nuove istanze del flusso di lavoro.
Se si elimina un flusso di lavoro e quindi si ricrea lo stesso flusso di lavoro, il flusso di lavoro ricreato non avrà gli stessi metadati del flusso di lavoro eliminato. È necessario ricampionare qualsiasi flusso di lavoro che ha chiamato il flusso di lavoro eliminato. In questo modo, il chiamante ottiene le informazioni corrette per il flusso di lavoro ricreato. In caso contrario, le chiamate al flusso di lavoro ricreato hanno esito negativo con un errore
Unauthorized
. Questo comportamento si applica anche ai flussi di lavoro che usano artefatti negli account di integrazione e nei flussi di lavoro che chiamano funzioni di Azure.
Mostrare le app per la logica nell'interfaccia della riga di comando
Per ottenere un flusso di lavoro specifico dell'app per la logica, usare il comando az logic workflow show
.
az logic workflow show --name
--resource-group
Il comando deve includere i parametri obbligatori seguenti:
Parametro | valore | Descrizione |
---|---|---|
Nome | --name -n |
Nome dell'app per la logica. |
Nome del gruppo di risorse | --resource-group -g |
Nome del gruppo di risorse in cui si trova l'app per la logica. |
Esempio - Ottenere un'app per la logica
In questo esempio viene restituita l'app per la logica testLogicApp
nel gruppo di risorse testResourceGroup
con log completi per il debug.
az logic workflow show --resource-group "testResourceGroup" --name "testLogicApp" --debug
Elencare le app per la logica nell'interfaccia della riga di comando
Per elencare le app per la logica per sottoscrizione, usare il comando az logic workflow list
. Questo comando restituisce il codice JSON per i flussi di lavoro dell'app per la logica.
È possibile filtrare i risultati in base ai parametri facoltativi seguenti:
Parametro | valore | Descrizione |
---|---|---|
Nome del gruppo di risorse | --resource-group -g |
Nome del gruppo di risorse in base al quale filtrare i risultati. |
Numero di articoli | --top |
Numero di elementi inclusi nei risultati. |
Filtro | --filter |
Tipo di filtro che si sta usando nell'elenco. È possibile filtrare in base allo stato (State ), al trigger (Trigger ) e all'identificatore della risorsa a cui si fa riferimento (ReferencedResourceId ). |
az logic workflow list [--filter]
[--resource-group]
[--top]
Esempio - Elencare le app per la logica
In questo esempio vengono restituiti tutti i flussi di lavoro abilitati nel gruppo di risorse testResourceGroup
in un formato di tabella ASCII.
az logic workflow list --resource-group "testResourceGroup" --filter "(State eq 'Enabled')" --output "table"
Errori
L'errore seguente indica che l'estensione app per la logica dell'interfaccia della riga di comando di Azure non è installata. Seguire la procedura descritta nella sezione relativa ai prerequisiti per installare l'estensione app per la logica nel computer.
az: 'logic' is not in the 'az' command group. See 'az --help'. If the command is from an extension, please make sure the corresponding extension is installed. To learn more about extensions, please visit https://learn.microsoft.com/cli/azure/azure-cli-extensions-overview
L'errore seguente potrebbe indicare che il percorso di file per il caricamento della definizione flusso di lavoro non è corretto.
Expecting value: line 1 column 1 (char 0)
Parametri globali
Con i comandi az logic
è possibile usare i parametri facoltativi globali dell'interfaccia della riga di comando di Azure seguenti:
Parametro | valore | Descrizione |
---|---|---|
Formato di output | --output -o |
Cambia il formato di output rispetto al formato JSON predefinito. |
Mostra solo errori | --only-show-errors |
Non visualizza gli avvisi e mostra solo gli errori. |
Verbose | --verbose |
Mostra log dettagliati. |
Debug | --debug |
Mostra tutti i log di debug. |
Messaggio di aiuto | --help -h |
Visualizza la finestra della Guida. |
Query | --query |
Imposta una stringa di query JMESPath per l'output JSON. |
Passaggi successivi
Per altre informazioni sull'interfaccia della riga di comando di Azure, vedere la documentazione sull'interfaccia della riga di comando di Azure.
È possibile trovare altri esempi di script dell'interfaccia della riga di comando App per la logica di Azure nel browser degli esempi di codice di Microsoft.
Successivamente, è possibile creare un'app per la logica di esempio tramite l'interfaccia della riga di comando di Azure usando una definizione del flusso di lavoro e uno script di esempio.