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) 。 有効な値:
|
-- bigfile-threshold | int | マルチパートダウンロードタスクのオブジェクトサイズのしきい値。 デフォルト値: 104857600 |
-- cache-control | String | オブジェクトがダウンロードされたときのwebページのキャッシュ動作。 |
-チェッカー | int | 並列に実行するチェッカーの数。 デフォルト値: 16。 |
-- checkpoint-dir | String | マルチパートダウンロードタスクのチェックポイントファイルが格納されているディレクトリ。 デフォルト値: |
-- content-disposition | String | オブジェクトの表示形式。 |
-- content-encoding | String | オブジェクトのエンコードに使用されるエンコード方法。 |
-- content-type | String | オブジェクトのコンテンツタイプ。 |
-- コピー小道具 | String | ダウンロードするオブジェクトの属性。 有効な値:
|
-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 | オブジェクトのメタデータを設定するために使用されるメソッド。 有効な値:
|
-- 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 | オブジェクトのストレージクラス。 有効な値:
|
-- タグ付け | 文字列 | キー=値形式のオブジェクトのタグ。 |
-- tagging-directive | String | 宛先オブジェクトのタグを設定するために使用されるメソッド。 有効な値:
|
-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/