delete-object

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

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

참고

Sub Account 사용자가 이 명령어를 실행하려면 Change/DeleteObject 액션 권한이 있어야 합니다. GOVERNANCE 모드 보존을 우회하여 삭제하는 경우(--bypass-governance-retention), Change/BypassGovernanceRetention 액션 권한이 추가로 필요합니다.

구문

delete-object 구문은 다음과 같습니다.

aws s3api delete-object \
    --bucket <bucket> \
    --key <key> \
    [--version-id <version-id>] \
    [--bypass-governance-retention | --no-bypass-governance-retention] \
    --endpoint-url <endpoint-url>

참고

삭제 대상 객체가 저장된 버킷에 버전 관리 설정 상태에 따라 동작이 달라질 수 있습니다.

버킷에 버전 관리가 설정되지 않은 경우, 객체는 영구적으로 삭제됩니다.
버전 관리가 활성화되어 있으면 객체에 삭제 마커가 삽입되며, 이 버전이 객체의 최신 버전이 됩니다. 해당 객체를 영구적으로 삭제하고 싶은 경우, 버전 ID를 지정하여 객체를 삭제해 주십시오.
버전 관리가 일시 중지된 경우, 버전 표시를 지정하지 않고 명령어를 호출하면 버전 ID가 NULL인 객체만 삭제할 수 있습니다. 버전 ID가 있는 객체가 현재 버전인 경우, 버전 ID가 NULL인 삭제 마커를 삽입하고 이 삭제 마커가 객체의 현재 버전이 됩니다. 객체의 특정 버전을 삭제하고 싶은 경우, 버전 ID를 지정하면 해당 버전을 삭제할 수 있습니다.

옵션

delete-object 실행 시 지정할 수 있는 옵션을 설명합니다.

필수 옵션

delete-object의 필수 옵션입니다.

옵션	타입	필수 여부	설명
`--bucket`	String	Required	버킷 이름
`--key`	String	Required	객체 이름

선택 옵션

delete-object의 선택 옵션입니다. 지정하지 않은 옵션에는 기본값이 적용됩니다.

옵션	타입	필수 여부	설명
`--version-id`	String	Optional	객체의 버전 ID 버전 관리가 적용된 버킷에서 특정 버전의 객체를 삭제하는 경우
`--bypass-governance-retention`	Boolean	Optional	`GOVERNANCE` 모드 보존 설정 우회 `GOVERNANCE` 보존이 설정된 객체 버전을 삭제할 때 사용 우회 권한 필요
`--no-bypass-governance-retention`	Boolean	Optional	`GOVERNANCE` 모드 보존 설정 우회 안 함

공통 옵션

aws 명령에서 공통으로 사용하는 옵션에 대한 정보는 Ncloud Storage 옵션을 참조해 주십시오.

예시

객체 삭제 요청이 성공하면 객체가 삭제되며 결과는 출력되지 않습니다.

명령

명령 예시는 다음과 같습니다.

aws s3api delete-object --bucket my-test-bucket \
    --key img/copy.png \
    --endpoint-url=https://kr.ncloudstorage.com

연관 명령어

연관 명령어는 다음과 같습니다.

put-object