config命令用于管理配置文件。
命令格式us3cli config [--ls][--su <配置名>][--rm <配置名>][--cat <配置名>][--encrypt][--ssl][--proxy [代理地址]]
[--accesskey ][--secretkey ][--endpoint <访问域名>]
参数说明 -a, --accesskey string :用于访问us3的API密钥或Token公钥
--cat string :打印指定配置项内容
--encrypt :是否配置加密
-e, --endpoint string :固定域名,可在地域和域名页查看
-h, --help :查看当前命令帮助
--ls :列出当前所有配置项
--proxy string :代理地址(ip:port)
--rm string :删除指定配置项
-s, --secretkey string :用于访问us3的API私钥或Token私钥
--ssl :使用https
--su string :切换指定配置为默认配置
配置文件内容说明:
配置项说明填写说明AccessKey用于鉴权的bucket公钥自定义配置文件格式,填写说明同上:
accesskey: "user accesskey"
secretkey: "user secretkey"
endpoint: "ufile.cn-north-02.ucloud.cn"
encrypt: "false"
enablessl: "false"
proxy: "http://ip:port or https://ip:port"
使用示例1.交互式配置
创建配置项#./us3cli config
请输入当前配置项名称: config1
开始创建新配置项:[ config1 ]
是否启用配置加密(y or n) ? n
请输入API/Token公钥[当前:]: xxxxxxxxxxxxxxxxxxxxxx
请输入API/Token私钥[当前:]: xxxxxxxxxxxxxxxxxxxxxx
地区列表:
No. RegionName Region
0 北京 cn-bj
1 上海二 cn-sh2
2 广州 cn-gd
3 香港 hk
4 洛杉矶 us-ca
5 新加坡 sg
6 雅加达 idn-jakarta
7 台北 tw-tp
8 拉各斯 afr-nigeria
9 圣保罗 bra-saopaulo
10 迪拜 uae-dubai
11 法兰克福 ge-fra
12 胡志明市 vn-sng
13 华盛顿 us-ws
14 孟买 ind-mumbai
15 首尔 kr-seoul
请输入region编号: 0
内外网列表:
No. Network
0 外网
1 内网
请选择或输入内外网编号:0
您选择的endpoint是:[cn-bj.ufileos.com],[当前:],请输入回车确认或自定义endponit:
当前最终配置:
ConfigName: config1
AccessKey: xxxxxxxxxxxxxxxxxxxxxx
SecretKey: xxxxxxxxxxxxxxxxxxxxxx
Endpoint: cn-bj.ufileos.com
请检查后输入回车确认:
是否启用HTTPS (y or n) ? n
是否启用代理(y or n):n
配置文件 [ config1 ] 已修改
是否使用该配置作为默认配置(当前默认配置为:< config >)(y or n)?
注意:
首次创建的配置文件时会自动将该配置作为默认配置配置加密只加密到公私钥,并且当前配置文件只在初次创建时可选是否加密填写代理地址时只需要填写“ ip:port”,客户端会根据填写的https启用状态补充需要的"https://"或“http://”头部信息列出配置项列表./us3cli config --ls
ConfigName ModTime FilePath Authority
config1 (Default) 2020-09-21 14:18:50 /root/.us3cliconfig/config1 Token
config2 2020-09-21 14:18:50 /root/.us3cliconfig/config2 Token
us3cli 2020-09-16 10:36:00 /root/.us3cliconfig/us3cli APIKey
说明:
1.Default标识表示该配置项是当前的默认配置
2.Authority表示权限分类,只用于快速区分Token和API密钥格式,不保证内容准确
切换配置项./us3cli config --su config2
删除配置项./us3cli config --rm config1
注意:以下所有命令的(y or n)选项规则均不区分大小写,输入yes或y表示确认,其他选项均表示取消
打印配置项./us3cli config --cat config2
ConfigName:config2
AccessKey: TOKEN_13be86*********
SecretKey: BAtrQO8LYdgve1HS_benbK-MXNTl3**********
Endpoint: cn-bj.ufileos.com
2.非交互式配置
./us3cli config config3 --accesskey TOKEN_AAGASGAZVZV**** --secretkey USAsflmTAAF****** --endpoint cn-bj.ufileos.com
Configuration file [ config3 ] has been updated
3.临时使用(对其他命令生效)
上传文件时临时使用配置项config3./us3cli cp test.txt us3://bucket1 --config config3
上传文件时临时使用配置文件 /home/ubuntu/myconfig1./us3cli cp test.txt us3://bucket1 --config /home/ubuntu/myconfig1
上传文件时使用自定义配置内容./us3cli cp test.txt us3://bucket1 --accesskey LTAI4G3t3BTza47xxxxxxxxxx --secretkey gznFs9daMtKmUaTq9xpxxxxxxxxxxxxx --endpoint cn-bj.ufileos.com
该命令用于创建存储空间
命令格式us3cli mb us3://<桶名字> [--acl <权限类型>][--region <桶所在地区>][--projectid <项目ID>]
参数说明 --accesskey <string> :用于访问us3的API公钥或Token公钥
-a, --acl <string> :权限类型,可以设置为private、public,默认为private私有(不区分大小写)
--config <string> :当前命令临时指定配置名/配置文件路径
--endpoint <string> :固定域名,可通过地域和域名页查看,如:cn-bj.ufileos.com
-h, --help :当前命令使用说明
--projectid <string> :项目ID,当前bucket属项目ID,默认为Default
-r, --region <string> :桶所在地区,可查看地域信息,默认地区为北京
--secretkey <string> :用于访问us3的API私钥或Token私钥
本命令提供命令输入和交互式输入二选一的操作,命令输入参数,就会自动跳过交互式输入。
使用示例交互式创建bucket./us3cli mb us3://us3cli-test
请输入要创建bucket的权限类型acl(private/public,默认为private):public
地区列表:
No. RegionName Region
0 北京 cn-bj
1 上海二 cn-sh2
2 广州 cn-gd
3 香港 hk
4 洛杉矶 us-ca
5 新加坡 sg
6 雅加达 idn-jakarta
7 台北 tw-tp
8 拉各斯 afr-nigeria
9 圣保罗 bra-saopaulo
10 迪拜 uae-dubai
11 法兰克福 ge-fra
12 胡志明市 vn-sng
13 华盛顿 us-ws
14 孟买 ind-mumbai
15 首尔 kr-seoul
请输入要创建bucket地区编号或地区代码(默认为北京:cn-bj):0
Region: cn-bj
当前账号下业务组分组信息如下:
No. ProjectName ProjectId
1 Default org-orcwsj
请输入要bucket的项目编号:1
Number: 1
ProjectID: org-orcwsj
Make bucket [ us3cli-test ] success
非交互式创建bucket,输入acl,region以及projectid信息,acl,region是必填项,projectid可不填./us3cli mb us3://us3cli-test --acl private --region cn-bj --projectid org-orcwsy
注意:若您的bucket不在默认项目下,bucket操作都需要加上--projectid参数,请创建bucket时自行记录projectid,或通过 ls 命令查看projectid
本命令用于删除存储空间
命令格式us3cli rb us3://<桶名字> [--projectid <项目ID>][--force]
参数说明 --accesskey <string> :用于访问us3的API公钥或Token公钥
--config <string> :当前命令临时指定配置名/配置文件路径
--endpoint <string> :固定域名,可通过地域和域名页查看
-f, --force :强制删除
-h, --help :当前命令使用说明
--projectid <string> :指定当前bucket所在projectid,可以在控制台查看,默认项目可忽略
--secretkey <string> :用于访问us3的API私钥或Token私钥
使用示例删除存储空间:存储空间必须为空,否则无法删除./us3cli rb us3://bucket1
The bucket [bucket1] is being deleted, continue(y or n)? y
Delete bucket [bucket1] success
本命令用于查看存储空间或文件信息
命令格式us3cli stat us3://<桶名字>[/<文件key>][--projectid <项目ID>]
参数说明 --accesskey <string> :用于访问us3的API公钥或Token公钥
--config <string> :当前命令临时指定配置名/配置文件路径
--endpoint <string> :固定域名,可通过地域和域名页查看
-h, --help :当前命令使用说明
--projectid <string> :指定当前bucket所在projectid,可以在控制台查看,默认项目可忽略
使用示例查看默认项目下存储空间bucket1的基本信息./us3cli stat us3://bucket1
BucketName: bucket1
Region: cn-bj
BucketId: ufile-dpgjzcn
Type: public
CreateTime: 2020-09-15 18:17:24
ModifyTime: 2020-09-15 18:17:24
查看us3://bucket1/test.txt的文件信息./us3cli stat us3://bucket1/aaa.txt
Name: aaa.txt
X-Ufile-Create-Time: Fri, 18 Sep 2020 10:09:05 GMT
X-Ufile-Storage-Class: STANDARD
Server: nginx/1.11.1
Date: Mon, 21 Sep 2020 11:17:56 GMT
Content-Type: application/octet-stream
Accept-Ranges: bytes
Etag: "AQAAAEpjpDD8COEdGg3uOeLfsR_ddQgc"
Content-Length: 4298
Last-Modified: Fri, 18 Sep 2020 10:09:05 GMT
Vary: Origin
该命令用于获取指定存储空间(Bucket)各存储类型的存储量大小,以及总存储量
注意:存储量结算时间为当前日期前一天0:00
命令格式us3cli du us3://<桶名字>[/<key>] [--force][--projectid <项目ID>]
参数说明 --accesskey <string> :用于访问us3的API公钥或Token公钥
--config <string> :当前命令临时指定配置名/配置文件路径
--endpoint <string> :固定域名,可通过地域和域名页查看
-f, --force :强制更新存储量
-h, --help :当前命令使用说明
--projectid <string> :指定当前bucket所在projectid,可以在控制台查看,默认项目可忽略
使用示例查看bucket1所占空间大小,内容包含各存储类型的存储量以及总存储量StorageClass Size
STANDARD: 1.05 GB
IA: 0 GB
ARCHIVE: 0 GB
Total storage: 1.05 GB
查看bucket1下的testfolder目录下各类型存储量以及文件数量#./us3cli du us3://bucket1/testfolder
FileCount FileSize
Sum 10000 99.77 MB
STANDARD 10000 99.77 MB
IA 0 0 B
ARCHIVE 0 0 B
UpdateTime: 2020-12-24 11:40:27 Thu
注意:当使用命令首次查看某个目录或前缀下的存储量时,会将数据保存在本地,24内使用非强制更新查看存储量时,都不会重新请求,只显示前24小时内拉取到的最新数据。有更新需要的可以添加-f/--force选项再次拉取存储量。
该命令用于上传、下载、拷贝文件
命令格式上传文件
us3cli cp <本地文件路径> us3://<桶名字>/<文件Key> [--check][--recursive][--reduce][--parallel <分片上传并发数>][--speedlimit <速度限制>][--storageclass <存储类型>][--exclude <通配符表达式>][--rexclude <正则表达式>][--include <通配符表达式>][--rinclude <正则表达式>][--metadata <Key>=<value1>[,<key2>=<value2>]...][--mimetype <多媒体文件格式>]
下载文件
us3cli cp us3://<桶名字>/<文件Key> <本地文件路径> [--recursive][--reduce][--speedlimit <速度限制>][--exclude <通配符表达式>][--rexclude <正则表达式>][--include <通配符表达式>][--rinclude <正则表达式>][--parallel <分片下载并发数>][--partsize <下载分片大小>]
拷贝文件
us3cli cp us3://<桶名字>/<文件Key> us3://<桶名字>/<文件Key> [--recursive][--reduce][--exclude <通配符表达式>][--rexclude <正则表达式>][--include <通配符表达式>][--rinclude <正则表达式>][--metadata <Key>=<value1>[,<key2>=<value2>]...]
参数说明 --accesskey <string> :用于访问us3的API公钥或Token公钥
-c, --check :用于上传文件夹结束后检查已上传文件的etag是否一致
--config <string> :当前命令临时指定配置名/配置文件路径
--endpoint <string> :固定域名,可通过地域和域名页查看
--exclude <string> :不包含当前通配符的文件名
-h, --help :当前命令使用说明
--include <string> :包含当前通配符的文件名
--metadata <string> :指定元数据信息(该参数仅限上传和拷贝) 多个元数据以","分隔,如 "key1=value,key2=value2",其他分隔符暂不支持
--mimetype <string> :指定mimetype(该参数仅限上传)
--parallel <int> :分片并发数或批量并发数
--partsize <string> :下载分片大小,默认大小为4M,最小值为1M(该参数仅限下载)
-r, --recursive :递归文件夹中的所有文件及子目录下所有文件
--reduce :是否以精简模式执行(不展示进度)
--rexclude <string> :不包含当前正则表达式的文件名
--rinclude <string> :包含当前正则表达式的文件名
--secretkey <string> :用于访问us3的API私钥或Token私钥
-s, --speedlimit <string> :平均速度限制(单位可以是B,KB,MB,不带单位默认以B/s计算),默认200MB/s
--storageclass <string> :指定存储类型,对应有效值:STANDARD, IA, ARCHIVE(该参数仅限上传),默认值:STANDARD
注意:
1.通配符表达式暂时只支持“*”,"?"两种字符,并且需要注意的是,四种表达式筛选均以当前目录下文件路径为准
如:us3://us3cli/test 目录下的test2/test3.txt 会以test2/test3.txt作为字符串筛选,而不是以test3.txt作为字符串进行筛选
2.以下所有speedlimit选项均描述为平均速度
3.单个文件上传时根据文件大小使用不同的请求,文件大于64MB使用分片上传,小于64MB时使用普通的put请求,故上传中的parallel参数仅限上传64MB以上大文件使用
4.由于windows环境下文件名存在不区分大小写的情况,要下载的文件已存在时,会在文件名及文件后缀名之间默认添加(1),(2)...等作为文件名后缀
,如:
文件test.txt存在,则下载的文件保存为test(1).txt,若此时test(1).txt也存在,也保存为test(2).txt,依次类推
使用示例上传单个文件./us3cli cp ~/go/src/test.txt us3://bucket1/test
上传单个大文件(大于64MB)并设置分片并发数为10./us3cli cp ~/go/src/test.mp4 us3://bucket1/test.mp4 --parallel 10
# 文件大小小于64MB时该参数无效
下载单个文件./us3cli cp us3://bucket1/test/test.txt ~/go/src/test.txt
拷贝单个文件./us3cli cp us3://bucket1/test.txt us3://bucket2/test.txt
拷贝文件夹./us3cli cp -r us3://bucket1/test us3://bucket2/test
下载文件夹./us3cli cp -r us3://bucket/test ~/go/src/test
指定存储类型上传上传单个文件并指定存储类型为IA(低频访问)类型
./us3cli cp ~/go/src/test.txt us3://bucket/path/test.txt --storageclass IA
限速上传上传文件test.txt,并设置速度为1024Kb/s
./us3cli cp ~/go/src/test.txt us3://bucket/test.txt --speedlimit 1024Kb
批量上传上传所有格式为jpg的文件(通配符)
./us3cli cp -r ~/go/src/test us3://bucket/test --include "*.jpg"
上传所有a开头b结尾的文件(正则表达式)
./us3cli cp -r ~/go/src/test us3://bucket/test --rinclude "a*b"
上传所有不包括a开头b结尾的文件(正则表达式)
./us3cli cp -r ~/go/src/test us3://bucket/test --rexclude "a*b"
上传所有文件名不包括001的文件(通配符)
./us3cli cp -r ~/go/src/test us3://bucket/test --exclude "*001*"
上传单个文件并指定元数据信息./us3cli cp ~/go/src/test us3://bucket/test --metadata key1=value1,key2=value2
指定mimetype为text/plain上传./us3cli cp ~/go/src/test us3://bucket/test --mimetype text/plain
上传文件夹并检查etag是否一致./us3cli cp -r ~/go/src/test us3://bucket/test --check
本命令用于目录的增量上传
命令格式us3cli sync <本地目录> us3://<桶名字>/<文件Key> [--reduce][--mode cache|local][--ruler modtime|etag][--speedlimit <速度限制>][--retrycount <重试次数>][--exclude <通配符表达式>][--rexclude <正则表达式>][--include <通配符表达式>][--rinclude <正则表达式>][--parallel <请求并发数>][--metadata <Key>=<value1>[,<key2>=<value2>]...][--mimetype <多媒体文件格式>][--storageclass <存储类型>][--force]
参数说明 --accesskey <string> :用于访问us3的API公钥或Token公钥
--config <string> :当前命令临时指定配置名/配置文件路径
--endpoint <string> :固定域名,可通过地域和域名页查看
--exclude <string> :不包含当前通配符的文件名
-f, --force :是否强制同步,在加入该选项后,同步删除时,不弹出确认信息
--no-delete :是否默认不删除源端不存在的对象, 且不弹出信息, 在与-f同时使用时,执行--no-delete
-h, --help :当前命令使用说明
--include <string> :包含当前通配符的文件名
--metadata <string> :指定元数据信息,多个元数据以","分隔,如 "key1=value,key2=value2",其他分隔符暂不支持
--mimetype <string> :指定mimetype上传
-m, --mode <string> :可选项 cache、local 默认值为cache
cache :以本地缓存为标准,检查基于缓存的增量文件,同步us3端对应目录的文件,默认为该模式
local :以本地文件系统为标准,检查本地文件以及us3不同步的文件,补全或删除us3端对应目录的文件
--parallel <int> :请求并发数,默认值为10
--reduce :是否以精简模式执行(不展示进度)
-r, --retrycount: <int> :失败重试次数,默认值:10
--rexclude <string> :不包含当前正则表达式的文件名
--rinclude <string> :包含当前正则表达式的文件名
--ruler <string> :可选项 modtime、etag 默认为modtime
modtime :在判断是否上传时采用文件最后修改时间作为判断标准,如果本地文件最后修改时间晚于us3,则进行上传请求,否则不上传
etag :在判断是否上传时采用文件etag作为判断标准,如果本地文件etag和us3中的etag不同,则进行上传请求,否则不上传
--secretkey <string> :用于访问us3的API私钥或Token私钥
-s, --speedlimit <string> :平均速度限制(单位可以是B,KB,MB,不带单位默认以B/s计算),默认200MB/s
--storageclass <string> :指定存储类型,对应有效值:STANDARD, IA, ARCHIVE,默认值:STANDARD
增量模式说明:
1.cache模式使用本地缓存,从本地上传到bucket成功的文件,都会被记录为上传成功文件,如果需要重新上传,可以选择删除当前用户目录下的.us3cliconfig/leveldb文件夹,使用命令时会自动创建新的文件夹。
2.local模式下最终以本地文件为标准,保证bucket中的目标文件夹和本地同步,以下场景会进行文件删除,请慎用
:
增量上传文件夹后,将本地文件删除,再次使用local模式增量,会将bucket中的文件删除以保持US3 Bucket和本地同步
使用示例cache模式,以本地缓存中保存的修改时间为标准,同步本地文件./us3cli sync /root/test us3://bucket/path
cache模式,以本地缓存中的文件etag信息为标准,同步本地文件./us3cli sync /root/test us3://bucket/path --ruler etag
local模式,对比本地文件夹与指定us3目录中的所有文件的修改时间,通过上传文件以及删除us3文件操作,将us3目录状态与本地保持一致(如us3中有相对于本地多余的文件,则会删除us3中对应多余文件,请慎用)./us3cli sync /root/test us3://bucket/path --mode local
local模式,对比本地文件夹与指定us3目录中的所有文件的etag信息,通过上传文件以及删除us3文件操作,将us3目录状态与本地保持一致(如us3中有相对于本地多余的文件,则会删除us3中对应多余文件,请慎用)./us3cli sync /root/test us3://bucket/path --mode local --ruler etag
限速为1024 Kb/s上传./us3cli sync /root/test us3://bucket/path --speedlimit 1024Kb
并发上传文件夹./us3cli sync /root/test us3://bucket/path --parallel 5
指定mimetype上传./us3cli sync /root/test us3://bucket/path --mimetype "mimetype"
指定存储类型上传./us3cli sync /root/test us3://bucket/path --storageclass "ARCHIVE"
指定元数据上传./us3cli sync /root/test us3://bucket/path --metadata "key1=value1,key2=value2"
本命令用于流式上传文件
命令格式us3cli rcat us3://<桶名字>/<文件Key> [--reduce][-retrycount <重试次数>][--speedlimit <速度限制>][--parallel <并发数限制>]
参数说明 --accesskey <string> :用于访问us3的API公钥或Token公钥
--config <string> :当前命令临时指定配置名/配置文件路径
--endpoint <string> :固定域名,可通过地域和域名页查看
-h, --help :当前命令使用说明
--parallel <int> :分片并发数
--reduce :是否以精简模式执行(不展示进度)
--retrycount: <int> :失败重试次数,默认值:10
--secretkey <string> :用于访问us3的API私钥或Token私钥
-s, --speedlimit <string> :平均速度限制(单位可以是B,KB,MB,不带单位默认以B/s计算),默认200MB/s
使用示例上传流式数据到us3中cat test.txt | ./us3cli rcat us3://bucket1/test.txt
流式上传文件test.txt并设置限速为 2MB/scat test.txt | ./us3cli rcat us3://bucket1/test.txt --speedlimit 2MB
流式上传文件test.txt并设置重试次数为5次cat test.txt | ./us3cli rcat us3://bucket1/test.txt --retrycount 5
流式上传文件test.txt并设置并发数为2cat test.txt | ./us3cli rcat us3://bucket1/test.txt --parallel 2
文章版权归作者所有,未经允许请勿转载,若此文章存在违规行为,您可以联系管理员删除。
转载请注明本文地址:https://www.ucloud.cn/yun/126766.html
摘要:产品底层升级后,推出工具,便于用户对存储空间文件进行管理操作,操作方式更灵活。文件挂载工具文件系统挂载工具可帮助用户在环境下以协议方式挂载文件目录,对文件对象进行操作。一致性比对工具一致性比对工具用于比对用户本地与存储空间中的文件是否一致。 常用工具本篇目录管理工具其他工具除使用 US3 管理控制台之外,您还可以通过 US3 提供的各类常用工具对 US3 存储空间及空间内的文件对象进行管理,...
摘要:概览概览产品简介产品概述功能概览产品优势使用限制存储类型地域和域名计量计费产品价格计费规则欠费处理计费案例快速上手开通服务开始使用控制台指南存储空间日志管理文件管理生命周期静态网站托管域名管理镜像回源跨区域复制跨域设置数据分析防盗链统计报 概览产品简介产品概述功能概览产品优势使用限制存储类型地域和域名计量计费产品价格计费规则欠费处理计费案例快速上手开通 US3 服务开始使用 US3控制台指南...
v1.7.0修复了前缀自动发现式列取时,校验阶段仅校验顶层前缀的bug在不勾选前缀自动发现时,会同步源端的空目录到目的端支持了七牛专有云的endpointv1.6.1修复了在专有云上无法创建endpoint的bug修复了使用前缀自动发现功能时可能会卡住的bug修复了url列表模式的endpoint可能无法创建的bugv1.6.0优化了数据的统计方式修复了在使用s3接口拉取列表时,返回结果中next...
摘要:迁移工具历史版本迁移工具历史版本迁移工具历史版本本篇目录介绍介绍安装步骤安装步骤介绍介绍介绍是对象存储提供的一款将数据迁移至存储空间的工具。 迁移工具(历史版本)本篇目录介绍安装步骤介绍ufile-import 是对象存储 US3 提供的一款将数据迁移至 US3 存储空间(Bucket) 的工具。您可以将 ufile-import 部署在本地服务或者云主机上,轻松将您其他云存储的数据迁移到 ...
摘要:示例移动到可执行目录下配置信息内同,配置路径自定义。卷的序列号是的目录个文件字节个目录可用字节进行挂载操作这里挂载到盘,并且指定为的用户,日志级别为,预读窗口为,挂载的桶名为注意目前下挂载只能前台挂载 下载与环境准备本篇目录运行环境下载链接配置账号访问信息运行环境US3FS基于Linux下fuse和Windows平台下winfsp实现,您的机器需要支持fuse或winfsp。建议您将US3F...
摘要:修复了写入过程中可能出现的进程中断的问题。修复了在对象存储中创建同名的目录和文件,会显示两个目录的问题修复了初始化分片上传失败会阻塞的问题 历史版本本篇目录US3FS V1.6.7US3FS V1.6.6US3FS V1.6.5US3FS V1.6.4US3FS V1.6.3US3FS V1.6.2US3FS V1.6.0US3FS v1.5.5US3FS v1.5.4US3FS v1.5....
阅读 325·2024-11-07 18:25
阅读 130514·2024-02-01 10:43
阅读 893·2024-01-31 14:58
阅读 856·2024-01-31 14:54
阅读 82839·2024-01-29 17:11
阅读 3129·2024-01-25 14:55
阅读 2013·2023-06-02 13:36
阅读 3073·2023-05-23 10:26