syncコマンドを実行すると、同じリージョンにあるObject Storage Service (OSS) バケット間、または同じバケットのディレクトリ間で、複数のオブジェクトを同時に同期できます。
使用上の注意
OSSディレクトリ間でオブジェクトを同期するには、
oss:GetObject、oss:ListObjects、oss:PutObject、およびoss:DeleteObject権限が必要です。 詳細については、「RAMユーザーへのカスタムポリシーのアタッチ」をご参照ください。同期コマンドを使用して、Cold ArchiveオブジェクトまたはDeep Cold Archiveオブジェクトをソースバケットから宛先バケットに同期することはできません。
コマンド構文
ossutil sync cloud_url cloud_urlパラメーター | 必須 | 説明 |
cloud_url | String | ソースパスと宛先パス。 パスは 重要
|
-- acl | String | オブジェクトのアクセス制御リスト (ACL) 。 有効な値:
|
-- backup-dir | String | バックアップディレクトリ。 |
-- bigfile-threshold | int | マルチパートアップロード、ダウンロード、コピーのオブジェクトサイズのしきい値。 デフォルト値: 104857600 |
-- cache-control | String | オブジェクトがダウンロードされたときのwebブラウザでのキャッシュ動作。 |
-- checkpoint-dir | String | チェックポイントファイルが保存されているディレクトリ。 デフォルト値: |
-チェックサム | / | 次のいずれかの条件が満たされた場合にのみ、ソースオブジェクトをコピーすることを指定します。 a. ソースオブジェクトのサイズが宛先オブジェクトのサイズと異なる。 つまり、ソースオブジェクトのCRC-64は宛先オブジェクトのサイズと異なりますが、ソースオブジェクトのサイズは宛先オブジェクトのサイズと同じです。 このメソッドは、あるバケットから別のバケットにオブジェクトをコピーする場合にのみ使用されます。 |
-- content-disposition | String | オブジェクトの表示モード。 |
-- content-encoding | String | オブジェクトのエンコードに使用されるエンコード方法。 |
-- content-type | String | オブジェクトのコンテンツタイプ。 |
-- コピー小道具 | String | ソースオブジェクトからコピーする属性。The attributes to copy from the source object. 有効な値:
|
-- 削除 | / | 宛先パスに存在するが、ソースパスには存在しないオブジェクトを削除します。 |
-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 | 宛先オブジェクトのメタデータを設定するために使用されるメソッド。 有効な値:
|
-- 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 | オブジェクトのストレージクラス。 有効な値:
|
-- タグ付け | 文字列 | キー=値ペアのオブジェクトのタグ。 |
-- tagging-directive | String | 宛先オブジェクトのタグを設定するために使用されるメソッド。 有効な値:
|
-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