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

Object Storage Service:set-props (オブジェクトプロパティの設定)

最終更新日:Nov 21, 2025

set-props コマンドは、アクセス権限、ストレージクラス、メタデータ、タグなどのオブジェクトプロパティを設定します。

注意事項

set-props コマンドは、変更するオブジェクトプロパティに応じて異なる API 操作を呼び出します。 必要な権限があることを確認してください。 たとえば、PutObjectAcl API 操作を呼び出すには、oss:PutObjectAcl 権限が必要です。 呼び出される特定の API 操作は次のとおりです。

  1. オブジェクトのアクセス制御リスト (ACL) のみを変更する場合: このコマンドは PutObjectAcl API 操作を呼び出します。

  2. オブジェクトタグのみを変更する場合: このコマンドは PutObjectTagging API 操作を呼び出します。 タグ変更命令に、増分追加などの既存のタグの更新が含まれる場合、システムはまず GetObjectTagging API 操作を呼び出して元のタグを取得します。

  3. オブジェクトのストレージクラスまたはメタデータを変更する場合: この操作はオブジェクトを再書き込みします。 このコマンドは CopyObject API 操作を呼び出すか、マルチパートコピーフロー (InitiateMultipartUpload -> UploadPartCopy -> CompleteMultipartUpload) を使用します。

  4. 複数のプロパティを同時に変更する場合: このコマンドは、API 操作の最も効率的な組み合わせを選択します。 例:

    • オブジェクトの権限とタグの両方を変更する場合: このコマンドは PutObjectAclPutObjectTagging を呼び出します。

    • オブジェクトの権限とストレージクラスの両方を変更する場合: このコマンドは、CopyObject API 操作またはマルチパートコピー API 操作 (InitiateMultipartUpload -> UploadPartCopy -> CompleteMultipartUpload) を直接呼び出して、権限とストレージクラスを同時に更新します。

コマンドのフォーマット

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

パラメーター

タイプ

説明

--acl

string

オブジェクトのアクセス制御リスト (ACL)。 有効値:

  • private: 非公開。

  • public-read: 公開読み取り。

  • 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

オブジェクトをアルファベット順にソートし、指定された値以前のオブジェクトを返します。

--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 です。

重要

このパラメーターは、-f--update--size-only、または --ignore-existing パラメーターを指定した場合にのみ有効になります。

--list-objects

/

ListObjects API 操作を使用してオブジェクトをリストします。

--max-size

SizeSuffix

転送するファイルの最大サイズ。 デフォルトの単位はバイトです。 サフィックス B、K、M、G、T、または P を使用できます。1 K (KiB) = 1024 B です。

--metadata

strings

オブジェクトのユーザーメタデータを key=value 形式で指定します。

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

Duration

指定した時間間隔より前に変更されたファイルに対してのみプロパティを設定します。 デフォルトの単位は秒です。 1 時間の場合は 1h などの単位サフィックスを使用できます。

説明

--min-age 1h は、1 時間以上前に変更されたファイルに対してのみプロパティを設定します。

--max-age

Duration

指定した時間間隔内に変更されたファイルに対してのみプロパティを設定します。 デフォルトの単位は秒です。 1 時間の場合は 1h などの単位サフィックスを使用できます。

説明

--max-age 1h は、過去 1 時間以内に変更されたファイルに対してのみプロパティを設定します。

--min-mtime

Time

指定した時刻以降に変更されたファイルに対してのみプロパティを設定します。 時刻は UTC 形式である必要があります。 例: 2006-01-02T15:04:05。

説明

--min-mtime "2006-01-02T15:04:05" は、2006 年 1 月 2 日 15:04:05 UTC 以降に変更されたファイルに対してのみプロパティを設定します。

--max-mtime

Time

指定した時刻より前に変更されたファイルに対してのみプロパティを設定します。 時刻は UTC 形式である必要があります。 例: 2006-01-02T15:04:05。

--min-size

SizeSuffix

転送するファイルの最小サイズ。 デフォルトの単位はバイトです。 サフィックス B、K、M、G、T、または P を使用できます。1 K (KiB) = 1024 B です。

--no-progress

/

進行状況バーを表示しません。

--page-size

int

バッチ処理中に各ページにリストするオブジェクトの最大数。 デフォルト値は 1000 です。 値の範囲は 1 から 1000 です。

--parallel

int

単一ファイルに対する操作の同時タスク数。

--part-size

SizeSuffix

パートサイズ。 デフォルトでは、ossutil はファイルサイズに基づいて適切なパートサイズを計算します。 値は 100 KiB から 5 GiB の間である必要があります。

-r, --recursive

/

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

--request-payer

string

リクエストの支払方法。 リクエスト元支払いモードを使用する場合は、このパラメーターを設定します。 有効値: requester。

--start-after

string

オブジェクトをアルファベット順にソートし、指定された値の後のオブジェクトを返します。

--storage-class

string

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

  • Standard: 標準。

  • IA: 低頻度アクセス。

  • Archive: アーカイブストレージ。

  • ColdArchive: コールドアーカイブ。

  • DeepColdArchive: ディープコールドアーカイブ。

--tagging

strings

オブジェクトのタグを key=value 形式で指定します。

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

--tagging-directive

string

タグを変更するための命令。 有効値:

  • replace: コマンドラインオプションで指定されたタグのみを保持します。

  • update: コマンドラインのタグとオブジェクトのタグの和集合を取ります。

  • purge: すべてのタグをクリアします。

  • delete: コマンドラインオプションで指定されたタグを削除し、残りを保持します。

--version-id

string

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

--list-format

string

リストファイルのフォーマット。 有効値: plain, inventory。

--list-manifest-from

string

ファイルからリストファイルのフォーマットの説明を読み取ります。 リストファイルのフォーマットが `inventory` の場合、このパラメーターは必須です。

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

  • オブジェクトのアクセス権限を非公開に設定します。

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

    ossutil set-props oss://examplebucket/exampleobject.txt --storage-class Archive
  • .txt 拡張子を持つオブジェクトの場合、content-type を text/plain に変更します。

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

    ossutil set-props oss://examplebucket/exampleobject.txt --tagging tag1=value1 --tagging-directive update
  • リストファイルからオブジェクトプロパティを設定します。

    説明

    リストファイルの各行はオブジェクトを表し、OSS パス形式 `oss://{bucket}/{key}` を使用します。 たとえば、list.txt ファイルには次の内容が含まれています。

    oss://examplebucket/key1
    oss://examplebucket/key2
    ossutil set-props list://list.txt 
  • マニフェストファイルからオブジェクトプロパティを設定します。

    説明

    インベントリタスクを実行すると、インベントリ結果に `csv.gz` ファイルと `manifest.json` ファイルが生成されます。 これら 2 つのファイルを使用して、マニフェストファイルからオブジェクトプロパティを設定する必要があります。

    ossutil set-props list://ca8007fc-4123-493e-9a01-dd1511fbac54.csv.gz --list-format inventory --list-manifest-from manifest.json