cp

Classic/VPC環境で利用できます。

バケットにオブジェクトをアップロードしたり、既にアップロードしたオブジェクトをローカルにダウンロードまたは別の場所にコピーしたりします。

構文

cp構文は次の通りです。

aws s3 cp \
    <source> \
    <destination> \
    [--dryrun] \
    [--quiet] \
    [--include <include>] \
    [--exclude <exclude>] \
    [--recursive] \
    [--follow-symlinks | --no-follow-symlinks] \
    [--no-guess-mime-type] \
    [--storage-class <storage-class>] \
    [--content-type <content-type>] \
    [--cache-control <cache-control>] \
    [--content-disposition <content-disposition>] \
    [--content-encoding <content-encoding>] \
    [--content-language <content-language>] \
    [--only-show-errors] \
    [--no-progress] \
    [--page-size <page-size>] \
    [--ignore-glacier-warnings] \
    [--metadata <metadata>] \
    [--copy-props <copy-props>] \
    [--metadata-directive <metadata-directive>] \
    --endpoint-url <endpoint-url>

オプション

cpの実行時に指定できるオプションについて説明します。

必須オプション

cpの必須オプションです。

オプション	タイプ	必須の有無	説明
`<source>`	String	Required	元のパスローカルパスまたは`s3://{bucket_name}[/{object_name}]`形式の S3 URI
`<destination>`	String	Required	コピー先のパスローカルパスまたは`s3://{bucket_name}[/{object_name}]`形式の S3 URI

任意オプション

cpの任意オプションです。指定しない場合、オプションにはデフォルト値が適用されます。

オプション	タイプ	必須の有無	説明
`--dryrun`	Boolean	Optional	コマンドを実行せずに結果だけを確認
`--quiet`	Boolean	Optional	レスポンス結果を表示しない
`--include`	String	Optional	指定したパターンと一致するオブジェクトのみがコマンドに含める指定した順序で適用
`--exclude`	String	Optional	指定したパターンと一致するオブジェクトをコマンドから除外指定した順序で適用
`--recursive`	Boolean	Optional	指定したパスの配下の項目までコピー
`--follow-symlinks`, `--no-follow-symlinks`	Boolean	Optional	シンボリックリンクが指すファイルのコンテンツをアップロードするかデフォルト: `--follow-symlinks` ローカルファイルシステムからオブジェクトをアップロードする場合のみ対象
`--no-guess-mime-type`	Boolean	Optional	アップロードするオブジェクトのコンテンツタイプの自動推測を無効化
`--storage-class`	String	Optional	オブジェクトを保存するストレージクラスを指定 `STANDARD` (デフォルト) \| `ONEZONE_IA` \| `DEEP_ARCHIVE`
`--content-type`	String	Optional	明示的なコンテンツタイプ定義
`--cache-control`	String	Optional	キャッシュ動作を設定
`--content-disposition`	String	Optional	オブジェクトの表示方式を指定
`--content-encoding`	String	Optional	コンテンツエンコードを設定
`--content-language`	String	Optional	コンテンツ言語を設定
`--only-show-errors`	Boolean	Optional	エラーのみ表示し、その他のレスポンス値は表示しない
`--no-progress`	Boolean	Optional	ファイル転送の進捗率を表示しない `--quiet`または`--only-show-errors`が指定されている場合は適用しない
`--page-size`	Integer	Optional	ページごとの項目数 `1`~`1000`
`--ignore-glacier-warnings`	Boolean	Optional	Deep Archiveにあるオブジェクトに対する変更操作(コピー、ダウンロード、移動など)に対応していないという警告を表示しない
`--metadata`	String	Optional	オブジェクトと併せて保存するメタデータを設定
`--copy-props`	String	Optional	コピー元のオブジェクトからコピーする属性を設定 `none` \| `metadata-directive` \| `default` (デフォルト) `none`: 属性をコピーしない `metadata-directive`: コンテンツ関連の属性とメタデータをコピー `default`: `metadata-directive`対象属性にタグを追加コピー Ncloud Storageから Ncloud Storageへコピーする場合のみ適用
`--metadata-directive`	String	Optional	コピー時のメタデータ処理方式 `COPY`(デフォルト)\| `REPLACE` `COPY`: 元のメタデータをコピー `REPLACE`: 再定義

共通オプション

awsコマンドで共通して使用するオプションについては、Ncloud Storageのオプションをご参照ください。

例

リクエストが成功すると、実行した操作のタイプとともに、コピー元のパスとコピー先のパスが出力されます。

コマンド

ローカルファイルをバケットにアップロードするコマンドの例は次の通りです。

aws s3 cp sample.txt s3://my-test-bucket/docs/sample.txt \
    --endpoint-url=https://kr.ncloudstorage.com

バケット内の別のパスにオブジェクトをコピーするコマンドの例は次の通りです。

aws s3 cp s3://my-test-bucket/img/image.png s3://my-test-bucket/img/copy.png \
    --endpoint-url=https://kr.ncloudstorage.com

オブジェクトのストレージクラスを変更するコマンドの例は次の通りです。

aws s3 cp s3://my-test-bucket/img/copy.png s3://my-test-bucket/img/copy.png \
    --storage-class DEEP_ARCHIVE \
    --endpoint-url=https://kr.ncloudstorage.com

バケット内のオブジェクトをローカルにダウンロードするコマンドの例は次の通りです。

aws s3 cp s3://my-test-bucket/docs/sample.txt ./ \
    --endpoint-url=https://kr.ncloudstorage.com

出力

ローカルファイルをバケットにアップロードする出力の例は次の通りです。

upload: ./sample.txt to s3://my-test-bucket/docs/sample.txt

バケット内の異なるパスにオブジェクトをコピーする出力の例は次の通りです。

copy: s3://my-test-bucket/img/image.png to s3://my-test-bucket/img/copy.png

オブジェクトのストレージクラスを変更する出力の例は次の通りです。

copy: s3://my-test-bucket/img/copy.png to s3://my-test-bucket/img/copy.png

バケット内のオブジェクトをローカルにダウンロードする出力の例は次の通りです。

download: s3://my-test-bucket/docs/sample.txt to ./sample.txt