The cp
command is used to upload, download, or copy objects.
./coscli cp <source_path> <destination_path> [flags]
Note:
- For more information on
bucketAlias
, see Download and Installation Configuration.- For other common options of this command (such as switching bucket and user account), see Common Options.
cp
includes the following optional flags:
Flag Abbreviation | Flag Name | Description |
---|---|---|
None | --include | Includes specific objects. |
None | --exclude | Excludes specific objects. |
-r | --recursive | Specifies whether to traverse all objects in the directory recursively |
None | --storage-class | Specifies the storage class for the object to upload. Default value: STANDARD |
None | --part-size | Part size. Default value: 32 MB |
None | --thread-num | Number of concurrent threads. Default value: 5 |
None | --rate-limiting | Speed limit for a single URL. Value range: 0.1-100 MB/s |
Note:
cp
automatically uses concurrent upload/download for large objects.- If an object is larger than
--part-size
, COSCLI will split the object into multiple parts according to--part-size
and use--thread-num
threads to concurrently upload/download the object.- Each thread maintains a URL. For each URL, you can use the
--rate-limiting
parameter to limit the speed of a single URL. When concurrent upload/download is enabled, the total rate is--thread-num * --rate-limiting
.- If an object is uploaded/downloaded in parts, checkpoint restart will be enabled by default.
--include
and--exclude
support standard regular expression syntax, so you can use them to filter files that meet specific criteria.- When using
zsh
, you may need to add double quotes at both ends of thepattern
string.
./coscli cp ~/test/ cos://bucket1/example/ -r --include ".*.mp4"
./coscli cp ~/example.txt cos://bucket1/example.txt
test
to the example
directory in the bucket1
bucket./coscli cp ~/test/ cos://bucket1/example/ -r
test
to the example
directory in the bucket1
bucket./coscli cp ~/test/ cos://bucket1/example/ -r --include .*.mp4
test
to the example
directory in the bucket1
bucket./coscli cp ~/test/ cos://bucket1/example/ -r --exclude .*.md
dir
directory (containing the dirA
, dirB
, dirC
, and dirD
subdirectories) except the dirD
directory./coscli cp dir/ cos://bucket1/example/ -r --exclude dirD/.*
test
to the example
directory in the bucket1
bucket using the ARCHIVE storage class./coscli cp ~/test/ cos://bucket1/example/ -r --storage-class ARCHIVE
./coscli cp cos://bucket1/example.txt ~/example.txt
example
directory in the bucket1
bucket to the test
directory./coscli cp cos://bucket1/example/ ~/test/ -r
example
directory in the bucket1
bucket to the test
directory./coscli cp cos://bucket1/example/ ~/test/ -r --include .*.mp4
example
directory in the bucket1
bucket to the test
directory./coscli cp cos://bucket1/example/ ~/test/ -r --exclude .*.md
./coscli cp cos://bucket1/example.txt cos://bucket1/example_copy.txt
./coscli cp cos://bucket1/example.txt cos://bucket2/example_copy.txt
example1
directory in bucket1
to the example2
directory in bucket2
./coscli cp cos://bucket1/example1/ cos://bucket2/example2/ -r
example1
directory in bucket1
to the example2
directory in bucket2
./coscli cp cos://bucket1/example1/ cos://bucket2/example2/ -r --include .*.mp4
example1
directory in bucket1
to the example2
directory in bucket2
./coscli cp cos://bucket1/example1/ cos://bucket2/example2/ -r --exclude .*.md
Was this page helpful?