---
title: "Datafenceの概要"
slug: "datafence-overview"
updated: 2026-09-17T09:57:32Z
published: 2026-09-17T09:57:32Z
canonical: "api.ncloud-docs.com/datafence-overview"
---

> ## 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.

# Datafenceの概要

VPC環境で利用できます。

Datafenceは、分析者が顧客データを自由に分析し、データ管理者はデータの任意の持ち出しを制限できるようにサポートする NAVERクラウドプラットフォームの分析環境構築サービスです。Datafenceサービスは、Datafenceとボックスの作成、データの持ち込み・持ち出しの審査を行う APIをRESTful形式で提供します。

## Datafenceの共通設定

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

### リクエスト

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

#### API URL

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

```
https://datafence.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)を参照 |
| `x-ncp-lang` | Optional | レスポンスデータの多言語処理 - `ko-KR` \| `en-US` (デフォルト) \| `zh-CN` - `ko-KR`: 韓国語 - `en-US`: 英語 - `zh-CN`: 中国語(簡体字) |

              参考

              

サブアカウントでバケット関連の Datafence APIを呼び出す場合、サブアカウントに Object Storageサービスの権限が必要な場合があります。

### レスポンス

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

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

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

**error**

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

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

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

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

| HTTPステータスコード | コード | メッセージ | 説明 |
| --- | --- | --- | --- |
| 200 | - | - | 成功 |
| 400 | 10001 | - | リクエスト情報とパラメータエラー |
| 400 | 2600003 | - | Datafence(または Box)の所有者ではない |
| 400 | 2600005 | - | リクエストした外部ネットワーク設定が現在と同じ状態 |
| 400 | 2600010 | - | Box内サーバの再起動状態 |
| 400 | 2600011 | - | Boxの作成数制限を超過 |
| 400 | 2600013 | - | 無効なパスワード |
| 400 | 2600023 | - | Datafence内に Boxが少なくとも1つ必要 |
| 400 | 2600024 | - | Boxが変更できない状態 |
| 400 | 2600025 | - | Datafenceが使用できない状態 |
| 400 | 2600026 | - | 無効な Action Type |
| 400 | 2600029 | - | バケットが存在しない |
| 400 | 2600031 | - | リクエストしたサーバ数が許容範囲外 |
| 400 | 2600033 | - | リクエストした Hadoopブロックストレージ容量が許容範囲外 |
| 400 | 2600035 | - | 無効なストレージインスタンスまたは NASインスタンス番号 |
| 400 | 2600038 | - | リクエストした NASが許容範囲外 |
| 400 | 2600040 | - | 変更後の NAS容量が変更前と同じ |
| 400 | 2600041 | - | Boxにサーバが存在しない |
| 400 | 2600047 | - | Boxストレージが存在しない |
| 400 | 2600053 | - | Datafenceが存在しない |
| 400 | 2600054 | - | Boxが存在しない |
| 400 | 2600072 | - | 無効なスペックコード |
| 400 | 2600073 | - | 無効なソフトウェアコード |
| 400 | 2610001 | - | 無効な持ち出し申請番号 |
| 400 | 2610002 | - | 申請したファイル名が重複している |
| 400 | 2610004 | - | 最大申請数超過 |
| 400 | 2610006 | - | ファイルサイズ超過 |
| 400 | 2610008 | - | 無効なファイル名 |
| 400 | 2610010 | - | 既に承認済みの持ち出し申請 |
| 400 | 2610012 | - | 申請したファイルが見つからない |
| 403 | 10002 | - | 権限のないリクエスト |
| 404 | 10003 | - | 存在しないリソース |
| 500 | 10007 | - | サービス内部エラー |

              参考

              

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."
    }
}
```

## Datafence API

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

### Datafence

Datafenceに関連する APIは次の通りです。

| API | 説明 |
| --- | --- |
| [get-datafence](/docs/ja/get-datafence) | Datafenceリストを照会 |
| [get-datafence-infra-history](/docs/ja/get-datafence-infra-history) | Datafenceのインフラ履歴を照会 |
| [get-datafence-infra-list](/docs/ja/get-datafence-infra-list) | Datafenceのインフラリストを照会 |
| [get-fence-custom-image](/docs/ja/get-fence-custom-image) | Datafenceのユーザーイメージを照会 |
| [change-datafence-infra](/docs/ja/change-datafence-infra) | Datafenceのインフラ設定を変更 |
| [change-fence-nas-volume](/docs/ja/change-fence-nas-volume) | Datafence NAS容量を変更 |

### Box

Boxに関連する APIは次の通りです。

| API | 説明 |
| --- | --- |
| [get-bucket-list](/docs/ja/get-bucket-list-2) | Datafenceの持ち込みまはた持ち出し時に使用するバケットリストを照会 |
| [get-product-spec](/docs/ja/get-product-spec) | Boxスペックリストを照会 |
| [create-box](/docs/ja/create-box) | Datafenceに Boxを作成 |
| [get-box-custom-image](/docs/ja/get-box-custom-image) | Box内ユーザーイメージを照会 |
| [get-box-history](/docs/ja/get-box-history) | Datafenceの Box履歴を照会 |
| [get-box-infra-history](/docs/ja/get-box-infra-history) | Datafenceの Boxインフラ履歴を照会 |
| [get-box-infra-list](/docs/ja/get-box-infra-list) | Datafenceの Boxインフラリストを照会 |
| [get-box-list](/docs/ja/get-box-list) | Datafenceの Boxリストを照会 |
| [get-box-summary-info](/docs/ja/get-box-summary-info) | Datafenceの Boxのサマリー情報を照会 |
| [get-connect-info](/docs/ja/get-connect-info) | Boxの Connectサーバ情報を照会 |
| [get-hadoop-cluster-info](/docs/ja/get-hadoop-cluster-info-1) | Boxの Hadoopクラスタ情報を照会 |
| [get-linux-info](/docs/ja/get-linux-info-1) | Boxの Linuxサーバ情報を照会 |
| [get-windows-info](/docs/ja/get-windows-info-1) | Boxの Windows Server情報を照会 |
| [get-tensorflow-info](/docs/ja/get-tensorflow-info) | Boxの TensorFlowサーバ情報を照会 |
| [change-box-block-external-network](/docs/ja/change-box-block-external-network) | Boxの外部ネットワークを許可するかブロックするかを設定 |
| [change-box-infra](/docs/ja/change-box-infra) | Boxのインフラ設定を変更 |
| [change-box-nas-volume](/docs/ja/change-box-nas-volume) | Boxの NAS容量を変更 |
| [return-box](/docs/ja/return-box) | Boxを返却 |

### Import

ファイル持ち込みに関連する APIは次の通りです。

| API | 説明 |
| --- | --- |
| [create-file-import](/docs/ja/create-file-import) | Boxへのファイル持ち込みを申請 |
| [get-import-detail](/docs/ja/get-import-detail) | Boxへのファイル持ち込み申請の詳細情報を照会 |
| [get-import-list](/docs/ja/get-import-list) | Boxへのファイル持ち込み申請リストを照会 |
| [get-target-nas-list](/docs/ja/get-target-nas-list-1) | Boxへの持ち込みファイルを保存する NASリストを照会 |

### Export

ファイル持ち出しに関連する APIは次の通りです。

| API | 説明 |
| --- | --- |
| [create-file-export](/docs/ja/create-file-export) | Boxからファイル持ち出しを申請 |
| [get-export-detail](/docs/ja/get-export-detail) | Boxからの持ち出し申請リストの詳細情報を照会 |
| [get-export-list](/docs/ja/get-export-list) | Boxからのファイル持ち出し申請リストを照会 |
| [get-source-nas-list](/docs/ja/get-source-nas-list-1) | Boxからの持ち出し申請ファイルが保存されている NASリストを照会 |
| [cancel-file-export](/docs/ja/cancel-file-export) | Boxからのファイル持ち出し申請をキャンセル |

### Export Approval

ファイル持ち出し審査に関連する APIは次の通りです。

| API | 説明 |
| --- | --- |
| [get-export-file-approve-detail](/docs/ja/get-export-file-approve-detail-1) | Boxからのファイル持ち出し審査対象の詳細情報を照会 |
| [get-export-file-approve-list](/docs/ja/get-export-file-approve-list-1) | Boxからのファイル持ち出し審査対象リストを照会 |
| [export-file-approve](/docs/ja/export-file-approve-1) | Boxからのファイル持ち出し申請を承認 |
| [export-file-reject](/docs/ja/export-file-reject-1) | Boxからのファイル持ち出し申請を却下 |

## Datafence関連リソース

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

- Datafence 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): Datafenceサービスで使用される NAVERクラウドプラットフォームの共通レスポンスステータスコード情報
- Datafenceサービスの使用方法
  - [Datafenceご利用ガイド](https://guide.ncloud-docs.com/docs/ja/datafence-overview): NAVERクラウドプラットフォームコンソールで Datafenceを使用する方法
  - [Ncloud使用環境ガイド](https://guide.ncloud-docs.com/docs/ja/environment-environment-1-1): VPC、Classic環境とサポートの有無に関するご利用ガイド
  - [料金の紹介、特徴、詳細機能](https://www.ncloud.com/product/analytics/datafence): Datafenceの料金体系、Datafenceの特徴と詳細機能、活用例のサマリー
  - [サービスのお知らせ](https://www.ncloud.com/intro/news): Datafenceに関するお知らせ
  - [よくある質問](https://www.ncloud.com/support/faq/prod?categoryCode2=ANALY&categoryCode3=SV_0268&page=1): Datafenceに関するよくあるご質問
  - [カスタマーサポート](https://www.ncloud.com/support/question/service): ご利用ガイドだけでは不明な点が解消されない場合、直接お問い合わせ