rm
コマンドを実行すると、不要になったオブジェクトを削除できます。
コマンド構文
ossutil rm oss:// bucket[/prefix] [flags]
パラメーター | データ型 | 説明 |
prefix | String | 削除するオブジェクトが格納されているディレクトリ、または削除するオブジェクトの名前に含まれるプレフィックス。 |
--all-versions | / | オブジェクトのすべてのバージョン。 |
-d, -- dirs | / | 現在のディレクトリのオブジェクトとサブディレクトリが返されることを指定します。 |
-- encoding-type | String | オブジェクト名のエンコードに使用されるエンコード方法。 有効値: url |
-- end-with | String | -- end-withパラメーターの値の前または同じ名前のオブジェクトが返されるように指定します。 |
--exclude | stringArray | パスまたはオブジェクト名の除外ルール。 |
-- exclude-from | stringArray | 除外ルールをルールファイルから読み取ることを指定します。 |
--files-from | stringArray | ソースオブジェクト名をルールファイルから読み取り、空の行またはコメント行を無視することを指定します。 |
-- files-from-raw | stringArray | ソースオブジェクト名をルールファイルから読み取ることを指定します。 |
--filter | stringArray | パスまたはオブジェクト名のフィルタールール。 |
-- filter-from | stringArray | パスまたはオブジェクト名のフィルタールールをルールファイルから読み取ることを指定します。 |
f, --force | / | 確認のプロンプトなしでコマンドを強制的に実行することを指定します。 |
--include | stringArray | パスまたはオブジェクト名の包含ルール。 |
-- include-from | stringArray | 包含ルールをルールファイルから読み取ることを指定します。 |
--limited-num | int | 返される結果の最大数。 |
-- list-objects | / | オブジェクトを一覧表示するためにListObjects操作を呼び出すことを指定します。 |
--max-age | 有効期間 | 最終変更時刻が -- max-ageパラメーターの値より前のオブジェクトを削除しないように指定します。 デフォルトの単位は秒です。 単位は、ミリ秒、秒、分、時間、日、週、月、または年とすることができる。 デフォルトでは、このパラメータは空のままです。 |
-- max-mtime | 時間 | 最終変更時刻が -- max-mtimeパラメーターの値より後のオブジェクトを削除しないように指定します。 値はUTCです。 デフォルトでは、このパラメータは空のままです。 |
--max-size | SizeSuffix | 削除できるオブジェクトの最大サイズを指定します。 デフォルトの単位はバイトです。 オブジェクトサイズの単位は、バイト、KiB、MiB、GiB、TiB、またはPiBです。 注: 1 KiB = 1,024バイト。 |
--metadata-exclude | stringArray | オブジェクトメタデータの除外ルール。 |
-- metadata-filter | stringArray | オブジェクトメタデータのフィルタールール。 |
-- metadata-filter-from | stringArray | オブジェクトメタデータのフィルタールールをルールファイルから読み取ることを指定します。 |
-- metadata-include | stringArray | オブジェクトメタデータの包含ルール。 |
--min-age | 有効期間 | 最終変更時刻が -- min-ageパラメーターの値より後のオブジェクトを削除しないように指定します。 デフォルトの単位は秒です。 単位は、ミリ秒、秒、分、時間、日、週、月、または年とすることができる。 デフォルトでは、このパラメータは空のままです。 |
-- min-mtime | 時間 | 最終変更時刻が -- min-mtimeパラメーターの値より前のオブジェクトを削除しないように指定します。 値はUTCです。 デフォルトでは、このパラメータは空のままです。 |
--min-size | SizeSuffix | 削除できるオブジェクトの最小サイズを指定します。 デフォルトの単位はバイトです。 オブジェクトサイズの単位は、バイト、KiB、MiB、GiB、TiB、またはPiBです。 注: 1 KiB = 1,024バイト。 |
--page-size | int | 返されるオブジェクトの最大数。 デフォルト値は 1000 です。 有効な値: 1 ~ 1000 |
-r, -- recursive | / | コマンドがオブジェクトに対して再帰的に実行されることを指定します。 このパラメーターを指定すると、rmコマンドはバケット内の条件を満たすすべてのオブジェクトに対して有効になります。 それ以外の場合、rmコマンドは指定されたパス内のオブジェクトに対してのみ有効になります。 |
-- request-payer | String | リクエストの支払人。 pay-by-requesterがバケットに対して有効になっている場合、このパラメーターをrequesterに設定します。 |
-- start-after | String | -- start-afterパラメーターの値の後に名前がアルファベット順であるオブジェクトが返されることを指定します。 |
-- version-id | String | オブジェクトのバージョンID。 |
詳細については、「コマンドラインオプション」をご参照ください。
例
examplebucketという名前のバケットからexampleobject.txtという名前のオブジェクトを削除します。
ossutil rm oss:// examplebucket/exampleobject.txt
examplebucketという名前のバケットから、名前にテストプレフィックスが含まれるすべてのオブジェクトを削除します。
ossutil rm oss:// examplebucket/test -r
を含む名前を持つすべてのオブジェクトを削除します。examplebucketという名前のバケットからのpngサフィックス:
ossutil rm oss:// examplebucket -- include "*.png" -r
名前にabc文字列が含まれ、jpgまたは。examplebucketという名前のバケットからのtxtサフィックス:
ossutil rm oss:// examplebucket -- include "* abc *" -- exclude "*.jpg" -- exclude "*.txt" -r
examplebucketというバージョン管理が有効なバケットから、exampleobject.txtというオブジェクトの特定のバージョンを削除します。
ossutil rm oss:// examplebucket/exampleobject.txt -- version-id CAEQARiBgID8rumR2hYiIGUyOTAyZGY2MzU5MjQ5ZjlhYzQzZjNlYTAyZDE3 ****
examplebucketというバージョン管理が有効なバケットから、exampleobject.txtというオブジェクトのすべてのバージョンを削除します。
ossutil rm oss://examplebucket/exampleobject.txt --all-versions
examplebucketというバージョン管理が有効なバケットからすべてのオブジェクトのすべてのバージョンを削除します。
ossutil rm oss:// examplebucket -- all-versions -r