---
title: "オブジェクトのアップロード"
url: https://docs.catalyst.zoho.com/ja/api/code-reference/cloud-scale/stratus/upload-object/
description: "このAPIは、Stratusに保存されているオブジェクトに対してアップロード操作を実行できるようにします。"
last_updated: 2026-02-23T12:39:41Z
service: Cloud Scale
type: api
---

# オブジェクトのアップロード

### 説明

このAPIは、必要な[オブジェクト](https://docs.catalyst.zoho.com/ja/cloud-scale/help/stratus/objects/introduction/)をバケットにアップロードできるようにします。バケットはその[一意のバケット名](https://docs.catalyst.zoho.com/ja/cloud-scale/help/stratus/buckets/name-bucket/#ideal-practices-to-name-a-bucket)で参照され、必要なオブジェクトはその名前を使用して参照されます。

### リクエスト詳細

#### リクエストURL

`PUT` {bucket_name}.zohostratus.com/{key}

上記のドメイン名はデータセンターに応じて変わります:

<table class="content-table">
	<thead>
		<tr>
	        <th class="w20p">DC</th>
            <th class="w40p">ドメイン名</th>
		</tr>
	</thead>
	<tbody>
        <tr>
            <td>`US`</td>
            <td>**zohostratus.com**</td>
        </tr>
        <tr>
            <td>`EU`</td>
            <td>**zohostratus.eu**</td>
        </tr>
         <tr>
            <td>`IN`</td>
            <td>**zohostratus.in**</td>
        </tr>
        <tr>
            <td>`AU`</td>
            <td>**zohostratus.com.au**</td>
        </tr>
        <tr>
            <td>`CA`</td>
            <td>**zohostratus.ca**</td>
        </tr>
        <tr>
            <td>`SA`</td>
            <td>**zohostratus.sa**</td>
        </tr>
        <tr>
            <td>`JP`</td>
            <td>**zohostratus.jp**</td>
        </tr>
	</tbody>
</table>

> **注意:** 開発環境でAPIを使用する場合、ドメインは次のような構造になります: https://<bucket_name>-development.zohostratus.com

#### パスパラメータ

- **project_id** (Numerical): プロジェクトの[一意のID](https://docs.catalyst.zoho.com/ja/getting-started/set-up-a-catalyst-project/general-settings/)

- **bucket_name** (String): [バケットの名前](https://docs.catalyst.zoho.com/ja/cloud-scale/help/stratus/buckets/name-bucket/#ideal-practices-to-name-a-bucket)

- **key** (String): アップロードする必要があるオブジェクトの名前

> **注意:** `key`の値を指定する際には、以下の点に注意してください:

* キーの最大長（パス名とオブジェクト名を含む）は255文字までサポートされます。

* キーにはスペースを含む以下の文字を含めることはできません: ダブルクォート、両方の山括弧、ハッシュタグ、バックスラッシュ、パイプ記号。

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

- **version_id** (String, optional): バージョニングが有効な場合にStratusによって生成されるIDです。`version_id`を使用して必要なオブジェクトを参照できます。

#### リクエストヘッダー
 **Authorization:** Zoho-oauthtoken {oauth_token} 

**オプションヘッダー** 

 **content-type:** application/json

 **content-length:** アップロードされるオブジェクトのバイト単位の生の長さ。

 **compress:** 保存時にオブジェクトを圧縮するかどうか。デフォルトでは常に圧縮が行われます。

 **cache-control:** ブラウザのキャッシュポリシーを指定するためにこのヘッダーを使用します。

 **overwrite:** ソースを上書きする必要があるかどうかを指定します。これはバージョニングされていないバケットのオブジェクトのみサポートされます。

 **expires-after:** オブジェクトのTime-to-Live（TTL）を秒単位で設定するために使用できるオプションです。値は60秒以上である必要があります。

 **x-user-meta:{1stKey}={1stValue};{2ndKey}={2ndValue};..{NthKey}={NthValue};:** オブジェクトの[メタデータ](https://docs.catalyst.zoho.com/ja/cloud-scale/help/stratus/objects/introduction/#metadata)。各キーと値のペアはセミコロンで区切られ、前のカラムに示されているように提供されます。このヘッダーの最大許可文字数は**2047文字**です。

#### スコープ

Stratus.fileop.CREATE

### レスポンス詳細

正常に実行されると、レスポンスには成功メッセージが含まれ、オブジェクトがアップロードされます。

#### 失敗レスポンスの可能性

**404** オブジェクト/バケットが見つからない場合:

**失敗レスポンス**

```json

    {
    "status": 404,
    "code": "bucket_not_found",
    "message": "no such bucket exists"
    }

```

**403** 未認証。アップロード操作を実行するために必要な権限がない場合

**失敗レスポンス**

```json

    {
    "status": 403,
    "code": "access_forbidden",
    "message": "request denied by resource access policy"
    }

```

**400** 不正なリクエスト。無効なファイル名

**失敗レスポンス**

```json

    {
    "status": 400,
    "code": "key_name_invalid",
    "message": "key name does not support one or more character(s)"
    }

```

**409** コンフリクト。同じ名前のオブジェクトが既に存在する

**失敗レスポンス**

```json

    {
    "status": 409,
    "code": "key_already_exists",
    "message": "key is already associated with another object in the bucket"
    }

```

**リクエスト例**

```bash

curl -X PUT https://{bucket_name}.zohostratus.com/{key}
-H "Authorization: Zoho-oauthtoken 1000.910*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*16.2f*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*57"

```

**レスポンス例**

```bash

200 OK

```

### SDK Documentation

* [Upload Object - Java SDK](https://docs.catalyst.zoho.com/ja/sdk/java/v1/cloud-scale/stratus/upload-object/)
* [Upload Object - Node.js SDK](https://docs.catalyst.zoho.com/ja/sdk/nodejs/v2/cloud-scale/stratus/upload-object/)
* [UploadObject - Python SDK](https://docs.catalyst.zoho.com/ja/sdk/python/v1/cloud-scale/stratus/upload-object/)
* [Upload - Web SDK](https://docs.catalyst.zoho.com/ja/sdk/web/v4/cloud-scale/stratus/overview/)
* [Upload - iOS SDK](https://docs.catalyst.zoho.com/ja/sdk/ios/v2/cloud-scale/stratus/upload-object/)
* [Upload - Android SDK](https://docs.catalyst.zoho.com/ja/sdk/android/v2/cloud-scale/stratus/upload-object/)
* [Upload - Flutter SDK](https://docs.catalyst.zoho.com/ja/sdk/flutter/v2/cloud-scale/stratus/upload-object/)