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 값이 원본과 일치하지 않으면 업로드가 실패합니다. |
아니오 |
| x-wos-storage-class | 파일의 스토리지 클래스를 지정합니다. 지원 값: Standard(표준), IA(저빈도), Archive(아카이브). 기본값은 버킷의 스토리지 클래스입니다. | 아니오 |
| x-wos-meta-* | 사용자 지정 메타데이터입니다. 이 정보는 headObject 또는 getObject 요청 시 응답 헤더로 반환됩니다. | 아니오 |
요청 본문
객체 데이터(바디)
응답 문법
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 | 업로드된 데이터의 Entity tag(엔터티 태그) |
응답 본문
없음
예시
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
이 문서의 내용이 도움이 되었습니까?
예
아니오