abort-multipart-upload

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

진행 중인 멀티파트 업로드를 중지합니다. 멀티파트 업로드가 중단된 후에는 해당 업로드 id를 사용하여 파트 업로드를 할 수 없습니다.

명령어

명령어 구문은 다음과 같습니다.

aws s3api abort-multipart-upload --bucket <value> --key <value> --upload-id <value> [--options]

파라미터

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

파라미터	타입	필수 여부	설명	제약 사항
--bucket <value>	string	Y	멀티파트 업로드로 대용량 객체를 업로드할 버킷 지정	-
--key <value>	string	Y	업로드할 객체의 이름(key값) 지정	-
--upload-id <value>	string	Y	멀티파트 업로드를 식별하는 ID	-
--endpoint-url <value>	string	Y	명령 호출의 기본 URL 지정	kr 리전만 가능, 호출 도메인 정보는 Ncloud Storage 개요 참고
--cli-input-json \| --cli-input-yaml	string	N	제공한 json 또는 yaml 문자열에서 인수 입력	json과 yaml을 함께 지정 불가
--generate-cli-skeleton <value>	integer	N	API 명령을 실행하지 않고 이후에 input으로 사용할 수 있는 파라미터 템플릿 생성	-
--debug	boolean	N	디버그 로깅 사용	-
--no-verify-ssl	boolean	N	SSL 인증서를 검증하는 기본 동작 재정의	-
--no-paginate	boolean	N	자동 pagination 비활성화, 결과에 대해 첫 번째 페이지 한 번만 호출됨	-
--output <value>	string	N	응답값의 포맷 지정	선택한 가능한 옵션 json text table yaml yaml-stream
--query <value>	string	N	응답 데이터를 필터링하는 데 사용할 JMESPath 쿼리	-
--profile <value>	string	N	자격 증명 파일에서 특정 profile 사용	-
--region <value>	string	N	리전 지정	kr만 지원
--color <value>	string	N	output color 설정	선택한 가능한 옵션 on off auto
--no-sign-request	boolean	N	자격 증명 로드 비활성화	-
--ca-bundle <value>	string	N	SSL 인증서를 확인할 때 사용할 CA 인증서 지정	-
--cli-read-timeout <value>	int	N	최대 읽기 시간, 0으로 입력시 타임아웃이 아닌 차단 상태로 변경됨	default는 60초로 설정
--cli-connect-timeout <value>	int	N	최대 연결 시간, 0으로 입력시 타임아웃이 아닌 차단 상태로 변경됨	default는 60초로 설정
--no-cli-pager	boolean	N	응답값의 cli pager 비활성화	-
--cli-auto-prompt	boolean	N	CLI 입력 파라미터 자동 프롬프트 설정	-
--no-cli-auto-prompt	boolean	N	CLI 입력 파라미터 자동 프롬프트 비활성화	-

권한

Subaccount 사용자가 이 명령어를 사용하려면 Change/AbortMultipartUpload 액션 권한이 필요합니다.

예시

abort-multipart-upload 명령어의 호출과 응답 예시를 설명합니다.

멀티파트 업로드 중지

호출 예시

업로드를 중지할 멀티파트업로드의 버킷과 key, 업로드 ID를 지정하여 명령어를 호출하면 멀티파트 업로드가 중지되고 관련 파트가 삭제됩니다. 호출 예시는 다음과 같습니다.

aws s3api abort-multipart-upload --endpoint-url=http://kr.ncloudstorage.com --bucket bucket-a --key 'multipart/01' --upload-id a1b23c4d-e56f-78gh-9101-1ij2k345l789

응답 예시

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

{
    "Bucket": "bucket-a",
    "Key": "multipart/01",
    "UploadId": "a1b23c4d-e56f-78gh-9101-1ij2k345l789"
}

주의

멀티파트 업로드를 중지해도 이전에 요청한 파트 업로드가 진행중인 경우, 해당 업로드가 성공하여 업로드한 파트가 스토리지에 남아있을 수 있습니다. 모든 파트가 완전히 제거되었는지 확인하고 불필요한 비용이 발생하는 것을 막으려면 ListParts API를 호출하여 모든 파트가 비어있는지 확인하는 것을 권장합니다.

연관 명령어

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