---
title: "Object Storage Document 관리"
slug: "analytics-cloudsearch-manageobjectstoragedocument"
tags: ["Cloud Search"]
updated: 2026-04-23T08:56:09Z
published: 2026-04-23T09:02:28Z
canonical: "api.ncloud-docs.com/analytics-cloudsearch-manageobjectstoragedocument"
---

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

# Object Storage Document 관리

Object Storage를 통해 대용량 문서 업로드(최대 100MB)를 수행할 수 있습니다.
문서에 대한 자세한 설명은 [Document 관리](/docs/analytics-cloudsearch-managedocument)를 통해 확인해주세요.

- BOM(Byte Order Mark)이 포함된 문서는 업로드가 불가합니다.
- 자동 완성 기능을 사용하고 있을 경우, 본 요청 이후 [자동 완성 설정 및 수정 요청](/docs/analytics-cloudsearch-putautocomplete)을 통해 자동 완성 색인을 갱신해야 합니다.


```http
POST https://cloudsearch.apigw.ntruss.com/CloudSearch/real/v1/domain/{name}/document/manage/object_storage
```

## 요청<a name="요청"></a>

### 요청 파라미터<a name="요청파라미터"></a>

| 파라미터명 | 필수 여부 | 타입   | 제약 사항 | 설명                                   |
|-------------|-----------|--------|----------|----------------------------------------|
| name      | Yes       | string | | 생성되어져 있는 Domain 이름 |

### 요청 바디<a name="요청바디"></a>

|    필드명    | 필수 여부 | 타입    | 제약 사항                                                                | 설명                             |
|------------|-----------|---------|--------------------------------------------------------------------------|----------------------------------|
| bucket   | Yes       | string |  | 업로드 할 문서가 위치한 버킷 이름 |
| objectPath  | Yes       | string  |  | 업로드 할 문서의 경로 |
| region  | Yes       | string  | "kr", "us", "sg", "jp", "de" | 버킷의 리전 정보 |
| pruning | Yes       | boolean  |  | 기존 색인된 문서의 삭제 여부(true로 할 경우 기존에 색인된 문서들을 삭제하고, 업로드 요청한 문서의 색인을 수행함) |

## 응답<a name="응답"></a>

### 응답 Status<a name="응답Status"></a>

|HTTP Status | Desc |
|-------- | ---------------------------- |
|200| OK, 요청 완료 |
|400|  Bad Request |
| 401    | Unauthorized, There is no authorization to read the object file  |
|403 | Forbidden                                          |                                                              |
|404 | Not Found                                       |                                                              |
| 500 | Internal Server Error                                                 |                                                              |

## 예시<a name="예시"></a>

### 요청 예시<a name="요청예시"></a>

```http
POST /CloudSearch/real/v1/domain/car/document/manage/object_storage HTTP/1.1
Host:cloudsearch.apigw.ntruss.com
Content-Type: application/json
x-ncp-apigw-signature-v2: cDwtHuQeGmwWyNmwlN6XIGA66zge4iMXvfoDQNna05g=
x-ncp-apigw-timestamp: 1545817618751
x-ncp-iam-access-key: teGTwtcSEGA7fu28BGGi

{
  "bucket": "my-test",
  "objectPath": "doc/car_upsert.json",
  "region": "kr",
  "pruning": false
}
```

### 응답 예시<a name="응답예시"></a>


```json
{"result":"ok"}
```