すべてのプロダクト
Search
ドキュメントセンター

Object Storage Service:OSSパス間でオブジェクトを同期する

最終更新日:Oct 14, 2024

syncコマンドを実行すると、同じリージョンにあるObject Storage Service (OSS) バケット間、または同じバケットのディレクトリ間で、複数のオブジェクトを同時に同期できます。

使用上の注意

  • OSSディレクトリ間でオブジェクトを同期するには、oss:GetObjectoss:ListObjectsoss:PutObject、およびoss:DeleteObject権限が必要です。 詳細については、「RAMユーザーへのカスタムポリシーのアタッチ」をご参照ください。

  • 同期コマンドを使用して、Cold ArchiveオブジェクトまたはDeep Cold Archiveオブジェクトをソースバケットから宛先バケットに同期することはできません。

コマンド構文

ossutil sync cloud_url cloud_url

パラメーター

必須

説明

cloud_url

String

ソースパスと宛先パス。 パスはoss:// bucketname/path/ 形式です。 たとえば、examplebucketのsrcdirディレクトリを同じバケットのdestdirディレクトリに同期するには、ソースパスをoss:// examplebucket/srcdir/ に設定し、宛先パスをoss:// examplebucket/destcdir/ に設定します。

重要

cloud_urlをスラッシュ (/) で終わらない値に設定した場合、ossutilは自動的に値の末尾に1つを追加します。

-- acl

String

オブジェクトのアクセス制御リスト (ACL) 。 有効な値:

  • private: プライベート

  • public-read: public-read。

  • public-read-write: public-read-write

  • default: バケットから継承

-- backup-dir

String

バックアップディレクトリ。

-- bigfile-threshold

int

マルチパートアップロード、ダウンロード、コピーのオブジェクトサイズのしきい値。 デフォルト値: 104857600

-- cache-control

String

オブジェクトがダウンロードされたときのwebブラウザでのキャッシュ動作。

-- checkpoint-dir

String

チェックポイントファイルが保存されているディレクトリ。 デフォルト値:. ossutil_checkpoint /.

-チェックサム

/

次のいずれかの条件が満たされた場合にのみ、ソースオブジェクトをコピーすることを指定します。 a. ソースオブジェクトのサイズが宛先オブジェクトのサイズと異なる。 つまり、ソースオブジェクトのCRC-64は宛先オブジェクトのサイズと異なりますが、ソースオブジェクトのサイズは宛先オブジェクトのサイズと同じです。 このメソッドは、あるバケットから別のバケットにオブジェクトをコピーする場合にのみ使用されます。

-- content-disposition

String

オブジェクトの表示モード。

-- content-encoding

String

オブジェクトのエンコードに使用されるエンコード方法。

-- content-type

String

オブジェクトのコンテンツタイプ。

-- コピー小道具

String

ソースオブジェクトからコピーする属性。The attributes to copy from the source object. 有効な値:

  • none

  • metadata

  • default

-- 削除

/

宛先パスに存在するが、ソースパスには存在しないオブジェクトを削除します。

-d, -- dirs

/

すべてのサブディレクトリ内のすべてのオブジェクトを再帰的に表示するのではなく、現在のディレクトリ内のオブジェクトとサブディレクトリをリストします。

-- encoding-type

String

オブジェクト名またはファイル名のエンコードに使用されるエンコード方法。 有効値: url

-- end-with

String

-- end-withパラメーターの値の前または同じ名前のオブジェクトが返されるように指定します。

-除外

stringArray

パスまたはオブジェクト名の除外ルール。

-- exclude-from

stringArray

ファイルから除外ルールを読み取ります。

-- 有効期限

String

キャッシュされたコンテンツの絶対有効期限。

-- files-から

stringArray

空行またはコメント行を無視して、ファイルからソースオブジェクト名のリストを読み取ります。

-- files-from-raw

stringArray

ファイルからソースオブジェクト名のリストを読み取ります。

-- フィルター

stringArray

パスまたはオブジェクト名のフィルタールール。

-- filter-from

stringArray

ファイルからフィルタールールを読み取ります。

-f、-- 力

/

確認を必要とせずに操作を強制します。

-含む

stringArray

パスまたはオブジェクト名の包含ルール。

-- include-from

stringArray

ファイルから包含ルールを読み取ります。

-j, -- job

int

マルチオブジェクト処理の同時ジョブ数。 デフォルト値:3。

-- list-objects

/

ListObjects操作を呼び出してオブジェクトを一覧表示します。

-最大年齢

有効期間

最終変更時刻がこのパラメーターの値より前のオブジェクトを除外します。 デフォルトの単位はs (秒) です。 ミリ秒はms、秒はs、分はm、時間はh、日はd、週はw、月はM、年はyの単位で数値をサフィックスできます。

-- max-mtime

時間

最終変更時刻がこのパラメーターの値より後のオブジェクトを除外します。 時刻は UTC である必要があります。

-最大サイズ

SizeSuffix

転送できるオブジェクトの最大サイズ。 デフォルトでは、サイズはバイト (B) 単位です。 数値に1024ベースの単位 (Bはbyte、KはKibibyte、MはMebibyte、GはGibibyte、TはTebibyte、PはPebibyte) でサフィックスを付けることができます。

-- max-sync-num

int

同期できるオブジェクトの最大数。 デフォルト値: 2000000 最大値: 5000000。

-- メタデータ

文字列

キー=値ペアのユーザーメタデータ。

-- metadata-ディレクティブ

String

宛先オブジェクトのメタデータを設定するために使用されるメソッド。 有効な値:

  • COPY

  • REPLACE

-- metadata-除外

stringArray

オブジェクトメタデータの除外ルール。

-- metadata-filter

stringArray

オブジェクトメタデータのフィルタールール。

-- metadata-filter-from

stringArray

ファイルからメタデータフィルタールールを読み取ります。

-- metadata-include

stringArray

オブジェクトメタデータの包含ルール。

-- 最低年齢

有効期間

最終変更時刻がこのパラメーターの値より後のオブジェクトを除外します。 デフォルトの単位はs (秒) です。 ミリ秒はms、秒はs、分はm、時間はh、日はd、週はw、月はM、年はyの単位で数値をサフィックスできます。

-- min-mtime

時間

最終変更時刻がこのパラメーターの値より前のオブジェクトを除外します。 時刻は UTC である必要があります。

-- 最小サイズ

SizeSuffix

転送できるオブジェクトの最小サイズ。 デフォルトでは、サイズはバイト (B) 単位です。 数値に1024ベースの単位 (Bはbyte、KはKibibyte、MはMebibyte、GはGibibyte、TはTebibyte、PはPebibyte) でサフィックスを付けることができます。

-- 進歩なし

/

進行状況バーを非表示にします。

-- ページサイズ

int

返されるオブジェクトの最大数。 デフォルト値は 1000 です。 有効な値: 1 ~ 1000

-- 平行

int

1つのオブジェクトを処理するための同時ジョブの数。

-- 部分サイズ

SizeSuffix

部品サイズ。 デフォルトでは、部品サイズはオブジェクトサイズに基づいて自動的に計算されます。 部分のサイズは100 KiBから5 GiBまで及びます。

-r, -- recursive

/

オブジェクトに対して再帰的にコマンドを実行することを指定します。 このパラメーターが指定されている場合、コマンドはバケット内のすべての一致するオブジェクトに対して操作を実行します。 このパラメーターが指定されていない場合、コマンドは指定されたパス内の指定されたオブジェクトに対してのみ操作を実行します。

-- request-payer

String

リクエストの支払人。 pay-by-requesterが有効な場合は、このパラメーターを指定します。 有効値: requester。

-- サイズだけ

/

コピー先オブジェクトとファイルサイズが異なる場合にのみ、コピー元オブジェクトをコピーします。

-- start-after

String

-- start-afterパラメーターの値の後に名前がアルファベット順であるオブジェクトが返されることを指定します。

-- ストレージクラス

String

オブジェクトのストレージクラス。 有効な値:

  • 標準

  • IA

  • アーカイブ

  • ColdArchive

  • DeepColdArchive

-- タグ付け

文字列

キー=値ペアのオブジェクトのタグ。

-- tagging-directive

String

宛先オブジェクトのタグを設定するために使用されるメソッド。 有効な値:

  • COPY

  • REPLACE

-u, -- update

/

最後に変更された時刻が宛先オブジェクトの時刻よりも遅い場合にのみ、ソースオブジェクトをコピーします。

-- 無視-既存

/

既に存在するオブジェクトをスキップします。

説明

詳細については、「コマンドラインオプション」をご参照ください。

  • examplebucket1のexampledirディレクトリを同じバケットのsrcdirディレクトリに同期します。

    ossutil sync oss://examplebucket1/exampledir/  oss://examplebucket1/srcdir/
  • examplebucket1のexampledirディレクトリをexamplebucket2のdestdirディレクトリに同期します。

    ossutil sync oss://examplebucket1/exampledir/ oss://examplebucket2/destdir/
  • examplebucket1からexamplebucket2にすべてのオブジェクトを同期し、-- deleteオプションを使用して、examplebucket2に存在するがexamplebucket1には存在しないオブジェクトを削除します。

    ossutil sync oss://examplebucket1 oss://examplebucket2 --delete