Object Storage Service:set-meta (オブジェクトのメタデータを管理)

パラメーターとオプション

サポートされるヘッダー

Expires (time.RFC3339: 2006-01-02T15:04:05Z07:00)
X-Oss-Object-Acl
Origin
X-Oss-Storage-Class
Content-Encoding
Cache-Control
Content-Disposition
Accept-Encoding
X-Oss-Server-Side-Encryption
Content-Type
X-Oss-Meta- プレフィックス付きヘッダー

これらのヘッダーの使用方法については、「オブジェクトのメタデータを管理」をご参照ください。

単一オブジェクト

オブジェクトのアクセス制御リスト（ACL）を private に設定します。

ossutil set-meta oss://examplebucket/exampleobject.txt X-Oss-Object-Acl:private

他のメタデータを変更せずに、オブジェクトの ACL を public-read に更新します（--update を使用）。

ossutil set-meta oss://examplebucket/exampleobject.txt X-Oss-Object-Acl:public-read --update

特定のオブジェクトバージョンのストレージクラスを標準ストレージに設定します。

ossutil set-meta oss://examplebucket/exampleobject.txt X-Oss-Storage-Class:Standard \
  --version-id CAEQARiBgID8rumR2hYiIGUyOTAyZGY2MzU5MjQ5ZjlhYzQzZjNlYTAyZDE3MDRk

特定のオブジェクトバージョンのストレージクラスをコールドアーカイブストレージに設定します。

ossutil set-meta oss://examplebucket/exampleobject.txt X-Oss-Storage-Class:ColdArchive \
  --version-id CAEQARiBgID8rumR2hYiIGUyOTAyZGY2MzU5MjQ5ZjlhYzQzZjNlYTAyZDE3MDRk

ストレージクラスの変更は、コマンドの実行完了後に有効になります。バージョン ID の取得方法については、「ls」をご参照ください。

共通プレフィックスを持つ複数オブジェクト

src プレフィックスを持つすべてのオブジェクトについて、Cache-Control を no-cache に、ACL を private に設定します。

ossutil set-meta oss://examplebucket/src Cache-Control:no-cache#X-Oss-Object-Acl:private -r

ディレクトリ内のすべての .jpg オブジェクトについて、ストレージクラスを低頻度アクセス（IA）に更新します。

ossutil set-meta oss://examplebucket/desfolder/ X-Oss-Storage-Class:IA \
  --include "*.jpg" -u -r

ファイル名に abc を含むオブジェクトについて、ストレージクラスをアーカイブに更新します。ただし、.jpg および .txt ファイルは除外します。

ossutil set-meta oss://examplebucket/desfolder/ X-Oss-Storage-Class:Archive \
  --include "*abc*" --exclude "*.jpg" --exclude "*.txt" -u -r

バッチ操作中に 1 つのオブジェクトでエラーが発生した場合、ossutil はそのエラーを ossutil_output ディレクトリにログ出力し、残りのオブジェクトの処理を継続します。

ファイル一覧から指定する複数オブジェクト

異なるディレクトリにあるオブジェクトのメタデータを更新するには、ローカルファイルにオブジェクト名を一覧表示し、--object-file オプションで指定します。

1. オブジェクト名を 1 行ずつ記述したファイル（例： localfile.txt）を作成します。

      exampleobject1.jpg
      dir1/exampleobject2.png
      dir2/exampleobject3.txt

2. コマンドを実行します。

      ossutil set-meta oss://examplebucket \
        Cache-Control:no-cache#X-Oss-Object-Acl:private \
        --update --object-file localfile.txt --snapshot-path dir/

期待される出力

正常終了時には、経過時間が表示されます。

0.106852(s) elapsed

単一オブジェクト

オブジェクトから特定のユーザーメタデータヘッダーを削除します。値を空欄のまま指定します。

ossutil set-meta oss://examplebucket/exampleobject.txt X-Oss-Meta-Createdby --delete

ファイル一覧から指定する複数オブジェクト

1. オブジェクト名を一覧表示したファイルを作成します。

      exampleobject1.jpg
      dir1/exampleobject2.png
      dir2/exampleobject3.txt

2. コマンドを実行します。

      ossutil set-meta oss://examplebucket X-Oss-Meta-Location \
        --delete --object-file localfile.txt --snapshot-path dir/

期待される出力

0.106846(s) elapsed