Leer en inglés

Compartir a través de


Inicio rápido: Creación y administración de flujos de trabajo con Azure PowerShell en Azure Logic Apps

Se aplica a: Azure Logic Apps (consumo)

En este inicio rápido se muestra cómo crear y administrar flujos de trabajo automatizados que ejecutan en Azure Logic Apps mediante Azure PowerShell. En PowerShell, se puede crear una aplicación lógica de consumo en Azure Logic Apps multiinquilino mediante el archivo JSON de una definición del flujo de trabajo de una aplicación lógica. A continuación, puede administrar la aplicación lógica mediante la ejecución de los cmdlets del módulo Az.LogicApp de PowerShell.

Nota

Este inicio rápido se aplica actualmente solo a los flujos de trabajo de la aplicación lógica de consumo que se ejecutan en Azure Logic Apps multiinquilino. Azure PowerShell no está disponible actualmente para los flujos de trabajo de aplicaciones lógicas estándar que se ejecutan en Azure Logic Apps de un solo inquilino. Para más información, consulte Diferencias de tipo de recurso y host en Azure Logic Apps.

Si no está familiarizado con Azure Logic Apps, aprenda a crear su primer flujo de trabajo de una aplicación lógica de consumo mediante Azure Portal, o en Visual Studio Code.

Requisitos previos

Comprobación de requisitos previos

Antes de empezar valide el entorno:

Ejemplo: creación de un grupo de recursos

Si aún no tiene un grupo de recursos para la aplicación lógica, créelo con el cmdlet New-AzResourceGroup. Por ejemplo, el siguiente comando crea un grupo de recursos denominado testResourceGroup en la ubicación westus.

Azure PowerShell
New-AzResourceGroup -Name testResourceGroup -Location westus

La salida muestra ProvisioningState como Succeeded cuando el grupo de recursos se crea correctamente:

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

Definición del flujo de trabajo

Antes de crear una aplicación lógica o actualizar una aplicación lógica ya existente mediante Azure PowerShell, necesita una definición de flujo de trabajo de la aplicación lógica. Para ver una definición de flujo de trabajo de ejemplo, en Azure Portal, abra cualquier flujo de trabajo de aplicación lógica existente en el diseñador. En la barra de herramientas del Diseñador, seleccione vista Código, que muestra la definición subyacente del flujo de trabajo en formato JSON.

Cuando se ejecutan los comandos para crear o actualizar la aplicación lógica, la definición de flujo de trabajo se carga como un parámetro requerido (Definition) o (DefinitionFilePath), en función del conjunto de parámetros. La definición del flujo de trabajo se debe crear en forma de archivo JSON que siga el esquema del lenguaje de definición de flujo de trabajo.

Creación de aplicaciones lógicas desde PowerShell

Para crear un flujo de trabajo de aplicaciones lógicas desde Azure PowerShell, use el cmdlet New-AzLogicApp con un archivo JSON para la definición.

Ejemplo: creación de una aplicación lógica

En este ejemplo, se crea un flujo de trabajo llamado testLogicApp en el grupo de recursos testResourceGroup en la ubicación westus. El archivo JSON testDefinition.json contiene la definición del flujo de trabajo.

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

Cuando el flujo de trabajo se crea correctamente, PowerShell muestra la definición del nuevo flujo de trabajo.

Actualización de aplicaciones lógicas desde PowerShell

Para actualizar el flujo de trabajo de una aplicación lógica desde Azure PowerShell, use el cmdlet Set-AzLogicApp.

Ejemplo: actualización de una aplicación lógica

En este ejemplo, se muestra cómo actualizar el flujo de trabajo de ejemplo creado en la sección anterior mediante otro archivo de definición JSON, newTestDefinition.json.

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

Cuando el flujo de trabajo se actualiza correctamente, PowerShell muestra la definición de flujo de trabajo actualizada de la aplicación lógica.

Eliminación de aplicaciones lógicas desde PowerShell

Para eliminar el flujo de trabajo de una aplicación lógica desde Azure PowerShell, use el cmdlet Remove-AzLogicApp.

Ejemplo: eliminación de una aplicación lógica

En este ejemplo, se elimina el flujo de trabajo de ejemplo creado en una sección anterior.

Azure PowerShell
Remove-AzLogicApp -ResourceGroupName testResourceGroup -Name testLogicApp

Después de responder al aviso de confirmación con y, se elimina la aplicación lógica.

Aspectos que se deben tener en cuenta: eliminación de una aplicación lógica

Eliminar una aplicación lógica afecta a las instancias de flujo de trabajo de las maneras siguientes:

  • Azure Logic Apps hace todo lo posible por cancelar todas las ejecuciones en curso y pendientes.

    Incluso con un gran volumen o trabajo pendiente, la mayoría de las ejecuciones se cancelan antes de que finalicen o se inicien. Sin embargo, el proceso de cancelación puede tardar en completarse. Mientras tanto, pueden seleccionarse algunas ejecuciones para su ejecución mientras el entorno en tiempo de ejecución se encarga del proceso de cancelación.

  • Azure Logic Apps no crea ni ejecuta nuevas instancias de flujo de trabajo.

  • Si elimina un flujo de trabajo y, luego, vuelve a crear el mismo flujo de trabajo, el flujo de trabajo recreado no tendrá los mismos metadatos que el flujo de trabajo eliminado. Tiene que volver a guardar todo flujo de trabajo que haya llamado al flujo de trabajo eliminado. De este modo, el autor de la llamada obtiene la información correcta para el flujo de trabajo recreado. De lo contrario, las llamadas al flujo de trabajo recreado producirán un error Unauthorized. Este comportamiento también se aplica a los flujos de trabajo que usan artefactos en cuentas de integración y a flujos de trabajo que llaman a funciones de Azure.

Visualización de aplicaciones lógicas en PowerShell

Para obtener un flujo de trabajo de aplicación lógica específica, use el comando Get-AzLogicApp.

Ejemplo: obtención de una aplicación lógica

En este ejemplo, se devuelve la aplicación lógica testLogicApp del grupo de recursos testResourceGroup.

Azure PowerShell
Get-AzLogicApp -ResourceGroupName testResourceGroup -Name testLogicApp

Pasos siguientes

Para más información sobre Azure PowerShell, consulte la documentación de Azure PowerShell.

Puede encontrar más ejemplos de scripts de Logic Apps en el explorador de ejemplos de código de Microsoft.