- HOME
- 開発者ガイドブック(APIリファレンス)
- オブジェクトストレージ
- サービス操作
- オブジェクト操作
- PUT Object
PUT Object
処理概要
bucketにobjectを追加します。
objectを追加するには、bucketに対してWRITE権限が必要です。
リクエスト
リクエストパラメタ
なし
リクエストヘッダー
このオペレーションはすべての操作に共通するリクエストヘッダに加えて下記のパラメータを使用しています。詳細については、一般的なリクエストヘッダを参照してください。リクエストヘッダーは最大8KBに制限されます。
Name | Type | Description | Required |
---|---|---|---|
– | 利用不可 | No | |
Content-Disposition | sring | objectに別名を付与します。 詳細はこちらを参照してください。 http://www.w3.org/Protocols/rfc2616/rfc2616-sec19.html#sec19.5.1. | No |
Content-Encoding | string | objectに適用されたコンテント・エンコーディングを指定することで、デコード処理がContent-Typeヘッダーを参照してメディアタイプを決めます。詳細はこちらを参照してください。 http://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html#sec14.11. | No |
Content-Length | string | bytes単位でのobjectのサイズ。 詳細はこちらを参照してください。 http://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html#sec14.13. | Yes |
Content-MD5 | string | base64でエンコードされた128ビットのパーツデータのMD5ダイジェスト。このヘッダは、パーツデータが最初に送信された同一のデータであること を確認するチェックに使用することができます。これはオプションですが、我々は、エンドツーエンドの整合性チェックなどのContent- MD5メカニズムを使用することをお勧めします。詳細については、 RFC 1864を参照してください。 | No |
Content-Type | string | objectのデータに対して標準MIME種別を記述します。詳細はこちらを参照してください。 http://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html#sec14.17. | No |
Expect | string | アプリケーションが 100-continueを利用する時、acknowledgmentを受信するまでリクエストボディを送りません。メッセージがヘッダーに基づいて拒否される場合、メッセージボディは送信しません。詳細は、RFC 2616を参照してください。 | No |
– | 利用不可 | No | |
x-amz-meta-* | string | この接頭辞で始まるヘッダーはユーザー定義メタデータです。ユーザー定義メタデータは2KBに制限されます。それぞれKey-Valueペアで扱います。S3はユーザー定義メタデータに対して検証や解釈を行いません。詳しい説明は、PUT Objectを参照してください。 | No |
– | 利用不可 | No | |
– | 利用不可 | No |
リクエストボディ
ファイルコンテンツ
PUT /sample-bucket/sample-object.txt HTTP/1.1 Host: 192.168.0.1 Content-Length: 123 Connection: keep-alive Date: Tue, 01 Sep 2015 10:00:00 +0000 Content-type: text/plain Authorization: AWS EXAMPLEjU2So5By3H5v2:EXAMPLEAjwlAvEi2cPLfQaM588ROWW90so7LwfPr
リクエストサンプル
レスポンス
レスポンスヘッダ
このオペレーションはすべての操作に共通するレスポンスヘッダに加えて下記のパラメータを使用しています。詳細については、一般的なレスポンスヘッダを参照してください。
Name | Type | Description |
---|---|---|
– | 利用不可 | |
– | 利用不可 |
レスポンスボディ
なし
レスポンスサンプル
HTTP/1.1 200 OK Date: Tue, 01 Sep 2015 10:00:00 GMT X-Clv-Request-Id: 01234567-89ab-cdef-0123-456789abcdef Server: Cleversafe/3.5.1.0 X-Clv-S3-Version: 2.4 x-amz-request-id: 01234567-89ab-cdef-0123-456789abcdef ETag: "abcdef0123456789abcdef0123456789" Content-Length: 0