Postagem HTTP

visualização

Ainda estamos trabalhando nesse recurso, mas adoraríamos que você experimentasse!

Atualmente, esse recurso é fornecido como parte de um programa de visualização de acordo com nossas políticas de pré-lançamento.

Esta página fornece uma referência completa para as ações HTTP POST disponíveis no catálogo de ações de automação de fluxo de trabalho. Essas ações permitem que você execute operações de requisição HTTP POST.

Pré-requisitos

Antes de usar ações HTTP na automação de fluxo de trabalho, certifique-se de ter:

endpointde destino de URLs API.
Quaisquer credenciais de autenticação necessárias (chave de API, token, etc.).
Compreensão dos formatos de requisição/resposta da API.

Dica

As ações HTTP suportam sintaxe secreta para qualquer valor de cabeçalho, permitindo que você passe dados sensíveis com segurança, como a chave de API. Consulte a seção de gerenciamento de segredos para obter mais informações.

Cabeçalhos de solicitação automáticos

Todas requests HTTP realizadas pelo fluxo de trabalho Automation incluem automaticamente os seguintes cabeçalhos:

Cabeçalho	Formatar
`x-abuse-info`	`Request sent by a New Relic WorkflowAutomation. {runId}` onde `{runId}` é o ID da execução do fluxo de trabalho
`User-Agent`	`NewRelic/WorkflowAutomation (region={region}; https://newrelic.com ; support@newrelic.com)` onde `{region}` é a região de New Relic

Cabeçalho

Formatar

x-abuse-info

Request sent by a New Relic WorkflowAutomation. {runId}

onde

{runId}

é o ID da execução do fluxo de trabalho

User-Agent

NewRelic/WorkflowAutomation (region={region}; https://newrelic.com ; support@newrelic.com)

onde

{region}

é a região de New Relic

Enviar dados para um servidor

Executa uma chamada HTTP POST para enviar dados para um endpointda API.

Importante

Se você precisar passar dados sensíveis para uma entrada, por exemplo, um cabeçalho de chave de API, poderá usar valores armazenados por meio da mutação secretsManagementCreateSecret do NerdGraph.

Exemplo

{
    "inputs": [
      {
        "key": "headers",
        "value": "{\"Api-Key\": \"${{ :secrets:NR_API_KEY }}\"}"
      }
    ]
  }

Campo de entrada	Opcionalidade	Tipo	Descrição
url	Obrigatório	Corda	A URL de destino da solicitação. O esquema deve ser incluído: `https://example.com`
parâmetros da URL	Opcional	Mapa	O parâmetro de consulta deve ser adicionado à URL. Recebe um objeto JSON em formato de string.
cabeçalhos	Opcional	Mapa	Os cabeçalhos a serem adicionados à solicitação. Recebe um objeto JSON em formato de string.
corpo	Opcional	Corda	O corpo da requisição.
seletores	Opcional	Lista	Os seletores permitem obter apenas o parâmetro especificado como saída.

Campo de saída	Tipo	Descrição
respostaCorpo	Corda	O corpo da resposta.
código de status	Interno	O código de status da resposta.
sucesso	Boleano	Status da solicitação.
mensagem de erro	Corda	Motivo da falha como mensagem.

Definição de fluxo de trabalho	Entrada	Saída
`name: httpPostTest steps: - name: query type: action action: http.post version: 1 inputs: url: ${{ .workflowInputs.url }} urlParams: ${{ .workflowInputs.urlParams }} headers: ${{ .workflowInputs.headers }} body: ${{ .workflowInputs.body }} selectors: ${{ .workflowInputs.selectors }}`	`{ "inputs": [ { "key": "url", "value": "https://example.com" }, { "key": "headers", "value": "{\"Content-Type\":\"application/json\"}" }, { "key": "urlParams", "value": "{\"foo\": \"bar\"}" }, { "key": "body", "value": "{\"foo\": \"bar\"}" }, { "key": "selectors", "value": "[{\"name\": \"responseBody\", \"expression\": \".responseBody\"}, {\"name\": \"statusCode\", \"expression\": \".statusCode\"}]" } ] }`	`Success case: { "success": true, "responseBody": "", "statusCode": 200 } Failure case: { "errorMessage": "An unexpected error failed to call http post endpoint.", "success": false }`

Definição de fluxo de trabalho

Entrada

Saída

name: httpPostTest

  steps:
    - name: query
      type: action
      action: http.post
      version: 1
      inputs:
        url: ${{ .workflowInputs.url }}
        urlParams: ${{ .workflowInputs.urlParams }}
        headers: ${{ .workflowInputs.headers }}
        body: ${{ .workflowInputs.body }}
        selectors: ${{ .workflowInputs.selectors }}

{
    "inputs": [
      {
        "key": "url",
        "value": "https://example.com"
      },
      {
        "key": "headers",
        "value": "{\"Content-Type\":\"application/json\"}"
      },
      {
        "key": "urlParams",
        "value": "{\"foo\": \"bar\"}"
      },
      {
        "key": "body",
        "value": "{\"foo\": \"bar\"}"
      },
      {
        "key": "selectors",
        "value": "[{\"name\": \"responseBody\", \"expression\": \".responseBody\"}, {\"name\": \"statusCode\", \"expression\": \".statusCode\"}]"
      }
    ]
  }

Success case:
    {
      "success": true,
      "responseBody": "",
      "statusCode": 200
    }

  Failure case:
    {
      "errorMessage": "An unexpected error failed to call http post endpoint.",
      "success": false
    }