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

API アクション

説明

oss:GetObject

オブジェクトのダウンロードに必要です。

oss:GetObjectVersion

オプション。--version-id オプションを使用してソースオブジェクトの特定のバージョンをダウンロードする場合に必要です。

kms:GenerateDataKey

オプション。ダウンロードするオブジェクトがサーバー側で KMS を使用して暗号化されている場合に必要です。

kms:Decrypt

oss:ListObjects

オプション。バッチダウンロード (再帰的な操作) に必要です。

パラメーター

説明

cloud_url

OSS オブジェクトのソースパス。フォーマットは oss://bucket[/prefix] です。例: oss://examplebucket/examplefile.txt。

file_url

ローカルファイルの宛先パス。宛先がディレクトリの場合、パスは区切り文字 (/ または \) で終わる必要があります。たとえば、Linux パスは /localfolder/examplefile.txt で、Windows パスは D:\localfolder\examplefile.txt です。

-r, --recursive

指定されたプレフィックスの下にあるすべての一致するオブジェクトに操作を再帰的に適用します。それ以外の場合、操作は指定された単一のオブジェクトにのみ適用されます。

-f --force

確認のプロンプトを表示せずに操作を強制します。

-u，--update

宛先ファイルが存在しない場合、またはソースオブジェクトの最終更新時刻が宛先ファイルの最終更新時刻より新しい場合にのみダウンロードを実行します。

--maxdownspeed

最大ダウンロード速度 (KB/s)。デフォルト値は 0 で、速度制限がないことを意味します。

--disable-ignore-error

バッチ操作中にエラーを無視する機能を無効にします。

--only-current-dir

現在のディレクトリ内のオブジェクトのみをダウンロードし、サブディレクトリとその中のオブジェクトは無視します。

--bigfile-threshold

再開可能なダウンロードのサイズしきい値 (バイト単位)。

デフォルト: 100 MB

値の範囲: 0～9223372036854775807

--part-size

パートサイズ (バイト単位)。デフォルトでは、ossutil はオブジェクトサイズに基づいて適切なパートサイズを自動的に計算します。

値の範囲: 1～9223372036854775807

--checkpoint-dir

ossutil が再開可能なダウンロードのチェックポイント情報を保存するディレクトリ。再開可能なダウンロードが失敗した場合、ossutil は .ossutil_checkpoint ディレクトリを作成してチェックポイント情報を記録します。ダウンロードが成功すると、ossutil はこのディレクトリを削除します。指定したディレクトリが削除可能であることを確認してください。

--range

オブジェクトの指定されたバイト範囲をダウンロードし、新しいファイルとして保存します。バイト番号は 0 から始まります。

• 範囲を指定する

  たとえば、3-9 は、3 バイト目から 9 バイト目まで (両端を含む) をダウンロードします。

• 開始位置を指定する

  たとえば、3- は、3 バイト目からオブジェクトの最後まで (両端を含む) をダウンロードします。

• 終了位置を指定する

  たとえば、-9 は、0 バイト目から 9 バイト目まで (両端を含む) をダウンロードします。

--encoding-type

オブジェクト名のエンコーディングタイプ。このオプションを url に設定します。このオプションが指定されていない場合、オブジェクト名はエンコードされません。

--include

指定されたパターンに一致するすべてのオブジェクトを含めます。

詳細については、「include および exclude オプション」をご参照ください。

--exclude

指定されたパターンに一致するすべてのオブジェクトを除外します。

詳細については、「include および exclude オプション」をご参照ください。

--meta

オブジェクトのメタデータを設定します。フォーマットは header:value#header:value です。例: Cache-Control:no-cache#Content-Encoding:gzip。メタデータの詳細については、「set-meta (オブジェクトのメタデータの管理)」をご参照ください。

--acl

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

• default (デフォルト): オブジェクトはバケットの ACL を継承します。

• private: バケットのオーナーのみが読み取りおよび書き込み権限を持ちます。他のユーザーはバケット内のオブジェクトにアクセスできません。

• public-read: バケットのオーナーのみが書き込み権限を持ちます。匿名ユーザーを含む他のすべてのユーザーは、バケット内のオブジェクトに対して読み取り専用権限を持ちます。これにより、データ漏洩や料金の増加につながる可能性があります。この ACL は注意して使用してください。

• public-read-write: 匿名ユーザーを含む誰もがバケット内のオブジェクトを読み書きできます。これにより、データ漏洩、料金の増加、悪意のあるコンテンツがアップロードされた場合の潜在的な法的責任につながる可能性があります。特定のユースケースを除き、公開読み書き権限を設定しないでください。

--snapshot-path

ダウンロード中にスナップショット情報が保存されるディレクトリ。次回のダウンロードでは、ossutil はこのディレクトリからスナップショット情報を読み取り、増分ダウンロードを実行します。

--disable-crc64

64 ビット巡回冗長検査 (CRC-64) を無効にします。デフォルトでは、ossutil はすべてのデータ転送で CRC-64 を有効にします。

--payer

リクエストの支払方法。指定されたパスへのアクセスから生成されるトラフィックとリクエストの料金をリクエスタに支払わせるには、このオプションを requester に設定します。

--partition-download

ダウンロードするオブジェクトのパーティションを指定します。値は パーティション番号:合計パーティション数 のフォーマットです。たとえば、1:5 は、この ossutil コマンドが合計 5 つのパーティションのうちパーティション 1 をダウンロードすることを示します。パーティション番号は 1 から始まります。ツールの内部アルゴリズムによって、ossutil がオブジェクトをどのようにパーティション分割するかが決まります。このオプションを使用すると、オブジェクトを複数のパーティションに分割し、複数の ossutil コマンドを使用して並行してダウンロードできます。各コマンドは、割り当てられたパーティションをダウンロードします。

-j，--job

複数オブジェクト操作の同時タスク数。デフォルト: 3。値の範囲: 1～10,000。

--parallel

単一オブジェクト操作の同時タスク数。値の範囲: 1～10,000。このオプションが設定されていない場合、ossutil は操作タイプとオブジェクトサイズに基づいて値を決定します。

--version-id

オブジェクトの特定のバージョンをダウンロードします。--version-id オプションは、バージョン管理が有効なバケットでのみ使用してください。バケットのバージョン管理を有効にする方法の詳細については、「bucket-versioning (バージョン管理)」をご参照ください。

--start-time

UNIX タイムスタンプ。このオプションを指定すると、最終更新時刻がこのタイムスタンプより前のオブジェクトは無視されます。

--end-time

UNIX タイムスタンプ。このオプションを指定すると、最終更新時刻がこのタイムスタンプより後のオブジェクトは無視されます。