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

Sets the metadata for the object. The format is header:value#header:value. Example: Cache-Control:no-cache#Content-Encoding:gzip. For more information about metadata, see set-meta (Manage object metadata).

--acl

The access control list (ACL) of the object. Valid values:

• default (default): The object inherits the ACL of the bucket.

• private: Only the bucket owner has read and write permissions. Other users cannot access the objects in the bucket.

• public-read: Only the bucket owner has write permissions. All other users, including anonymous users, have read-only permissions on the objects in the bucket. This can lead to data leaks and increased fees. Use this ACL with caution.

• public-read-write: Anyone, including anonymous users, can read and write objects in the bucket. This can lead to data leaks, increased fees, and potential legal liabilities if malicious content is uploaded. Except for specific use cases, do not configure public read-write permissions.

--snapshot-path

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

--disable-crc64

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

--payer

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

--partition-download

ダウンロードするオブジェクトのパーティションを指定します。値の形式は Partition number:Total partitions です。例：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 タイムスタンプ。このオプションを指定すると、最終更新時刻がこのタイムスタンプより後のオブジェクトは無視されます。