オブジェクトにコンテンツを追加する - Object Storage Service

追加可能オブジェクトの末尾にコンテンツを追加します。

使用上の注意

追加アップロードを実行するには、oss:GetObjectおよびoss:PutObject権限が必要です。詳細については、「RAMユーザーへのカスタムポリシーのアタッチ」をご参照ください。
追加アップロードの詳細については、「追加アップロード」をご参照ください。
指定されたオブジェクトが存在しない場合、コマンドは追加可能なオブジェクトを作成します。オブジェクトが存在するが追加できない場合、コマンドはエラーを返します。

コマンド構文

ossutil append source oss:// bucket/object [flags]

パラメーター	データ型	説明
source	String	データソース。ローカルパス、OSSパス、または`-`を指定できます。 `-`を指定した場合、ossutilは標準入力からの入力を受け入れます。
-- acl	String	オブジェクトのアクセス制御リスト (ACL) 。有効な値： private: ACLはプライベートです。 public-read: ACLはpublic-readです。 public-read-write: ACLはpublic-read-writeです。デフォルト: ACLはバケットから継承されます。
-- cache-control	String	オブジェクトのダウンロード時のwebブラウザでのキャッシュ動作を指定します。
-- content-disposition	String	オブジェクトの表示モード。
-- content-encoding	String	オブジェクトのエンコード方法。
-- content-type	String	オブジェクトのコンテンツタイプ。
-- encoding-type	String	オブジェクト名またはファイル名のエンコード方法。有効な値: url。
-- 有効期限	String	キャッシュされたコンテンツの絶対有効期限。
-- メタデータ	文字列	キー=値ペアの形式のオブジェクトのユーザーメタデータ。
-- request-payer	String	リクエストの支払人。 pay-by-requesterがバケットに対して有効になっている場合、このパラメーターをrequesterに設定します。有効値: requester。
-- ストレージクラス	String	オブジェクトのストレージクラス。有効な値：スタンダード: スタンダード IA: まれなアクセス (IA) アーカイブ: Archive ColdArchive: コールドアーカイブ DeepColdArchive: ディープコールドアーカイブ
-- タグ付け	文字列	オブジェクトは、キー=値ペアの形式でタグ付けされます。

説明

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

例

1.txtファイルをローカルディレクトリからバケットにアップロードし、オブジェクトACLをprivateに設定し、tag=valueタグをオブジェクトに追加します。
```
ossutil append 1.txt oss:// dst-bucket/append.txt -- acl private -- tagging tag=value
```
標準入力を使用して、append.txtオブジェクトの末尾に2.txtのコンテンツを追加します。
```
cat 2.txt | ossutil append - oss:// dst-bucket/append.txt
```
bucket src-bucket内の3.txtのコンテンツをappend.txtオブジェクトの末尾に追加します。
```
ossutil append oss:// src-bucket/3.txt oss:// dst-bucket/append.txt
```