链接复制成功!
下载对象
约束与限制
- 对于存储类别为归档存储或深度归档存储的对象,需要确认对象的状态为“已恢复”才能对其进行下载。
- 控制台不支持批量下载文件或下载文件夹,您可以使用Browser+或者obsutil实现此功能:
使用方式
OBS支持通过控制台、API、SDK、OBS Browser+、obsutil方式下载对象。
使用OBS控制台
- 在OBS管理控制台左侧导航栏选择“对象存储”。
- 在OBS管理控制台桶列表中,单击待操作的桶,进入“对象”页面。
- 选中待下载的文件,并单击右侧的“下载”或“更多>下载为”,根据浏览器提示完成文件下载。
也可以选中多个文件,单击文件列表上方的“更多>下载”。
在“下载为”对话框,右键单击“对象”,选择“复制链接地址”,可以获取到对象的下载链接地址。
使用API
使用图形化工具OBS Browser+
- 登录OBS Browser+。
- 选中待配置的桶,选中需要下载的文件或文件夹后,单击“下载”。
OBS支持批量下载多个文件和文件夹,点击选中待下载的文件或文件夹即可。
- 对于存储类别为归档存储的桶中的文件,需要确认对象的状态为“已恢复”才能对其进行下载。请参见恢复对象查看如何恢复文件。
- 批量下载仅支持下载当前已经列举出来的文件或文件夹,可以通过下拉触底更新已列举出的文件或文件夹数量,每次触底更新100个。
- 在对话框中选择存放文件或文件夹的路径后,单击“选择文件夹”。
使用命令行工具obsutil
命令结构:
- Windows操作系统
- 下载单个对象
obsutil cp obs://bucket/key file_or_folder_url [-tempFileDir=xxx] [-dryRun] [-u] [-vlength] [-vmd5] [-p=1] [-threshold=52428800] [-versionId=xxx] [-ps=auto] [-cpd=xxx][-fr] [-o=xxx] [-config=xxx] [-e=xxx] [-i=xxx] [-k=xxx] [-t=xxx]
- 批量下载对象
obsutil cp obs://bucket[/key] folder_url -r [-tempFileDir=xxx] [-dryRun] [-f] [-flat] [-u] [-vlength] [-vmd5] [-j=1] [-p=1] [-threshold=52428800] [-ps=auto] [-include=*.xxx] [-exclude=*.xxx] [-timeRange=time1-time2] [-mf] [-o=xxx] [-cpd=xxx] [-config=xxx] [-e=xxx] [-i=xxx] [-k=xxx] [-t=xxx]
- 下载单个对象
- macOS/Linux操作系统
- 下载单个对象
./obsutil cp obs://bucket/key file_or_folder_url [-tempFileDir=xxx] [-dryRun] [-u] [-vlength] [-vmd5] [-p=1] [-threshold=52428800] [-versionId=xxx] [-ps=auto] [-cpd=xxx] [-fr] [-o=xxx] [-config=xxx] [-e=xxx] [-i=xxx] [-k=xxx] [-t=xxx]
- 批量下载对象
./obsutil cp obs://bucket[/key] folder_url -r [-tempFileDir=xxx] [-dryRun] [-f] [-flat] [-u] [-vlength] [-vmd5] [-j=1] [-p=1] [-threshold=52428800] [-ps=auto] [-include=*.xxx] [-exclude=*.xxx] [-timeRange=time1-time2] [-mf] [-o=xxx] [-cpd=xxx] [-config=xxx] [-e=xxx] [-i=xxx] [-k=xxx] [-t=xxx]
- 下载单个对象
运行示例:
- 以Windows操作系统为例,运行obsutil cp obs://bucket-test/key d:\temp\test.txt,下载单个对象。
obsutil cp obs://bucket-test/key d:\temp\test.txt Start at 2024-09-30 08:39:34.180766 +0000 UTC Parallel: 5 Jobs: 5 Threshold: 50.00MB PartSize: auto VerifyLength: false VerifyMd5: false CheckpointDir: xxxx TempFileDir: xxxx [==========================================] 100.00% 4.86 KB/s 8.46MB/8.46MB 0s Download successfully, 8.46MB, obs://bucket-test/key --> d:\temp\test.txtt, cost [41], status [200], request id [000001924215BEC84019EDF4044A5451]
- 以Windows操作系统为例,运行obsutil cp obs://bucket-test/temp d:\ -f -r,批量下载对象。
obsutil cp obs://bucket-test/temp d:\ -f -r Start at 2024-09-30 08:41:56.0306522 +0000 UTC Parallel: 5 Jobs: 5 Threshold: 50.00MB PartSize: auto VerifyLength: false VerifyMd5: false CheckpointDir: xxxx Task id: 3066a4b0-4d21-4929-bb84-4829c32cbd0f OutputDir: xxxx TempFileDir: xxxx [======================================================] 100.00% tps:17.86 155.59 KB/s 7.20MB/7.20MB 0s Succeed count: 6 Failed count: 0 Succeed bytes: 70B Metrics [max cost:153 ms, min cost:129 ms, average cost:92.00 ms, average tps:70, transfered size: 7.20MB] Task id: 3066a4b0-4d21-4929-bb84-4829c32cbd0f
- 更多运行示例,请参见下载示例。
参数说明:
参数 |
约束 |
描述 |
---|---|---|
file_or_folder_url |
下载对象时必选 |
本地文件/文件夹路径。 |
folder_url |
批量下载时必选 |
本地文件夹路径。 |
bucket |
必选 |
桶名。 |
key |
下载对象时必选 批量下载时可选 |
待下载的对象名,或批量下载的对象名前缀。 下载对象时,该值不能为空,最终保存在本地的位置及命名规则如下:
批量下载时,最终保存在本地的位置规则如下:
说明:
|
fr |
附加参数,下载对象时可选 |
下载对象时生成结果清单文件。 |
flat |
附加参数,批量下载时可选 |
批量下载时,不包含上一级父对象名前缀。 |
tempFileDir |
附加参数,可选 |
分段下载时保存临时文件的文件夹,默认为配置文件中的defaultTempFileDir。
说明:
|
dryRun |
附加参数,可选 |
测试模式运行,不执行实际的下载操作。 |
u |
附加参数,可选 |
增量下载操作,设置该参数后,下载每个对象时会对比本地对应路径的文件,仅在文件不存在,或者文件大小与对象大小不一致,或者文件的最后修改时间早于对象的最后修改时间时进行下载。 |
vlength |
附加参数,可选 |
下载完成后,验证本地文件大小是否与桶中对象的大小一致。 |
vmd5 |
附加参数,可选 |
下载完成后,验证本地文件的MD5值是否与桶中对象的MD5值一致。
说明:
桶中对象必须包含元数据x-obs-meta-md5chksum,否则会忽略MD5值校验。 |
p |
附加参数,可选 |
每个分段下载任务的最大并发数,默认为配置文件中的defaultParallels。 |
threshold |
附加参数,可选 |
开启分段下载任务的阈值,单位:字节,默认为配置文件中的defaultBigfileThreshold。
说明:
|
versionId |
附加参数,下载对象时可选 |
下载单个对象时可指定的对象版本号。 |
ps |
附加参数,可选 |
每个分段下载任务的段大小,单位:字节,默认为配置文件中的defaultPartSize。
说明:
|
fs |
附加参数,可选 |
是否使用并行文件系统的列举方式,如果桶是并行文件系统,推荐加上该参数。
注意:
|
cpd |
附加参数,可选 |
生成断点记录文件的文件夹,默认为运行obsutil命令的用户目录的子文件夹.obsutil_checkpoint。
说明:
每个分段下载任务会产生唯一对应的断点记录文件并保存至该文件夹的down子文件夹下,分段任务执行成功后,对应的断点记录文件会被自动删除;分段任务执行失败或被中断后,下次执行该分段任务时会尝试通过对应的断点记录文件恢复任务。 |
r |
附加参数,批量下载时必选 |
按指定的对象名前缀批量下载对象。 |
f |
附加参数,批量下载时可选 |
强制操作,不进行询问提示。 |
j |
附加参数,批量下载时可选 |
批量下载时的最大并发数,默认为配置文件中的defaultJobs。
说明:
工具会保证该值至少为1。 |
exclude |
附加参数,批量下载时可选 |
不包含源对象的匹配模式,如:*.txt。
说明:
须知:
|
include |
附加参数,批量下载时可选 |
include参数规定了下载对象的对象名格式,满足该格式的对象才会被下载。例如“*.jpg”规定只有对象名后缀为“.jpg”的对象会被下载。
说明:
须知:
|
timeRange |
附加参数,批量下载时可选 |
下载对象时的时间段匹配模式,仅下载最后修改时间在该时间段内的对象。 该匹配模式优先级低于对象名匹配模式:exclude和include,优先执行对象名匹配模式后才会执行该匹配模式。
说明:
须知:
|
mf |
附加参数,可选 |
设置名称匹配模式(include、exclude)和时间匹配模式(timeRange)对对象名以“/”结尾的对象也生效。 |
o |
附加参数,可选 |
生成结果清单文件的文件夹,命令执行完成后,会在该文件夹下生成结果清单文件(可能包含成功结果、失败结果和警告结果三个文件),默认为运行obsutil命令的用户目录的子文件夹.obsutil_output。
说明:
|
config |
附加参数,可选 |
运行当前命令时的自定义配置文件,可支持的配置参数请参考配置参数说明。 |
e |
附加参数,可选 |
指定终端节点。 |
i |
附加参数,可选 |
指定用户的AK。 |
k |
附加参数,可选 |
指定用户的SK。 |
t |
附加参数,可选 |
指定用户的securitytoken。 |
响应结果:
字段名 |
描述 |
---|---|
Parallel |
请求中的-p参数。 |
Jobs |
请求中的-j参数。 |
Threshold |
请求中的-threshold参数。 |
PartSize |
请求中的-ps参数。 |
Exclude |
请求中的-exclude参数。 |
Include |
请求中的-include参数。 |
TimeRange |
请求中的-timeRange参数。 |
VerifyLength |
请求中的-vlength参数。 |
VerifyMd5 |
请求中的-vmd5参数。 |
CheckpointDir |
请求中的-cpd参数。 |
OutputDir |
请求中的-o参数。 |
ArcDir |
请求中的-arcDir参数。 |
Succeed count |
成功的任务数。 |
Failed count |
失败的任务数。 |
Skip count |
增量上传/下载/复制、同步上传/下载/复制跳过的任务数。
说明:
跳过的任务数也会记录到成功的任务数中。 |
Warning count |
执行完成但包含警告的任务数。
说明:
|
Succeed bytes |
上传/下载成功的字节数。 |
max cost |
所有任务中的最长耗时,单位:毫秒。 |
min cost |
所有任务中的最短耗时,单位:毫秒。 |
average cost |
平均耗时,单位:毫秒。 |
average tps |
平均每秒的任务完成个数。 |
Task id |
每次运行的唯一标识号,用于查找批量任务生成的结果清单文件。 |