DeleteObject

Prev Next

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

Ncloud Storage 버킷에 저장된 객체를 삭제합니다.

참고

버전 관리가 설정된 버킷에서 객체를 삭제하는 경우, 다음을 참고해 주십시오.

  • 버전 아이디 지정하지 않고 삭제: 객체가 삭제되지 않고 삭제 마커가 추가됩니다. 삭제 마커가 추가된 후에는 ListObjectsV2 API 호출 시 객체가 표시되지 않으며, GetObject API 호출 시 응답 오류가 반환됩니다.
  • 버전 아이디 지정하여 삭제: 해당 객체 버전이 영구 삭제됩니다.
  • 삭제 마커의 버전 아이디 지정하여 삭제: 삭제 마커가 제거되어 이전 버전의 객체가 다시 노출되며 현재 객체로 동작합니다.

요청

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

메서드 URI
DELETE /{Key}

요청 헤더

Ncloud Storage API에서 공통으로 사용하는 헤더에 대한 정보는 Ncloud Storage 요청 헤더를 참조해 주십시오.

요청 경로 파라미터

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

필드 타입 필수 여부 설명
Key String Required 객체 이름

요청 쿼리 파라미터

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

필드 타입 필수 여부 설명
versionId String Optional 객체 버전 아이디
  • ListObjectVersions 참조
  • 버전 관리가 설정된 버킷에서 특정 객체 버전을 영구 삭제하는 경우, 입력

요청 예시

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

DELETE /object.csv HTTP/1.1
Host: bucket.kr.ncloudstorage.com

응답

응답 형식을 설명합니다.

응답 헤더

Ncloud Storage API에서 공통으로 사용하는 헤더에 대한 정보는 Ncloud Storage 응답 헤더를 참조해 주십시오.

응답 상태 코드

Ncloud Storage API에서 공통으로 사용하는 응답 상태 코드에 대한 정보는 Ncloud Storage 응답 상태 코드를 참조해 주십시오.

응답 예시

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

버전 관리가 설정되지 않은 버킷인 경우

버전 관리가 설정되지 않은 버킷인 경우의 응답 예시는 다음과 같습니다.

HTTP/1.1 204 No Content

버전 관리가 설정된 버킷인 경우

버전 관리가 설정된 버킷인 경우의 응답 예시는 다음과 같습니다.

HTTP/1.1 204 No Content
x-amz-delete-marker: "true"