Invocar uma função Azure

A ação de invocação do Azure Functions permite chamar qualquer Azure Function acionada por HTTP diretamente dos fluxos de trabalho. Ela fornece uma interface suportada e validada para invocar o Azure Functions — com entradas tipadas, validação de URL e autenticação baseada em segredos — em vez de construir chamadas HTTP brutas.

Esta ação envia uma solicitação HTTP para um endpoint do Azure Function e retorna a resposta. A autenticação usa o mecanismo de chave de função do Azure; o fluxo de trabalho o passa como o cabeçalho x-functions-key.

Os campos a seguir configuram a solicitação do Azure Function.

Campo de entrada	Opcionalidade	Tipo	Descrição
`function`	Obrigatório	Corda	URL HTTPS completa do endpoint de gatilho HTTP do Azure Function. Por exemplo, `"https://myapp.azurewebsites.net/api/MyFunction"` .
`key`	Opcional	Corda	Uma chave de API no nível da função ou no nível do host para autenticação. O fluxo de trabalho o envia como o cabeçalho `x-functions-key` . Passe como um segredo.
`method`	Obrigatório	Corda	Método HTTP a ser usado. Um de `"GET"` , `"POST"` , `"PUT"` , `"DELETE"` , `"PATCH"` . O padrão é `"POST"` .
`body`	Opcional	Corda	Corpo da solicitação como uma string JSON. Aplica-se apenas quando `method` não é `GET` ou `HEAD` . Aceita referências de segredos.
`headers`	Opcional	Mapa	Cabeçalhos HTTP adicionais no formato JSON. Por exemplo, `{"X-Custom-Header": "value", "Content-Type": "application/json"}` . Aceita referências de segredos.
`queryParameters`	Opcional	Mapa	Parâmetros de consulta para anexar à URL da função. Não deve começar com `?` ou `&` . Por exemplo, `param1=value1&param2=value2` .

A ação retorna os seguintes campos.

Campo de saída	Tipo	Descrição
`statusCode`	Inteiro	Código de status HTTP retornado pela Azure Function. Por exemplo, `200` , `404` ou `500` .
`response`	Corda	Corpo da resposta da Azure Function. Pode ser JSON, texto simples, HTML ou qualquer outro formato.
`success`	Boleano	Indica se a chamada de função foi bem-sucedida. `true` para respostas 2xx (200–299), `false` caso contrário.

Campo de saída

Tipo

Descrição

statusCode

Inteiro

Código de status HTTP retornado pela Azure Function. Por exemplo,

200

404

500

response

Corda

Corpo da resposta da Azure Function. Pode ser JSON, texto simples, HTML ou qualquer outro formato.

success

Boleano

Indica se a chamada de função foi bem-sucedida.

true

para respostas 2xx (200–299),

false

caso contrário.

Exemplo: acionar uma função de correção

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 }}"}'

Exemplo: solicitação GET com 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"

Exemplo: invocar uma função e registrar o 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 }}

Esta tradução de máquina é fornecida para sua comodidade.

Invocar uma função Azure