--- title: "オブジェクトのダウンロード" url: https://docs.catalyst.zoho.com/ja/sdk/web/v4/cloud-scale/stratus/download-object/ description: "このページでは、Stratusからオブジェクトを取得するWeb SDKメソッドについて説明します。" last_updated: 2026-02-23T12:39:41Z service: Cloud Scale type: general related_links: - name: "Stratus Component Help Documentation" url: /ja/cloud-scale/help/stratus/introduction - name: "Java SDK" url: /ja/sdk/java/v1/cloud-scale/stratus/download-object/ - name: "Node.js SDK" url: /ja/sdk/nodejs/v2/cloud-scale/stratus/download-object/ - name: "Python SDK" url: /ja/sdk/python/v1/cloud-scale/stratus/download-object/ - name: "iOS SDK" url: /ja/sdk/ios/v2/cloud-scale/stratus/download-object/ - name: "Android SDK" url: /ja/sdk/android/v2/cloud-scale/stratus/download-object/ - name: "Flutter SDK" url: /ja/sdk/flutter/v2/cloud-scale/stratus/download-object/ - name: "REST API" url: /ja/api/code-reference/cloud-scale/stratus/get-all-buckets/#GetAllBuckets --- # オブジェクトのダウンロード このSDKメソッドは、バケットからオブジェクトをダウンロードするために使用できます。レスポンスは**blob**形式になります。以下のコードスニペットで使用されているStratusリファレンスは、[コンポーネントインスタンス](https://docs.catalyst.zoho.com/ja/sdk/web/v4/cloud-scale/stratus/initialize-stratus-instance/)です。 バケットの[バージョニング](https://docs.catalyst.zoho.com/ja/cloud-scale/help/stratus/stratus-config/general-settings/#versioning)ステータスに関する想定レスポンス: * `versionId` を渡さない場合、リクエストで指定したキーとともに**最新のオブジェクト**が返されます。 * バケットでバージョニングが有効にされた後、無効にされた場合。デフォルトでは、プリンシパルの最初のオブジェクトが返されます。このオブジェクトの最新バージョンをダウンロードするには、`versionId` パラメータに「`topVersion`」の値を渡す必要があります。 * 特定のバージョンを取得するには、`versionId` クエリパラメータに有効なバージョンを値として使用します。 **使用パラメータ**
パラメータ名 データ型 定義
`key` **String** オブジェクトの名前を保持します。
`options` **JSON Object**
  • `versionId`: オプションの**String**パラメータです。必要なオブジェクトバージョンの一意の `version ID` を保持します。
  • `range`: オプションの**String**パラメータです。必要なオブジェクトのバイト範囲です。オブジェクトの特定部分を取得するために使用されます。
  • `cached`: オプションの**Boolean**パラメータです。
    • オブジェクトのキャッシュバージョンを取得するために使用されます。
    • 「`true`」または「`false`」の2つの値のみを受け付けます。
    • このパラメータが使用されない場合、値は `false` になります。
    • バケットで[キャッシュ](https://docs.catalyst.zoho.com/ja/cloud-scale/help/stratus/stratus-config/general-settings/#caching)が有効で、このパラメータを渡した場合、値は `true` になります。この場合、オブジェクトはキャッシュドメインから取得されます。
  • `signed`: オプションの**Boolean**パラメータです。デフォルト値は「`false`」です。署名付きURLを取得するためのAPI呼び出しを行います。
  • `signedUrlFn`:
    • オプションの**Function**パラメータです。
    • サーバーSDK（[Java](https://docs.catalyst.zoho.com/ja/sdk/java/v1/cloud-scale/stratus/pre-signed-urls/)、[Node.js](https://docs.catalyst.zoho.com/ja/sdk/nodejs/v2/cloud-scale/stratus/pre-signed-urls/)、および[Python](https://docs.catalyst.zoho.com/ja/sdk/python/v1/cloud-scale/stratus/pre-signed-urls/)）で提供される**署名付きURL APIレスポンス**を返すコールバックファンクションです。ファイルをダウンロードするために使用されます。
    • このファンクションは非同期ファンクションとPromiseのみを受け付けます。
    • このファンクションを使用すると、CatalystはキャッシュURLと有効期限をパラメータとして渡し、署名付きURLの生成に使用できます。
`processCallback` **Function** ファイルダウンロード中のコールバックファンクションです。
### オブジェクト名を使用したオブジェクトのダウンロード 以下のSDKスニペットを使用すると、`key` を使用してStratusのバケットからオブジェクトをダウンロードできます。 ```javascript const getObject = await bucket.getObject("key"); const getObjectStart = getObject.start(); // リクエストを開始する const getObjectAbort = getObject.abort(); // リクエストを中止する ``` ### 特定バージョンのオブジェクトのダウンロード 以下のSDKスニペットを使用すると、`key` と `versionId` を使用してStratusのバケットから特定バージョンのオブジェクトをダウンロードできます。 ```javascript const options = { 'versionId': 'djkshr8374yiuhf48', // オブジェクトの特定バージョンをダウンロードする } const getObject = await bucket.getObject("key", options); const getObjectStart = getObject.start(); // リクエストを開始する const getObjectAbort = getObject.abort(); // リクエストを中止する ``` ### プロセスコールバック付きオブジェクトのダウンロード 以下のSDKスニペットを使用すると、プロセスコールバックオプションを使用してStratusのバケットから特定のオブジェクトをダウンロードできます。このSDKは、ダウンロード操作とともにロギング、ロード/バッファ画面のレンダリングなどの追加ファンクションを実行したい場合に最適です。 ```javascript // オブジェクトのダウンロード中のプロセスコールバック const processCallback = () => { // オブジェクトの取得中に実行する関数 console.log("Downloading Object"); } const options = { 'versionId': 'djkshr8374yiuhf48' } const getObject = await bucket.getObject("key", options, processCallback); const getObjectStart = getObject.start(); // リクエストを開始する const getObjectAbort = getObject.abort(); // リクエストを中止する ``` **レスポンス例** ```json { "status": 200, "content": {Blob Data}, "message": "OK" } ``` **想定される例外** * **404**: オブジェクトまたはBucketが見つかりません * **416**: リクエストされた範囲が満たせません ### オブジェクトの特定部分のダウンロード このセクションでは、Stratusからローカルシステムにオブジェクトの必要なバイト範囲をダウンロードできるSDKメソッドについて説明します。以下のコードスニペットで使用されているStratusリファレンスは、[コンポーネントインスタンス](https://docs.catalyst.zoho.com/ja/sdk/web/v4/cloud-scale/stratus/initialize-stratus-instance/)です。 このメソッドは、オブジェクトの開始バイトと終了バイトの範囲を使用して、オブジェクトを複数のバイト範囲に分割する方式で機能します。 ```javascript const processCallback = () => { // オブジェクトの取得中に実行する関数 console.log("Downloading Object"); } const options = { 'range': '0-2000' // オブジェクトのバイト単位の開始・終了範囲 } const getObject = await stratus.getObject("key", options, processCallback); const getObjectStart = getObject.start(); // リクエストを開始する const getObjectAbort = getObject.abort(); // リクエストを中止する ``` **レスポンス例** ```json { "status": 206, "content": {Blob Data}, "message": "PARTIAL_CONTENT" } ``` ### 署名付きURLを使用したオブジェクトのダウンロード #### 非同期ファンクションの使用 ```javascript // 署名付きURLを使用したオブジェクトのダウンロード // 非同期ファンクションの使用 const processCallback = () => { // オブジェクトの取得中に実行する関数 console.log("Downloading Object"); } const options = { 'range': '0-2000' // オブジェクトのバイト単位の開始・終了範囲, 'signed': true, // 署名付きURLを使用してバケットからオブジェクトを取得することを宣言する 'signedUrlFn' : async (functionData) => { console.log("Data : " + functionData); // ファンクションロジック return { "signed_url": "" //署名付きURL } } } const getObject = await stratus.getObject("key", options, processCallback); const getObjectStart = getObject.start(); // リクエストを開始する const getObjectAbort = getObject.abort(); // リクエストを中止する ``` #### Promiseの使用 ```javascript // Promiseの使用 const processCallback = () => { // オブジェクトの取得中に実行する関数 console.log("Downloading Object"); } const options = { 'range': '0-2000' // オブジェクトのバイト単位の開始・終了範囲, 'signed': true, // 署名付きURLを使用してバケットからオブジェクトを取得することを宣言する 'signedUrlFn' : (functionData) => { return new Promise((resolve, reject) => { console.log("Data : " + functionData); // ファンクションロジック resolve({ "signed_url" : "" }) }) } } const getObject = await stratus.getObject("key", options, processCallback); const getObjectStart = getObject.start(); // リクエストを開始する const getObjectAbort = getObject.abort(); // リクエストを中止する ``` #### オプション付きSignedURLの使用 以下のSDKメソッドを使用すると、署名付きURLを使用してオブジェクトをダウンロードし、署名付きURLの**有効期限**を設定できます。 ```javascript // 署名付きURLと有効期限を使用したオブジェクトのダウンロード const processCallback = () => { // オブジェクトの取得中に実行する関数 console.log("Downloading Object"); } const options = { 'range': '0-2000' // オブジェクトのバイト単位の開始・終了範囲, 'signed': true, // 署名付きURLを使用してバケットからオブジェクトを取得することを宣言する 'signedUrlFn' : async (functionData) => { console.log("Data : " + functionData); // ファンクションロジック return { "signed_url": "" // 署名付きURL } }, "expiryInSeconds" : 3000 // 秒単位 } const getObject = await stratus.getObject("key", options, processCallback); const getObjectStart = getObject.start(); // リクエストを開始する const getObjectAbort = getObject.abort(); // リクエストを中止する ``` ### キャッシュURLを使用したキャッシュオブジェクトのダウンロード 以下のSDKメソッドを使用すると、[キャッシュURL](https://docs.catalyst.zoho.com/ja/cloud-scale/help/stratus/stratus-config/general-settings/#caching)を使用してキャッシュオブジェクトをダウンロードできます。 ```javascript // キャッシュURL const processCallback = () => { // オブジェクトの取得中に実行する関数 console.log("Downloading Object"); } const options = { 'range': '0-2000' // オブジェクトのバイト単位の開始・終了範囲, 'cached': true, // キャッシュURLを使用してバケットからオブジェクトを取得することを宣言する } const getObject = await stratus.getObject("key", options, processCallback); const getObjectStart = getObject.start(); // リクエストを開始する const getObjectAbort = getObject.abort(); // リクエストを中止する ```