授权码下载对象
功能说明
使用授权码下载对象或按对象名前缀批量下载对象到本地。
下载对象或批量下载时，请确保OBS桶中的源对象不发生变化，否则可能产生下载失败或者数据不一致的问题。
命令结构
- Windows操作系统
- 直接输入授权码下载单个对象
obsutil share-cp authorization_code file_or_folder_url -key=xxx [-ac=xxx] [-dryRun] [-tempFileDir=xxx] [-u] [-vlength] [-vmd5] [-p=1] [-threshold=52428800] [-ps=auto] [-cpd=xxx][-fr] [-o=xxx] [-config=xxx] [-e=xxx] [-i=xxx] [-k=xxx] [-t=xxx]
- 使用文件路径传入授权码下载单个对象
obsutil share-cp file://authorization_code_file_url file_or_folder_url -key=xxx [-ac=xxx] [-dryRun] [-tempFileDir=xxx] [-u] [-vlength] [-vmd5] [-p=1] [-threshold=52428800] [-ps=auto] [-cpd=xxx][-fr] [-o=xxx] [-config=xxx] [-e=xxx] [-i=xxx] [-k=xxx] [-t=xxx]
- 直接输入授权码批量下载对象
obsutil share-cp authorization_code folder_url -r [-key=xxx] [-ac=xxx] [-dryRun] [-tempFileDir=xxx] [-f] [-u] [-vlength] [-vmd5] [-flat] [-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]
- 使用文件路径传入授权码批量下载对象
obsutil share-cp file://authorization_code_file_url folder_url -r [-key=xxx] [-ac=xxx] [-dryRun] [-tempFileDir=xxx] [-f] [-u] [-vlength] [-vmd5] [-flat] [-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 share-cp authorization_code file_or_folder_url -key=xxx [-ac=xxx] [-dryRun] [-tempFileDir=xxx] [-u] [-vlength] [-vmd5] [-p=1] [-threshold=52428800] [-ps=auto] [-cpd=xxx][-fr] [-o=xxx] [-config=xxx] [-e=xxx] [-i=xxx] [-k=xxx] [-t=xxx]
- 使用文件路径传入授权码下载单个对象
./obsutil share-cp file://authorization_code_file_url file_or_folder_url -key=xxx [-ac=xxx] [-dryRun] [-tempFileDir=xxx] [-u] [-vlength] [-vmd5] [-p=1] [-threshold=52428800] [-ps=auto] [-cpd=xxx][-fr] [-o=xxx] [-config=xxx] [-e=xxx] [-i=xxx] [-k=xxx] [-t=xxx]
- 直接输入授权码批量下载对象
./obsutil share-cp authorization_code folder_url -r [-key=xxx] [-ac=xxx] [-dryRun] [-tempFileDir=xxx] [-f] [-u] [-vlength] [-vmd5] [-flat] [-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]
- 使用文件路径传入授权码批量下载对象
./obsutil share-cp file://authorization_code_file_url folder_url -r [-key=xxx] [-ac=xxx] [-dryRun] [-tempFileDir=xxx] [-f] [-u] [-vlength] [-vmd5] [-flat] [-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 share-cp xxx d:\temp\test.txt -ac=123456 -key=src/test.txt ，下载单个对象。
obsutil share-cp xxx d:\temp\test.txt -ac=123456 -key=test/test.txt The authorized prefix is [test/test.txt] Start at 2024-09-30 07:55:36.7698045 +0000 UTC Parallel: 3 Jobs: 3 Threshold: 50.00MB PartSize: auto VerifyLength: false VerifyMd5: false CheckpointDir: xxxx TempFileDir: xxxx Waiting to prepare the temp file [xxx]. [==========================================] 100.00% 4.86 KB/s 0s Download successfully, 19B, n/a, https://endpoint:443/test/test.txt --> d:\temp\test.txt The authorized prefix is [test/test.txt]
- 以Windows操作系统为例，运行obsutil share-cp xxx d:\temp -ac=123456 -f -r，批量下载对象。
obsutil share-cp xxx d:\temp -ac=123456 -f -r The authorized prefix is [test] Start at 2024-09-30 08:05:07.0097508 +0000 UTC Parallel: 3 Jobs: 3 Threshold: 50.00MB PartSize: auto VerifyLength: false VerifyMd5: false CheckpointDir: xxxx Task id: 1a50b1dd-3f92-42ae-a974-ff8fe514c2c2 OutputDir: xxxx TempFileDir: xxxx [======================================================] 100.00% 155.59 KB/s 0s Succeed count: 6 Failed count: 0 Succeed bytes: xxx Metrics [max cost:153 ms, min cost:129 ms, average cost:92.00 ms, average tps:17.86, transfered size:70B] Task id: 1a50b1dd-3f92-42ae-a974-ff8fe514c2c2 The authorized prefix is [test/]
参数说明
|
参数 |
约束 |
描述 |
|---|---|---|
|
authorization_code 或 file://authorization_code_file_url |
必选 |
授权码。
说明：
如果以“file://”开头，则表明授权码是从本地文件中获取。 |
|
file_or_folder_url |
下载对象时必选 |
本地文件/文件夹路径。 |
|
folder_url |
批量下载时必选 |
本地文件夹路径。 |
|
key |
附加参数，下载对象时必选 批量下载时可选 |
待下载的对象名，或批量下载的对象名前缀。 下载对象时，该值不能为空，最终保存在本地的位置及命名规则如下：
批量下载时，最终保存在本地的位置规则如下：
说明：
须知：
批量下载时，如果设置了flat选项，且如果创建授权码时的对象名前缀为空或者不以“/”结尾，则可能导致下载的对象列表为空。 |
|
ac |
附加参数，可选 |
提取码。
说明：
|
|
r |
附加参数，批量下载时必选 |
按指定的对象名前缀批量下载对象。 |
|
fr |
附加参数，下载对象时可选 |
下载对象时生成结果清单文件。 |
|
flat |
附加参数，批量下载时可选 |
批量下载时，不包含上一级父对象名前缀。 |
|
tempFileDir |
附加参数，可选 |
分段下载时保存临时文件的文件夹，默认为配置文件中的defaultTempFileDir。
说明：
|
|
dryRun |
附加参数，可选 |
测试模式运行，不执行实际的下载操作。 |
|
u |
附加参数，可选 |
增量下载操作，设置该参数后，下载每个对象时会对比本地对应路径的文件，仅在文件不存在，或者文件大小与对象大小不一致，或者文件的最后修改时间早于对象的最后修改时间时进行下载。
注意：
在比较每个本地文件与桶内对象差异时，会产生一次HEAD请求费用。 |
|
vlength |
附加参数，可选 |
下载完成后，验证本地文件大小是否与桶中对象的大小一致。 |
|
vmd5 |
附加参数，可选 |
下载完成后，验证本地文件的MD5值是否与桶中对象的MD5值一致。
说明：
桶中对象必须包含元数据x-obs-meta-md5chksum，否则会忽略MD5值校验。
注意：
如果您的业务涉及加密场景，请勿使用该参数。 |
|
p |
附加参数，可选 |
每个分段下载任务的最大并发数，默认为配置文件中的defaultParallels。 |
|
threshold |
附加参数，可选 |
开启分段下载任务的阈值，单位：字节，默认为配置文件中的defaultBigfileThreshold。
说明：
|
|
ps |
附加参数，可选 |
每个分段下载任务的段大小，单位：字节，默认为配置文件中的defaultPartSize。
说明：
|
|
cpd |
附加参数，可选 |
生成断点记录文件的文件夹，默认为运行obsutil命令的用户目录的子文件夹.obsutil_checkpoint。
说明：
每个分段下载任务会产生唯一对应的断点记录文件并保存至该文件夹的down子文件夹下，分段任务执行成功后，对应的断点记录文件会被自动删除；分段任务执行失败或被中断后，下次执行该分段任务时会尝试通过对应的断点记录文件恢复任务。 |
|
f |
附加参数，批量下载时可选 |
强制操作，不进行询问提示。 |
|
j |
附加参数，批量下载时可选 |
批量下载时的最大并发数，默认为配置文件中的defaultJobs。
说明：
工具会保证该值至少为1。 |
|
exclude |
附加参数，批量下载时可选 |
不包含源对象的匹配模式，如：*.txt。
说明：
须知：
|
|
include |
附加参数，批量下载时可选 |
包含源对象的匹配模式，如：*.jpg。
说明：
须知：
|
|
timeRange |
附加参数，批量下载时可选 |
下载对象时的时间段匹配模式，仅下载最后修改时间在该时间段内的对象。 该匹配模式优先级低于对象名匹配模式：exclude和include，优先执行对象名匹配模式后才会执行该匹配模式。
说明：
须知：
|
|
mf |
附加参数，可选 |
设置名称匹配模式（include、exclude）和时间匹配模式（timeRange）对对象名以“/”结尾的对象也生效。 |
|
o |
附加参数，可选 |
生成结果清单文件的文件夹，命令执行完成后，会在该文件夹下生成结果清单文件（可能包含成功结果、失败结果和警告结果三个文件），默认为运行obsutil命令的用户目录的子文件夹.obsutil_output。
说明：
|
|
config |
附加参数，可选 |
运行当前命令时的自定义配置文件，可支持的配置参数请参考配置参数说明。 |
|
e |
附加参数，可选 |
指定终端节点。 |
|
i |
附加参数，可选 |
指定用户的AK。 |
|
k |
附加参数，可选 |
指定用户的SK。 |
|
t |
附加参数，可选 |
指定用户的securitytoken。 |
响应结果
请参考上传对象的响应结果。
