HTTP Put

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 o comando http put disponível 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 PUT.

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

Criar recurso no URI

Executa uma solicitação HTTP PUT para atualizar dados em um endpointda API.

Importante

Se você precisar passar dados sensíveis para uma entrada, por exemplo um cabeçalho Api-Key, você pode 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 HTTP da resposta.
sucesso	Boleano	Status da solicitação.
mensagem de erro	Corda	Motivo da falha como mensagem.

Definição de fluxo de trabalho	Entradas	Saídas
`name: httpPutTest steps: - name: query type: action action: http.put 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: { "responseBody": "", "statusCode": 200 "success": true } Failure case: { "errorMessage": "An unexpected error failed to call http post endpoint.", "success": false }`

Definição de fluxo de trabalho

Entradas

Saídas

name: httpPutTest

  steps:
    - name: query
      type: action
      action: http.put
      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:
    {
      "responseBody": "",
      "statusCode": 200
      "success": true
    }

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