--- title: "sync" slug: "cli-objectstorage-high-level-sync" updated: 2026-09-17T09:16:11Z published: 2026-09-17T09:16:11Z canonical: "cli.ncloud-docs.com/cli-objectstorage-high-level-sync" --- > ## Documentation Index > Fetch the complete documentation index at: https://cli.ncloud-docs.com/llms.txt > Use this file to discover all available pages before exploring further. # sync Classic/VPC 환경에서 이용 가능합니다. Object Storage 버킷 간 또는 버킷과 로컬 디렉터리 간에 폴더와 객체를 동기화합니다 ## 구문 `sync` 구문은 다음과 같습니다. ``` aws s3 sync \ \ \ [--dryrun] \ [--quiet] \ [--include ] \ [--exclude ] \ [--acl ] \ [--follow-symlinks | --no-follow-symlinks] \ [--no-guess-mime-type] \ [--content-type ] \ [--only-show-errors] \ [--no-progress] \ [--page-size ] \ [--metadata ] \ [--metadata-directive ] \ [--size-only] \ [--exact-timestamps] \ [--delete] \ --endpoint-url ``` ## 옵션 `sync` 실행 시 지정할 수 있는 옵션을 설명합니다. ### 필수 옵션 `sync`의 필수 옵션입니다. | 옵션 | 타입 | 필수 여부 | 설명 | | --- | --- | --- | --- | | `<source>` | String | Required | 원본 경로 - 로컬 디렉터리 또는 `s3://{bucket_name}[/{prefix}]` 형식의 S3 URI | | `<destination>` | String | Required | 대상 경로 - 로컬 디렉터리 또는 `s3://{bucket_name}[/{prefix}]` 형식의 S3 URI | ### 선택 옵션 `sync`의 선택 옵션입니다. 지정하지 않은 옵션에는 기본값이 적용됩니다. | 옵션 | 타입 | 필수 여부 | 설명 | | --- | --- | --- | --- | | `--dryrun` | Boolean | Optional | 명령을 실제로 실행하지 않고 수행 결과만 확인 | | `--quiet` | Boolean | Optional | 응답 결과 미표시 | | `--include` | String | Optional | 지정한 패턴과 일치하는 객체만 명령에 포함 - 지정한 순서대로 적용 | | `--exclude` | String | Optional | 지정한 패턴과 일치하는 객체를 명령에서 제외 - 지정한 순서대로 적용 | | `--follow-symlinks`, `--no-follow-symlinks` | Boolean | Optional | 심볼릭 링크가 가리키는 파일의 콘텐츠 업로드 여부 - 기본값: `--follow-symlinks` - 로컬 파일 시스템에서 객체를 업로드하는 경우에만 해당 | | `--no-guess-mime-type` | Boolean | Optional | 업로드할 객체의 콘텐츠 유형 자동 추측 비활성화 | | `--acl` | String | Optional | 객체에 적용할 접근 제어 목록 - `private` \| `public-read` \| `public-read-write` \| `authenticated-read` | | `--content-type` | String | Optional | 명시적인 콘텐츠 유형 정의 | | `--only-show-errors` | Boolean | Optional | 에러만 표시하고 다른 응답값은 미표시 | | `--no-progress` | Boolean | Optional | 파일 전송 진행률 미표시 - `--quiet` 또는 `--only-show-errors`가 지정된 경우, 미적용 | | `--page-size` | Integer | Optional | 페이지당 항목 수 - `1`~`1000` | | `--metadata` | String | Optional | 객체와 함께 저장할 메타데이터 설정 | | `--metadata-directive` | String | Optional | 동기화 시 메타데이터 처리 방식 - `COPY` (기본값) \| `REPLACE` - `COPY`: 원본 복사 - `REPLACE`: 재정의 | | `--size-only` | Boolean | Optional | 객체 크기만을 기준으로 동기화 여부 결정 | | `--exact-timestamps` | Boolean | Optional | 크기가 같은 객체는 타임스탬프가 정확히 일치하는 경우에만 동기화 대상에서 제외 - Object Storage에서 로컬로 동기화하는 경우에만 적용 | | `--delete` | Boolean | Optional | 원본에는 없고 대상 경로에만 있는 객체 삭제 | ### 공통 옵션 `aws` 명령에서 공통으로 사용하는 옵션에 대한 정보는 [Object Storage 옵션](/docs/guide-objectstorage#%EC%98%B5%EC%85%98)을 참조해 주십시오. ## 예시 요청이 성공하면 동기화된 객체의 원본 경로와 대상 경로가 출력됩니다. ### 명령 버킷의 객체를 로컬 디렉터리로 동기화하는 명령 예시는 다음과 같습니다. ``` aws s3 sync s3://my-test-bucket ./local-dir \ --endpoint-url=https://kr.object.ncloudstorage.com ``` 로컬 디렉터리의 파일을 버킷으로 동기화하는 명령 예시는 다음과 같습니다. ``` aws s3 sync ./local-dir s3://my-test-bucket \ --endpoint-url=https://kr.object.ncloudstorage.com ``` 버킷의 객체를 다른 버킷으로 동기화하면서 원본에 없는 파일을 삭제하는 명령 예시는 다음과 같습니다. ``` aws s3 sync s3://my-test-bucket s3://my-backup-bucket \ --delete \ --endpoint-url=https://kr.object.ncloudstorage.com ``` 참고 awscli 2 버전에서는 동기화 명령 실행 시 지원하지 않는 API를 호출하여 오류가 발생할 수 있으므로 1.15.x 버전 사용을 권장합니다. ### 출력 버킷의 객체를 로컬 디렉터리로 동기화하는 출력 예시는 다음과 같습니다. ``` Completed 87 Bytes/87 Bytes (1012 Bytes/s) with 2 file(s) remaining download: s3://my-test-bucket/sample.txt to local-dir/sample.txt Completed 87 Bytes/87 Bytes (1012 Bytes/s) with 1 file(s) remaining download: s3://my-test-bucket/docs/report.txt to local-dir/docs/report.txt ``` 로컬 디렉터리의 파일을 버킷으로 동기화하는 출력 예시는 다음과 같습니다. ``` Completed 24 Bytes/24 Bytes (613 Bytes/s) with 1 file(s) remaining upload: local-dir/notes.txt to s3://my-test-bucket/notes.txt ``` 버킷의 객체를 다른 버킷으로 동기화하면서 원본에 없는 파일을 삭제한 출력 예시는 다음과 같습니다. ``` delete: s3://my-backup-bucket/obsolete.txt ```