Guida introduttiva: Creare e gestire flussi di lavoro con Azure CLI in Azure Logic Apps

Si applica a: Azure Logic Apps (A consumo)

Questa guida introduttiva illustra come creare e gestire flussi di lavoro automatizzati eseguiti in Azure Logic Apps usando l'estensione Azure CLI Logic Apps (az logic). Dalla riga di comando, è possibile creare una Consumption logic app in Azure Logic Apps multi-tenant utilizzando un file JSON per definire il flusso di lavoro di una logic app. È quindi possibile gestire l'app per la logica eseguendo operazioni come list, show (get), update e delete dalla riga di comando.

Questa guida rapida si applica attualmente solo ai flussi di lavoro delle app della logica a consumo eseguiti nelle Azure Logic Apps multi-tenant. L'interfaccia della riga di comando di Azure non è attualmente disponibile per i flussi di lavoro di Logic App Standard eseguiti in Azure Logic Apps 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 Azure Logic Apps, scopri come creare il primo flusso di lavoro dell'app per il consumo nel portale di Azure o in Visual Studio Code.

Prerequisiti

• Account e sottoscrizione di Azure. Ottenere un account gratuito.

• L'CLI di Azure installata nel computer locale.

• Estensione CLI di Azure Logic Apps installata sul tuo 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:

È anche possibile includere altri parametri facoltativi 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.

Aggiorna app di logica dal CLI

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'applicazione 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 aggiornata del flusso di lavoro dell'app per la logica. Se l'aggiornamento non riesce, vedere l'elenco dei possibili errori.

Eliminare app logiche dal CLI

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:

È anche possibile includere un parametro facoltativo, --yes -y, per ignorare le richieste di conferma.

az logic workflow delete --name
                         --resource-group
                         [--yes]

Il CLI quindi chiede di confermare l'eliminazione della tua app 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 logica, elenca le app logiche nel CLI o visualizza le app logiche nel portale di Azure.

Esempio - Eliminare un'applicazione 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'applicazione 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:

• Azure Logic Apps si impegna al massimo per annullare eventuali esecuzioni in corso e sospese.

  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.

• Azure Logic Apps non creano né eseguono 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 ha 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:

Esempio - Ottenere Logic App

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:

az logic workflow list [--filter]
                       [--resource-group]
                       [--top]

Esempio - Elenco di applicazioni logiche

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 CLI di Azure Logic Apps 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:

Passaggi successivi

Per altre informazioni sull'interfaccia della riga di comando di Azure, vedere la documentazione sull'interfaccia della riga di comando di Azure.

Altri esempi di script della CLI di Azure Logic Apps sono disponibili 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.