---
title: "オブジェクトのダウンロード"
url: https://docs.catalyst.zoho.com/ja/api/code-reference/cloud-scale/stratus/download-object/
description: "このAPIは、Stratusに保存されているオブジェクトに対してダウンロード操作を実行できるようにします。"
last_updated: 2026-03-24T12:08:39Z
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

`GET` {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

* コンソールからバケットURLを取得することをお勧めします。

#### パスパラメータ

- **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): ダウンロードする必要があるオブジェクトの名前

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

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

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

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

 **Range:** オブジェクトの特定のバイト範囲をダウンロードする場合

 **retrieve-meta:** オブジェクトのメタデータを取得する場合 | 指定可能な値: `True/False` | デフォルト値: `False`

#### スコープ

Stratus.fileop.READ

#### レスポンスをオーバーライドするクエリパラメータ

以下のクエリパラメータを追加してレスポンスを変更し、必要なレスポンスを取得できます。これらはすべてオプションパラメータです。オーバーライドはリクエストが成功した場合にのみ機能します。

- **responseContentType** (String, optional): レスポンスの`Content-Type`ヘッダーを設定します。標準的な[IANAで定義された](https://www.iana.org/assignments/media-types/media-types.xhtml)コンテンツタイプのみ使用できます。

- **responseContentLanguage** (String, optional): レスポンスの`Content-Language`ヘッダーを設定します。

- **responseContentDisposition** (String, optional): レスポンスの`Content-Disposition`ヘッダーを設定します。パラメータ値は次の形式である必要があります:
 attachment; filename="name"
**例:** attachment; filename="logo.svg"

- **responseCacheControl** (String, optional): レスポンスの`Cache-Control`ヘッダーを設定します。
**例:** public,max-age=3600,no-transform

### レスポンス詳細

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

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

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

**失敗レスポンス**

```json

    {
    "status": 404,
    "code": "key_not_found",
    "message": "no such key is associated with any object in the bucket"
    }

```

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

**失敗レスポンス**

```json

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

```

**リクエスト例**

```bash

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

```

**レスポンス例**

```bash

200 OK
// 生データのバイト

```

### SDK Documentation

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