Classic/VPC環境で利用できます。
Ncloud Storageに作成されたバケット同士またはローカルディレクトリとフォルダとオブジェクトを同期します。コマンド
コマンド構文は次の通りです。
aws s3 sync <source> <destination> --endpoint-url <value> [--options]
パラメータ
パラメータの説明は次の通りです。
| パラメータ | タイプ | 必須の有無 | 説明 | 制限事項 |
|---|---|---|---|---|
| --endpoint-url <value> | string | Y | コマンド呼び出しのデフォルト URLを指定 | krリージョンのみ対応、呼び出しドメイン情報はNcloud Storageの概要を参照 |
| --dryrun | boolean | N | 動作の実行結果だけ確認し、実際には未適用 | - |
| --quiet | boolean | N | レスポンス結果を表示しない | - |
| --include <value> | string | N | 指定されたオブジェクトのみコマンドに含めるようにルールを設定、指定された順番で適用 | - |
| --exclude <value> | string | N | 指定されたオブジェクトはコマンドの対象外になるようにルールを設定、指定された順番で適用 | - |
| --follow-symlinksまたは--no-follow-symlinks | boolean | N | アップロードするファイルのシンボリックリンクのコンテンツをアップロードするかどうか設定 | ローカルファイルシステムからオブジェクトをアップロードする場合に限る |
| --no-guess-mime-type | boolean | N | アップロードされたオブジェクトのコンテンツタイプの自動指定を無効化 | - |
| --storage-class <value> | string | N | オブジェクトを保存するストレージクラスを指定 | 選択可能なオプション - STANDARD - DEEP_ARCHIVE * デフォルトは Standardクラスに保存 |
| --content-type <value> | string | N | 明示的なコンテンツタイプ定義 | - |
| --cache-control <value> | string | N | キャッシュ動作の設定 | - |
| --content-disposition <value> | string | N | オブジェクトに対する表現情報を指定 | - |
| --content-encoding <value> | string | N | テンプレートエンコード設定 | - |
| --content-language <value> | string | N | コンテンツ言語設定 | - |
| --only-show-errors | boolean | N | エラーのみ表示、その他のレスポンス値は表示しない | - |
| --no-progress | boolean | N | ファイル転送の進捗率を表示しない | --quiteまたは--only-show-errosが指定された場合、未適用 |
| --page-size <value> | integer | N | レスポンスごとのリスト項目数を指定 | 最大1,000個までサポート |
| --ignore-glacier-warnings | boolean | N | Deep Archiveにあるオブジェクトに対する変更(コピー、ダウンロード、移動など)に未対応に関する警告を表示しない | - |
| --metadata <value> | string | N | オブジェクトと一緒に保存するメタデータを設定 | - |
| --copy-props <value> | string | N | ソースオブジェクトからコピーする属性を設定 | Ncloud Storageから Ncloud Storageにコピーする場合にのみ適用 |
| --metadata-directive <value> | string | N | CopyObject操作に対する x-amz-metadata-directiveヘッダを設定 | このオプションが設定されている場合、--copy-propsは無効化する |
| --size-only | boolean | N | keyのサイズのみを基準に同期するかどうかを決定するように適用 | - |
| --exact-timestamps | boolean | N | Ncloud Storageからローカルに同期する際に、Ncloud Storageとローカルにある同じサイズのオブジェクトのタイムスタンプが完全に一致する場合を除く | - |
| --delete | boolean | N | ソースバケットまたはローカルディレクトリと比較してソースにはないが、同期目的地のバケットまたはディレクトリにのみあるオブジェクトは同期中に削除するように設定 | - |
| --debug | boolean | N | デバッグロギングを使用 | - |
| --no-verify-ssl | boolean | N | SSL証明書を検証する基本動作を再定義 | - |
| --no-paginate | boolean | N | 自動 pagination無効化、結果に対して最初のページが一度だけ呼び出される | - |
| --output <value> | string | N | レスポンスの形式を指定 | 選択可能なオプション - json - text - table - yaml - yaml-stream |
| --query <value> | string | N | レスポンスデータの絞り込みに使用する JMESPathクエリ | - |
| --profile <value> | string | N | 認証情報ファイルで特定の profileを使用 | - |
| --region <value> | string | N | リージョンを指定 | krのみ対応 |
| --color <value> | string | N | output color設定 | 選択可能なオプション - on - off - auto |
| --no-sign-request | boolean | N | 認証情報のロードを無効化 | - |
| --ca-bundle <value> | string | N | SSL証明書の確認時に使用する CA証明書を指定 | - |
| --cli-read-timeout <value> | int | N | 最大読み取り時間、0を入力するとタイムアウトではなく、ブロック状態に変更される | デフォルトは60秒に設定 |
| --cli-connect-timeout <value> | int | N | 最大接続時間、0を入力するとタイムアウトではなく、ブロック状態に変更される | デフォルトは60秒に設定 |
| --no-cli-pager | boolean | N | レスポンスの cli pagerを無効化 | - |
| --cli-auto-prompt | boolean | N | CLI入力パラメータの自動プロンプト設定 | - |
| --no-cli-auto-prompt | boolean | N | CLI入力パラメータの自動プロンプトを無効化 | - |
例
syncコマンドの呼び出し例とレスポンス例を説明します。
指定された Ncloud Storageのバケットを別のバケットで同期
呼び出し例
同期したいソースバケットと対象バケットを指定してコマンドを呼び出すと、ソースバケットのオブジェクトをコピーして同期します。この時、Standard Classに保存されているか、復元が完了した Deep Archive Classに保存されているオブジェクトのみコピーされます。呼び出しのサンプルコードは次の通りです。
aws s3 sync s3://bucket-aa s3://bucket-sync --endpoint-url=http://kr.ncloudstorage.com
レスポンス例
レスポンスのサンプルコードは次の通りです。
copy: s3://bucket-aa/log-2412/241202120123.txt to s3://bucket-sync/log-2412/241202120123.txt
copy: s3://bucket-aa/image4.png to s3://bucket-sync/image4.png
copy: s3://bucket-aa/image3.png to s3://bucket-sync/image3.png
warning: Skipping file s3://bucket-aa/log-2412/image.png. Object is of storage class GLACIER. Unable to perform copy operations on GLACIER objects. You must restore the object to be able to perform the operation. See aws s3 copy help for additional parameter options to ignore or force these transfers.
warning: Skipping file s3://bucket-aa/log-2412/image2.png. Object is of storage class GLACIER. Unable to perform copy operations on GLACIER objects. You must restore the object to be able to perform the operation. See aws s3 copy help for additional parameter options to ignore or force these transfers.
ローカルオブジェクトを指定された Ncloud Storageバケットに同期し、一致しないすべてのオブジェクトを削除
呼び出し例
--deleteオプションを利用してコマンドを呼び出すと、同期目的地のバケットまたはディレクトリからソースにないオブジェクトを削除できます。
aws s3 sync ./sync/ s3://bucket-sync --endpoint-url=http://kr.ncloudstorage.com --delete
レスポンス例
レスポンスのサンプルコードは次の通りです。
delete: s3://bucket-sync/image.png
delete: s3://bucket-sync/image2.png
upload: sync/image/4.png to s3://bucket-sync/image/4.png
upload: sync/image/1.png to s3://bucket-sync/image/1.png
delete: s3://bucket-sync/log-2412/241201120224.txt
delete: s3://bucket-sync/log-2412/241203120012.txt
upload: sync/document/1.pdf to s3://bucket-sync/document/1.pdf
delete: s3://bucket-sync/ncs_5.png
delete: s3://bucket-sync/ncloudstorage5.pptx
Ncloud Storageバケットに保存されたオブジェクトのうち、特定の prefix下位のオブジェクトを除いたすべてのオブジェクトをローカルディレクトリに同期
呼び出し例
--recursiveオプションを使用すると、prefix下位のすべてのオブジェクトを含めて照会できます。さらに、--summarizeオプションを使用するとそのバケットまたは特定の prefix下位に保存されたオブジェクトの総数とサイズを確認できます。呼び出しのサンプルコードは次の通りです。
aws s3 sync s3://bucket-sync ./ncs/ --endpoint-url=http://kr.ncloudstorage.com --exclude "*document/*"
レスポンス例
レスポンスのサンプルコードは次の通りです。
download: s3://bucket-sync/test.txt to ncs/test.txt
download: s3://bucket-sync/test2.txt to ncs/test2.txt
download: s3://bucket-sync/test3.txt to ncs/test3.txt
download: s3://bucket-sync/image/4.png to ncs/image/4.png
download: s3://bucket-sync/image/1.png to ncs/image/1.png