copy

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

오브젝트를 새로운 위치로 복사합니다. 대상 위치를 지정하지 않으면 오브젝트의 메타데이터만 변경됩니다.

구문

copy 구문은 다음과 같습니다.

swift copy \
    <container> <object> [<object> ...] \
    [--destination </container[/object]>] \
    [--fresh-metadata] \
    [--meta <name:value>] \
    [--header <header:value>]

옵션

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

필수 옵션

copy의 필수 옵션입니다.

옵션	타입	필수 여부	설명
`<container>`	String	Required	컨테이너 이름
`<object>`	List	Required	오브젝트 이름 공백으로 구분하여 여러 개 입력 가능

선택 옵션

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

옵션	타입	필수 여부	설명
`--destination`	String	Optional	복사할 대상 컨테이너와 오브젝트 이름 `/container/object` 형식으로 입력 오브젝트 이름을 생략하면 원본과 동일한 이름 사용 여러 오브젝트를 복사할 때 오브젝트 이름까지 지정하면 오류
`--fresh-metadata`	Boolean	Optional	기존 메타데이터를 제외하고 복사 미입력 시 기존 메타데이터 유지 또는 추가
`--meta`	String	Optional	메타데이터 항목 `name:value` 형식으로 입력 다중 메타데이터 설정 가능 (예시: `swift post test-container-01 --meta name1:value1 --meta name2:value2`)
`--header`	String	Optional	요청에 사용할 표준 HTTP 헤더 및 사용자 정의 메타데이터 표준 HTTP 헤더의 경우 `header:value` 형식으로 입력 사용자 정의 메타데이터의 경우 `X-Object-Meta-{header}:value` 형식으로 입력 반복 입력 가능 (예시: `--header Content-Type:text/plain --header X-Object-Meta-header:value`)

공통 옵션

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

예시

명령을 실행하면 원본 오브젝트와 대상 경로가 출력됩니다.

명령

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

swift copy test-container-01 sample.txt \
    --destination /test-container-01/copied.txt

출력

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

created container test-container-01
test-container-01/sample.txt copied to /test-container-01/copied.txt