DeleteObjects

Prev Next

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

Ncloud Storage 버킷에 저장된 2개 이상의 객체를 한 번에 삭제합니다.

요청

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

메서드 URI
POST -

요청 헤더

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

참고

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

필드 타입 필수 여부 설명
Content-MD5 String Conditional MD5 해시 값
  • x-amz-checksum-*를 입력하지 않은 경우, 필수 입력
x-amz-checksum-* String Conditional 체크섬 해시 값
  • 키의 *에 지원 알고리즘 입력
    • 지원 알고리즘: crc32 | crc32c | sha1 | sha256
  • Content-MD5를 입력하지 않은 경우, 필수 입력

요청 쿼리 파라미터

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

필드 타입 필수 여부 설명
delete String Required 객체 삭제 요청
  • 값 없이 키만 입력

요청 바디

요청 바디에 대한 설명은 다음과 같습니다.

필드 타입 필수 여부 설명
Delete Object Required 객체 목록
Delete.Object Array Required 객체 정보
Delete.Quiet Boolean Optional 응답 상세 정보 생략 여부
  • true: 생략 (유효 값)

Delete.Object

Delete.Object에 대한 설명은 다음과 같습니다.

필드 타입 필수 여부 설명
Key String Required 객체 이름
VersionId String Optional 객체 버전 아이디
  • ListObjectVersions 참조
  • 버전 관리가 설정된 버킷에서 객체의 특정 버전을 삭제하는 경우, 입력
ETag String Optional 객체 고유 식별자(Entity Tag)
LastModifiedTime Integer Optional 마지막 수정 일시
Size Integer Optional 객체 크기(Byte)

요청 예시

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

POST /?delete HTTP/1.1
Host: {Bucket}.kr.ncloudstorage.com
Content-MD5: {Content-MD5}

<?xml version="1.0" encoding="UTF-8"?>
<Delete>
    <Object>
        <Key>Data1.xlsx</Key>
        <VersionId>89f83309-****-****-****-9cc2c468d0e9</VersionId>
    </Object>
    <Object>
        <Key>Data2.xlsx</Key>
    </Object>
</Delete>

응답

응답 형식을 설명합니다.

응답 헤더

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

응답 바디

응답 바디에 대한 설명은 다음과 같습니다.

필드 타입 필수 여부 설명
DeleteResult Object - 삭제 요청 객체 정보
DeleteResult.Deleted Array - 삭제 성공 객체 목록
DeleteResult.Error Array - 삭제 실패 객체 목록

DeleteResult.Deleted

DeleteResult.Deleted에 대한 설명은 다음과 같습니다.

필드 타입 필수 여부 설명
Key String - 객체 이름
VersionId String - 객체 버전 아이디
  • 요청에 VersionId를 입력한 경우, 표시
DeleteMarker Boolean - 삭제 마커 여부
  • true | false
    • true: 삭제 마커
      • false: 삭제 마커 아님
DeleteMarkerVersionId String - 삭제 마커 버전 아이디
  • 버전 관리가 설정된 버킷에서 삭제를 취소하는 경우, 다음 요청의 VersionId에 해당 값 입력

DeleteResult.Error

DeleteResult.Error에 대한 설명은 다음과 같습니다.

필드 타입 필수 여부 설명
Key String - 객체 이름
VersionId String - 객체 버전 아이디
Code String - 오류 코드
Message String - 오류 메시지

응답 상태 코드

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

응답 예시

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

전체 삭제가 성공한 경우

전체 삭제가 성공한 경우의 응답 예시는 다음과 같습니다.

HTTP/1.1 200 OK

<?xml version="1.0" encoding="UTF-8"?>
<DeleteResult>
    <Deleted>
        <Key>Data1.xlsx</Key>
        <DeleteMarker>true</DeleteMarker>
        <DeleteMarkerVersionId>b253ab10-****-****-****-9cc2c468d0e9</DeleteMarkerVersionId>
    </Deleted>
    <Deleted>
        <Key>Date2.xlsx</Key>
        <DeleteMarker>true</DeleteMarker>
        <DeleteMarkerVersionId>b253aad9-****-****-****-9cc2c468d0e9</DeleteMarkerVersionId>
    </Deleted>
</DeleteResult>
참고

요청 바디의 객체 정보가 콘솔에 등록한 정보와 일치하지 않는 경우, Content-MD5 또는 x-amz-checksum-* 헤더 값이 요청 바디와 일치하여 200 OK가 반환되어도 해당 객체는 삭제되지 않을 수 있습니다. 따라서 API 호출 후 콘솔에서 객체가 정상적으로 삭제되었는지 확인해 주십시오.

일부 삭제만 성공한 경우

일부 삭제만 성공한 경우의 응답 예시는 다음과 같습니다.

HTTP/1.1 200 OK

<DeleteResult>
    <Deleted>
        <Key>Data2.xlsx</Key>
        <DeleteMarker>true</DeleteMarker>
        <DeleteMarkerVersionId>f201de46-****-****-****-9cc2c468d0e9</DeleteMarkerVersionId>
    </Deleted>
    <Error>
        <Key>Data1.xlsx</Key>
        <VersionId>&#x9;89f83309-****-****-****-9cc2c468d0e9</VersionId>
        <Code>InvalidArgument</Code>
        <Message>Invalid version id specified</Message>
    </Error>
</DeleteResult>