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

Object Storage Service:オブジェクトのダウンロード

最終更新日:Oct 17, 2024

cpコマンドを実行して、画像やビデオなどのリソースをObject Storage Service (OSS) からローカルコンピューターにダウンロードできます。

使用上の注意

オブジェクトをダウンロードするには、oss:GetObjectまたはoss:ListObjects権限が必要です。 詳細については、「RAMユーザーへのカスタムポリシーのアタッチ」をご参照ください。

コマンド構文

ossutil cp oss://bucket[/prefix] local-path [flags]

パラメーター

タイプ

説明

ローカルパス

String

ダウンロードするオブジェクトを保存するパス。 パスには、相対パス、絶対パス、または-を指定できます。 パラメーターを-に設定すると、オブジェクトは標準出力ディレクトリに保存されます。

prefix

String

ダウンロードするオブジェクトの名前のプレフィックス。 prefixパラメーターの値がスラッシュ (/) で終わる場合、ossutilは複数のオブジェクトをダウンロードします。 prefixパラメーターの値がスラッシュ (/) で終わっていない場合、ossutilはコマンドラインオプションに基づいて複数のオブジェクトをダウンロードするか単一のオブジェクトをダウンロードするかを決定します。

-- acl

String

オブジェクトのアクセス制御リスト (ACL) 。 有効な値:

  • private: プライベート

  • public-read: public-read

  • public-read-write: public-read-write

  • default: バケットから継承

-- bigfile-threshold

int

マルチパートダウンロードタスクのオブジェクトサイズのしきい値。 デフォルト値: 104857600

-- cache-control

String

オブジェクトがダウンロードされたときのwebページのキャッシュ動作。

-チェッカー

int

並列に実行するチェッカーの数。 デフォルト値: 16。

-- checkpoint-dir

String

マルチパートダウンロードタスクのチェックポイントファイルが格納されているディレクトリ。 デフォルト値:. ossutil_checkpoint /.

-- content-disposition

String

オブジェクトの表示形式。

-- content-encoding

String

オブジェクトのエンコードに使用されるエンコード方法。

-- content-type

String

オブジェクトのコンテンツタイプ。

-- コピー小道具

String

ダウンロードするオブジェクトの属性。 有効な値:

  • none

  • metadata

  • default

-d, -- dirs

String

現在のディレクトリのオブジェクトとサブディレクトリが返されることを指定します。

-- encoding-type

String

オブジェクト名のエンコードに使用されるエンコード方法。 有効値: url

-- end-with

String

-- end-withパラメーターの値の前または同じ名前のオブジェクトが返されるように指定します。

-除外

stringArray

パスまたはオブジェクト名の除外ルール。

-- exclude-from

stringArray

除外ルールをルールファイルから読み取ることを指定します。

-- 有効期限

stringArray

キャッシュされたコンテンツの絶対有効期限。

-- files-から

stringArray

オブジェクト名をルールファイルから読み取り、空行またはコメント行を無視することを指定します。

-- files-from-raw

stringArray

オブジェクト名をルールファイルから読み取ることを指定します。

-- フィルター

stringArray

パスまたはオブジェクト名のフィルタールール。

-- filter-from

stringArray

パスまたはオブジェクト名のフィルタールールをルールファイルから読み取ることを指定します。

-f、-- 力

/

確認のプロンプトなしでコマンドを強制的に実行することを指定します。

-含む

stringArray

パスまたはオブジェクト名の包含ルール。

-- include-from

stringArray

包含ルールをルールファイルから読み取ることを指定します。

-j, -- job

int

複数のオブジェクトに対して実行できる同時タスクの数。 デフォルト値: 3。

-- list-objects

/

オブジェクトを一覧表示するためにListObjects操作を呼び出すことを指定します。

-最大年齢

有効期間

最終変更時刻が -- max-ageパラメーターの値より前のオブジェクトをダウンロードしないように指定します。 デフォルトの単位は秒です。 単位は、ミリ秒、秒、分、時間、日、週、月、または年とすることができる。 デフォルトでは、このパラメータは空のままです。

-- max-mtime

時間

最終変更時刻が -- max-mtimeパラメーターの値より後のオブジェクトをダウンロードしないように指定します。 値はUTCです。 デフォルトでは、このパラメータは空のままです。

-最大サイズ

SizeSuffix

ダウンロードできるオブジェクトの最大サイズ。 デフォルトの単位はバイトです。 オブジェクトサイズの単位は、バイト、KiB、MiB、GiB、TiB、またはPiBです。 注: 1 KiB = 1,024バイト。

-- メタデータ

文字列

キー=値形式のオブジェクトのユーザーメタデータ。

-- metadata-ディレクティブ

String

オブジェクトのメタデータを設定するために使用されるメソッド。 有効な値:

  • COPY

  • REPLACE

-- metadata-除外

stringArray

オブジェクトメタデータの除外ルール。

-- metadata-filter

stringArray

オブジェクトメタデータのフィルタールール。

-- metadata-filter-from

stringArray

オブジェクトメタデータのフィルタールールをルールファイルから読み取ることを指定します。

-- metadata-include

stringArray

オブジェクトメタデータの包含ルール。

-- 最低年齢

有効期間

最終変更時刻が -- min-ageパラメーターの値より後のオブジェクトをダウンロードしないように指定します。 デフォルトの単位は秒です。 単位は、ミリ秒、秒、分、時間、日、週、月、または年とすることができる。 デフォルトでは、このパラメータは空のままです。

-- min-mtime

時間

最終変更時刻が -- min-mtimeパラメーターの値より前のオブジェクトをダウンロードしないように指定します。 値はUTCです。 デフォルトでは、このパラメータは空のままです。

-- 最小サイズ

SizeSuffix

ダウンロードできるオブジェクトの最小サイズ。 デフォルトの単位はバイトです。 オブジェクトサイズの単位は、バイト、KiB、MiB、GiB、TiB、またはPiBです。 注: 1 KiB = 1,024バイト。

-- 進歩なし

/

進行状況バーが表示されないことを指定します。

-- ページサイズ

int

返されるオブジェクトの最大数。 デフォルト値は 1000 です。 有効な値: 1 ~ 1000

-- 平行

int

1つのオブジェクトに対する内部操作の同時タスクの数。

-- 部分サイズ

SizeSuffix

部品サイズ。 デフォルトでは、ossutilはオブジェクトサイズに基づいて適切な部品サイズを計算します。 有効値: KiB 100 5 GiB。

-r, -- recursive

/

コマンドがオブジェクトに対して再帰的に実行されることを指定します。 このパラメーターを指定すると、バケット内の条件を満たすすべてのオブジェクトに対してコマンドが有効になります。 それ以外の場合、コマンドは指定されたパス内のオブジェクトに対してのみ有効になります。

-- request-payer

String

リクエストの支払人。 pay-by-requesterがバケットに対して有効になっている場合、このパラメーターをrequesterに設定します。

-- サイズだけ

/

オブジェクトのサイズがローカルファイルのサイズと異なる場合にのみ、オブジェクトをダウンロードすることを指定します。

-- start-after

String

-- start-afterパラメーターの値の後に名前がアルファベット順であるオブジェクトが返されることを指定します。

-- ストレージクラス

String

オブジェクトのストレージクラス。 有効な値:

  • 標準

  • IA

  • アーカイブ

  • ColdArchive

  • DeepColdArchive

-- タグ付け

文字列

キー=値形式のオブジェクトのタグ。

-- tagging-directive

String

宛先オブジェクトのタグを設定するために使用されるメソッド。 有効な値:

  • COPY

  • REPLACE

-u, -- update

/

オブジェクトの最終変更時刻がローカルファイルの最終変更時刻より後の場合にのみ、オブジェクトをダウンロードすることを指定します。

-- 無視-既存

/

既に存在するオブジェクトをスキップします。

説明

詳細については、「コマンドラインオプション」をご参照ください。

ダウンロードしたオブジェクトの命名規則:

  • 単一のオブジェクトがローカルディレクトリにダウンロードされた場合、ダウンロードされたオブジェクトは元の名前を保持します。

  • 1つのオブジェクトが指定された名前でダウンロードされ、同じ名前のローカルファイルが存在しない場合、ダウンロードされたオブジェクトは指定された名前で保存されます。

  • 複数のオブジェクトが指定されたローカルディレクトリにダウンロードされた場合、オブジェクトがOSSに保存されているのと同じディレクトリ構造がローカルディレクトリに作成され、ダウンロードされたオブジェクトは元の名前を保持します。

説明

ダウンロードするオブジェクトの相対パスは、cpコマンドで指定されたパスに従う部分です。

たとえば、cpコマンドで指定したパスが /root/dir /の場合、/root/dir/subdir/test.txtファイルの相対パスはsubdir/test.txtです。

単一オブジェクトのダウンロード

ダウンロードしたオブジェクトの名前を指定しない場合、ダウンロードしたオブジェクトは元の名前を保持します。 ダウンロードしたオブジェクトの名前を指定した場合、ダウンロードしたオブジェクトは指定した名前を使用します。

  • ダウンロードしたオブジェクトを元の名前で保存します。

    ossutil cp oss://examplebucket/examplefile.txt D:/localpath
  • ダウンロードしたオブジェクトを指定した名前で保存します。

    ossutil cp oss://examplebucket/examplefile.txt D:/localpath/example.txt

複数のオブジェクトのダウンロード

  • 特定のタイプのオブジェクトをダウンロードする

    同じ接頭辞や接尾辞など、特定のパターンの名前を持つ複数のオブジェクトをダウンロードする場合は、-- includeパラメーターと -- excludeパラメーターを使用して、上記の条件を満たすオブジェクトをダウンロードできます。

    JPG形式ではないすべてのオブジェクトをダウンロードします。

    ossutil cp oss://examplebucket/destfolder/ D:/localpath/ --exclude "*.jpg" -r
  • ディレクトリのダウンロード

    ossutil cp -r oss://examplebucket/destfolder/ D:/localpath/
  • バケットのルートディレクトリにあるすべてのオブジェクトをダウンロードする

    ossutil cp -r oss://examplebucket  D:/localpath/