Object Storage Service:Advanced commands

コマンドの範囲

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

すべての高度なコマンド

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

• --request-payer string：リクエストの支払方法。リクエスト元支払いモードを使用する場合は、このパラメーターを `requester` に設定します。

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

• --start-after/--end-with (, ]：キーのクエリ範囲を指定します。範囲は開始値を含まず、終了値を含みます。

• フィルターオプション：オブジェクト/ファイル名、オブジェクト/ファイルフォルダー、オブジェクト/ファイルサイズ、オブジェクト/ファイル時刻、オブジェクトのメタデータなどの情報に基づいてフィルター条件を設定できます。特定のフィルタリングルールの詳細については、「フィルターオプション」をご参照ください。

• --limited-num：クエリ API によって返されるデータを設定します。

• --recursive/-r：再帰的な操作を実行します。ルートディレクトリ内のすべてのファイルまたはオブジェクト (サブディレクトリを含む) に再帰的にアクセスします。

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

  説明

  オブジェクトの場合、これは Delimiter メソッドを使用して模倣されます。これには、プレフィックス配下のすべてのオブジェクトをスキャンする必要があります。オブジェクトが多いほど、操作に時間がかかります。

• --force/-f：確認プロンプトなしで操作を強制実行します。

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

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

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

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

• --checksum：CRC-64 チェックサムを比較します。まずファイルサイズが比較されます。ファイルサイズが同じ場合、次に CRC-64 チェックサムが比較されます。片側に 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

バッチ処理中にページごとにリストするオブジェクトの最大数。デフォルト値：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。

--version-id

string

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

--storage-class

string

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

--acl

string

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

--cache-control

string

オブジェクトのダウンロード時の Web ページのキャッシュ動作を指定します。

--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 rule option parameter：Glob マッチングパターン。

• rule filename rule option parameter：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

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

 *.jpg

--filter-from

パラメーターにはルールファイルのパスを指定します。ルールファイル内の各行は命令 Glob マッチングパターンを表します。

複数のルールファイルをインポートするには、これらのオプションを繰り返します。

例：--filter-from filter-file.txt では、ルールファイル filter-file.txt の内容は次のとおりです：

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

オプション

説明

--files-from

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

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

--files-from-raw

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

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

パラメーター

説明

--min-age

Duration

指定された時間間隔より前に更新されたファイルのみを処理します。デフォルトの単位は秒です。単位サフィックスを使用できます。例：1h は 1 時間を示します。

--max-age

Duration

指定された時間間隔内に更新されたファイルのみを処理します。デフォルトの単位は秒です。単位サフィックスを使用できます。例：1h は 1 時間を示します。

--min-mtime

Time

指定された時刻以降に更新されたファイルのみを処理します。時刻形式は UTC です。例：2006-01-02T15:04:05。

--max-mtime

Time

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

パラメーター

説明

--min-size

このサイズより小さいファイルは転送しません。デフォルトの単位はバイト (B) です。単位サフィックスも使用できます。例：1K (KiB) は 1024 バイトを表します。

--max-size

このサイズより大きいファイルは転送しません。デフォルトの単位はバイト (B) です。単位サフィックスも使用できます。例：1K (KiB) は 1024 バイトを表します。