Habilitación del modo con estado para conectores integrados sin estado en Azure Logic Apps

Se aplica a: Azure Logic Apps (estándar)

En los flujos de trabajo de aplicación lógica estándar, los siguientes conectores integrados basados en el proveedor de servicios no tienen estado, de forma predeterminada:

  • Azure Service Bus
  • SAP
  • IBM MQ

Para ejecutar estas operaciones del conector en modo con estado, debe habilitar esta funcionalidad. En esta guía paso a paso se muestra cómo habilitar el modo con estado para estos conectores.

Requisitos previos

Habilitación del modo con estado en Azure Portal

  1. En Azure Portal, abra el recurso aplicación lógica estándar donde desea habilitar el modo con estado para estas operaciones del conector.

  2. Habilite la integración de red virtual para la aplicación lógica y agregue la aplicación lógica a la subred creada anteriormente:

    1. En el recurso de menú de la aplicación lógica, en Configuración, seleccione Redes.

    2. En la sección Tráfico saliente, seleccione Integración de red virtual>Agregar red virtual.

    3. En el panel Agregar integración con red virtual que se abre, seleccione la suscripción de Azure y la red virtual.

    4. En Subred, seleccione Seleccionar existente. En la lista Subred , seleccione la subred en la que desea agregar la aplicación lógica.

    5. Cuando termine, elija Aceptar.

      En la página Redes , la opción integración de red virtual ahora aparece establecida en Activado, por ejemplo:

      Screenshot shows Azure portal, Standard logic app resource, Networking page, VNet integration set to On.

    Para obtener información general sobre cómo habilitar la integración de red virtual con la aplicación, consulte Habilitación de la integración de red virtual en App de Azure Service.

  3. A continuación, actualice la configuración del sitio web subyacente de la aplicación lógica (<logic-app-name.azurewebsites.net>) mediante cualquiera de las siguientes herramientas:

Actualización de la configuración del sitio web para la aplicación lógica

Después de habilitar la integración de red virtual para la aplicación lógica, debe actualizar la configuración del sitio web subyacente de la aplicación lógica (<logic-app-name.azurewebsites.net>) mediante uno de los métodos siguientes:

  • Azure Portal (el token de portador no es necesario)
  • API de Azure Resource Management (token de portador necesario)
  • Azure PowerShell (el token de portador no es necesario)

Azure portal

Para configurar puertos privados de red virtual mediante Azure Portal, siga estos pasos:

  1. En Azure Portal, busque y abra el recurso de aplicación lógica estándar.
  2. En el menú de la aplicación lógica, en Configuración, seleccione Configuración.
  3. En la página Configuración , seleccione Configuración general.
  4. En Configuración de la plataforma, en el cuadro Puertos privados de red virtual, escriba los puertos que desea usar.

API de Administración de recursos de Azure

Para completar esta tarea con la API de Azure Resource Management: actualizar por identificador, revise los siguientes requisitos, sintaxis y valores de parámetros.

Requisitos

Se requiere autorización de OAuth y el token de portador. Para obtener el token de portador, siga estos pasos.

  1. Mientras ha iniciado sesión en Azure Portal, abra las herramientas de desarrollo del explorador web (F12).

  2. Obtenga el token mediante el envío de cualquier solicitud de administración, por ejemplo, guardando un flujo de trabajo en la aplicación lógica estándar.

Sintaxis

Novedades un recurso mediante el identificador de recurso especificado:

PATCH https://management.azure.com/{resourceId}?api-version=2021-04-01

Valores de parámetros

Elemento Value Descripción
Método de solicitud HTTP PATCH
<resourceId> subscriptions/{yourSubscriptionID}/resourcegroups/{yourResourceGroup}/providers/Microsoft.Web/sites/{websiteName}/config/web
<yourSubscriptionId> El identificador de la suscripción de Azure
<yourResourceGroup> El grupo de recursos que contiene el recurso de la aplicación lógica
<websiteName> Nombre del recurso de la aplicación lógica, que es mystandardlogicapp en este ejemplo.
El cuerpo de la solicitud HTTP {"properties": {"vnetPrivatePortsCount": "2"}}

Ejemplo

https://management.azure.com/subscriptions/XXxXxxXX-xXXx-XxxX-xXXX-XXXXxXxXxxXX/resourcegroups/My-Standard-RG/providers/Microsoft.Web/sites/mystandardlogicapp/config/web?api-version=2021-02-01

Azure PowerShell

Para completar esta tarea con Azure PowerShell, revise los siguientes requisitos, sintaxis y valores. Este método no requiere que obtenga manualmente el token de portador.

Sintaxis

Set-AzContext -Subscription {yourSubscriptionID}
$webConfig = Get-AzResource -ResourceId {resourceId}
$webConfig.Properties.vnetPrivatePortsCount = 2
$webConfig | Set-AzResource -ResourceId {resourceId}

Para más información, consulte la siguiente documentación:

Valores de parámetros

Elemento Value
<yourSubscriptionID> El identificador de la suscripción de Azure
<resourceId> subscriptions/{yourSubscriptionID}/resourcegroups/{yourResourceGroup}/providers/Microsoft.Web/sites/{websiteName}/config/web
<yourResourceGroup> El grupo de recursos que contiene el recurso de la aplicación lógica
<websiteName> Nombre del recurso de la aplicación lógica, que es mystandardlogicapp en este ejemplo.

Ejemplo

https://management.azure.com/subscriptions/XXxXxxXX-xXXx-XxxX-xXXX-XXXXxXxXxxXX/resourcegroups/My-Standard-RG/providers/Microsoft.Web/sites/mystandardlogicapp/config/web?api-version=2021-02-01

Solución de errores

Error: El recuento de instancias reservadas no es válido

Si recibe un error que indica Que el recuento de instancias reservadas no es válido, use la siguiente solución alternativa:

$webConfig.Properties.preWarmedInstanceCount = $webConfig.Properties.reservedInstanceCount
$webConfig.Properties.reservedInstanceCount = $null
$webConfig | Set-AzResource -ResourceId {resourceId}

Ejemplo de error:

Set-AzResource :
{
   "Code":"BadRequest",
   "Message":"siteConfig.ReservedInstanceCount is invalid.  Please use the new property siteConfig.PreWarmedInstanceCount.",
   "Target": null,
   "Details":
   [
      {
         "Message":"siteConfig.ReservedInstanceCount is invalid. Please use the new property siteConfig.PreWarmedInstanceCount."
      },
      {
         "Code":"BadRequest"
      },
      {
         "ErrorEntity":
         {
            "ExtendedCode":"51021",
            "MessageTemplate":"{0} is invalid. {1}",
            "Parameters":
            [
               "siteConfig.ReservedInstanceCount", "Please use the new property siteConfig.PreWarmedInstanceCount."
            ],
            "Code":"BadRequest",
            "Message":"siteConfig.ReservedInstanceCount is invalid. Please use the new property siteConfig.PreWarmedInstanceCount."
         }
      }
   ],
   "Innererror": null
}

Evitar la pérdida de contexto durante los eventos de escalado de recursos

Los eventos de escalado de recursos pueden provocar la pérdida de contexto para los conectores integrados con el modo con estado habilitado. Para evitar esta posible pérdida antes de que se puedan producir estos eventos, corrija el número de instancias disponibles para el recurso de aplicación lógica. De este modo, no se puede producir ningún evento de escalado para provocar esta posible pérdida de contexto.

  1. En el menú de recursos de la aplicación lógica, en Configuración, seleccione Escalar horizontalmente.

  2. En App Escalabilidad horizontal, establezca Aplicar Escalabilidad horizontal Límite en , que muestra el límite máximo de Escalabilidad horizontal.

  3. En la página Escalado horizontal, en Escalado horizontal de aplicaciones, establezca el número de Instancias siempre preparadas en el mismo número que Límite máximo de Escalabilidad horizontal y ráfaga máxima, que aparece en Plan Escalabilidad horizontal, por ejemplo:

    Screenshot shows Azure portal, Standard logic app resource, Scale out page, and Always Ready Instances number set to match Maximum Scale Out Limit and Maximum Burst.

  4. Cuando haya terminado, en la barra de herramientas Escalar horizontalmente , seleccione Guardar.

Pasos siguientes