すべてのプロダクト
Search
ドキュメントセンター

Cloud Storage Gateway:データダウンロード

最終更新日:May 08, 2026

レプリケーションモードでは、ファイルゲートウェイのデータダウンロード機能を使用して、OSS バケットからローカルクライアントにデータをダウンロードできます。

前提条件

  • ファイルゲートウェイが作成済みで、キャッシュディスクがアタッチされている必要があります。

  • OSS バケットが作成済みである必要があります。詳細については、「コンソール クイックスタート」をご参照ください。

    重要
    • ファイルゲートウェイは、標準ストレージ、低頻度アクセス (IA)、およびアーカイブ OSS バケットをサポートします。ミラーリングベースのオリジンフェッチが有効なバケットはサポートされません。

    • ゲートウェイをアーカイブバケットに関連付けないでください。代わりに、ファイルを標準ストレージまたは低頻度アクセスバケットに保存し、ライフサイクルルールを設定してアーカイブまたはコールドアーカイブにトランジションするようにしてください。これにより、不要なリストア操作を回避できます。

    • クライアントがファイルを書き込む際、ゲートウェイは CopyObject を呼び出して、ファイルの更新時刻をオブジェクトのメタデータとして保存します。アーカイブまたはコールドアーカイブのオブジェクトに対して CopyObject を実行するとリストアがトリガーされ、アップロードが遅延したり、失敗したりする可能性があります。

  • ファイルゲートウェイで逆同期または高速同期を使用している必要があります。詳細については、「高速同期」をご参照ください。

背景情報

デフォルトでは、ファイルゲートウェイは逆同期または高速同期を使用して、OSS バケットからローカルクライアントにメタデータを同期します。レプリケーションモードでは、データのコピーがローカルクライアントと OSS バケットの両方に保存されます。データダウンロード機能を使用すると、ファイルゲートウェイは指定されたディレクトリのファイルデータ、または逆同期または高速同期によって同期されるすべてのファイルデータをローカルクライアントにダウンロードできます。

インターネット経由でのデータダウンロードには OSS 料金が発生します。この機能は必要に応じて使用してください。詳細については、「課金概要」をご参照ください。

新規共有のデータダウンロードの有効化

  1. Cloud Storage Gateway コンソールの ゲートウェイ一覧 ページで、対象のファイルゲートウェイを検索してクリックし、共有 をクリックします。

  2. 共有の作成 ダイアログボックスで、バケットの設定 および 基本情報 の各セクションでパラメーターを設定し、詳細設定 を選択します。詳細については、「共有の作成」をご参照ください。

  3. 詳細設定 セクションで、以下のパラメーターを設定し、次へ をクリックします。

    パラメーター

    説明

    モード

    レプリケーションモード を選択します。

    逆同期

    逆同期 をオンにします。この機能は、OSS バケットからローカルクライアントにメタデータを同期するもので、ゲートウェイのディザスタリカバリ、データ復元、データ共有などのシナリオに適しています。

    逆同期はディレクトリにアクセスされた場合にのみトリガーされます。アクセスされていないディレクトリや新しく追加されたデータを確実にダウンロードするには、高速同期を使用してください。詳細については、「高速同期」をご参照ください。

    説明
    • 逆同期では、バケット内のすべてのオブジェクトがスキャンされます。バケットに多数のオブジェクトが含まれている場合、OSS API リクエスト料金が発生します。詳細については、Object Storage Service (OSS) の料金ページのリクエスト料金をご参照ください。

    • 基本情報 セクションで 同期グループに追加 を選択した場合、このオプションは使用できません。

    逆同期間隔

    値は 15 秒~36000 秒の範囲内である必要があります。

    説明

    バケットに多数のオブジェクトが含まれている場合は、逆同期間隔を 3600 秒以上に設定してください。そうでない場合、頻繁なスキャンにより OSS API リクエスト料金が高額になる可能性があります。

    レプリケーションモードの詳細設定

    レプリケーションモードの詳細設定 を選択します。

  4. レプリケーションモードの詳細設定 セクションで、以下のパラメーターを設定して データダウンロード を有効化します。

    パラメーター

    説明

    複製モードにするディレクトリの設定

    このパラメーターは、レプリケーションモードで実行されるファイルデータの範囲を指定します。

    • このパラメーターを選択しない場合、共有内のすべてのデータがデフォルトでレプリケーションモードで実行されます。

    • このパラメーターを選択する場合、ディレクトリの追加 をクリックして、対象データディレクトリのパスを入力します。指定されたディレクトリパスのデータはレプリケーションモードで実行されますが、指定されていないパスのデータはキャッシュモードで実行されます。

    説明
    • ディレクトリをキャッシュモードからレプリケーションモードに変更する場合、データダウンロードが有効になっていると、そのディレクトリ内のファイルが同期されます。レプリケーションモード用のデータダウンロードを同時に有効にしてください。

    • 指定するディレクトリパスは、共有のルートディレクトリを基準とした相対パスです。たとえば、レプリケーションモードを有効にするディレクトリの絶対パスが /mnt/myshare/mydir/ で、マウントポイントが /mnt/myshare の場合、/mydir/ と入力します。

    データダウンロード

    データダウンロードを有効にすると、逆同期または高速同期によってメタデータとファイルデータの両方がダウンロードされます。無効の場合、メタデータのみが同期されます。

    説明
    • レプリケーションモードでファイルデータをダウンロードするには、キャッシュディスク容量が複製対象ファイルの合計サイズの少なくとも 1.1 倍である必要があります。バケット使用量の今後の増加を見込んで、キャッシュディスク容量を計画してください。

    • データダウンロードを初めて有効にするとフルスキャンがトリガーされ、ゲートウェイのパフォーマンスに影響を与える可能性があります。この機能を有効にする際は、ゲートウェイがアイドル状態であることを確認し、すべてのデータがダウンロードされるまでアイドル状態を維持してください。

    • データダウンロード機能は、シングルライター・マルチリーダーのシナリオのみをサポートします。対応するバケットに複数のアクセサ(ゲートウェイや直接的な OSS アクセスなど)がある場合、1 つのアクセサのみがバケットにファイルをアップロードできます。他のアクセサはファイルをダウンロードすることしかできません。マルチライター・マルチリーダーのシナリオではデータ損失が発生する可能性があるため、この機能は慎重に使用してください。

    ダウンロード速度制限

    データダウンロード を有効にする際にこのパラメーターを設定します。ダウンロード速度制限は 0 MB/s ~ 1280 MB/s の範囲内で設定する必要があります。0 MB/s を指定すると、ダウンロード速度は無制限になります。

    逆同期間隔

    データダウンロード を有効にする際にこのパラメーターを設定します。値は 3600 秒~36000 秒の範囲内である必要があります。

    説明
    • バケットに多数のオブジェクトが含まれている場合は、逆同期間隔を 3600 秒以上に設定してください。そうでない場合、頻繁なスキャンにより OSS API リクエスト料金が高額になる可能性があります。

    • 逆同期はディレクトリにアクセスされた場合にのみトリガーされます。アクセスされていないディレクトリや新しく追加されたデータを確実にダウンロードするには、高速同期を使用してください。

既存共有のデータダウンロードの有効化

  1. CSG コンソールの ゲートウェイ ページで、対象のファイルゲートウェイを検索してクリックします。

  2. 共有 タブで、対象の共有を検索し、[操作] 列の 詳細設定 をクリックします。

  3. 共有の詳細設定 ページで、以下のパラメーターを設定して データダウンロード を有効化します。

    パラメーター

    説明

    モード

    データダウンロード 機能は レプリケーションモード のみで使用できます。

    逆同期

    逆同期 をオンにします。この機能は、OSS バケットからローカルクライアントにメタデータを同期するもので、ゲートウェイのディザスタリカバリ、データ復元、データ共有などのシナリオに適しています。

    逆同期はディレクトリにアクセスされた場合にのみトリガーされます。アクセスされていないディレクトリや新しく追加されたデータを確実にダウンロードするには、高速同期を使用してください。詳細については、「高速同期」をご参照ください。

    説明
    • 逆同期では、バケット内のすべてのオブジェクトがスキャンされます。バケットに多数のオブジェクトが含まれている場合、OSS API リクエスト料金が発生します。詳細については、「Object Storage Service (OSS) pricing」ページのリクエスト料金をご参照ください。

    • 基本情報 セクションで 同期グループに追加 を選択した場合、このオプションは使用できません。

    データダウンロード

    データダウンロードを有効にすると、逆同期または高速同期によってメタデータとファイルデータの両方がダウンロードされます。無効の場合、メタデータのみが同期されます。

    説明
    • データをダウンロードするには、キャッシュディスク容量が複製対象ファイルの合計サイズの少なくとも 1.1 倍である必要があります。バケット使用量の今後の増加を見込んで、キャッシュディスク容量を計画してください。

    • データダウンロードを初めて有効にするとフルスキャンがトリガーされ、ゲートウェイのパフォーマンスに影響を与える可能性があります。この機能を有効にする際は、ゲートウェイがアイドル状態であることを確認し、すべてのデータがダウンロードされるまでアイドル状態を維持してください。

    • データダウンロード機能は、シングルライター・マルチリーダーのシナリオのみをサポートします。対応するバケットに複数のアクセサ(ゲートウェイや直接的な OSS アクセスなど)がある場合、1 つのアクセサのみがバケットにファイルをアップロードできます。他のアクセサはファイルをダウンロードすることしかできません。マルチライター・マルチリーダーのシナリオではデータ損失が発生する可能性があるため、この機能は慎重に使用してください。

    ダウンロード速度制限

    データダウンロード を有効にする際にこのパラメーターを設定します。ダウンロード速度制限は 0 MB/s ~ 1280 MB/s の範囲内で設定する必要があります。0 MB/s を指定すると、ダウンロード速度は無制限になります。