upload-part-copy

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

Ncloud Storage 버킷에 저장된 객체를 복사하여 멀티파트 업로드의 파트로 업로드합니다.

참고

Sub Account 사용자가 이 명령어를 실행하려면 View/GetObject (복사할 객체가 저장된 버킷), Change/PutObject (객체를 저장할 대상 버킷) 액션 권한이 있어야 합니다.

구문

upload-part-copy 구문은 다음과 같습니다.

aws s3api upload-part-copy \
    --bucket <bucket> \
    --copy-source <copy-source> \
    --key <key> \
    --part-number <part-number> \
    --upload-id <upload-id> \
    [--copy-source-range <copy-source-range>] \
    [--sse-customer-algorithm <sse-customer-algorithm>] \
    [--sse-customer-key <sse-customer-key>] \
    [--sse-customer-key-md5 <sse-customer-key-md5>] \
    [--copy-source-sse-customer-algorithm <copy-source-sse-customer-algorithm>] \
    [--copy-source-sse-customer-key <copy-source-sse-customer-key>] \
    [--copy-source-sse-customer-key-md5 <copy-source-sse-customer-key-md5>] \
    --endpoint-url <endpoint-url>

옵션

upload-part-copy 실행 시 지정할 수 있는 옵션을 설명합니다.

필수 옵션

upload-part-copy의 필수 옵션입니다.

옵션	타입	필수 여부	설명
`--bucket`	String	Required	버킷 이름
`--copy-source`	String	Required	복사할 원본 객체 `{bucket_name}/{object_name}` 형태로 입력 (예시: `my-test-bucket/large.bin`) 버킷 이름: list-buckets 참조 객체 이름: list-objects-v2 참조 버전 관리가 설정된 버킷에서 객체의 특정 버전을 복사하는 경우, 입력값에 `?versionId={versionId}` 추가 버전 아이디 확인: list-object-versions 참조 최대 5GB
`--key`	String	Required	객체 이름
`--part-number`	Integer	Required	업로드 중인 파트의 번호 파트의 개수는 1~10,000개까지 가능
`--upload-id`	String	Required	멀티파트 업로드 ID create-multipart-upload 참조

선택 옵션

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

옵션	타입	필수 여부	설명
`--copy-source-range`	String	Optional	원본에서 복사할 바이트 범위
`--sse-customer-algorithm`	String	Optional	사용자 암호화 알고리즘 (AES256)
`--sse-customer-key`	String	Optional	사용자 제공 암호화 키
`--sse-customer-key-md5`	String	Optional	사용자 제공 암호화 키의 MD5 값
`--copy-source-sse-customer-algorithm`	String	Optional	원본의 사용자 암호화 알고리즘 (AES256)
`--copy-source-sse-customer-key`	String	Optional	원본의 사용자 제공 암호화 키
`--copy-source-sse-customer-key-md5`	String	Optional	원본의 사용자 제공 암호화 키의 MD5 값

공통 옵션

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

예시

파트 복사 요청이 성공하면 복사된 파트의 식별 정보와 원본 버전 정보가 반환됩니다.

명령

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

aws s3api upload-part-copy --bucket my-test-bucket \
    --key copied-large.bin \
    --part-number 1 \
    --upload-id {upload_id} \
    --copy-source my-test-bucket/large.bin \
    --endpoint-url=https://kr.ncloudstorage.com

출력

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

{
    "ServerSideEncryption": "AES256",
    "CopyPartResult": {
        "ETag": "\"6caef151b75db9c5c62d1ff002024964\"",
        "LastModified": "2026-09-04T06:18:18Z"
    }
}

연관 명령어

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