delete-object

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

Object Storage에 저장한 객체를 삭제합니다.

구문

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>

옵션

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 명령에서 공통으로 사용하는 옵션에 대한 정보는 Object Storage 옵션을 참조해 주십시오.

예시

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

명령

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

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