개요
오브젝트를 업로드하고 메타 데이터를 생성합니다.
기존에 있는 오브젝트는 덮어쓰고 기존에 있는 메타 데이터는 변경합니다.
구문
PUT /v1/AUTH_{project_id}/{container}/{object}
요청
| 명칭 | In | 타입 | 설명 |
|---|---|---|---|
| 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) |
응답
| 명칭 | In | 타입 | 설명 |
|---|---|---|---|
| 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.gov-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) 상태 코드를 응답합니다.