Guida introduttiva: Creare e gestire flussi di lavoro con Azure PowerShell 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 Azure PowerShell. Da PowerShell è 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 i cmdlet nel modulo Az.LogicApp PowerShell.

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 tramite il 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.

• Il modulo Az PowerShell installato nel computer locale.

• 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 Connect-AzAccount.

• Controllare la versione di Azure PowerShell eseguendo Get-InstalledModule -Name Az. Per la versione più recente, vedere le ultime note sulla versione.

  Se non si ha la versione più recente, aggiornare l'installazione seguendo i passaggi per Aggiornare il modulo azure PowerShell.

Esempio - Creare un gruppo di risorse

Se non si ha già un gruppo di risorse per l'app per la logica, creare il gruppo con il cmdlet New-AzResourceGroup . Il comando seguente ad esempio crea un gruppo di risorse denominato testResourceGroup nella posizione westus.

New-AzResourceGroup -Name testResourceGroup -Location westus

L'output mostra ProvisioningState come Succeeded quando il gruppo di risorse viene creato correttamente:

ResourceGroupName : testResourceGroup
Location          : westus
ProvisioningState : Succeeded
Tags              :
ResourceId        : /subscriptions/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/resourceGroups/testResourceGroup

Definizione flusso di lavoro

Prima di creare una nuova app per la logica o aggiornare un'app per la logica esistente usando Azure PowerShell, è necessaria una definizione del flusso di lavoro per l'app per la logica. Per visualizzare una definizione del flusso di lavoro di esempio, nella portale di Azure aprire qualsiasi flusso di lavoro dell'app per la logica esistente nella finestra di progettazione. Sulla barra degli strumenti della finestra di progettazione selezionare Visualizzazione codice, che mostra la definizione sottostante del flusso di lavoro in formato JSON.

Quando si eseguono i comandi per creare o aggiornare l'app per la logica, la definizione del flusso di lavoro viene caricata come parametro obbligatorio (Definition) o (DefinitionFilePath) a seconda del set di parametri. È 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 da PowerShell

Per creare un flusso di lavoro dell'app per la logica da Azure PowerShell, usare il cmdlet New-AzLogicApp con un file JSON per la definizione.

Esempio - Creare un'app per la logica

In questo esempio viene creato un flusso di lavoro denominato testLogicApp nel gruppo testResourceGroup di risorse con il percorso westus. Il file JSON testDefinition.json contiene la definizione flusso di lavoro.

New-AzLogicApp -ResourceGroupName testResourceGroup -Location westus -Name testLogicApp -DefinitionFilePath .\testDefinition.json

Quando il flusso di lavoro viene creato correttamente, PowerShell visualizza la nuova definizione del flusso di lavoro.

Aggiornare le app per la logica da PowerShell

Per aggiornare il flusso di lavoro di un'app per la logica da Azure PowerShell, usare il cmdlet Set-AzLogicApp.

Esempio - Aggiornare l'app per la logica

Questo esempio illustra come aggiornare il flusso di lavoro di esempio creato nella sezione precedente usando un file di definizione JSON diverso, newTestDefinition.json.

Set-AzLogicApp -ResourceGroupName testResourceGroup -Name testLogicApp -DefinitionFilePath .\newTestDefinition.json

Quando il flusso di lavoro viene aggiornato correttamente, PowerShell mostra la definizione aggiornata del flusso di lavoro dell'app per la logica.

Eliminare app per la logica da PowerShell

Per eliminare il flusso di lavoro di un'app per la logica da Azure PowerShell, usare il cmdlet Remove-AzLogicApp.

Esempio - Eliminare un'app per la logica

In questo esempio viene eliminato il flusso di lavoro di esempio creato in una sezione precedente.

Remove-AzLogicApp -ResourceGroupName 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.

Visualizzare le app per la logica in PowerShell

Per ottenere un flusso di lavoro specifico dell'app per la logica, usare il comando Get-AzLogicApp.

Esempio - Ottenere un'app per la logica

Questo esempio restituisce l'app testLogicApp per la logica nel gruppo testResourceGroupdi risorse .

Get-AzLogicApp -ResourceGroupName testResourceGroup -Name testLogicApp

Passaggi successivi

Per altre informazioni su Azure PowerShell, vedere la documentazione di Azure PowerShell.

È possibile trovare altri esempi di script di App per la logica nel browser degli esempi di codice di Microsoft.