HTTP 取得

プレビュー

この機能はまだ開発中ですが、ぜひお試しください。

この機能は現在、弊社のプレリリースポリシーに従ってプレビュープログラムの一部として提供されています。

このページでは、ワークフロー自動化アクションカタログで使用できる HTTP Get に関する包括的なリファレンスを提供します。これらのアクションにより、HTTP GETリクエスト操作を実行できるようになります。

前提条件

ワークフロー自動化で HTTP アクションを使用する前に、次の点を確認してください。

目標APIエンドポイントのURL。
必要な認証資格情報 ( APIキー、VPN など)。
API リクエスト/レスポンス形式の理解。

ヒント

HTTP アクションは、任意のヘッダー値の秘密の構文をサポートしているため、 APIキーなどの機密データを安全に渡すことができます。詳細については、シークレットマネージャーを参照してください。

自動リクエストヘッダー

ワークフローオートメーションによって実行されるすべての HTTP requestsには、次のヘッダーが自動的に含まれます。

ヘッダー	形式
`x-abuse-info`	`Request sent by a New Relic WorkflowAutomation. {runId}` `{runId}` はワークフロー実行IDです
`User-Agent`	`NewRelic/WorkflowAutomation (region={region}; https://newrelic.com ; support@newrelic.com)` `{region}` はNew Relicのリージョンです

ヘッダー

形式

x-abuse-info

Request sent by a New Relic WorkflowAutomation. {runId}

{runId}

はワークフロー実行IDです

User-Agent

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

{region}

はNew Relicのリージョンです

ウェブデータのリクエスト

HTTP GET呼び出しを実行して、 APIエンドポイントからデータを取得します。

重要

入力に機密データ（ Api-Keyヘッダーなど）を渡す必要がある場合は、 secretsManagementCreateSecret NerdGraph ミューテーションを介して保存された値を使用できます。

例

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

入力フィールド	オプション性	タイプ	説明
url	必須	弦	リクエストのターゲット URL。スキームを含める必要があります: `https://example.com` 。動的な値については、ワークフロー入力の使用を参照してください。
urlパラメータ	オプション	地図	URL に追加するのは間違いありません。文字列化された JSON オブジェクトを受け取ります。
ヘッダ	オプション	地図	リクエストに追加するヘッダー。文字列化された JSON オブジェクトを受け取ります。
セレクター	オプション	リスト	指定されたもののみを出力として取得するセレクター。

セレクター

目的: API 応答から特定のデータを抽出します。

構造：

name: 抽出された値を格納する変数名
expression: レスポンスを解析するためのJSONPathまたは式
JSONレスポンスを解析するにはresponseBody | fromjsonを使用します
ドット表記を使用して追加のフィルターをチェーンします (例: .abbreviation)

出力フィールド	タイプ	説明
レスポンスボディ	弦	応答の本文。
ステータスコード	Int	応答のステータスコード。
成功	ブール値	リクエストのステータス。
エラーメッセージ	弦	失敗の理由をメッセージとして表示します。

ワークフロー定義	入力	出力
`name: httpGetTest steps: - name: query type: action action: http.get version: 1 inputs: url: ${{ .workflowInputs.url }} urlParams: ${{ .workflowInputs.urlParams }} headers: ${{ .workflowInputs.headers }} selectors: ${{ .workflowInputs.selectors }}`	`{ "inputs": [ { "key": "url", "value": "https://example.com" }, { "key": "urlParams", "value": "{\"foo\": \"bar\"}" }, { "key": "headers", "value": "{\"baz\": \"bat\"}" }, { "key": "selectors", "value": "[{\"name\": \"responseBody\", \"expression\": \".responseBody\"}, {\"name\": \"statusCode\", \"expression\": \".statusCode\"}]" } ] }`	`Success case: { "responseBody": "<!doctype html>\n<html>...</html>\n", "statusCode": 200, "success": true } Failure case: { "errorMessage": "An unexpected error failed to call http get endpoint.", "success": false }`

ワークフロー定義

入力

出力

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

{
    "inputs": [
      {
        "key": "url",
        "value": "https://example.com"
      },
      {
        "key": "urlParams",
        "value": "{\"foo\": \"bar\"}"
      },
      {
        "key": "headers",
        "value": "{\"baz\": \"bat\"}"
      },
      {
        "key": "selectors",
        "value": "[{\"name\": \"responseBody\", \"expression\": \".responseBody\"}, {\"name\": \"statusCode\", \"expression\": \".statusCode\"}]"
      }
    ]
  }

Success case:
    {
      "responseBody": "<!doctype html>\n<html>...</html>\n",
      "statusCode": 200,
      "success": true
    }

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

この機械翻訳は、参考として提供されています。

プレビュー

前提条件.css-21sua1{background:none;border:none;width:0;padding:0;}

ヒント

自動リクエストヘッダー

ウェブデータのリクエスト

重要

セレクター

前提条件