Object Storage Service:高度なコマンド

コマンドの範囲

サポートされるオプション

すべての高度なコマンド

• --encoding-type string：オブジェクト名またはファイル名のエンコーディングメソッド。有効値：url。

• --request-payer string：リクエストの支払方法。リクエスト元支払いモードを使用する場合は、このオプションを requester に設定します。

バッチ操作をサポートするコマンド

• --start-after/--end-with (, ]：左側が開区間、右側が閉区間です。これらのオプションを使用して、クエリのキー範囲を設定します。

• フィルターオプション：名前、ディレクトリ、サイズ、更新時刻、またはメタデータによってオブジェクトまたはファイルのフィルター条件を設定できます。フィルター規則の詳細については、「フィルターオプション」をご参照ください。

• --limited-num：クエリ API によって返されるアイテム数を設定します。

• --recursive/-r：再帰的な操作を実行します。このオプションを使用すると、サブディレクトリを含むルートディレクトリ配下のすべてのファイルまたはオブジェクトにアクセスできます。

• --dirs/-d：サブディレクトリを除き、ルートディレクトリ内のファイルまたはオブジェクトにのみアクセスします。

  説明

  オブジェクトの場合、OSS はデリミタパラメーターを使用してディレクトリをシミュレートします。これには、指定されたプレフィックス配下のすべてのオブジェクトをスキャンする必要があります。オブジェクトが多いほど、スキャン時間は長くなります。

• --force/-f：確認のプロンプトを表示せずに操作を強制実行します。

• --list-objects：ListObjects API を使用してオブジェクトをリスト表示します。

送信先フィルター規則をサポートするコマンド

• --update：送信先ファイルがソースファイルより新しい場合はスキップしますが、更新時刻がソースファイルと同じ場合は更新します。

• --size-only：ファイルサイズのみを比較します。サイズが異なるファイルのみが同期されます。

• --checksum：CRC64 チェックサムを比較します。OSS はまずファイルサイズを比較します。サイズが一致する場合、CRC64 値を比較します。どちらかの側に CRC64 がない場合、OSS はファイルを不一致として扱います。このオプションは、オブジェクト間のコピー操作にのみ適用されます。

• --ignore-existing：送信先にすでに存在するファイルをスキップします。

単一オブジェクト操作をサポートするコマンド

--version-id string：オブジェクトのバージョン ID。

リストモードをサポートするコマンド

--list-format：リストファイルの形式。有効値：plain および inventory。

--list-manifest-from：ファイルからリストファイル形式の説明を読み取ります。リストファイルの形式が inventory の場合にこのオプションを設定します。

ローカルオプション

タイプ

説明

--encoding-type

string

オブジェクト名またはファイル名のエンコーディングメソッド。有効値：url。

--request-payer

string

リクエストの支払方法。リクエスト元支払いモードを使用する場合は、このオプションを requester に設定します。有効値：requester。

--start-after

string

指定された値の後にアルファベット順で出現するオブジェクトを返します。指定された値自体は含まれません。

--end-with

string

指定された値の前にアルファベット順で出現するオブジェクトを返します。指定された値自体は含まれます。

--page-size

int

バッチ処理中にページごとにリスト表示されるオブジェクトの最大数。デフォルト値：1000。有効値：1～1000。

--include

stringArray

パスまたはファイル名のインクルード規則。

--include-from

stringArray

規則ファイルからインクルード規則を読み取ります。

--exclude

stringArray

パスまたはファイル名のエクスクルード規則。

--exclude-from

stringArray

規則ファイルからエクスクルード規則を読み取ります。

--filter

stringArray

パスまたはファイル名のフィルター規則。

--files-from

stringArray

ファイルからソースファイル名のリストを読み取ります。# または ; で始まる空白行とコメント行は無視されます。このオプションは、ファイルフィルタリング操作にのみ適用されます。

--files-from-raw

stringArray

ファイルからソースファイル名のリストを読み取ります。このオプションは、ファイルフィルタリング操作にのみ適用されます。

--max-age

Duration

指定された時刻より前に更新されたファイルは転送しません。デフォルトの単位：秒。サポートされるサフィックス：ms、s、m、h、d、w、M、y。デフォルト値：off。

--min-age

Duration

指定された時刻より後に更新されたファイルは転送しません。デフォルトの単位：秒。サポートされるサフィックス：ms、s、m、h、d、w、M、y。デフォルト値：off。

--max-mtime

Time

指定された時刻より後に更新されたファイルは転送しません。時刻形式：協定世界時 (UTC)。デフォルト値：off。

--min-mtime

Time

指定された時刻より前に更新されたファイルは転送しません。時刻形式：協定世界時 (UTC)。デフォルト値：off。

--max-size

SizeSuffix

転送する最大ファイルサイズ。デフォルトの単位：バイト (B)。サポートされるサフィックス：B、K、M、G、T、P。1K (KiB) = 1024B。

--min-size

SizeSuffix

転送する最小ファイルサイズ。デフォルトの単位：バイト (B)。サポートされるサフィックス：B、K、M、G、T、P。1K (KiB) = 1024B。

--metadata-exclude

stringArray

オブジェクトメタデータのエクスクルード規則。

--metadata-include

stringArray

オブジェクトメタデータのインクルード規則。

--metadata-filter

stringArray

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

--metadata-filter-from

stringArray

規則ファイルからオブジェクトメタデータのフィルター規則を読み取ります。

--checksum

/

サイズまたはチェックサム (利用可能な場合) が送信先ファイルと異なるソースファイルのみをコピーします。

--size-only

/

サイズが送信先ファイルと異なるソースファイルのみをコピーします。

-u, --update

/

送信先にすでに存在し、ソースファイルよりも新しい更新時刻を持つファイルをスキップします。

-r, --recursive

/

再帰的な操作を実行します。このオプションを指定すると、コマンドはバケット内の条件に一致するすべてのオブジェクトに対して操作を実行します。それ以外の場合は、指定されたパスにあるオブジェクトに対してのみ操作を実行します。

-d, --dirs

/

すべてのサブディレクトリ内のすべてのファイルを再帰的にリスト表示する代わりに、現在のディレクトリ内のファイルとサブディレクトリを返します。

-f, --force

/

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

--list-objects

/

ListObjects API を使用してオブジェクトをリスト表示します。

--no-progress

/

プログレスバーを非表示にします。

-j, --job

int

複数ファイルの操作における同時タスク数。デフォルト値：3。

--checkers

int

同時チェッカーの数。デフォルト値：16。

--parallel

int

単一ファイルに対する内部操作の同時タスク数。

--part-size

SizeSuffix

マルチパートアップロードのパートサイズ。デフォルトでは、ossutil はファイルサイズに基づいて適切なパートサイズを計算します。有効値：100 KiB～5 GiB。

--bigfile-threshold

int

大きなファイルのマルチパートアップロード、ダウンロード、またはコピーをトリガーするしきい値。デフォルト値：104857600。

--version-id

string

オブジェクトのバージョン ID。

--storage-class

string

オブジェクトのストレージクラス。有効値：Standard、IA、Archive、ColdArchive、DeepColdArchive。

--acl

string

オブジェクトのアクセス権限。有効値：private、public-read、public-read-write、default。

--cache-control

string

オブジェクトがダウンロードされる際のキャッシュ動作を指定します。

--content-disposition

string

オブジェクトの表示方法を指定します。

--content-encoding

string

オブジェクトのエンコーディングメソッドを宣言します。

--content-type

string

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

--expires

string

キャッシュされたコンテンツの絶対有効期限を指定します。

--copy-props

string

ソースオブジェクトからコピーするプロパティを指定します。有効値：none、metadata、default。

--tagging

string

オブジェクトのタグを key=value 形式で指定します。

--tagging-directive

string

送信先オブジェクトのタグを設定する方法を指定します。有効値：COPY、REPLACE。

--metadata

string

オブジェクトのユーザー定義メタデータを key=value 形式で指定します。

--metadata-directive

string

送信先オブジェクトのメタデータを設定する方法を指定します。有効値：COPY、REPLACE。

--list-format

string

リストファイルの形式。有効値：plain および inventory。

--list-manifest-from

string

ファイルからリストファイル形式の説明を読み取ります。リストファイルの形式が inventory の場合にこのオプションを設定します。

アイテム

説明

フィルター規則の構文

• rule pattern：glob パターンマッチング。

• rule filename：glob パターンマッチングを使用する規則ファイルへのパス。

• rule modifiers pattern：glob パターンマッチングの命令。+ はインクルードを意味します。規則に一致するオブジェクトは結果に含まれます。- はエクスクルードを意味します。規則に一致するオブジェクトは結果から除外されます。

フィルター規則のパラメーター

• --include

• --include-from

• --exclude

• --exclude-from

• --filter

• --filter-from

オプション

説明

--include

--exclude

各オプションは引数として直接パターンを取ります。各オプションは 1 つの規則を定義します。複数の規則を使用するには、オプションを繰り返します。

例：--include "*.txt" --include "*.js" --exclude "*.jpg" は、すべての .txt および .js ファイルを含めますが、すべての .jpg ファイルを除外します。

次のコマンドは、Alibaba Cloud OSS の oss://examplebucket/exampledir/ ディレクトリからローカルの localdir/ ディレクトリに、フィルター規則に一致するファイルを再帰的にダウンロードします。規則には、すべての .txt および .js ファイルが含まれますが、すべての .jpg ファイルは除外されます。

ossutil cp -r oss://examplebucket/exampledir/ localdir/ --include "*.txt" --include "*.js" --exclude "*.jpg"

--filter

各オプションは引数として命令とパターンを取ります。各オプションは 1 つの規則を定義します。複数の規則を使用するには、オプションを繰り返します。

例：--filter "+ *.txt" --filter "+ *.js" --filter "- *.jpg" は、すべての .txt および .js ファイルを含めますが、すべての .jpg ファイルを除外します。

• + 記号はインクルードを意味します。規則に一致するオブジェクトは結果に含まれます。

• - 記号はエクスクルードを意味します。規則に一致するオブジェクトは結果から除外されます。

次のコマンドは、Alibaba Cloud OSS の oss://examplebucket/exampledir/ ディレクトリからローカルの localdir/ ディレクトリに、フィルター規則に一致するファイルを再帰的にダウンロードします。規則は .txt と .js ファイルを除外しますが、.png ファイルのみを含めます。

ossutil cp -r oss://examplebucket/exampledir/ localdir/ --filter "- *.txt" --filter "- *.js" --filter "+ *.png"

--include-from

--exclude-from

各オプションは引数として規則ファイルへのパスを取ります。規則ファイルの各行は glob パターンです。複数の規則ファイルを使用するには、オプションを繰り返します。

--include-from で読み取られた規則はインクルード規則です。--exclude-from で読み取られた規則はエクスクルード規則です。

例：--include-from include-file.txt --exclude-from exclude-file.txt は、すべての .txt および .js ファイルを含めますが、すべての .jpg ファイルを除外します。

include-file.txt 規則ファイルには、次の内容が含まれています：

 *.txt
 *.js

規則ファイル include-file.txt には、次の内容が含まれています：

 *.jpg

--filter-from

各オプションは引数として規則ファイルへのパスを取ります。規則ファイルの各行は、命令と glob パターンです。

複数の規則ファイルを使用するには、オプションを繰り返します。

例：--filter-from filter-file.txt。filter-file.txt 規則ファイルには、次の内容が含まれています：

 # a filter rule file
 + *.txt
 + *.js
 - **

オプション

説明

--files-from

ファイルからパスまたはファイル名のリストを読み取ります。複数のリストファイルを使用するには、オプションを繰り返します。

リストファイルの各行を処理する際、OSS は先頭と末尾の空白をトリミングし、# または ; で始まるコメント行を無視します。

--files-from-raw

ファイルからパスまたはファイル名のリストを読み取ります。複数のリストファイルを使用するには、オプションを繰り返します。

リストファイルの各行を処理する際、OSS は先頭または末尾の空白をトリミングせず、# または ; で始まるコメント行を無視しません。

パラメーター

説明

--min-age

Duration

指定された時間間隔より前に更新されたファイルのみを処理します。デフォルトの単位：秒。サポートされるサフィックス：ms、s、m、h、d、w、M、y。例：1h は 1 時間を意味します。

--max-age

Duration

指定された時間間隔内に更新されたファイルのみを処理します。デフォルトの単位：秒。サポートされるサフィックス：ms、s、m、h、d、w、M、y。例：1h は 1 時間を意味します。

--min-mtime

Time

指定された時刻より後に更新されたファイルのみを処理します。時刻形式：協定世界時 (UTC)。例：2006-01-02T15:04:05。

--max-mtime

Time

指定された時刻より前に更新されたファイルのみを処理します。時刻形式：協定世界時 (UTC)、例：2006-01-02T15:04:05。

パラメーター

説明

--min-size

指定されたサイズより小さいファイルは転送しません。デフォルトの単位：バイト (B)。サポートされるサフィックス：K (KiB)、M (MiB)、G (GiB)、T (TiB)、P (PiB)、E (EiB)。例：1K は 1024 バイトを意味します。

--max-size

指定されたサイズより大きいファイルは転送しません。デフォルトの単位：バイト (B)。サポートされるサフィックス：K (KiB)、M (MiB)、G (GiB)、T (TiB)、P (PiB)、E (EiB)。例：1K は 1024 バイトを意味します。