---
title: "apply-file-export"
slug: "apply-file-export-1"
updated: 2026-09-17T09:16:09Z
published: 2026-09-17T09:16:09Z
canonical: "api.ncloud-docs.com/apply-file-export-1"
---

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

# apply-file-export

VPC 환경에서 이용 가능합니다.

데이터박스의 파일을 Object Storage의 버킷으로 내보내기 위해 파일 반출을 신청합니다.

## 요청

요청 형식을 설명합니다. 요청 형식은 다음과 같습니다.

| 메서드 | URI |
| --- | --- |
| POST | /api/v1/export/apply-file-export |

### 요청 헤더

Cloud Data Box API에서 공통으로 사용하는 헤더에 대한 정보는 [Cloud Data Box 요청 헤더](/docs/data-box-overview#%EC%9A%94%EC%B2%AD%ED%97%A4%EB%8D%94)를 참조해 주십시오.

### 요청 바디

요청 바디에 대한 설명은 다음과 같습니다.

| 필드 | 타입 | 필수 여부 | 설명 |
| --- | --- | --- | --- |
| `dataBoxNo` | Integer | Required | 데이터박스 번호 - 네이버 클라우드 플랫폼 콘솔의 **My Space** 메뉴에서 **[서버 상세 정보 보기]** 버튼 클릭 후 나타나는 **인프라** 탭 메뉴 화면에서 서버 이름에 공통으로 표시되는 숫자 - 데이터박스 상세 정보 확인 방법: [Cloud Data Box 사용 가이드](https://guide.ncloud-docs.com/docs/clouddatabox-connect#2-%EC%9D%B8%ED%94%84%EB%9D%BC-%EC%84%9C%EB%B9%84%EC%8A%A4%EC%9D%98-%EC%A0%91%EC%86%8D-%EC%A0%95%EB%B3%B4-%ED%99%95%EC%9D%B8) 참조 |
| `nasInstanceNo` | Integer | Required | 소스 NAS 인스턴스 번호 - [get-nas-list](/docs/get-nas-list) 참조 |
| `bucketName` | String | Required | 타깃 버킷 이름 - [get-bucket-list](/docs/get-bucket-list-1) 참조 |
| `fileList` | Array | Required | 반출 파일 정보: [fileList](/docs/apply-file-export-1#fileList) |

#### `fileList`

`fileList`에 대한 설명은 다음과 같습니다.

| 필드 | 타입 | 필수 여부 | 설명 |
| --- | --- | --- | --- |
| `name` | String | Required | 반출 파일 이름 |
| `description` | String | Required | 반출 파일 설명(자) - 30~N - 반출 심사의 근거가 되므로 [데이터 반출 기준](https://guide.ncloud-docs.com/docs/clouddatabox-importexport#%EB%8D%B0%EC%9D%B4%ED%84%B0%EB%B0%98%EC%B6%9C%EA%B8%B0%EC%A4%80)을 준수하여 입력 |
| `type` | String | Required | 반출 파일 유형 - `TABLE` \| `IMAGE` \| `MODEL` \| `LICENCE` - `TABLE`: 구분자로 나누어진 텍스트 - `IMAGE`: 이미지 - `MODEL`: 분석 모델 - `LICENCE`: 라이선스 |
| `tableDetail` | String | Conditional | 테이블 파일의 필드 구분자 - `TAB` \| `SPACE` \| `COMMA` \| `CUSTOM` - `TAB`: 탭 - `SPACE`: 공백 - `COMMA`: 쉼표 - `CUSTOM`: 사용자 정의 |
| `delimiter` | String | Conditional | 사용자 정의 구분자 - `tableDetail`이 `CUSTOM`인 경우, 필수 입력 |
| `imageDetail` | String | Conditional | 이미지 파일 확장자 - `BMP` \| `GIF` \| `JPEG` \| `TIFF` - `BMP`: bmp 파일 - `GIF`: gif 파일 - `JPEG`: jpeg 파일 - `TIFF`: tiff 파일 - `type`이 `IMAGE`인 경우, 필수 입력 |
| `modelDetail` | String | Conditional | 분석 모델 형식 - `TENSORFLOW` \| `PYTORCH` \| `SCIKIT_LEARN` \| `R` - `TENSORFLOW`: Tensorflow 파일 - `PYTORCH`: PyTorch 파일 - `SCIKIT_LEARN`: scikit-learn 파일 - `R`: R 파일 - `type`이 `MODEL`인 경우, 필수 입력 |
| `modelVersion` | String | Conditional | 분석 모델 버전 - `type`이 `MODEL`인 경우, 필수 입력 |

### 요청 예시

요청 예시는 다음과 같습니다.

```
curl --location --request POST 'https://databox.apigw.ntruss.com/api/v1/import/apply-file-import' \
--header 'x-ncp-apigw-timestamp: {Timestamp}' \
--header 'x-ncp-iam-access-key: {Access Key}' \
--header 'x-ncp-apigw-signature-v2: {API Gateway Signature}' \
--data '{
    "dataBoxNo": ****,
    "nasInstanceNo": ********,
    "bucketName": "bckt111",
    "fileList": [
        {
            "name": "T1_member.txt",
            "description": "테스트용 멤버 목록 파일입니다. ID: 임의의 일련번호. 이름: 가상 인물의 이름. 직책: 가상 직책 부여. 부서: 가상 부서 배정",
            "type": "TABLE",
            "tableDetail": "TAB"
        }
    ]
}'
```

## 응답

응답 형식을 설명합니다.

### 응답 바디

응답 바디에 대한 설명은 다음과 같습니다.

| 필드 | 타입 | 필수 여부 | 설명 |
| --- | --- | --- | --- |
| `totalCount` | Integer | - | 응답 결과 수 |
| `content` | Array | - | 반출 신청 정보: [content](/docs/apply-file-export-1#content) |

#### `content`

`content`에 대한 설명은 다음과 같습니다.

| 필드 | 타입 | 필수 여부 | 설명 |
| --- | --- | --- | --- |
| `exportNo` | Integer | - | 반출 신청 번호 |
| `nasInstanceNo` | Integer | - | 소스 NAS 인스턴스 번호 |
| `bucketName` | String | - | 타깃 버킷 이름 |
| `nasName` | String | - | 소스 NAS 이름 |
| `fileName` | String | - | 반출 파일 이름 |
| `status` | String | - | 반출 상태 - `심사요청(파일 전송전)` \| `심사요청(파일 전송중)` \| `심사요청(파일 전송완료)` \| `승인(버킷 전송중)` \| `승인(버킷 전송완료)` \| `반려` - `심사요청(파일 전송전)`: 심사용 Object Storage로 파일 전송 준비 - `심사요청(파일 전송중)`: 심사용 Object Storage로 파일 전송 진행 - `심사요청(파일 전송완료)`: 심사용 Object Storage로 파일 전송 완료 - `승인(버킷 전송중)`: 반출 승인 후 타깃 버킷으로 파일 전송 진행 - `승인(버킷 전송완료)`: 반출 승인 후 타깃 버킷으로 파일 전송 완료 - `반려`: 반출 심사 반려 |

### 응답 상태 코드

Cloud Data Box API에서 공통으로 사용하는 응답 상태 코드에 대한 정보는 [Cloud Data Box 응답 상태 코드](/docs/data-box-overview#%EC%9D%91%EB%8B%B5%EC%83%81%ED%83%9C%EC%BD%94%EB%93%9C)를 참조해 주십시오.

### 응답 예시

응답 예시는 다음과 같습니다.

```
{
    "totalCount": 1,
    "content": [
        {
            "exportNo": 3294,
            "nasInstanceNo": ********,
            "bucketName": "bckt111",
            "nasName": "nasw1",
            "fileName": "T1_member.txt",
            "status": "심사요청(파일 전송전)"
        }
    ]
}
```