PutObject

개요

오브젝트를 업로드하고 메타데이터를 생성합니다. 기존에 있는 오브젝트는 덮어쓰고 기존에 있는 메타데이터는 변경합니다.

구문

PUT /v1/AUTH_{project_id}/{container}/{object}

요청

Name In Type Description
project_id path string 프로젝트 ID를 입력합니다.
container path string 컨테이너(버킷) 이름을 입력합니다.
object path string 오브젝트의 이름을 입력합니다.
multipart-manifest (Optional) query string multipart-manifest=put인 경우, 해당 오브젝트는 대용량 오브젝트(SLO) 매니페스트로 인식합니다. 요청의 body 부분에 매니페스트 내용을 포함시켜야 합니다.
temp_url_sig query string temp url
temp_url_expires query integer temp url
X-Object-Manifest (Optional) header string 대용량 오브젝트(DLO) 매니페스트를 입력합니다. 포맷은{container}/{prefix}입니다.
X-Auth-Token (Optional) header string 발급한 Token 값을 입력합니다.
Content-Length (Optional) header integer 해당 오브젝트의 크기를 입력합니다. chunked transfer encoding을 사용하시는 경우, 설정 하지 않으시면 됩니다.
Transfer-Encoding (Optional) header string chunked transfer encoding 사용하도록 설정합니다. 사용하는 경우, Content-Length 헤더를 0이 아닌 값으로 설정하면 안됩니다.
Content-Type (Optional) header string 해당 오브젝트의 MIME 타입을 입력합니다.
X-Detect-Content-Type (Optional) header boolean true인 경우, 파일 확장자를 기반으로 Content-Type을 결정합니다. Content-Type 옵션보다 우선순위가 높습니다.
X-Copy-From (Optional) header string 오브젝트를 복사 합니다. 해당 헤더의 값은 {container}/{object}입니다. Range 헤더와 조합 가능합니다.
X-Copy-From-Account (Optional) header string 다른 어카운트로의 오브젝트를 복사합니다.
ETag (Optional) header string ETag 헤더 값입니다.
Content-Disposition (Optional) header string 브라우저에 대한 작동을 재정의 합니다.
Content-Encoding (Optional) header string 해당 오브젝트의 인코딩 방식입니다.
X-Delete-At (Optional) header integer 해당 오브젝트의 삭제 시간을 입력합니다. (Unix Epoch timestamp)
X-Delete-After (Optional) header integer 해당 시간 이후에 해당 오브젝트를 삭제합니다. (seconds)
X-Object-Meta-name (Optional) header string 해당 오브젝트의 메타데이터를 세팅합니다. 헤더명의 name 부분이 메타데이터의 키 역할을 합니다. 추가, 업데이트, 삭제가 가능하며, 삭제는 빈 값으로 요청하시면 됩니다.
If-None-Match (Optional) header string ETag 조건 헤더입니다. 자세한 정보는 해당 링크에서 확인 : RFC2616

응답

Name In Type Description
Content-Length header string 응답 결과의 길이입니다. (Bytes)
ETag header string ETag 헤더 값입니다.
X-Trans-Id header string 해당 요청의 트랜젝션 ID입니다.
X-Openstack-Request-Id header string 해당 요청의 트랜젝션 ID입니다. (X-Trans-Id와 동일합니다.)
Date header string 해당 요청의 응답 시간입니다. (UTC)
Content-Type header string 응답 결과의 MIME 타입입니다.
last_modified header string 해당 오브젝트가 수정된 가장 최근 시간입니다. (UTC)

예시

요청 예시

curl -i -X PUT -H "X-Auth-Token: $token" -T "/FILE_PATH/OBJECT" https://kr.archive.ncloudstorage.com/v1/AUTH_{project_id}/{container}/{object}

응답 예시

HTTP/1.1 201 Created
Last-Modified: Mon, 17 Sep 2018 07:36:47 GMT
Content-Length: 0
Etag: 95444a08aec383972a52eaaac43e6dce
Content-Type: text/html; charset=UTF-8
X-Trans-Id: txe5ad93db05334b1cb44d2-005b9f598e
X-Openstack-Request-Id: txe5ad93db05334b1cb44d2-005b9f598e
Date: Mon, 17 Sep 2018 07:36:46 GMT

요청이 성공하게 되면 Created (201) 상태 코드를 응답합니다. 요청이 Timeout이 되면 Request Timeout (408) 상태 코드를 응답합니다.