PostObject

Prev Next

Classic/VPC 환경에서 이용 가능합니다.

오브젝트의 메타데이터를 설정하거나 변경합니다.

요청

요청 형식을 설명합니다. 요청 형식은 다음과 같습니다.

메서드 URI
POST /v1/AUTH_{project_id}/{container}/{object}

요청 헤더

헤더에 대한 설명은 다음과 같습니다.

필드 타입 필수 여부 설명
X-Auth-Token String Optional 발급한 토큰 값
X-Object-Meta-{name} String Optional 설정할 메타데이터
  • {name} 부분에 메타데이터의 키 입력
  • 헤더 값에 메타데이터 값 입력
X-Delete-At Integer Optional 오브젝트의 자동 삭제 예정 시각(Unix Timestamp, 초 단위)
  • 데이터를 일시적으로 저장하기 원할 때 사용
  • 입력된 일시에 오브젝트 삭제
  • 리스트에서 제거되기까지는 시간이 걸릴 수 있음
  • 삭제 예약이 설정되지 않은 오브젝트에만 입력 가능하며, 설정 후 변경/해제 불가
X-Delete-After Integer Optional 오브젝트의 자동 삭제 예정 시점(초 단위로 입력)
  • 데이터를 일시적으로 저장하기 원할 때 사용
  • 입력한 초만큼 지난 시각이 X-Delete-At(Unix Timestamp)으로 변환되어 저장되며, 그 이후 동작은 X-Delete-At과 동일
  • X-Delete-At 헤더와 동시 사용 시 우선순위를 가짐
  • 삭제 예약이 설정되지 않은 오브젝트에만 입력 가능하며, 설정 후 변경/해제 불가
Content-Disposition String Optional 브라우저의 응답 처리 방식
Content-Encoding String Optional 오브젝트의 인코딩 방식
Content-Type String Optional 오브젝트의 MIME 타입

요청 경로 파라미터

파라미터에 대한 설명은 다음과 같습니다.

필드 타입 필수 여부 설명
project_id String Required 프로젝트 ID
container String Required 대상 오브젝트가 저장된 컨테이너 이름
object String Required 대상 오브젝트 이름

요청 예시

요청 예시는 다음과 같습니다.

curl -L -X POST 'https://kr.archive.gov-ncloudstorage.com/v1/AUTH_{project_id}/{container}/{object}' \
-H 'X-Auth-Token: {token}' \
-H 'X-Object-Meta-collection: C3' \
-H 'X-Delete-After: 3600' \
-H 'X-Object-Meta-Row: C3-A8'

응답

응답 형식을 설명합니다.

응답 헤더

Archive Storage API에서 공통으로 사용하는 헤더에 대한 자세한 내용은 Archive Storage 공통 헤더를 참조해 주십시오.

응답 상태 코드

응답 상태 코드에 대한 설명은 다음과 같습니다.

HTTP 상태 코드 코드 메시지 설명
202 - Accepted 요청 성공

응답 예시

응답 예시는 다음과 같습니다.

HTTP/1.1 202 Accepted
Content-Length: 76
Content-Type: text/html; charset=UTF-8
X-Trans-Id: tx31cb8b345bac4fe7b33ab-005b9f7388
X-Openstack-Request-Id: tx31cb8b345bac4fe7b33ab-005b9f7388
Date: Mon, 17 Sep 2018 09:27:37 GMT