---
title: "Object Storage Document管理"
slug: "analytics-cloudsearch-manageobjectstoragedocument"
updated: 2026-09-17T09:57:26Z
published: 2026-09-17T09:57:26Z
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を通じて大容量Documentアップロード(最大100MB)を実行できます。 Documentに対する詳しい説明は[Document管理](/docs/ja/analytics-cloudsearch-managedocument)を通じて確認してください。

- BOM(Byte Order Mark)が含まれたDocumentはアップロードが不可能です。
- **自動完成機能を使っている場合は本リクエスト以降、 [自動完成設定及び修正リクエスト](/docs/ja/analytics-cloudsearch-putautocomplete)を通じて自動完成インデックスを更新する必要があります。**

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

## リクエスト

### リクエストパラメータ

| パラメータ名 | 必須 | タイプ | 制約事項 | 説明 |
| --- | --- | --- | --- | --- |
| name | Yes | string |  | 作成されているDomain名 |

### リクエストボディ

| フィールド名 | 必須 | タイプ | 制約事項 | 説明 |
| --- | --- | --- | --- | --- |
| bucket | Yes | string |  | アップロードするDocumentが位置したバケット名 |
| objectPath | Yes | string |  | アップロードするDocumentのパス |
| region | Yes | string | "kr", "us", "sg", "jp", "de" | バケットのリージョン情報 |
| pruning | Yes | boolean |  | 既存インデックスされたDocumentの削除区分(trueにする場合、既存インデックスされたDocumentを削除し、アップロードリクエストしたDocumentのインデックスを実行します。) |

## レスポンス

### レスポンスStatus

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

## 例示

### リクエスト例示

```
POST /CloudSearch/real/v1/domain/car/document/manage/object_storage HTTP/1.1
Host:cloudsearch.apigw.ntruss.com
accept: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
}
```

### レスポンス例示

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