cp

Prev Next

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

버킷에 객체를 업로드하거나 이미 업로드한 객체를 로컬에 다운로드 또는 다른 위치에 복사합니다.

명령어

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

aws s3 cp <source> <destination> --endpoint-url <value> [--options]

파라미터

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

파라미터 타입 필수 여부 설명 제약 사항
--endpoint-url <value> string Y 명령 호출의 기본 URL 지정 kr 리전만 가능, 호출 도메인 정보는 Ncloud Storage 개요 참고
--dryrun boolean N 동작 수행 결과만 확인하고 실제로는 미적용 -
--quiet boolean N 응답 결과 미노출 -
--include <value> string N 지정된 객체만 명령에 포함하도록 규칙 설정, 지정된 순서대로 적용 -
--exclude <value> string N 지정된 객체는 명령에 제외하도록 규칙 설정, 지정된 순서대로 적용 -
--follow-symlinks 또는 --no-follow-symlinks boolean N 업로드하는 파일의 심볼릭 링크의 콘텐츠 업로드 여부 설정 로컬 파일 시스템에서 객체를 업로드하는 경우에만 해당
--no-guess-mime-type boolean N 업로드된 객체의 콘텐츠 유형 자동 지정 비활성화 -
--storage-class <value> string N 객체를 저장할 스토리지 클래스 지정 선택 가능한 옵션
- STANDARD
- DEEP_ARCHIVE
* Default는 Standard 클래스에 저장
--content-type <value> string N 명시적인 콘텐츠 유형 정의 -
--cache-control <value> string N 캐싱 동작 설정 -
--content-disposition <value> string N 객체에 대한 표현 정보 지정 -
--content-encoding <value> string N 콘텐츠 인코딩 설정 -
--content-language <value> string N 콘텐츠 언어 설정 -
--only-show-errors boolean N 에러만 표시, 다른 응답값은 미노출 -
--no-progress boolean N 파일 전송 진행율 미표시 --quite 또는 --only-show-erros가 지정된 경우, 미적용
--page-size <value> integer N 각 응답별 리스팅 개수 지정 최대 1,000개 지원
--ignore-glacier-warnings boolean N Deep Archive에 있는 객체에 대한 변경 작업(복사, 다운로드, 이동 등) 미지원 관련 경고 미노출 -
--metadata <value> string N 객체와 함께 저장할 메타데이터 설정 -
--copy-props <value> string N 원본 객체에서 복사할 속성값 설정 Ncloud Storage에서 Ncloud Storage로 복사하는 경우에만 적용
--metadata-directive <value> string N CopyObject 작업에 대한 x-amz-metadata-directive 헤더 설정 이 옵션이 설정된 경우, --copy-props 비활성화됨
--recursive boolean N 명령 적용 범위를 하위 디렉토리까지 적용 -
--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 입력 파라미터 자동 프롬프트 비활성화 -

예시

cp 명령어의 호출과 응답 예시를 설명합니다.

로컬에 있는 객체를 Ncloud Storage에 업로드

호출 예시

Ncloud Storage에 업로드할 로컬 파일의 경로와 업로드할 대상 버킷을 지정하면 객체 업로드가 가능합니다. 호출 예시는 다음과 같습니다.

aws s3 cp test.txt s3://bucket-aa/ --endpoint-url=http://kr.ncloudstorage.com

응답 예시

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

upload: ./test.txt to s3://bucket-aa/text.txt

Ncloud Storage에 저장되어 있는 객체를 Ncloud Storage 내 다른 위치에 복사

호출 예시

복사할 원본 객체의 경로와 복사할 위치를 지정하여 명령어를 호출하면 객체를 복사할 수 있습니다. 스토리지 클래스를 지정하지 않으면 Standard Class에 저장됩니다. 호출 예시는 다음과 같습니다.

aws s3 cp s3://bucket-aa/image.png s3://bucket-a/img/ --endpoint-url=http://kr.ncloudstorage.com

응답 예시

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

copy: s3://bucket-aa/image.png to s3://bucket-a/img/image.png

Standard Class에 저장되어 있는 객체를 Deep Archive Class로 변경

호출 예시

스토리지 클래스 옵션과 함께 명령어를 호출하면 객체가 저장된 스토리지 클래스를 변경할 수 있습니다. cp 명령어를 활용하여 메타데이터, 스토리지 클래스 등 객체의 속성을 변경을 할 수 있습니다. 호출 예시는 다음과 같습니다.

aws s3 cp s3://bucket-aa/1234.png s3://bucket-aa/ --endpoint-url=http://kr.ncloudstorage.com --storage-class=DEEP_ARCHIVE

응답 예시

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

copy: s3://bucket-aa/1234.png to s3://bucket-aa/1234.png

Ncloud Storage에 저장되어 있는 객체를 로컬에 다운로드

호출 예시

다운로드 할 소스 객체의 경로와 다운로드 할 로컬 경로를 지정하여 명령어를 호출하면 객체를 복사할 수 있습니다. Standard Class에 저장된 객체나 Deep Archive Class에서 복원한 객체만 다운로드를 지원합니다. 호출 예시는 다음과 같습니다.

aws s3 cp s3://bucket-aa/image.png ./ --endpoint-url=http://kr.ncloudstorage.com

응답 예시

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

download: s3://bucket-aa/image.png to ./image.png