delete-objects

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

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

참고

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

구문

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

aws s3api delete-objects \
    --bucket <bucket> \
    --delete <delete> \
    [--bypass-governance-retention | --no-bypass-governance-retention] \
    --endpoint-url <endpoint-url>

옵션

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

필수 옵션

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

옵션	타입	필수 여부	설명
`--bucket`	String	Required	버킷 이름
`--delete`	String	Required	삭제할 객체 목록 구문 참조

`--delete` 구문

Shorthand 구문

Objects=[{Key=string,VersionId=string,ETag=string,LastModifiedTime=timestamp,Size=long},{Key=string,VersionId=string,ETag=string,LastModifiedTime=timestamp,Size=long}],Quiet=boolean

JSON 구문

{
  "Objects": [
    {
      "Key": "string",
      "VersionId": "string",
      "ETag": "string",
      "LastModifiedTime": timestamp,
      "Size": long
    }
    ...
  ],
  "Quiet": true|false
}

선택 옵션

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

옵션	타입	필수 여부	설명
`--bypass-governance-retention`	Boolean	Optional	`GOVERNANCE` 모드 보존 설정 우회 `GOVERNANCE` 보존이 설정된 객체 버전을 삭제할 때 사용 우회 권한 필요
`--no-bypass-governance-retention`	Boolean	Optional	`GOVERNANCE` 모드 보존 설정 우회 안 함

공통 옵션

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

예시

객체 삭제 요청이 성공하면 삭제된 각 객체의 식별 정보가 반환됩니다.

명령

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

aws s3api delete-objects --bucket my-test-bucket \
    --delete '{"Objects":[{"Key":"synced/report.txt"}],"Quiet":false}' \
    --endpoint-url=https://kr.ncloudstorage.com

출력

출력 예시는 다음과 같습니다.

{
    "Deleted": [
        {
            "Key": "synced/report.txt"
        }
    ]
}

연관 명령어

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