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。

ローカルオプション

説明

-- encoding型の文字列

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

-- request-payer文字列

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

-- start-after文字列

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

-- end-文字列付き

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

-- page-size int

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

-stringArrayを含む

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

-- include-stringArrayから

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

-- stringArrayを除外する

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

-- exclude-stringArrayから

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

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

-- checkers int

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

-- parallel int

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

-- 部分サイズのSizeSuffix

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

-- bigfile-threshold int

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

オブジェクト属性に関連するオプション

-- version-id文字列

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

-- ストレージクラス文字列

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

-- acl文字列

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

-- cache-制御文字列

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

-- content-disposition文字列

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

-- content-encoding string

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

-- content-type文字列

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

-- expires文字列

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

-- copy-props文字列

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

-- タグ文字列

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

-- tagging-ディレクティブ文字列

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

-- メタデータ文字列

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

-- metadata-ディレクティブ文字列

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

項目

説明

フィルタールールの構文

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

• 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ベースの単位で接尾辞を付けることができます。