Guia de início rápido: criar e gerenciar fluxos de trabalho com o Azure PowerShell nos Aplicativos Lógicos do Azure

Aplica-se a: Aplicativos Lógicos do Azure (Consumo)

Este guia de início rápido mostra como criar e gerenciar fluxos de trabalho automatizados que são executados nos Aplicativos Lógicos do Azure usando o Azure PowerShell. No PowerShell, você pode criar um aplicativo lógico de Consumo em Aplicativos Lógicos do Azure multilocatários usando o arquivo JSON para uma definição de fluxo de trabalho de aplicativo lógico. Em seguida, você pode gerenciar seu aplicativo lógico executando os cmdlets no módulo Az.LogicApp PowerShell.

Nota

Atualmente, este início rápido aplica-se apenas a fluxos de trabalho de aplicativos lógicos de consumo executados em Aplicativos Lógicos do Azure multilocatário. O Azure PowerShell está atualmente indisponível para fluxos de trabalho de aplicativos lógicos padrão executados em Aplicativos Lógicos do Azure de locatário único. Para obter mais informações, consulte Tipo de recurso e diferenças de host nos Aplicativos Lógicos do Azure.

Se você é novo nos Aplicativos Lógicos do Azure, saiba como criar seu primeiro fluxo de trabalho de aplicativo lógico de consumo por meio do portal do Azure ou no Visual Studio Code.

Pré-requisitos

• Uma conta do Azure com uma subscrição ativa. Se não tiver uma subscrição do Azure, crie uma conta gratuita.

• O módulo Az PowerShell instalado no computador local.

• Um grupo de recursos do Azure no qual criar seu aplicativo lógico.

Verificação de pré-requisitos

Antes de começar, valide seu ambiente:

• Entre no portal do Azure e verifique se sua assinatura está ativa executando Connect-AzAccount.

• Verifique sua versão do Azure PowerShell executando Get-InstalledModule -Name Azo . Para obter a versão mais recente, consulte as notas de versão mais recentes.

  Se você não tiver a versão mais recente, atualize sua instalação seguindo as etapas para Atualizar o módulo do Azure PowerShell.

Exemplo - Criar grupo de recursos

Se você ainda não tiver um grupo de recursos para seu aplicativo lógico, crie o grupo com o cmdlet New-AzResourceGroup . Por exemplo, o comando a seguir cria um grupo de recursos nomeado testResourceGroup no local westus.

New-AzResourceGroup -Name testResourceGroup -Location westus

A saída mostra como ProvisioningStateSucceeded quando o grupo de recursos é criado com êxito:

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

Definição do fluxo de trabalho

Antes de criar um novo aplicativo lógico ou atualizar um aplicativo lógico existente usando o Azure PowerShell, você precisa de uma definição de fluxo de trabalho para seu aplicativo lógico. Para ver um exemplo de definição de fluxo de trabalho, no portal do Azure, abra qualquer fluxo de trabalho de aplicativo lógico existente no designer. Na barra de ferramentas Designer , selecione Visualização de código, que mostra a definição subjacente do fluxo de trabalho no formato JSON.

Quando você executa os comandos para criar ou atualizar seu aplicativo lógico, sua definição de fluxo de trabalho é carregada como um parâmetro necessário (Definition) ou (DefinitionFilePath), dependendo do conjunto de parâmetros. Você deve criar sua definição de fluxo de trabalho como um arquivo JSON que siga o esquema da Linguagem de Definição de Fluxo de Trabalho.

Criar aplicativos lógicos a partir do PowerShell

Para criar um fluxo de trabalho de aplicativo lógico do Azure PowerShell, use o cmdlet New-AzLogicApp com um arquivo JSON para a definição.

Exemplo - Criar aplicativo lógico

Este exemplo cria um fluxo de trabalho nomeado testLogicApp no grupo testResourceGroup de recursos com o local westus. O arquivo testDefinition.json JSON contém a definição do fluxo de trabalho.

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

Quando o fluxo de trabalho é criado com êxito, o PowerShell mostra sua nova definição de fluxo de trabalho.

Atualizar aplicativos lógicos do PowerShell

Para atualizar o fluxo de trabalho de um aplicativo lógico do Azure PowerShell, use o cmdlet Set-AzLogicApp.

Exemplo - Atualizar aplicativo lógico

Este exemplo mostra como atualizar o fluxo de trabalho de exemplo criado na seção anterior usando um arquivo de definição JSON diferente, newTestDefinition.json.

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

Quando seu fluxo de trabalho é atualizado com êxito, o PowerShell mostra a definição de fluxo de trabalho atualizada do seu aplicativo lógico.

Excluir aplicativos lógicos do PowerShell

Para excluir o fluxo de trabalho de um aplicativo lógico do Azure PowerShell, use o cmdlet Remove-AzLogicApp.

Exemplo - Excluir aplicativo lógico

Este exemplo exclui o fluxo de trabalho de exemplo criado em uma seção anterior.

Remove-AzLogicApp -ResourceGroupName testResourceGroup -Name testLogicApp

Depois de responder ao prompt de confirmação com y, o aplicativo lógico é excluído.

Considerações - Excluir aplicativo lógico

A exclusão de um aplicativo lógico afeta as instâncias de fluxo de trabalho das seguintes maneiras:

• Os Aplicativos Lógicos do Azure fazem o melhor esforço para cancelar quaisquer execuções em andamento e pendentes.

  Mesmo com um grande volume ou lista de pendências, a maioria das execuções são canceladas antes de terminarem ou começarem. No entanto, o processo de cancelamento pode levar tempo para ser concluído. Enquanto isso, algumas execuções podem ser pegas para execução enquanto o tempo de execução funciona através do processo de cancelamento.

• Os Aplicativos Lógicos do Azure não criam nem executam novas instâncias de fluxo de trabalho.

• Se você excluir um fluxo de trabalho e, em seguida, recriar o mesmo fluxo de trabalho, o fluxo de trabalho recriado não terá os mesmos metadados que o fluxo de trabalho excluído. Você precisa salvar novamente qualquer fluxo de trabalho chamado fluxo de trabalho excluído. Dessa forma, o chamador obtém as informações corretas para o fluxo de trabalho recriado. Caso contrário, as chamadas para o fluxo de trabalho recriado falharão com um Unauthorized erro. Esse comportamento também se aplica a fluxos de trabalho que usam artefatos em contas de integração e fluxos de trabalho que chamam funções do Azure.

Mostrar aplicativos lógicos no PowerShell

Para obter um fluxo de trabalho de aplicativo lógico específico, use o comando Get-AzLogicApp.

Exemplo - Obter aplicativo lógico

Este exemplo retorna o aplicativo testLogicApp lógico no grupo testResourceGroupde recursos .

Get-AzLogicApp -ResourceGroupName testResourceGroup -Name testLogicApp

Próximos passos

Para obter mais informações sobre o Azure PowerShell, consulte a documentação do Azure PowerShell.

Você pode encontrar exemplos de script adicionais de Aplicativos Lógicos no navegador de exemplos de código da Microsoft.