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.

Aporte	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` .

Aporte

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

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

?

&

. Por ejemplo,

param1=value1&param2=value2

La acción devuelve los siguientes campos.

Producción	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.

Producción

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