PostObject
최신 업데이트：2025-08-18 15:51:54
폼 기반 방식으로 데이터를 업로드하는 인터페이스입니다. HTML 폼에 적합하며, IAM wos:PutObject 권한이 필요합니다.
요청 문법
POST / HTTP/1.1
Host: Bucket.Endpoint
Keep-Alive: 300
Connection: keep-alive
Content-Type: multipart/form-data; boundary=-9431149156168
Content-Length: length
--9431149156168
Content-Disposition: form-data; name=”key”
key
--9431149156168
Content-Disposition: form-data; name=”content-Type”
content_type
--9431149156168
Content-Disposition: form-data; name=”x-wos-meta-*”
x-wos-meta-*
--9431149156168
Content-Disposition: form-data; name=”content-MD5”
content_MD5
--9431149156168
Content-Disposition: form-data; name=”policy”
policy=
--9431149156168
Content-Disposition: form-data; name=”signature”
signature=
--9431149156168
Content-Disposition: form-data; name=”file”; filename=”MyFilename”
Content-Type: image/jpeg
fil_content
--9431149156168
Content-Disposition: form-data; name=”submit”
Upload to WCS
--9431149156168—
URI 요청 파라미터
없음
요청 헤더
Common Request Headers 를 사용하세요.
폼 파라미터
| 파라미터 | 설명 | 필수 여부 |
|---|---|---|
| key | 이번 요청으로 생성되는 객체의 이름입니다. | 예 |
| file | 객체의 내용입니다. 타입: 바이너리 또는 텍스트 제한: 요청마다 한 개의 file 파라미터만 가능 |
예 |
| content-type | 업로드할 객체의 MIME타입을 지정합니다. | 아니오 |
| Content-MD5 | 업로드할 객체 데이터의 MD5 값입니다. 데이터가 전송 중 손상될 경우 403 SignatureDoesNotMatch 오류가 발생하며, MD5 값이 원본과 일치하지 않으면 업로드에 실패합니다. |
아니오 |
| x-wos-storage-class | 파일의 스토리지 클래스를 지정합니다. 지원 값: Standard(표준), IA(저빈도), Archive(아카이브). 기본값은 버킷의 스토리지 클래스입니다. | 아니오 |
| x-wos-meta-* | 사용자 정의 메타데이터입니다. 이 정보는 headObject 및 getObject 요청 시 응답 헤더로 반환됩니다. | 아니오 |
요청 본문
객체 데이터
응답 문법
HTTP/1.1 status_code
x-wos-request-id: request id
Content-Type: type
Location: location
Date: date
ETag: etag
Server:WS-web-server
응답 헤더
Common Response Headers 외에 아래 항목이 포함됩니다.
| 요소명 | 설명 |
|---|---|
| Etag | 업로드된 데이터의 Entity tag(엔터티 태그) |
응답 본문
없음
예시
POST /object HTTP/1.1
Date: Fri, 18 May 2017 01:19:49 GMT
Host: bucket.s3-cn-east-1.wcsapi.com
Content-Type: multipart/form-data; boundary=---------------------------7db143f50da2
Content-Length: 2424
Content-Disposition: form-data; name="AWSAccessKeyId"
94963ba9c9ebb26620acf4d8aac40b72c5706c6a
-----------------------------7db143f50da2
Content-Disposition: form-data; name="key"
object01
-----------------------------7db143f50da2
Content-Disposition: form-data; name="acl"
public-read
-----------------------------7db143f50da2
Content-Disposition: form-data; name="content-type"
text/plain
-----------------------------7db143f50da2
Content-Disposition: form-data; name="policy"
eyJjb25kaXRpb25zIjogW3siYWNsIjogInB1YmxpYy1yZWFkIn0sIHsiYnVja2V0IjogIndzdGVzdC0yIn0sIHsia2V5IjogInYydDEudHh0In0sIFsiY29udGVudC1sZW5ndGgtcmFuZ2UiLCAxMDQ4NTc5LCAxMDQ4NTc2MF1dLCAiZXhwaXJhdGlvbiI6ICIyMDE3LTEyLTEzVDA3OjU0OjU5LjEzWiJ9
-----------------------------7db143f50da2
Content-Disposition: form-data; name="signature"
+c+e164E4cZ7J1WEVp/BKEI91bs=
-----------------------------7db143f50da2
Content-Disposition: form-data; name="file"; filename="C:\Testtools\UpLoadFiles\object
\1024Bytes.txt"
Content-Type: text/plain
01234567890
-----------------------------7db143f50da2
HTTP/1 100 Continue
HTTP/1 200 OK
x-wos-request-id: 90E2BA00C26C00000133B442A90063FD
Date: Fri, 18 May 2017 01:20:27 GMT
ETag: "ab7abb0da4bca5323ab6119bb5dcd296"
Content-Length: 0
Connection: close
Server: WS-Web-Server
이 문서의 내용이 도움이 되었습니까?
예
아니오