すべてのプロダクト
Search
ドキュメントセンター

Object Storage Service:set-props

最終更新日:Aug 28, 2024

set-propsコマンドを実行して、オブジェクトアクセス制御リスト (ACL) 、ストレージクラス、メタデータ、タグなどのオブジェクト属性を設定できます。

コマンド構文

ossutil set-props oss:// bucket[/prefix] [flags]

パラメーター

データ型

説明

-- acl

String

オブジェクトのACL。 有効な値:

  • private: プライベート

  • public-read: public-read

  • public-read-write: public-read-write

  • default: バケットから継承

-- bigfile-threshold

int

マルチパートアップロード、ダウンロード、コピーのオブジェクトサイズのしきい値。 デフォルト値: 104857600

-- cache-control

String

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

-- content-disposition

String

オブジェクトの表示形式。

-- content-encoding

String

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

-- content-type

String

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

-d, -- dirs

/

現在のディレクトリのオブジェクトとサブディレクトリが返されることを指定します。

-- encoding-type

String

オブジェクト名のエンコードに使用されるエンコード方法。 有効値: url

-- end-with

String

-- end-withパラメーターの値の前または同じ名前のオブジェクトが返されるように指定します。

--exclude

stringArray

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

-- exclude-from

stringArray

除外ルールをルールファイルから読み取ることを指定します。

--expires

String

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

--files-from

stringArray

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

-- files-from-raw

stringArray

ソースオブジェクト名をルールファイルから読み取ることを指定します。

--filter

stringArray

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

-- filter-from

stringArray

パスまたはオブジェクト名のフィルタールールをルールファイルから読み取ることを指定します。

-f, --force

/

確認のプロンプトなしでコマンドを強制的に実行することを指定します。

--include

stringArray

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

-- include-from

stringArray

包含ルールをルールファイルから読み取ることを指定します。

-j, -- job

int

複数のオブジェクトに対して実行できる同時タスクの数。 デフォルト値: 3。

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

文字列

キー=値形式のオブジェクトのユーザーメタデータ。

例: -- metadata test=value,test1=value1

--metadata-directive

String

オブジェクトメタデータの変更に使用されるパラメーター。 有効な値:

  • replace: コマンドラインオプションのメタデータを保持します。

  • update: コマンドラインオプションとオブジェクトのメタデータの共通部分を保持します。

  • purge: すべてのメタデータを削除します。

  • delete: コマンドラインオプションのメタデータを削除し、他のメタデータを保持します。

--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バイト。

--no-progress

/

進行状況バーが表示されないことを指定します。

--page-size

int

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

--parallel

int

1つのオブジェクトに対する内部操作の同時タスクの数。

--part-size

SizeSuffix

部品サイズ。 デフォルトでは、ossutilはオブジェクトサイズに基づいて適切な部品サイズを計算します。 有効値: KiB 100 5 GiB。

-r, -- recursive

/

コマンドがオブジェクトに対して再帰的に実行されることを指定します。 このパラメーターを指定すると、バケット内の条件を満たすすべてのオブジェクトに対してset-propsコマンドが有効になります。 それ以外の場合、set-propsコマンドは指定されたパス内のオブジェクトに対してのみ有効になります。

-- request-payer

String

リクエストの支払人。 pay-by-requesterがバケットに対して有効になっている場合、このパラメーターをrequesterに設定します。

-- start-after

String

-- start-afterパラメーターの値の後に名前がアルファベット順であるオブジェクトが返されることを指定します。

--storage-class

String

オブジェクトのストレージクラス。 有効な値:

  • 標準

  • IA

  • アーカイブ

  • ColdArchive

  • DeepColdArchive

--tagging

文字列

キー=値形式のオブジェクトのタグ。

例: -- tagging tag1=value1,tag2=value2

-- tagging-directive

String

オブジェクトタグの変更に使用されるパラメーター。 有効な値:

  • replace: コマンドラインオプションのタグを保持します。

  • update: コマンドラインオプションとオブジェクトのタグの共通部分を保持します。

  • purge: すべてのタグを削除します。

  • delete: コマンドラインオプションのタグを削除し、他のタグを保持します。

-- version-id

String

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

詳細については、「コマンドラインオプション」をご参照ください。

  • exampleobject.txtオブジェクトのACLをprivateに設定します。

    ossutil set-props oss:// examplebucket/exampleobject.txt -- acl private
  • exampleobject.txtオブジェクトのストレージクラスをArchiveに設定します。

    ossutil set-props oss://examplebucket/exampleobject.txt --storage-class Archive
  • 名前に含まれるオブジェクトのcontent-typeパラメーターを設定します。テキスト /プレーンへのtxtサフィックス:

    ossutil set-pros oss://bucket/prefix --content-type text/plain --include *.txt --metadata-directive update -r
  • exampleobject.txtオブジェクトのタグを設定します。

    ossutil set-props oss://examplebucket/exampleobject.txt --tagging tag1=value1 --tagging-directive update