对象存储服务 OBS-上传对象:参数说明

时间：2024-12-11 17:17:47

对象存储服务 OBS

参数说明

参数	约束	描述
file_url	多文件/文件夹上传时可选上传文件时必选	本地文件路径。说明：多文件/文件夹上传时，禁止路径嵌套，例如：/a/b/c和/a/b/。多文件/文件夹上传时，必须配置msm=1，此时可以用英文逗号分隔多个文件，例如：file_url1,file_url2。多文件/文件夹上传时，文件和文件夹可以同时存在，例如：file_url1,folder_url1,file_url2,folder_url2。
folder_url	多文件/文件夹上传时可选上传文件夹时必选	本地文件夹路径。说明：上传文件夹时，如果未设置flat选项，则直接上传整个文件夹；如果设置了flat选项，则上传文件夹下的所有内容。多文件/文件夹上传时，禁止路径嵌套，例如：/a/b/c和/a/b/。多文件/文件夹上传时，必须配置msm=1，此时可以用逗号分隔多个文件夹，例如：folder_url1,folder_url2。多文件/文件夹上传时，文件和文件夹可以同时存在，例如：file_url1,folder_url1,file_url2,folder_url2。
filelist_url	多文件/文件夹上传时可选	包含待上传文件/文件夹列表的文件，必须配置msm=2。说明：该文件为普通文本文件（如.txt文件、.csv文件），文件中的每行代表一个待上传的文件/文件夹，例如： file_url1 file_url2 folder_url1 folder_url2 文件中待上传的文件/文件夹禁止路径嵌套，例如：/a/b/c和/a/b/。
bucket	必选	桶名。
key	可选	上传文件时的对象名/对象名前缀，或上传文件夹时的对象名前缀。规则如下：上传文件时，如果该值为空，则将对象上传到桶的根目录，对象名为文件名。如果该值不为空，如果该值以“/”结尾，则以该值作为对象名前缀上传对象，对象名为该值+文件名；否则，将该值作为对象名进行上传；上传文件夹时，如果该值为空，则将文件夹上传到桶的根目录；如果该值不为空，如果该值以“/”结尾，则将该值作为对象名前缀上传文件夹；否则，将文件夹上传到以该值加上“/”结尾的对象名前缀下。说明：请参考上传示例理解该参数的使用方式。
fr	附加参数，上传文件时可选	上传文件时生成结果清单文件。
flat	附加参数，多文件/文件夹上传或上传文件夹时可选	上传文件夹时，只上传该文件夹下的所有内容。
arcDir	附加参数，可选	上传文件成功后的归档路径，上传成功后的文件会移动到该路径下。
dryRun	附加参数，可选	测试模式运行，不执行实际的上传操作。
link	附加参数，可选	上传软链接文件/文件夹指向的真实路径。须知：如果未指定该参数，而待上传的文件是一个软链接且该软链接指向的目标文件不存在，则Windows操作系统会产生“The system cannot find the file specified”的上传失败异常，而macOS/Linux操作系统会产生“No such file or directory”的上传失败异常。文件夹软链接不能形成环，否则上传会以panic的形式退出；如果不希望产生panic，请在配置文件中配置panicForSymbolicLinkCircle为false。
u	附加参数，可选	增量上传操作，设置该参数后，上传每个文件时会对比桶中对应路径的对象，仅在对象不存在，或者对象大小与文件大小不一致，或者对象的最后修改时间早于文件的最后修改时间时进行上传。注意：在比较每个本地文件与桶内对象差异时，会产生一次HEAD请求费用。
vlength	附加参数，可选	上传完成后，验证桶中对象的大小是否与本地文件大小一致。
vmd5	附加参数，可选	上传完成后，验证桶中对象的MD5值是否与本地文件的MD5值一致。说明：如果待上传的本地文件较大，使用该参数将会因为计算MD5而导致整体性能下降。 MD5值校验通过后，会将该值设置为对象元数据x-obs-meta-md5chksum，用于下载或复制时校验MD5。注意：如果您的业务涉及加密场景，请勿使用该参数。
p	附加参数，可选	每个分段上传任务的最大并发数，默认为配置文件中的defaultParallels。
threshold	附加参数，可选	开启分段上传任务的阈值，单位：字节，默认为配置文件中的defaultBigfileThreshold。说明：如果待上传的文件小于该阈值，则使用直接上传模式；否则使用分段上传模式。直接上传模式不会产生断点记录文件，不支持断点续传。支持带容量单位配置，例如，配置1MB代表1048576字节。
acl	附加参数，可选	上传文件时可指定的预定义访问策略。支持的值： private public-read public-read-write bucket-owner-full-control 说明：以上四个值分别对应：私有读写、公共读、公共读写、桶拥有者完全控制，四种预定义访问策略。
sc	附加参数，可选	上传文件时可指定的对象的存储类型。支持的值： standard：标准存储，访问时延低、吞吐量高，适用于有大量热点文件（平均一个月多次）或小文件（小于1MB）。 warm：低频访问存储，可用性略低于standard，适用于不频繁访问（平均一年少于12次）但在需要时也要求快速访问数据的业务场景。 cold：归档存储，安全、持久且成本极低，适用于很少访问（平均一年访问一次）数据的业务场景。
meta	附加参数，可选	上传文件时可指定的标准和自定义元数据。格式为：key1:value1#key2:value2#key3:value3。说明：以上值表示复制对象完成后，桶内目标对象包含三组自定义元数据，分别为：key1:value1、key2:value2、key3:value3。标准元数据头包括：Content-Type、Content-Encoding、Cache-Control、Content-Disposition、Content-Language、Expires。
ps	附加参数，可选	每个分段上传任务的段大小，单位：字节，取值范围是100KB~5GB，默认为配置文件中的defaultPartSize。说明：支持带容量单位配置，例如，配置1MB代表1048576字节。支持配置为auto，此时obsutil会根据源文件大小自动设置每个分段任务的段大小。
cpd	附加参数，可选	生成断点记录文件的文件夹，默认为运行obsutil命令的用户目录的子文件夹.obsutil_checkpoint。说明：每个分段上传任务会产生唯一对应的断点记录文件并保存至该文件夹的upload子文件夹下，分段任务执行成功后，对应的断点记录文件会被自动删除；分段任务执行失败或被中断后，下次执行该分段任务时会尝试通过对应的断点记录文件恢复任务。
r	附加参数，上传文件夹时必选多文件上传时可选	递归上传文件夹中的所有文件和子文件夹。
f	附加参数，多文件/文件夹上传或上传文件夹时可选	强制操作，不进行询问提示。
j	附加参数，多文件/文件夹上传或上传文件夹时可选	上传文件夹时批量任务的最大并发数，默认为配置文件中的defaultJobs。说明：工具会保证该值至少为1。
encoding-type	附加参数，可选	对象名有特殊字符时，取值为url。说明： Util 5.5.12版本及以上支持该参数。
msm	附加参数，多文件/文件夹上传时必选	开启多文件/文件夹上传模式，支持的值：[1\|2]。说明：如果msm=1则代表上传的URL是一组文件/文件夹列表（以英文逗号分隔）。如果该值为msm=2则代表上传的URL是一个包含文件/文件夹列表的文件。如果文件/文件夹名本身包含英文逗号，请不要使用msm=1的模式。如果没有设置r参数，则列表中的文件夹不会被上传。
exclude	附加参数，多文件/文件夹上传或上传文件夹时可选	不包含文件的匹配模式，如：.txt。说明：支持“”匹配多个任意字符和“?”匹配单个任意字符，例如abc.txt代表匹配以abc开头以.txt结尾的任意文件。您可以使用“\”代表匹配“”字符本身，使用“\?”代表匹配“?”字符本身。如果待上传的文件名匹配该参数，则跳过该文件的上传。须知：建议使用引号传递该匹配模式（Linux/Mac操作系统使用单引号，Windows操作系统使用双引号）防止特殊符号被操作系统转义，导致不可预期的结果。该匹配模式作用于文件全路径（含文件名和文件目录）。该匹配模式仅对文件夹中的文件生效。支持指定多个exclude参数，如 -exclude=.xxx -exclude=*.xxx
include	附加参数，多文件/文件夹上传或上传文件夹时可选	包含文件的匹配模式，如：.jpg。说明：支持“”匹配多个任意字符和“?”匹配单个任意字符。您可以使用“\”代表匹配“”字符本身，使用“\?”代表匹配“?”字符本身。首先执行exclude的匹配规则，如果待上传的文件名不匹配exclude，则判断待上传的文件名是否匹配该参数，如果匹配则上传该文件，否则跳过该文件的上传。说明：如何使用include实现前缀匹配上传： ./obsutil cp /localpath/ obs://test/ -include=/localpath/2022-12-09/* -f -r 以上命令的含义是，上传本地路径localpath下符合匹配规则的文件到test桶下，匹配规则是以/localpath/2022-12-09/开头的。须知：建议使用引号传递该匹配模式（Linux/Mac操作系统使用单引号，Windows操作系统使用双引号）防止特殊符号被操作系统转义，导致不可预期的结果。该匹配模式作用于文件全路径（含文件名和文件目录）。该匹配模式仅对文件夹中的文件生效。支持指定多个include参数，如 -include=.xxx -include=.xxx
at	附加参数，多文件/文件夹上传或上传文件夹时可选	指定按照文件最后访问时间作为timeRange匹配模式，仅上传最后访问时间满足timeRange时间段的文件。说明：需配合timeRange使用
disableDirObject	附加参数，多文件夹上传时可选	上传文件夹时候，文件夹本身不会作为一个对象上传，在有很多空文件夹场景时候可以避免无用文件夹上传到对象存储桶中；文件夹下有文件时候，文件夹下文件依然会上传并保持原有路径格式，不受影响。
timeRange	附加参数，多文件/文件夹上传或上传文件夹时可选	上传文件时的时间段匹配模式，仅上传最后修改时间在该时间段内的文件。该匹配模式优先级低于文件名匹配模式：exclude和include，优先执行文件名匹配模式后才会执行该匹配模式。说明：使用“time1-time2”，代表匹配的时间段，其中time1必须小于等于time2，格式为yyyyMMddHHmmss。时间格式支持自动补全，例如yyyyMMdd等价于yyyyMMdd000000，yyyyMM等价于yyyyMM01000000。使用“-time2”，代表匹配最后修改时间在time2之前的所有文件，使用“time1-”，代表匹配最后修改时间time1之后的所有文件。须知：该匹配模式表示的时间是UTC时间。
mf	附加参数，可选	设置名称匹配模式（include、exclude）和时间匹配模式（timeRange）对文件夹也生效。
o	附加参数，可选	生成结果清单文件的文件夹，命令执行完成后，会在该文件夹下生成结果清单文件（可能包含成功结果、失败结果、警告结果三个文件），默认为运行obsutil命令的用户目录的子文件夹.obsutil_output。说明：结果清单文件命名规则：cp_{succeed \| failed \| warning}_report_时间_TaskId.txt。单个结果清单文件默认情况下最大为30MB且最大可保留的文件个数为1024，可在配置文件中通过recordMaxLogSize和recordBackups分别配置。当涉及多文件/文件夹时，如需确认失败任务的具体错误信息，可参考结果清单文件夹下的失败结果清单文件"cp_failed_report_时间_TaskId.txt"及日志路径下的日志文件。
config	附加参数，可选	运行当前命令时的自定义配置文件，可支持的配置参数请参考配置参数说明。
e	附加参数，可选	指定终端节点。
i	附加参数，可选	指定用户的AK。
k	附加参数，可选	指定用户的SK。
t	附加参数，可选	指定用户的securitytoken。

上一篇：对象存储服务 OBS-上传对象:命令结构

下一篇：对象存储服务 OBS-上传对象:命令结构

新客秒杀 2核2G 3M L实例

68元/年

普惠上云领千元上云礼券

立即前往

企业专享 X实例 4核8G 5M

888元/年

热门域名 1元随心购

1元/年起

对象存储服务 OBS-上传对象:参数说明

意见反馈

0/200

提交取消

提交成功！非常感谢您的反馈，我们会继续努力做到更好反馈提交失败！请稍后重试！

对象存储服务 OBS-上传对象:参数说明

对象存储服务 OBS-上传对象:参数说明

参数说明

7*24

备案

专业服务

退订

建议反馈

售前咨询热线