Invocar una función de Azure

La acción Invoke de Azure Functions le permite llamar a cualquier Azure Function activada por HTTP directamente desde los flujos de trabajo. Proporciona una interfaz compatible y validada para invocar Azure Functions —con entradas tipadas, validación de URL y autenticación respaldada por secretos— en lugar de construir llamadas HTTP sin procesar.

Esta acción envía una solicitud HTTP a un extremo de Azure Function y devuelve la respuesta. La autenticación utiliza el mecanismo de clave de función de Azure; el flujo de trabajo lo pasa como el encabezado x-functions-key.

Los siguientes campos configuran la solicitud de Azure Function.

Campo de entrada	Opcionalidad	Tipo	Descripción
`function`	Requerido	Cadena	URL HTTPS completa del extremo del desencadenador HTTP de Azure Function. Por ejemplo, `"https://myapp.azurewebsites.net/api/MyFunction"` .
`key`	Opcional	Cadena	Una clave de API a nivel de función o a nivel de host para la autenticación. El flujo de trabajo lo envía como el encabezado `x-functions-key` . Páselo como un secreto.
`method`	Requerido	Cadena	Método HTTP a utilizar. Uno de `"GET"` , `"POST"` , `"PUT"` , `"DELETE"` , `"PATCH"` . El valor predeterminado es `"POST"` .
`body`	Opcional	Cadena	Cuerpo de la solicitud como cadena JSON. Aplica solo cuando `method` no es `GET` o `HEAD` . Acepta referencias de secretos.
`headers`	Opcional	Mapa	Encabezados HTTP adicionales en formato JSON. Por ejemplo, `{"X-Custom-Header": "value", "Content-Type": "application/json"}` . Acepta referencias de secretos.
`queryParameters`	Opcional	Mapa	Parámetros de consulta para agregar a la URL de la función. No debe comenzar con `?` o `&` . Por ejemplo, `param1=value1&param2=value2` .

La acción devuelve los siguientes campos.

Campo de salida	Tipo	Descripción
`statusCode`	Entero	Código de estado HTTP devuelto por Azure Function. Por ejemplo, `200` , `404` o `500` .
`response`	Cadena	Cuerpo de la respuesta de la función de Azure. Puede ser JSON, texto sin formato, HTML o cualquier otro formato.
`success`	Booleano	Indica si la llamada a la función se realizó correctamente. `true` para respuestas 2xx (200-299), `false` en caso contrario.

Campo de salida

Tipo

Descripción

statusCode

Entero

Código de estado HTTP devuelto por Azure Function. Por ejemplo,

200

404

500

response

Cadena

Cuerpo de la respuesta de la función de Azure. Puede ser JSON, texto sin formato, HTML o cualquier otro formato.

success

Booleano

Indica si la llamada a la función se realizó correctamente.

true

para respuestas 2xx (200-299),

false

en caso contrario.

Ejemplo: activar una función de remediación

name: azure-function-invoke-remediation

steps:
  - name: invokeRemediationFunction
    type: action
    action: azure.functions.invoke
    version: 1
    inputs:
      function: "https://remediation.azurewebsites.net/api/fix-incident"
      key: ${{ :secrets:azure:functionKey }}
      method: "POST"
      body: '{"incidentId":"${{ .workflowInputs.incidentId }}"}'

Ejemplo: solicitud GET con parámetros de consulta

name: azure-function-invoke-get

steps:
  - name: getFromFunction
    type: action
    action: azure.functions.invoke
    version: 1
    inputs:
      function: "https://myapp.azurewebsites.net/api/GetStatus"
      key: ${{ :secrets:azure:functionKey }}
      method: "GET"
      queryParameters: "env=prod&region=eastus"

Ejemplo: invocar una función y registrar el resultado

name: azure-function-invoke-and-log

steps:
  - name: invokeFunction
    type: action
    action: azure.functions.invoke
    version: 1
    inputs:
      function: "https://myapp.azurewebsites.net/api/RunCheck"
      key: ${{ :secrets:azure:functionKey }}
      method: "POST"
      body: '{"target":"${{ .workflowInputs.target }}"}'
      headers:
        Content-Type: "application/json"

  - name: logFunctionResult
    type: action
    action: newrelic.ingest.sendLogs
    version: 1
    inputs:
      logs:
        - message: "Azure Function invocation complete"
          attributes:
            success: ${{ .steps.invokeFunction.outputs.success }}
            statusCode: ${{ .steps.invokeFunction.outputs.statusCode }}
            response: ${{ .steps.invokeFunction.outputs.response }}

Te ofrecemos esta traducción automática para facilitar la lectura.

Invocar una función de Azure