---
title: "Data Flowの概要"
slug: "analytics-dataflow"
updated: 2026-09-17T09:57:35Z
published: 2026-09-17T09:57:35Z
canonical: "api.ncloud-docs.com/analytics-dataflow"
---

> ## Documentation Index
> Fetch the complete documentation index at: https://api.ncloud-docs.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Data Flowの概要

VPC環境で利用できます。

Data Flowは、大規模なデータを抽出、変換、ロードするための複雑なワークフローを構成・実行し、モニタリングする NAVERクラウドプラットフォームの完全管理型データ統合サービスです。Data Flowサービスは、Workflow、Job、Trigger機能関連の APIを RESTful形式で提供します。

## Data Flowの共通設定

Data Flow APIで共通して使用されるリクエスト形式とレスポンス形式を説明します。

### リクエスト

共通リクエスト形式を説明します。

#### API URL

リクエスト API URLは次の通りです。

```
https://dataflow.apigw.ntruss.com
```

#### リクエストヘッダ

リクエストヘッダの説明は次の通りです。

| フィールド | 必須の有無 | 説明 |
| --- | --- | --- |
| `x-ncp-apigw-timestamp` | Required | 1970年1月1日00:00:00協定世界時(UTC)からの経過時間(ミリ秒) - API Gatewayサーバとの時間差が5分以上の場合は無効なリクエストとみなす - Unix Timestamp形式 |
| `x-ncp-iam-access-key` | Required | NAVERクラウドプラットフォームから発行された Access Key - Access Keyの発行と確認: [認証キーの作成](/docs/ja/common-ncpapi)を参照 - サブアカウントの Access Key発行と確認: [サブアカウントの作成](https://guide.ncloud-docs.com/docs/ja/subaccount-use#%EC%84%9C%EB%B8%8C-%EA%B3%84%EC%A0%95-%EC%83%9D%EC%84%B1)を参照 |
| `x-ncp-apigw-signature-v2` | Required | NAVERクラウドプラットフォームから発行された Access Keyとマッピングする Secret Keyと HMAC暗号化アルゴリズム(HmacSHA256)でリクエスト情報を暗号化した後、Base64にエンコードした署名 - Secret Keyの発行と確認: [認証キーの作成](/docs/ja/common-ncpapi)を参照 - 署名の作成: [シグネチャーの作成](/docs/ja/common-ncpapi)を参照 |

### レスポンス

共通レスポンス形式を説明します。

#### レスポンスボディ

レスポンスボディの説明は次の通りです。

**ErrorResponse** ErrorResponseは API呼び出し失敗情報を定義します。ErrorResponseの説明は次の通りです。

| フィールド | タイプ | 必須の有無 | 説明 |
| --- | --- | --- | --- |
| `error` | Object | - | エラーコードとメッセージ |
| `error.errorCode` | String | Required | エラーコード |
| `error.message` | String | Required | エラーメッセージ |
| `error.details` | String | Required | エラーメッセージの詳細説明 |

#### レスポンスステータスコード

レスポンスステータスコードの説明は次の通りです。

| HTTPステータスコード | コード | メッセージ | 説明 | 解決方法 |
| --- | --- | --- | --- | --- |
| 200 | - | OK | リクエスト処理成功 | - |
| 201 | - | Created | 作成完了 | - |
| 202 | - | Request is accepted but not completed yet. | リクエストは受け取ったが、まだ完了していない | - |
| 204 | - | No Content | リクエスト処理成功、コンテンツは返していない | - |
| 400 | - | Bad Request | 無効なリクエスト | リクエスト構文を確認 |
| 400 | - | bad-parameter | リクエストパラメータエラー | リクエスト値を確認 |
| 400 | - | bad-state | リクエスト状態エラー | リクエスト対象の状態を確認 |
| 400 | - | client-request-failed | 連携サービスのリクエストエラー | 連携サービスを確認 |
| 400 | - | client-resource-not-found | 連携サービスのリソースエラー | 連携サービスのリソースを確認 |
| 400 | - | client-unauthorized | 連携サービスの権限エラー | 連携サービスの権限を確認 |
| 400 | - | No valid member exists of given member number. | 無効なリクエスト | リクエストパラメータ、ヘッダを再確認 |
| 401 | - | Unauthorized | 認証失敗 | ジョブの作成者とリクエスタの権限を確認 |
| 403 | - | Forbidden | サーバのジョブ拒否 | リクエスト機能に対する使用権限を所有しているか確認 |
| 404 | - | resource-not-found | リクエストリソース IDエラー | リクエスト対象を確認 |
| 500 | - | unknown-resource-action | ジョブ実行エラー | NAVERクラウドプラットフォームポータルの[お問い合わせ](https://www.ncloud.com/support/question/service)から問い合わせる |
| 500 | - | Internal Server Error | サーバ内部エラー | しばらくしてから再試行 |

              参考

              

NAVERクラウドプラットフォームで共通して使用されるレスポンスステータスコードの詳細は、[Ncloud APIのレスポンスステータスコード](/docs/ja/common-ncpapi#3%EC%9D%91%EB%8B%B5%EC%83%81%ED%83%9C%EC%BD%94%EB%93%9C)をご参照ください。

#### レスポンス例

呼び出しが成功した場合のレスポンス例は、API仕様書を確認してください。呼び出しに失敗した場合のレスポンスのサンプルコードは次の通りです。

```
{
    "error": {
        "errorCode": "200",
        "message": "Authentication Failed",
        "details": "Invalid authentication information."
    }
}
```

## Data Flow API

Data Flowサービスが提供する APIの説明は次の通りです。

### Dashboard

Dashboard関連 APIの説明は次の通りです。

| API | 説明 |
| --- | --- |
| [getExecutionInterval](/docs/ja/analytics-dataflow-getexecutioncount) | ジョブの実行数を照会 |
| [getExecutionResult](/docs/ja/analytics-dataflow-getexecutionresult) | ジョブの実行数、成功数、失敗数を照会 |
| [getExecutionTimes](/docs/ja/analytics-dataflow-getexecutiontimes) | ジョブの実行時間を照会 |

### Workflow

ワークフロー関連 APIの説明は次の通りです。

| API | 説明 |
| --- | --- |
| [createWorkflow](/docs/ja/analytics-dataflow-createworkflow) | ワークフローを作成 |
| [getWorkflows](/docs/ja/analytics-dataflow-getworkflows) | ワークフローリストを照会 |
| [getWorkflowById](/docs/ja/analytics-dataflow-getworkflowbyid) | ワークフローの詳細情報を照会 |
| [getWorkflowExecutions](/docs/ja/analytics-dataflow-getworkflowexecutions) | ワークフロー実行リストを照会 |
| [updateWorkflow](/docs/ja/analytics-dataflow-updateworkflow) | ワークフローを更新 |
| [deleteWorkflow](/docs/ja/analytics-dataflow-deleteworkflow) | ワークフローを削除 |

### Job

ジョブ関連 APIの説明は次の通りです。

| API | 説明 |
| --- | --- |
| [createJob](/docs/ja/analytics-dataflow-createjob) | ジョブを作成 |
| [getJobs](/docs/ja/analytics-dataflow-getjobs) | ジョブリストを照会 |
| [getJobById](/docs/ja/analytics-dataflow-getjobbyid) | ジョブの詳細情報を照会 |
| [updateJob](/docs/ja/analytics-dataflow-updatejob) | ジョブを更新 |
| [verifyJob](/docs/ja/analytics-dataflow-verifyjob) | ジョブ実行リクエスト項目を検証 |
| [executeJob](/docs/ja/analytics-dataflow-executejob) | ジョブを実行 |
| [getJobExecutions](/docs/ja/analytics-dataflow-getjobexecutions) | ジョブ実行リストを照会 |
| [getJobExecutionById](/docs/ja/analytics-dataflow-getjobexecutionbyid) | ジョブ実行の詳細情報を照会 |
| [updateJobExecuteConfig](/docs/ja/analytics-dataflow-updatejobexecuteconfig) | ジョブ実行オプションを更新 |
| [deleteJob](/docs/ja/analytics-dataflow-deletejob) | ジョブを削除 |

### Trigger

トリガー関連 APIの説明は次の通りです。

| API | 説明 |
| --- | --- |
| [createTrigger](/docs/ja/analytics-dataflow-createtrigger) | トリガーを作成 |
| [getTriggers](/docs/ja/analytics-dataflow-gettriggers) | トリガーリストを照会 |
| [getTriggerById](/docs/ja/analytics-dataflow-gettriggerbyid) | トリガーの詳細を個別照会 |
| [deleteTrigger](/docs/ja/analytics-dataflow-deletetrigger) | トリガーを削除 |

## Data Flow関連リソース

Data Flow APIについてユーザーの理解に役立つよう、さまざまな関連リソースを提供しています。

- Data Flow APIの使用方法
  - [署名(シグネチャー)の作成](/docs/ja/common-ncpapi): リクエストヘッダに追加する署名の作成方法
  - [API Gatewayご利用ガイド](https://guide.ncloud-docs.com/docs/ja/apigw-apigw-1): リクエストヘッダに追加する API Keyを発行
  - [Sub Accountご利用ガイド](https://guide.ncloud-docs.com/docs/ja/subaccount-overview): リクエストヘッダに追加する Access Keyの発行方法
  - [Ncloudの共通レスポンスステータスコード](/docs/ja/common-ncpapi#3-%EC%9D%91%EB%8B%B5-%EC%83%81%ED%83%9C-%EC%BD%94%EB%93%9C): Data Flowサービスで使用される NAVERクラウドプラットフォームの共通レスポンスステータスコード情報
- Data Flowサービスの使用方法
  - [Data Flowご利用ガイド](https://guide.ncloud-docs.com/docs/ja/dataflow-overview): NAVERクラウドプラットフォームコンソールで Data Flowを使用する方法
  - [Ncloud使用環境ガイド](https://guide.ncloud-docs.com/docs/ja/environment-environment-1-1): VPC、Classic環境とサポート有無に関するガイド
  - [料金の紹介、特徴、詳細機能](https://www.ncloud.com/product/analytics/dataFlow): Data Flowの料金の紹介、特徴、詳細機能のサマリー
  - [サービスのお知らせ](https://www.ncloud.com/intro/news): Data Flowサービスに関するお知らせ
  - [よくある質問](https://www.ncloud.com/support/faq/prod?categoryCode2=ANALY&categoryCode3=SV_0237&page=1): Data Forestに関するよくあるご質問
  - [お問い合わせ](https://www.ncloud.com/support/question/general): APIガイドだけでは不明な点が解消されない場合、直接お問い合わせ