tencent cloud

フィードバック

ファイルの同時アップロード・ダウンロードまたはコピー - sync

最終更新日:2024-07-04 16:48:52

    コマンド形式

    syncコマンドは、ファイルのアップロード・ダウンロード・コピーを同期させるときに使います。cpコマンドと異なる点は、syncコマンドはまず同名ファイルのcrc64を比較し、crc64の値が同じ場合は転送を行わない点です。
    ./coscli sync <source_path> <destination_path> [flag]
    説明:
    bucketAliasについては、設定をご参照ください。
    syncコマンドには、以下のオプションflagが含まれます。
    flagの略称
    flagの正式名称
    flagの用途
    -h
    --help
    ヘルプ情報を出力
    -c
    --config-path
    使用する設定ファイルパスを指定
    なし
    --include
    特定のモードを含むファイル
    なし
    --exclude
    特定のモードを除外したファイル
    -r
    --recursive
    フォルダ内のすべてのファイルを再帰的にトラバーサル処理するかどうか
    なし
    --storage-class
    アップロードするファイルのタイプを指定(デフォルトはSTANDARD)
    なし
    --part-size
    ファイルチャンクサイズ(デフォルトは32MB)
    なし
    --thread-num
    同時実行スレッド数(デフォルトの同時実行は5)
    なし
    --rate-limiting
    シングルリンクレート制限(0.1~100MB/s)
    なし
    --routines
    파일 간 동시 업로드 또는 다운로드 스레드의 파일 수를 지정하며, 기본값은 3입니다.
    なし
    --fail-output
    이 옵션은 업로드 또는 다운로드가 실패할 때 파일의 오류 출력을 활성화할지 여부를 결정합니다(기본값은 true, 활성화). 활성화되면 실패한 파일 전송은 지정된 목록(지정하지 않은 경우 기본값은 ./coscli_output임)에 기록됩니다. 비활성화되면 실패한 파일의 수만 콘솔로 출력됩니다.
    なし
    --fail-output-path
    이 옵션은 업로드 또는 다운로드 실패를 기록하는 파일의 오류 출력 폴더를 지정하는 데 사용됩니다. 사용자 정의 폴더 경로를 제공함으로써 오류 출력 폴더의 위치 및 이름을 제어할 수 있다. 이 옵션을 설정하지 않은 경우 기본 오류 로그 폴더 ./coscli_output를 사용합니다.
    なし
    --retry-num
    빈도 제한 재시도 횟수(기본값은 0, 재시도하지 않음). 1-10회 선택 가능. 여러 대의 컴퓨터가 동시에 동일한 COS 목록에서 다운로드 작업을 실행하는 경우, 이 매개변수를 지정하여 재시도함으로써 빈도 제한 오류를 피할 수 있습니다.
    なし
    --err-retry-num
    오류 재시도 횟수(기본값은 0임). 1-10회로 지정하거나 0으로 설정하여 재시도하지 않음을 나타냅니다.
    なし
    --err-retry-interval
    재시도 간격(--err-retry-num1-10로 지정할 때에만 사용 가능). 1-10초의 재시도 간격을 지정하며, 지정하지 않거나 0으로 설정한 경우 매번 재시도 간격은 1-10초 내에서 무작위로 선택됩니다.
    なし
    --only-current-dir
    현재 목록의 파일만 업로드하고 하위 목록 및 그 내용을 무시할지 여부(기본값은 false, 무시하지 않음).
    なし
    --disable-all-symlink
    업로드 시 모든 심볼릭 링크의 하위 파일 및 심볼릭 링크의 하위 목록을 무시할지 여부(기본값은 true, 업로드하지 않음).
    なし
    --enable-symlink-dir
    심볼링 링크의 하위 목록 업로드할지 여부(기본값은 false, 업로드하지 않음).
    なし
    --disable-crc64
    CRC64 데이터 검증 비활성화 여부 (기본값은 false, 검증 활성화).
    なし
    --delete
    지정된 타겟 경로에 있는 임의의 기타 파일을 삭제하고 이번 동기화된 파일만 유지(기본값은 false, 삭제하지 않음) 실수로 데이터가 삭제되는 것을 방지하기 위해 --delete 옵션을 사용하기 전에 버전 제어를 활성화하는 것이 좋습니다.
    なし
    --backup-dir
    타겟측에서 이미 삭제되었지만 소스측에 존재하지 않는 파일을 저장하기 위해 삭제된 파일의 백업을 동기화합니다(다운로드할 때에만 유효하고 --delete=true 시 필히 지정). 업로드 및 버킷 복제는 버전 제어를 사용하여 실수로 삭제되는 데이터를 복구하시기 바랍니다.
    なし
    --force
    확인 알림이 없는 강제 작업 (기본값은 false).
    説明:
    syncコマンドは、大容量ファイルのアップロードやダウンロードを行う場合、アップロード/ダウンロードの同時実行を自動的に有効にします。
    ファイルが--part-sizeよりも大きい場合、COSCLIはまず--part-sizeに従ってファイルをチャンクにし、次に--thread-num個のスレッドを使用してアップロード/ダウンロードのタスクを同時に実行します。
    各スレッドは1つのリンクを維持します。各リンクに対して--rate-limitingパラメータを使用すると、シングルリンクのレート制限ができます。同時アップロード/ダウンロードが有効な場合、合計レートは、--thread-num * --rate-limitingとなります。
    ファイルをチャンクでアップロード/ダウンロードする場合、デフォルトで中断からの再開が有効になります。
    --include--excludeは標準的な正規表現の構文をサポートしており、これを使えば特定の条件を満たすファイルをフィルタリングすることができます。
    zshを使用する場合、pattern文字列の両端に二重引用符を付ける必要がある場合があります。

    操作事例

    ファイルの同時アップロード

    ./coscli sync ~/example.txt cos://bucket1/example.txt

    ファイルの同時ダウンロード

    ./coscli sync cos://bucket1/example.txt ~/example.txt

    バケット内でのファイル同期コピー

    ./coscli sync cos://bucket1/example.txt cos://bucket1/example_copy.txt

    バケット間でのファイル同期コピー

    ./coscli sync cos://bucket1/example.txt cos://bucket2/example_copy.txt
    お問い合わせ

    カスタマーサービスをご提供できるため、ぜひお気軽にお問い合わせくださいませ。

    テクニカルサポート

    さらにサポートが必要な場合は、サポートチケットを送信して弊社サポートチームにお問い合わせください。24時間365日のサポートをご提供します。

    電話サポート(24 時間365日対応)