PutObject
最終更新日：2025-08-18 15:51:52
単一リクエストで完全なファイルをバケットにアップロードします。
- 指定したバケットに同名のファイルが既に存在する場合、新しくアップロードされたファイルが元のファイルを上書きします。
- 利用者には wos:putObject 権限が必要です。
リクエスト構文
PUT /Key+ HTTP/1.1
Host: Bucket.Endpoint
Cache-Control: CacheControl
Content-Disposition: ContentDisposition
Content-Encoding: ContentEncoding
Content-Language: ContentLanguage
Content-Length: ContentLength
Content-MD5: ContentMD5
Content-Type: ContentType
Expires: Expires
x-wos-storage-class: StorageClass
Body
URIリクエストパラメータ
なし
リクエストヘッダー
Common Request Headers に加え、以下もサポートされます。
| パラメータ | 説明 | 必須 |
|---|---|---|
| Content-MD5 | アップロードするオブジェクトデータのMD5値。送信中にデータが破損した場合、403 SignatureDoesNotMatch エラーが返され、MD5値が元の値と一致しないためアップロードは失敗します。 |
No |
| x-wos-storage-class | ファイルのストレージクラスを指定します。サポート値：Standard（標準ストレージ）、IA（低頻度アクセスストレージ）、Archive（アーカイブストレージ）。デフォルトはバケットのストレージクラスです。 | No |
| x-wos-meta-* | カスタムメタデータ。この情報はheadObjectやgetObject実行時にレスポンスヘッダとして返されます。 | No |
リクエストボディ
オブジェクト本体
レスポンス構文
HTTP/1 status_code
x-wos-request-id: request id
Date: date
Content-Length: length
Content-Type: type
Server: WS-web-server
レスポンスヘッダー
Common Response Headers に加えて以下も含まれます。
要素名 | 説明 |
Etag | アップロードデータのエンティティタグ |
レスポンスボディ
なし
例
PUT /object02 HTTP/1.1
Host: bucket.s3-cn-east-1.wcsapi.com
Accept: */*
Date: Sat, 03 Dec 2011 07:12:31 +0000
Authorization: AWS BF6C09F302931425E9A7:KUxrlwKGWYpUOTgwNxIHALsRdT4=
Content-Length
HTTP/1 200 OK
x-wos-request-id: 001B21A61C6C0000013402C4616D5285
Content-Type: text/xml
Etag: "33bee59f4c1f859a7aedd36779b321cf"
Date: Sat, 03 Dec 2011 07:12:31 GMT
Content-Length: 0
Server:WS-web-server
このドキュメントの内容は役に立ちましたか?
はい
いいえ