HTTP Post

Aperçu

Nous travaillons toujours sur cette fonctionnalité, mais nous aimerions que vous l'essayiez !

Cette fonctionnalité est actuellement fournie dans le cadre d'un programme d'aperçu conformément à nos politiques de pré-sortie.

Cette page fournit une référence complète pour http post disponible dans le catalogue des actions d'automatisation des workflows. Ces actions vous permettent d'effectuer des opérations de requête http post.

Prérequis

Avant d'utiliser les actions HTTP dans l'automatisation workflow, assurez-vous de disposer de :

cible points de terminaison d'API URLs.
Toutes les informations d'identification d'authentification requises (clé API, jeton, etc.).
Compréhension des formats de requête/réponse de l'API.

Conseil

Les actions HTTP prennent en charge la syntaxe secrète pour toute valeur d'en-tête, ce qui vous permet de transmettre en toute sécurité des données sensibles telles que les clés API. Consultez gestion des secrets pour plus d'informations.

En-têtes de requête automatiques

Toutes les requêtes HTTP effectuées par Workflow Automation incluent automatiquement les en-têtes suivants :

En-tête	Format
`x-abuse-info`	`Request sent by a New Relic WorkflowAutomation. {runId}` où `{runId}` est l'ID d'exécution du workflow
`User-Agent`	`NewRelic/WorkflowAutomation (region={region}; https://newrelic.com ; support@newrelic.com)` où `{region}` est la région New Relic

En-tête

Format

x-abuse-info

Request sent by a New Relic WorkflowAutomation. {runId}

où

{runId}

est l'ID d'exécution du workflow

User-Agent

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

où

{region}

est la région New Relic

Envoyer des données à un serveur

Effectue un appel HTTP POST pour envoyer des données à un point de terminaison d'API.

Important

Si vous devez transmettre des données sensibles à une entrée, par exemple un en-tête de clé API, vous pouvez utiliser les valeurs stockées via la mutation NerdGraph secretsManagementCreateSecret.

Exemple

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

Champ de saisie	optionnalité	Type	Description
url	Requis	Chaîne	L'URL cible de la requête. Le dispositif doit être inclus : `https://example.com`
urlParams	Facultatif	Carte	Les paramètres de requête à ajouter à l'URL. Prend un objet JSON converti en chaîne de caractères.
en-têtes	Facultatif	Carte	Les en-têtes à ajouter à la requête. Prend un objet JSON converti en chaîne de caractères.
corps	Facultatif	Chaîne	Le corps de la requête.
sélecteurs	Facultatif	List	Les sélecteurs permettant d'obtenir uniquement les paramètres spécifiés en sortie.

Champ de sortie	Type	Description
corps de réponse	Chaîne	Le corps de la réponse.
code d'état	Int	Le code d'état de la réponse.
succès	Booléen	Statut de la requête.
message d'erreur	Chaîne	Motif de l'échec : message.

définition du flux de travail	Saisir	Sortir
`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 }`

définition du flux de travail

Saisir

Sortir

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
    }