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 헤더와 동시 사용 시 우선순위를 가짐
Content-Disposition String Optional 브라우저의 응답 처리 방식
Content-Encoding String Optional 오브젝트의 인코딩 방식
Content-Type String Optional 오브젝트의 MIME 타입

요청 경로 파라미터

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

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

요청 쿼리 파라미터

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

필드 타입 필수 여부 설명
bulk-delete String Optional 여러 오브젝트 및 컨테이너를 한 번에 삭제
  • 최대 10,000개까지 요청 가능
  • 키 입력 후 삭제 대상을 요청 바디에 입력
extract-archive String Optional 압축된 파일 업로드
  • 값으로 압축 해제할 파일 확장자 입력
  • 업로드된 파일이 자동으로 압축 해제되어 지정된 위치에 저장

요청 예시

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

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