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