Object Storage Service:高レベルのコマンド

コマンドセット

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

すべての高レベルコマンド

• -- encoding-type string: オブジェクト名またはファイル名のエンコード方法。 有効値: url

• -- request-payer string: リクエストの支払人。 pay-by-requesterが有効な場合は、このオプションを指定します。 有効値: requester。

バッチ処理をサポートする高レベルのコマンド

• -- start-after/-- end-with: クエリするオブジェクト名の範囲を指定します。 範囲は左開き、右閉じた間隔です。

• filter: オブジェクトとファイルのフィルタールールを名前、パス、サイズ、時間、メタデータで指定します (オブジェクトのみ) 。 詳細については、「フィルターオプション」をご参照ください。

• -- limited-num: レスポンスの結果数を制限します。

• -- recursive/-r: すべてのファイルまたはオブジェクト、およびルートディレクトリ内のすべてのサブディレクトリに対して操作を再帰的に実行することを指定します。

• -- dirs/-d: ルートディレクトリ内のファイルまたはオブジェクトのみを照合し、ルートディレクトリ内のサブディレクトリを無視します。

  説明

  このオプションをオブジェクトに適用すると、デリミタを使用してディレクトリがシミュレートされ、指定された名前のプレフィックスを持つすべてのオブジェクトがスキャンされます。 オブジェクトのスキャンに使用される時間は、指定された名前のプレフィックスを持つオブジェクトの数に正比例します。

• -- force/-f: 確認を必要とせずに操作を強制します。

• -- list-objects: ListObjects操作を呼び出してオブジェクトを一覧表示します。

宛先オブジェクトによるフィルタリングをサポートする高レベルのコマンド

• -- update: ソースファイルまたはオブジェクトの最終変更時刻が、宛先オブジェクトまたはファイルの最終変更時刻よりも遅い場合にのみ、操作を実行します。

• -- size-only: ソースファイルまたはオブジェクトのサイズがターゲットオブジェクトまたはファイルのサイズと異なる場合にのみ、操作を実行します。

• -- checksum: 以下の条件のうちの1つが満たされた場合にのみ動作が実行されることを指定する。 a. ソースオブジェクトのサイズが宛先オブジェクトのサイズと異なる。 つまり、ソースオブジェクトのCRC-64は宛先オブジェクトのサイズと異なりますが、ソースオブジェクトのサイズは宛先オブジェクトのサイズと同じです。 ソースオブジェクトまたは宛先オブジェクトにCRC-64値がない場合、ソースオブジェクトのCRC-64は宛先オブジェクトのサイズと異なります。 このメソッドは、あるバケットから別のバケットにオブジェクトをコピーする場合にのみ使用されます。

• -- ignore-existing: 既に存在するオブジェクトをスキップします。

個々のオブジェクトに適用される高レベルのコマンド

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

リストモードをサポートする高レベルのコマンド

-- list-format: リストファイルの形式。 有効な値: plainとinventory。

-- list-manifest-from: ファイルからリストファイルの形式説明を読み込みます。 形式がインベントリの場合は、このパラメーターを指定する必要があります。

ローカルオプション

タイプ

説明

-- encoding-type

String

オブジェクト名またはファイル名のエンコードに使用されるエンコード方法。 有効値: url

-- request-payer

String

リクエストの支払人。 pay-by-requesterが有効な場合は、このオプションを指定します。 有効値: requester。

-- start-after

String

-- start-afterオプションの値の後に名前がアルファベット順であるオブジェクトと照合します。

-- end-with

String

-- end-withオプションの値の前または同じ名前のオブジェクトと一致します。

-- ページサイズ

int

返されるオブジェクトの最大数。 デフォルト値は 1000 です。 有効な値: 1 ~ 1000

-含む

stringArray

パスまたはオブジェクト名の包含ルール。

-- include-from

stringArray

ファイルから包含ルールを読み取ります。

-除外

stringArray

パスまたはオブジェクト名の除外ルール。

-- exclude-from

stringArray

ファイルから除外ルールを読み取ります。

-- フィルター

stringArray

パスまたはオブジェクト名のフィルタールール。

-- files-から

stringArray

空行またはコメント行を無視して、ファイルからソースオブジェクト名のリストを読み取ります。

-- files-from-raw

stringArray

空の行とコメント行を無視せずに、ファイルからソースオブジェクト名のリストを読み取ります。

-最大年齢

有効期間

最終変更時刻がこのオプションの値より前のオブジェクトを除外します。 デフォルトの単位はs (秒) です。 ミリ秒はms、秒はs、分はm、時間はh、日はd、週はw、月はM、年はyの単位で数値をサフィックスできます。

-- 最低年齢

有効期間

最終変更時刻がこのオプションの値より後のオブジェクトを除外します。 デフォルトの単位はs (秒) です。 ミリ秒はms、秒はs、分はm、時間はh、日はd、週はw、月はM、年はyの単位で数値をサフィックスできます。

-- max-mtime

時間

最終変更時刻がこのオプションの値より後のオブジェクトを除外します。 時刻は UTC である必要があります。

-- min-mtime

時間

最終変更時刻がこのオプションの値より前のオブジェクトを除外します。 時刻は UTC である必要があります。

-最大サイズ

SizeSuffix

転送できるファイルまたはオブジェクトの最大サイズ。 デフォルトでは、サイズはバイト (B) 単位です。 数値に1024ベースの単位 (Bはbyte、KはKibibyte、MはMebibyte、GはGibibyte、TはTebibyte、PはPebibyte) でサフィックスを付けることができます。

-- 最小サイズ

SizeSuffix

転送できるファイルまたはオブジェクトの最小サイズ。 デフォルトでは、サイズはバイト (B) 単位です。 数値に1024ベースの単位 (Bはbyte、KはKibibyte、MはMebibyte、GはGibibyte、TはTebibyte、PはPebibyte) でサフィックスを付けることができます。

-- metadata-除外

stringArray

オブジェクトメタデータの除外ルール。

-- metadata-include

stringArray

オブジェクトメタデータの包含ルール。

-- metadata-filter

stringArray

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

-- metadata-filter-from

stringArray

ファイルからメタデータフィルタールールを読み取ります。

-チェックサム

/

次のいずれかの条件が満たされた場合にのみ、ソースオブジェクトをコピーすることを指定します。 a. ソースオブジェクトのサイズが宛先オブジェクトのサイズと異なる。 つまり、ソースオブジェクトのCRC-64は宛先オブジェクトのサイズと異なりますが、ソースオブジェクトのサイズは宛先オブジェクトのサイズと同じです。

-- サイズだけ

/

コピー先のオブジェクトまたはファイルとファイルサイズが異なる場合にのみ、コピー元のファイルまたはオブジェクトをコピーします。

-u, -- update

/

最後に変更された時刻が宛先オブジェクトまたはファイルの時刻よりも遅い場合にのみ、ソースファイルまたはオブジェクトをコピーします。

-r, -- recursive

/

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

-d, -- dirs

/

現在のディレクトリ内のファイルまたはオブジェクトおよびサブディレクトリと照合します。

-f、-- 力

/

確認を必要とせずに操作を強制します。

-- list-objects

/

ListObjects操作を呼び出してオブジェクトを一覧表示します。

-- 進歩なし

/

進行状況バーを非表示にします。

-j, -- job

int

複数のファイルまたはオブジェクトを処理するための同時ジョブの数。 デフォルト値: 3。

-チェッカー

int

並列に実行できるチェッカーの数。 デフォルト値: 16。

-- 平行

int

1つのファイルまたはオブジェクトを処理するための同時ジョブの数。

-- 部分サイズ

SizeSuffix

部品サイズ。 デフォルトでは、部品サイズはオブジェクトサイズに基づいて自動的に計算されます。 部品サイズは100 KiBから5 GiBの範囲です。

-- bigfile-threshold

int

マルチパートアップロード、ダウンロード、またはコピーを使用する場合のオブジェクトサイズのしきい値。 デフォルト値: 104857600

-- version-id

String

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

-- ストレージクラス

String

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

-- acl

String

オブジェクトのアクセス制御リスト (ACL) 。 有効な値: private、public-read、public-read-write、およびdefault。

-- cache-control

String

オブジェクトがダウンロードされたときのwebブラウザでのキャッシュ動作。

-- content-disposition

String

オブジェクトの表示モード。

-- content-encoding

String

オブジェクトのエンコードに使用されるエンコード方法。

-- content-type

String

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

-- 有効期限

String

キャッシュされたコンテンツの絶対有効期限。

-- コピー小道具

String

ソースオブジェクトからコピーする属性。The attributes to copy from the source object. 有効な値: none、metadata、default。

-- タグ付け

String

キー=値ペアのオブジェクトタグ。

-- tagging-directive

String

宛先オブジェクトのタグを設定するために使用されるメソッド。 有効な値: COPYとREPLACE。

-- メタデータ

String

キー=値ペアのユーザーメタデータ。

-- metadata-ディレクティブ

String

宛先オブジェクトのメタデータを設定するために使用されるメソッド。 有効な値: COPYとREPLACE。

-- リスト形式

String

リストファイルの形式。 有効な値: plainとinventory。

-- list-manifest-from

String

ファイルからリストファイルの形式説明を読み込みます。 形式がインベントリの場合は、このパラメーターを指定する必要があります。

項目

説明

フィルタールールの構文

• ルールパターン: グロブマッチングパターン

• rule filename: glob一致パターンを含むファイルへのパス

• rule modifiers pattern: glob matching pattern with a directive. + ディレクティブは包含を示します。 -ディレクティブは除外を示します。

フィルターオプション

• -含む

• -- include-from

• -除外

• -- exclude-from

• -- フィルター

• -- filter-from

オプション

説明

-含む

-除外

オプション名の後に一致するパターンを指定します。 各オプションの後には、1つのマッチングパターン (ルールとも呼ばれます) のみが続きます。 -- include "*.txt" -- include "*.js" -- exclude "*.jpg" 設定のように、オプションを繰り返すことで、コマンドで複数の一致するパターンを指定できます。

-- フィルター

ディレクティブを含む一致するパターンを指定します。 各オプションの後には、一致するパターンが1つだけ続きます。 オプションを繰り返すことで、コマンドで複数の一致するパターンを指定できます。in -- filter "+ *.txt" -- filter "+ *.js" -- filter "- *.txt" 設定です。

-- include-from

-- exclude-from

オプション名の後にルールファイルのパスを指定します。 各グロブマッチングパターンは、ルールファイル内の別々の行に配置される。 オプションを繰り返すことで、コマンドで複数のルールファイルを指定できます。

-- include-fromオプションに続くルールファイルには、包含ルールのみが含まれます。 -- exclude-fromオプションに続くルールファイルには、除外ルールのみが含まれます。

たとえば、コマンドで次のフィルターを指定できます。-- include-from include-file.txt -- exclude-from exclude-file.txt、

include-file.txtファイルには次のパターンが含まれています。

 *.txt
 *.js

exclude-file.txtファイルには *.jpgのパターンが含まれています。

-- filter-from

オプション名の後にルールファイルのパスを指定します。 各ディレクティブベースのグロブマッチングパターンは、ルールファイルの別々の行に配置されます。

オプションを繰り返すことで、コマンドで複数のルールファイルを指定できます。

たとえば、-- filter-from filter-file.txtを指定できます。

次のパターンを含む

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

オプション

説明

-- files-から

指定したリストファイルからパス, ファイル名, またはオブジェクト名を読み込みます。 オプションを繰り返すことで, コマンドに複数のリストファイルを指定できます。

ossutilがリストファイルからデータを読み取るとき、各行の先頭と末尾のスペース、および数字記号 (#) またはセミコロン (;) で始まる行は無視されます。

-- files-from-raw

指定したリストファイルからパス, ファイル名, またはオブジェクト名を読み込みます。 オプションを繰り返すことで, コマンドに複数のリストファイルを指定できます。

ossutilがリストファイルからデータを読み取るとき、各行の先頭または末尾のスペース、または数字記号 (#) またはセミコロン (;) で始まる行は無視されません。

オプション

説明

-- 最低年齢

最終変更時刻がこのオプションの値より後のオブジェクトを除外します。 デフォルトの単位はs (秒) です。 数値を時間の単位でサフィックスすることができます。 例えば、1hは1時間を示す。

-最大年齢

最終変更時刻がこのオプションの値より前のオブジェクトを除外します。 デフォルトの単位はs (秒) です。 数値を時間の単位でサフィックスすることができます。 例えば、1hは1時間を示す。

-- min-mtime

最終変更時刻がこのオプションの値より前のオブジェクトを除外します。 時刻は UTC である必要があります。 例: 2006-01-02T15:04:05。

-- max-mtime

最終変更時刻がこのオプションの値より後のオブジェクトを除外します。 時刻は UTC である必要があります。 例: 2006-01-02T15:04:05。

オプション

説明

-- 最小サイズ

含めることができるファイルまたはオブジェクトの最小サイズ。 デフォルトでは、サイズはバイト (B) 単位です。 1024単位のサイズ単位は、1K (1,024バイト) のように数値の後に指定できます。

-最大サイズ

含めることができるファイルまたはオブジェクトの最大サイズ。 デフォルトでは、サイズはバイト (B) 単位です。 数値には、1K (1,024バイト) のように、1024ベースの単位で接尾辞を付けることができます。