Object Storage Service:高度なコマンド

コマンドの範囲

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

すべての高度なコマンド

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

• --request-payer string：リクエスト元支払いモードを有効にします。 requester に設定します。

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

• --start-after/--end-with (, ]：キー範囲フィルター。 開始は含まず、終了は含みます。

• フィルターオプション：オブジェクト/ファイル名、フォルダー、サイズ、時間、またはメタデータでフィルタリングします。 詳細については、フィルターオプションをご参照ください。

• --limited-num： API クエリごとに返される結果の数を制限します。

• --recursive/-r：すべてのサブディレクトリを再帰的に処理します。

• --dirs/-d：サブディレクトリを除き、現在のディレクトリのみを一覧表示します。

  説明

  オブジェクトの場合、このオプションはデリミタメソッドを使用し、プレフィックス配下のすべてのオブジェクトをスキャンします。 オブジェクトが多いほど、スキャン時間が長くなります。

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

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

宛先フィルタリングルールをサポートするコマンド

• --update：更新日時のみを比較します。 ソースが宛先より新しい場合にのみ同期します。

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

• --checksum：まずファイルサイズを比較し、次に CRC-64 チェックサムを比較します。 どちらかの側にチェックサムがない場合、ファイルは不整合として扱われます。 オブジェクト間のコピーにのみ有効です。

• --ignore-existing：既存のファイルをスキップします。

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

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

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

--list-format：リストのフォーマット。 有効な値： plain および inventory。

--list-manifest-from：リストのマニフェストをファイルから読み取ります。 このパラメーターは、リストのフォーマットが inventory の場合に必要です。

ローカルオプション

オプションタイプ

説明

--encoding-type

string

入力オブジェクトまたはファイル名のエンコーディングを指定します。有効な値：url。

--request-payer

string

リクエスト元支払いを有効にします。有効な値：requester。

--start-after

string

指定された値の後 (その値を含まず) にアルファベット順でオブジェクトを返します。

--end-with

string

指定された値まで (その値を含む) アルファベット順でオブジェクトを返します。

--page-size

int

バッチ処理における 1 ページあたりの最大オブジェクト数。デフォルト：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、K、M、G、T、P。1 K (KiB) = 1024 B。

--min-size

SizeSuffix

転送する最小ファイルサイズを指定します。デフォルト単位：バイト。サポートされている接尾辞：B、K、M、G、T、P。1 K (KiB) = 1024 B。

--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

マルチパート操作のパートサイズを指定します。デフォルトでは自動計算されます。範囲：100 KiB ～ 5 GiB。

--bigfile-threshold

int

マルチパートアップロード、ダウンロード、またはコピーのサイズしきい値を指定します。デフォルト：104857600 (100 MiB)。

--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、インベントリ。

--list-manifest-from

string

ファイルからリストファイルフォーマットの説明を読み取ります。リストファイルフォーマットがインベントリの場合、このパラメーターは必須です。

項目

説明

フィルター ルールの構文

• glob パターン：ルールオプションのパラメータとして glob パターンを指定します。

• ルールファイル：ルールオプションのパラメータとして、glob パターンを含むファイルのパスを指定します。

• rule modifiers pattern rule option parameter: 指示用の 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

ルールファイル exclude-file.txt の内容は次のとおりです。

 *.jpg

--filter-from

パラメータの後にルールファイルパスを指定します。ルールファイル内の各行は命令付き glob パターンを表します。

複数のルールファイルを読み込むには、これらのオプションを繰り返し指定します。

たとえば、--filter-from filter-file.txt では、ルールファイル filter-file.txt の内容は次のとおりです。

 # フィルター ルール ファイル
 + *.txt
 + *.js
 - **

オプション

説明

--files-from

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

リストファイルの各行を処理する際、先頭または末尾のスペースは削除され、# または ; で始まるコメント行は無視されます。

--files-from-raw

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

リストファイルの各行を処理する際、先頭または末尾のスペース、および # または ; で始まるコメント行は無視されません。

パラメータ

説明

--min-age

Duration

指定した期間より前に変更されたファイルのみを処理します。デフォルトの単位は秒です。単位のサフィックス (例：1h) をサポートします。

--max-age

Duration

指定した期間内に変更されたファイルのみを処理します。デフォルトの単位は秒です。単位のサフィックス (例：1h) をサポートします。

--min-mtime

Time

指定した時刻より後に変更されたファイルのみを処理します。

--max-mtime

Time

指定した時刻より前に変更されたファイルのみを処理します。

パラメータ

説明

--min-size

このサイズより小さいファイルをスキップします。デフォルトの単位はバイトです。例：1K (KiB) = 1024 バイト。

--max-size

このサイズより大きいファイルをスキップします。デフォルトの単位はバイトです。例：1K (KiB) = 1024 バイト。