---
title: "cp"
slug: "cp"
updated: 2026-10-08T09:46:37Z
published: 2026-10-08T09:46:37Z
canonical: "cli.ncloud-docs.com/cp"
---

> ## Documentation Index
> Fetch the complete documentation index at: https://cli.ncloud-docs.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 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`の必須オプションです。

| オプション | タイプ | 必須の有無 | 説明 |
| --- | --- | --- | --- |
| `&lt;source&gt;` | String | Required | 元のパス - ローカルパスまたは`s3://{bucket_name}[/{object_name}]`形式の S3 URI |
| `&lt;destination&gt;` | 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のオプション](/docs/ja/storage-ncloudstorage#%EC%98%B5%EC%85%98)をご参照ください。

## 例

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

### コマンド

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

```
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
```