메뉴
Amazon Simple Storage Service
개발자 안내서 (API Version 2006-03-01)

객체 삭제

Amazon S3에서 바로 하나 이상의 객체를 삭제할 수 있으며, 다음과 같은 객체 삭제 옵션을 선택할 수 있습니다.

  • 단일 객체 삭제 — Amazon S3는 단일 HTTP 요청으로 하나의 객체를 삭제할 수 있는 DELETE API를 제공합니다.

  • 여러 객체 삭제 — Amazon S3는 또한 단일 HTTP 요청으로 최대 1,000개의 객체를 삭제할 수 있는 Multi-Object Delete API를 제공합니다.

버전 관리를 사용하지 않는 버킷에서 객체를 삭제할 때는 객체 키 이름만 제공하면 되지만, 버전 관리를 사용하는 버킷에서 객체를 삭제할 때는 객체의 버전 ID를 제공하여 객체의 특정 버전만 삭제할 수 있습니다.

버전 관리를 사용하는 버킷의 객체 삭제

버전 관리를 사용하는 버킷에서는 동일한 객체에 대해 여러 버전이 존재할 수 있습니다. 버전 관리를 사용하는 버킷에서 작업할 때 삭제 API는 다음과 같은 옵션을 제공합니다.

  • 버전이 지정되지 않은 삭제 요청 — 즉, 객체의 키만 지정하며 버전 ID는 지정하지 않습니다. 이 경우 Amazon S3는 삭제 마커를 만들고 응답으로 그 버전 ID를 반환합니다. 그 결과 객체가 버킷에서 보이지 않습니다. 객체 버전 관리 및 삭제 마커 개념에 대한 자세한 내용은 객체 버전 관리 단원을 참조하십시오.

  • 버전이 지정된 삭제 요청 — 즉, 객체의 키와 버전 ID를 모두 지정합니다. 이 경우 다음 두 가지 결과가 가능합니다.

    • 버전 ID가 특정 객체 버전과 일치할 경우 Amazon S3는 해당 특정 버전의 객체를 삭제합니다.

    • 버전 ID가 해당 객체의 삭제 마커와 일치할 경우 Amazon S3는 삭제 마커를 삭제합니다. 그 결과 해당 객체가 버킷에서 다시 표시됩니다.

MFA를 사용하는 버킷의 객체 삭제

멀티 팩터 인증(MFA)을 사용하는 버킷에서 객체를 삭제할 경우 다음과 같은 사항에 주의합니다.

  • 무효한 MFA 토큰을 제공할 경우 요청에 실패합니다.

  • MFA가 활성화된 버킷에서 버전을 지정한 삭제를 요청(객체 키 및 버전 ID 제공)할 경우 MFA 토큰이 올바르지 않으면 요청에 실패합니다. 또한 MFA가 활성화된 버킷에서 Multi-Object Delete API를 사용할 때 버전이 지정된 삭제 요청(객체 키 및 버전 ID 제공) 시 MFA 토큰을 제공하지 않으면 요청이 모두 실패로 끝납니다.

다음은 성공적인 요청 사례입니다.

  • MFA를 사용하는 버킷에서 버전을 지정하지 않은 삭제 요청을 할 경우(버전이 지정된 객체를 삭제하지 않음) MFA 토큰을 제공하지 않아도 삭제에 성공합니다.

  • MFA를 사용하는 버킷에서 버전을 지정하지 않은 객체에 대해 여러 객체를 삭제할 경우 MFA 토큰을 제공하지 않아도 삭제에 성공합니다.

MFA 삭제에 대한 자세한 내용은 MFA Delete 단원을 참조하십시오.

관련 리소스