set-props コマンドは、アクセス権限、ストレージクラス、メタデータ、タグなどのオブジェクトプロパティを設定します。
注意事項
set-props コマンドは、変更するオブジェクトプロパティに応じて異なる API 操作を呼び出します。 必要な権限があることを確認してください。 たとえば、PutObjectAcl API 操作を呼び出すには、oss:PutObjectAcl 権限が必要です。 呼び出される特定の API 操作は次のとおりです。
オブジェクトのアクセス制御リスト (ACL) のみを変更する場合: このコマンドは
PutObjectAclAPI 操作を呼び出します。オブジェクトタグのみを変更する場合: このコマンドは
PutObjectTaggingAPI 操作を呼び出します。 タグ変更命令に、増分追加などの既存のタグの更新が含まれる場合、システムはまずGetObjectTaggingAPI 操作を呼び出して元のタグを取得します。オブジェクトのストレージクラスまたはメタデータを変更する場合: この操作はオブジェクトを再書き込みします。 このコマンドは
CopyObjectAPI 操作を呼び出すか、マルチパートコピーフロー (InitiateMultipartUpload->UploadPartCopy->CompleteMultipartUpload) を使用します。複数のプロパティを同時に変更する場合: このコマンドは、API 操作の最も効率的な組み合わせを選択します。 例:
オブジェクトの権限とタグの両方を変更する場合: このコマンドは
PutObjectAclとPutObjectTaggingを呼び出します。オブジェクトの権限とストレージクラスの両方を変更する場合: このコマンドは、
CopyObjectAPI 操作またはマルチパートコピー API 操作 (InitiateMultipartUpload->UploadPartCopy->CompleteMultipartUpload) を直接呼び出して、権限とストレージクラスを同時に更新します。
コマンドのフォーマット
ossutil set-props oss://bucket[/prefix] [flags]パラメーター | タイプ | 説明 |
--acl | string | オブジェクトのアクセス制御リスト (ACL)。 有効値:
|
--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 です。 重要 このパラメーターは、 |
--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 | メタデータを変更するための命令。 有効値:
|
--metadata-exclude | stringArray | オブジェクトのメタデータを除外するルール。 |
--metadata-filter | stringArray | オブジェクトのメタデータをフィルターするルール。 |
--metadata-filter-from | stringArray | ルールファイルからオブジェクトメタデータのフィルタリングルールを読み取ります。 |
--metadata-include | stringArray | オブジェクトのメタデータを含めるルール。 |
--min-age | Duration | 指定した時間間隔より前に変更されたファイルに対してのみプロパティを設定します。 デフォルトの単位は秒です。 1 時間の場合は 1h などの単位サフィックスを使用できます。 説明
|
--max-age | Duration | 指定した時間間隔内に変更されたファイルに対してのみプロパティを設定します。 デフォルトの単位は秒です。 1 時間の場合は 1h などの単位サフィックスを使用できます。 説明
|
--min-mtime | Time | 指定した時刻以降に変更されたファイルに対してのみプロパティを設定します。 時刻は UTC 形式である必要があります。 例: 2006-01-02T15:04:05。 説明
|
--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 | オブジェクトのストレージクラス。 有効値:
|
--tagging | strings | オブジェクトのタグを key=value 形式で指定します。 例: --tagging tag1=value1,tag2=value2。 |
--tagging-directive | string | タグを変更するための命令。 有効値:
|
--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/key2ossutil 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