このトピックでは、appendfromfileコマンドを実行して、object Storage Service (OSS) の追加可能オブジェクトにコンテンツを追加する方法について説明します。
使用上の注意
追加アップロードを実行するには、
oss:GetObject
およびoss:PutObject
権限が必要です。 詳細については、「RAMユーザーへのカスタムポリシーのアタッチ」をご参照ください。このトピックでは、64ビットLinuxシステムに基づくサンプルコマンドラインを提供します。 他のシステムのために、取り替えて下さい./ossutil64対応するバイナリ名を持つコマンドで 詳細は、「ossutilコマンドリファレンス」をご参照ください。
追加アップロードの詳細については、「追加アップロード」をご参照ください。
コマンド構文
. /ossutil64 appendfromfile localfilename oss:// bucketname/objectname
[-- meta <value>]
次の表に、構文のパラメーターを示します。
パラメーター | 説明 |
localfilename | アップロードするローカルファイルのフルパス。 |
bucketname | バケットの名前です。 |
オブジェクト名 | コンテンツを追加するオブジェクトの名前。 appendfromfileコマンドを実行して追加アップロードを実行する場合、オブジェクトのローカルファイルの元の名前を保持するか、別の名前を指定できます。 |
-メタ | オブジェクトのメタデータ。 このパラメーターは、appendfromfileコマンドを最初に実行してオブジェクトをアップロードするときにのみ設定できます。 例: |
例
次の例では、appendfromfileコマンドを最初に使用して、ルートディレクトリにあるexampleobject.txtという名前のローカルファイルをexamplebucketバケットにアップロードし、そのファイルをexampleobject.txtオブジェクトとしてバケットに格納します。 次に、appendfromfileコマンドを使用して、exampleobject.txtオブジェクトにコンテンツを追加します。
次のコマンドを実行してexampleobject.txtをアップロードし、アップロードされたオブジェクトのアクセス制御リスト (ACL) をprivateに設定します。
./ossutil64 appendfromfile exampleobject.txt oss:// examplebucket/exampleobject.txt -- meta "x-oss-object-acl:private"
次のサンプル出力は、ローカルファイルがバケットにアップロードされ、exampleobject.txtオブジェクトとして保存されていることを示しています。 exampleobject.txtオブジェクトのサイズは5バイトです。
合計追加5(100.00%) バイト、速度は0.00(KB/s) ローカルファイルのサイズは5、オブジェクトの新しいサイズは5、平均速度は0.04(KB/s)
次のコマンドを実行して、dest.txtという名前のファイルの内容をexampleobject.txtに追加します。
exampleobject.txtにさらにコンテンツを追加する場合は、dest.txtを、exampleobject.txtにコンテンツを追加するファイルの名前に置き換えます。
./ossutil64 appendfromfile dest.txt oss:// examplebucket/exampleobject.txt
次のサンプル出力は、コンテンツがexampleobject.txtに追加され、追加アップロード操作後のオブジェクトサイズが150バイトであることを示しています。
合計追加150(100.00%) バイト、速度は0.00(KB/s) ローカルファイルサイズが150、オブジェクトの新しいサイズが150、平均速度が1.19(KB/s)
一般的なオプション
ossutilを使用して別のリージョンにあるバケットに切り替える場合は、コマンドに -eオプションを追加して、指定したバケットがあるリージョンのエンドポイントを指定します。 ossutilを使用して別のAlibaba Cloudアカウントに属するバケットに切り替える場合、コマンドに -iオプションを追加して、指定されたアカウントのAccessKey IDを指定し、コマンドに -kオプションを追加して、指定されたアカウントのAccessKey secretを指定します。
たとえば、次のコマンドを実行して、追加アップロードのexampleobject.txtファイルを、中国 (上海) リージョンにあり、別のAlibaba Cloudアカウントが所有するexamplebucketバケットにアップロードできます。
./ossutil64 appendfromfile exampleobject.txt oss:// examplebucket/exampleobject.txt -e shanghai.aliyuncs.com -i LTAI4Fw2NbDUCV8zYUzA **** -k 67DLVBkH7EamOjy2W5RVAHUY9H ****
共通オプションの詳細については、「共通オプション」をご参照ください。