Classic/VPC 환경에서 이용 가능합니다.
멀티파트 업로드를 통해 이미 업로드한 파트를 조합하여 객체를 생성하고 멀티파트 업로드를 완료합니다.
명령어
명령어 구문은 다음과 같습니다.
aws s3api complete-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 개요 참고 |
--multipart-upload <value> | string | Y | 요청 파일 또는 내용 | Syntax 참고 |
--mpu-object-size <value> | long | Y | 멀티파트 업로드 요청의 예상 총 객체 크기 | 지정된 객체 크기 값과 실제 크기 값이 다른 경우, HTTP 400 InvalidRequest 오류 발생 |
--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 | 응답값의 포맷 지정 | 선택한 가능한 옵션
|
--query <value> | string | N | 응답 데이터를 필터링하는 데 사용할 JMESPath 쿼리 | - |
--profile <value> | string | N | 자격 증명 파일에서 특정 profile 사용 | - |
--region <value> | string | N | 리전 지정 | kr만 지원 |
--color <value> | string | N | output color 설정 | 선택한 가능한 옵션
|
--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 입력 파라미터 자동 프롬프트 비활성화 | - |
--sse-customer-algorithm | string | N | 사용자 암호화 알고리즘 (AES256) | - |
--sse-customer-key | string | N | 사용자 제공 암호화 키 | - |
--sse-customer-key-md5 | string | N | 사용자 제공 암호화 키의 MD5 값 | - |
--multipart-upload Syntax
- Shorthand Syntax
Parts=[{ETag=string, PartNumber=integer},{ETag=string, PartNumber=integer}]
- Json Syntax
{
"Parts": [
{
"ETag": "string",
"PartNumber": integer
}
...
]
}
권한
Subaccount 사용자가 이 명령어를 사용하려면 Change/AbortMultipartUpload 액션 권한이 필요합니다.
예시
complete-multipart-upload 명령어의 호출과 응답 예시를 설명합니다.
멀티파트 업로드 완료
호출 예시
모든 파트의 업로드를 완료한 후, 객체와 파트를 명시하여 명령어를 호출하면 멀티파트 업로드가 완료됩니다. 호출 예시는 다음과 같습니다.
aws s3api complete-multipart-upload --bucket bucket-a --key 'multipart/01' --multipart-upload file://mpustruct \
--upload-id a1b23c4d-e56f-78gh-9101-1ij2k345l789 --endpoint-url=http://kr.ncloudstorage.com
응답 예시
응답 예시는 다음과 같습니다.
{
"ETag": "\"a2b370952633c9d9ef503abcd8b460bb\"",
"Bucket": "bucket-a",
"Key": "multipart/01"
}
연관 명령어
연관 명령어는 다음과 같습니다.