yexinru/doc-exports
1
0
Fork 0
forked from docs/doc-exports
Code Pull Requests Activity
Files
a41a4e0331fbc0beff63bb28fa59228cc9a751df
doc-exports/docs/obs/tool-obsutil/obs_11_0013.html
weihongmin1 a41a4e0331 OBS Util 0115 Version 
Reviewed-by: Sabelnikov, Dmitriy <dmitriy.sabelnikov@t-systems.com>
Co-authored-by: weihongmin1 <weihongmin1@huawei.com>
Co-committed-by: weihongmin1 <weihongmin1@huawei.com>
2026-02-17 10:18:57 +00:00

493 lines
61 KiB
HTML
Raw Blame History

<a name="obs_11_0013"></a><a name="obs_11_0013"></a>
<h1 class="topictitle1">Uploading an Object</h1>
<div id="body1542440101580"><div class="section" id="obs_11_0013__section1479112110815"><h4 class="sectiontitle">Function</h4><p id="obs_11_0013__p11772825481">You can use this command to upload one or more local files or folders to a specified path in OBS. These files can be texts, images, videos, or any other type of files.</p>
<div class="notice" id="obs_11_0013__note15184181913594"><span class="noticetitle"><img src="public_sys-resources/notice_3.0-en-us.png"> </span><div class="noticebody"><p id="obs_11_0013__p8240134902215">Do not change the local file or folder when uploading it. Otherwise, the upload may fail or data may be inconsistent.</p>
</div></div>
</div>
<div class="section" id="obs_11_0013__section144331226124017"><h4 class="sectiontitle">Constraints</h4><p id="obs_11_0013__p146878203226">obsutil has restrictions on the size of files or folders to be uploaded. You can upload an empty file or folder of 0 bytes. You can also upload a single file or folder with a maximum size of 5 GB in normal mode or a single file with a maximum size of 48.8 TB in multipart mode.</p>
</div>
<div class="section" id="obs_11_0013__section1220752192216"><h4 class="sectiontitle">Command Line Structure</h4><ul id="obs_11_0013__ul2098662312412"><li id="obs_11_0013__li198632362414">In Windows<ul id="obs_11_0013__ul48751720253"><li id="obs_11_0013__li1012518598242">Uploading a file<pre class="screen" id="obs_11_0013__screen10125859132415">obsutil cp file_url obs://bucket[/key] [-arcDir=xxx] [-dryRun] [-link] [-u] [-vlength] [-vmd5] [-p=1] [-threshold=5248800] [-acl=xxx] [-sc=xxx] [-meta=aaa:bbb#ccc:ddd] [-ps=auto] [-o=xxx] [-cpd=xxx] [-fr] [-o=xxx] [-config=xxx] </pre>
</li><li id="obs_11_0013__li162401213162513">Uploading a folder<pre class="screen" id="obs_11_0013__screen13477182952517">obsutil cp folder_url obs://bucket[/key] -r [-arcDir=xxx] [-dryRun] [-link] [-f] [-flat] [-u] [-vlength] [-vmd5] [-j=1] [-p=1] [-threshold=52428800] [-acl=xxx] [-sc=xxx] [-meta=aaa:bbb#ccc:ddd] [-ps=auto] [-include=*.xxx] [-exclude=*.xxx] [-timeRange=time1-time2] [-mf] [-o=xxx] [-cpd=xxx] [-config=xxx] </pre>
</li><li id="obs_11_0013__li34261510004">Uploading multiple files/folders<pre class="screen" id="obs_11_0013__screen16426171015020">obsutil cp file1_url,folder1_url|filelist_url obs://bucket[/prefix] -msm=1 [-r] [-arcDir=xxx] [-dryRun] [-link] [-f] [-u] [-vlength] [-vmd5] [-flat] [-j=1] [-p=1] [-threshold=52428800] [-acl=xxx] [-sc=xxx] [-meta=aaa:bbb#ccc:ddd] [-ps=auto] [-include=*.xxx] [-exclude=*.xxx][-timeRange=time1-time2] [-at] [-mf] [-o=xxx] [-cpd=xxx] [-config=xxx] </pre>
<div class="note" id="obs_11_0013__note15723610203812"><img src="public_sys-resources/note_3.0-en-us.png"><span class="notetitle"> </span><div class="notebody"><p id="obs_11_0013__p117231210193813">In this command, <strong id="obs_11_0013__b42071337173019">/prefix</strong> is the name prefix for uploading folders. For more examples, see <a href="obs_11_0028.html">Upload</a>.</p>
</div></div>
</li></ul>
</li><li id="obs_11_0013__li7461142911245">In Linux or macOS<ul id="obs_11_0013__ul19781832122716"><li id="obs_11_0013__li13282130132713">Uploading a file<pre class="screen" id="obs_11_0013__screen146603552810">./obsutil cp file_url obs://bucket[/key] [-arcDir=xxx] [-dryRun] [-link] [-u] [-vlength] [-vmd5] [-p=1] [-threshold=5248800] [-acl=xxx] [-sc=xxx] [-meta=aaa:bbb#ccc:ddd] [-ps=auto] [-o=xxx] [-cpd=xxx] [-fr] [-o=xxx] [-config=xxx] </pre>
</li><li id="obs_11_0013__li186411137132711">Uploading a folder<pre class="screen" id="obs_11_0013__screen13485493273">./obsutil cp folder_url obs://bucket[/key] -r [-arcDir=xxx] [-dryRun] [-link] [-f] [-flat] [-u] [-vlength] [-vmd5] [-j=1] [-p=1] [-threshold=52428800] [-acl=xxx] [-sc=xxx] [-meta=aaa:bbb#ccc:ddd] [-ps=auto] [-include=*.xxx] [-exclude=*.xxx] [-timeRange=time1-time2] [-at] [-mf] [-o=xxx] [-cpd=xxx] [-config=xxx] </pre>
</li><li id="obs_11_0013__li15783102710113">Uploading multiple files/folders<pre class="screen" id="obs_11_0013__screen12783527311">./obsutil cp file1_url,folder1_url|filelist_url obs://bucket[/prefix] -msm=1 [-r] [-arcDir=xxx] [-dryRun] [-link] [-f] [-u] [-vlength] [-vmd5] [-flat] [-j=1] [-p=1] [-threshold=52428800] [-acl=xxx] [-sc=xxx] [-meta=aaa:bbb#ccc:ddd] [-ps=auto] [-include=*.xxx] [-exclude=*.xxx][-timeRange=time1-time2] [-mf] [-o=xxx] [-cpd=xxx] [-config=xxx] </pre>
<div class="note" id="obs_11_0013__note42087119455"><img src="public_sys-resources/note_3.0-en-us.png"><span class="notetitle"> </span><div class="notebody"><p id="obs_11_0013__obs_11_0013_p117231210193813">In this command, <strong id="obs_11_0013__obs_11_0013_b42071337173019">/prefix</strong> is the name prefix for uploading folders. For more examples, see <a href="obs_11_0028.html">Upload</a>.</p>
</div></div>
</li></ul>
</li></ul>
</div>
<div class="section" id="obs_11_0013__section12825311152712"><h4 class="sectiontitle">Examples</h4><ul id="obs_11_0013__ul982661182711"><li id="obs_11_0013__li1082661113271">Take the Windows OS as an example. Run the <strong id="obs_11_0013__b457411313143">obsutil cp d:\temp\test.txt obs://bucket-test/key</strong> command to upload the <strong id="obs_11_0013__b13351626289">test.txt</strong> file in the <strong id="obs_11_0013__b184796717283">temp</strong> directory in the <strong id="obs_11_0013__b20216114195415">D:</strong> drive to bucket <strong id="obs_11_0013__b17166181019302">bucket-test</strong> and rename the file as <strong id="obs_11_0013__b1548034519305">key</strong>.<pre class="screen" id="obs_11_0013__screen1382619113279"><strong id="obs_11_0013__b6826181113275">obsutil cp d:\temp\test.txt obs://bucket-test/key</strong>
Start at 2024-09-30 08:11:41.6724827 +0000 UTC
Parallel: 5 Jobs: 5
Threshold: 50.00MB PartSize: auto
VerifyLength: false VerifyMd5: false
CheckpointDir: C:\Users\Administrator\.obsutil_checkpoint
[====================================================] 100.00% 1.68 MB/s 8.46MB/8.46MB 5s
Upload successfully, 8.46MB, n/a, d:\temp\test.txt --&gt; obs://bucket-test/key, cost [5], status [200], request id [0000016979E1D2B2860BB5181229C72C]</pre>
</li></ul>
<ul id="obs_11_0013__ul1582881116275"><li id="obs_11_0013__li158285115275">Take the Windows OS as an example. Run the <strong id="obs_11_0013__b153291461773">obsutil cp d:\temp obs://bucket-test -f -r</strong> command to recursively upload all files and subfolders in the <strong id="obs_11_0013__b730152817319">temp</strong> directory in the <strong id="obs_11_0013__b9193646165319">D:</strong> drive to the <strong id="obs_11_0013__b715414169321">temp</strong> folder in bucket <strong id="obs_11_0013__b17902047143116">bucket-test</strong>.<pre class="screen" id="obs_11_0013__screen1982811119278"><strong id="obs_11_0013__b18828711162710">obsutil cp d:\temp obs://bucket-test -f -r</strong>
Start at 2024-09-30 08:14:12.1406275 +0000 UTC
Parallel: 5 Jobs: 5
Threshold: 50.00MB PartSize: auto
VerifyLength: false VerifyMd5: false
CheckpointDir: C:\Users\Administrator\.obsutil_checkpoint
Task id: 104786c8-27c2-48fc-bc6a-5886596fb0ed
OutputDir: C:\Users\Administrator\.obsutil_output
[========================================================] 100.00% tps:35.71 2.02 KB/s 7.20MB/7.20MB 0s
Succeed count: 5 Failed count: 0
Succeed bytes: xxx
Metrics [max cost:90 ms, min cost:45 ms, average cost:63.80 ms, average tps:35.71, transferred size: 7.20MB]
Task id: 104786c8-27c2-48fc-bc6a-5886596fb0ed</pre>
</li></ul>
<ul id="obs_11_0013__ul2829191132718"><li id="obs_11_0013__li16829141192712">For more examples, see <a href="obs_11_0027.html">Common Examples</a>.</li></ul>
</div>
<div class="section" id="obs_11_0013__section6559191102418"><h4 class="sectiontitle">Parameter Description</h4>
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="obs_11_0013__table10831182114445" frame="border" border="1" rules="all"><thead align="left"><tr id="obs_11_0013__row683212154419"><th align="left" class="cellrowborder" valign="top" width="16.161616161616163%" id="mcps1.3.5.2.1.4.1.1"><p id="obs_11_0013__p118329219446">Parameter</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="25.252525252525253%" id="mcps1.3.5.2.1.4.1.2"><p id="obs_11_0013__p15137125919108">Optional or Mandatory</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="58.58585858585859%" id="mcps1.3.5.2.1.4.1.3"><p id="obs_11_0013__p12832121184414">Description</p>
</th>
</tr>
</thead>
<tbody><tr id="obs_11_0013__row108328217449"><td class="cellrowborder" valign="top" width="16.161616161616163%" headers="mcps1.3.5.2.1.4.1.1 "><p id="obs_11_0013__p64495172515">file_url</p>
</td>
<td class="cellrowborder" valign="top" width="25.252525252525253%" headers="mcps1.3.5.2.1.4.1.2 "><p id="obs_11_0013__p271644516461">Optional for uploading multiple files/folders</p>
<p id="obs_11_0013__p154316502519">Mandatory for uploading a file</p>
</td>
<td class="cellrowborder" valign="top" width="58.58585858585859%" headers="mcps1.3.5.2.1.4.1.3 "><p id="obs_11_0013__p17425512259">The local file path</p>
<ul id="obs_11_0013__ul11986194965014"><li id="obs_11_0013__li39868497505">Do not nest paths when uploading multiple files/folders. For example, you cannot specify <strong id="obs_11_0013__b1848971413517">/a/b/c</strong> and <strong id="obs_11_0013__b435701814519">/a/b/</strong> at the same time.</li><li id="obs_11_0013__li2986194975016">If this parameter is configured when uploading multiple files/folders, <strong id="obs_11_0013__b9663111914354">msm</strong> must be set to <strong id="obs_11_0013__b79301721123515">1</strong>. In this case, use commas (,) to separate multiple file paths, for example, <strong id="obs_11_0013__b11255202563616">file_url1,file_url2</strong>.</li><li id="obs_11_0013__li49864493507">Files and folders can both be included when uploading multiple files/folders. For example, <strong id="obs_11_0013__b16921184147">file_url1,folder_url1,file_url2,folder_url2</strong>.</li></ul>
</td>
</tr>
<tr id="obs_11_0013__row994520519116"><td class="cellrowborder" valign="top" width="16.161616161616163%" headers="mcps1.3.5.2.1.4.1.1 "><p id="obs_11_0013__p1294565714">folder_url</p>
</td>
<td class="cellrowborder" valign="top" width="25.252525252525253%" headers="mcps1.3.5.2.1.4.1.2 "><p id="obs_11_0013__p15401134114611">Optional for uploading multiple files/folders</p>
<p id="obs_11_0013__p2945850113">Mandatory for uploading a folder</p>
</td>
<td class="cellrowborder" valign="top" width="58.58585858585859%" headers="mcps1.3.5.2.1.4.1.3 "><p id="obs_11_0013__p7945859110">The local folder path</p>
<ul id="obs_11_0013__ul11619328115118"><li id="obs_11_0013__li1462002885112">If <strong id="obs_11_0013__b153351113104718">flat</strong> is not configured when uploading a folder, the entire folder is uploaded. If <strong id="obs_11_0013__b393113319502">flat</strong> is configured, all files in the folder are uploaded.</li><li id="obs_11_0013__li14620228105119">Do not nest paths when uploading multiple files/folders. For example, you cannot specify <strong id="obs_11_0013__b2676623141912">/a/b/c</strong> and <strong id="obs_11_0013__b1267742311915">/a/b/</strong> at the same time.</li><li id="obs_11_0013__li17620728195119">If this parameter is configured when uploading multiple files/folders, <strong id="obs_11_0013__b6871116144811">msm</strong> must be set to <strong id="obs_11_0013__b108713164487">1</strong>. In this case, use commas (,) to separate multiple folder paths, for example, <strong id="obs_11_0013__b18872171614815">folder_url1,folder_url2</strong>.</li><li id="obs_11_0013__li1862042815116">Files and folders can both be included when uploading multiple files/folders. For example, <strong id="obs_11_0013__b094155717223">file_url1,folder_url1,file_url2,folder_url2</strong>.</li></ul>
</td>
</tr>
<tr id="obs_11_0013__row695793184611"><td class="cellrowborder" valign="top" width="16.161616161616163%" headers="mcps1.3.5.2.1.4.1.1 "><p id="obs_11_0013__p1095713174613">filelist_url</p>
</td>
<td class="cellrowborder" valign="top" width="25.252525252525253%" headers="mcps1.3.5.2.1.4.1.2 "><p id="obs_11_0013__p11957237464">Optional for uploading multiple files/folders</p>
</td>
<td class="cellrowborder" valign="top" width="58.58585858585859%" headers="mcps1.3.5.2.1.4.1.3 "><p id="obs_11_0013__p4957133194611">The path of the file that contains the list of files/folders to be uploaded. If this parameter is configured, <strong id="obs_11_0013__b1016475513516">msm</strong> must be set to <strong id="obs_11_0013__b164781558155">2</strong>.</p>
<ul id="obs_11_0013__ul78439202526"><li id="obs_11_0013__li48437209527">The list file is in common text file formats, such as TXT and CSV. Each line in the file indicates a file or folder to be uploaded. For example:<p id="obs_11_0013__p1084352045212"><a name="obs_11_0013__li48437209527"></a><a name="li48437209527"></a>file_url1</p>
<p id="obs_11_0013__p188431320195211">file_url2</p>
<p id="obs_11_0013__p16843102015527">folder_url1</p>
<p id="obs_11_0013__p1184382045217">folder_url2</p>
</li><li id="obs_11_0013__li284314207524">Do not nest paths in the list file. For example, you cannot specify <strong id="obs_11_0013__b09236311376">/a/b/c</strong> and <strong id="obs_11_0013__b79238319711">/a/b/</strong> at the same time.</li></ul>
</td>
</tr>
<tr id="obs_11_0013__row1538192203220"><td class="cellrowborder" valign="top" width="16.161616161616163%" headers="mcps1.3.5.2.1.4.1.1 "><p id="obs_11_0013__p154092113211">bucket</p>
</td>
<td class="cellrowborder" valign="top" width="25.252525252525253%" headers="mcps1.3.5.2.1.4.1.2 "><p id="obs_11_0013__p105401120328">Mandatory</p>
</td>
<td class="cellrowborder" valign="top" width="58.58585858585859%" headers="mcps1.3.5.2.1.4.1.3 "><p id="obs_11_0013__p1954062113212">The name of the bucket where you will upload the file or folder</p>
</td>
</tr>
<tr id="obs_11_0013__row823371133212"><td class="cellrowborder" valign="top" width="16.161616161616163%" headers="mcps1.3.5.2.1.4.1.1 "><p id="obs_11_0013__p13233171113215">key</p>
</td>
<td class="cellrowborder" valign="top" width="25.252525252525253%" headers="mcps1.3.5.2.1.4.1.2 "><p id="obs_11_0013__p152331511173216">Optional</p>
</td>
<td class="cellrowborder" valign="top" width="58.58585858585859%" headers="mcps1.3.5.2.1.4.1.3 "><p id="obs_11_0013__p16965474526">The object name or object name prefix specified when uploading a file, or the object name prefix specified when uploading a folder</p>
<p id="obs_11_0013__p7241744611">When uploading a file or folder, the upload path and name change depending on the value of this parameter. The specific rules are as follows:</p>
<ul id="obs_11_0013__ul6871618467"><li id="obs_11_0013__li98717181065">If this parameter is left blank, the object is uploaded to the root directory of the bucket, and the object name is the name of the uploaded file or folder.</li><li id="obs_11_0013__li16594192113619">If this parameter is specified:<ul id="obs_11_0013__ul15791124011198"><li id="obs_11_0013__li6791140141911">If the parameter value ends with a slash (/), the object is uploaded to the directory indicated by this value, and the object name is the parameter value plus the file name, for example, <strong id="obs_11_0013__b1084519233387">folder/filename.txt</strong> or <strong id="obs_11_0013__b8746192711385">folder/foldername</strong>.</li></ul>
<ul id="obs_11_0013__ul8224628122112"><li id="obs_11_0013__li12224182816218">If the parameter value does not end with a slash (/), the object name for the file is the parameter value, for example, <strong id="obs_11_0013__b1058511719492">filename.txt</strong>, and the object name for the folder is the parameter value plus a slash (/), for example, <strong id="obs_11_0013__b27426719817">folder/</strong>, which is also the name of the directory where the folder is uploaded.</li></ul>
</li></ul>
<div class="note" id="obs_11_0013__note14528254193716"><span class="notetitle"> NOTE: </span><div class="notebody"><p id="obs_11_0013__p54049131261">For details about how to use this parameter, see <a href="obs_11_0028.html">Upload</a>.</p>
</div></div>
</td>
</tr>
<tr id="obs_11_0013__row81423312116"><td class="cellrowborder" valign="top" width="16.161616161616163%" headers="mcps1.3.5.2.1.4.1.1 "><p id="obs_11_0013__p123051451513">fr</p>
</td>
<td class="cellrowborder" valign="top" width="25.252525252525253%" headers="mcps1.3.5.2.1.4.1.2 "><p id="obs_11_0013__p113071451811">Optional for uploading a file (additional parameter)</p>
</td>
<td class="cellrowborder" valign="top" width="58.58585858585859%" headers="mcps1.3.5.2.1.4.1.3 "><p id="obs_11_0013__p73101351816">Generates an operation result file when uploading a file.</p>
</td>
</tr>
<tr id="obs_11_0013__row1251145411111"><td class="cellrowborder" valign="top" width="16.161616161616163%" headers="mcps1.3.5.2.1.4.1.1 "><p id="obs_11_0013__p175391756612">flat</p>
</td>
<td class="cellrowborder" valign="top" width="25.252525252525253%" headers="mcps1.3.5.2.1.4.1.2 "><p id="obs_11_0013__p11542185610113">Optional for uploading a folder or multiple files/folders (additional parameter)</p>
</td>
<td class="cellrowborder" valign="top" width="58.58585858585859%" headers="mcps1.3.5.2.1.4.1.3 "><p id="obs_11_0013__p135464561110">Uploads all files in a folder but not the folder itself.</p>
</td>
</tr>
<tr id="obs_11_0013__row1875517442484"><td class="cellrowborder" valign="top" width="16.161616161616163%" headers="mcps1.3.5.2.1.4.1.1 "><p id="obs_11_0013__p7755144410481">arcDir</p>
</td>
<td class="cellrowborder" valign="top" width="25.252525252525253%" headers="mcps1.3.5.2.1.4.1.2 "><p id="obs_11_0013__p13755134434810">Optional (additional parameter)</p>
</td>
<td class="cellrowborder" valign="top" width="58.58585858585859%" headers="mcps1.3.5.2.1.4.1.3 "><p id="obs_11_0013__p1175594410487">The path to which the uploaded files are archived</p>
</td>
</tr>
<tr id="obs_11_0013__row1460211592532"><td class="cellrowborder" valign="top" width="16.161616161616163%" headers="mcps1.3.5.2.1.4.1.1 "><p id="obs_11_0013__p1537517155414">dryRun</p>
</td>
<td class="cellrowborder" valign="top" width="25.252525252525253%" headers="mcps1.3.5.2.1.4.1.2 "><p id="obs_11_0013__p13376216548">Optional (additional parameter)</p>
</td>
<td class="cellrowborder" valign="top" width="58.58585858585859%" headers="mcps1.3.5.2.1.4.1.3 "><p id="obs_11_0013__p1137981175411">Conducts a dry run.</p>
</td>
</tr>
<tr id="obs_11_0013__row91758361333"><td class="cellrowborder" valign="top" width="16.161616161616163%" headers="mcps1.3.5.2.1.4.1.1 "><p id="obs_11_0013__p8177143613314">link</p>
</td>
<td class="cellrowborder" valign="top" width="25.252525252525253%" headers="mcps1.3.5.2.1.4.1.2 "><p id="obs_11_0013__p1817793616310">Optional (additional parameter)</p>
</td>
<td class="cellrowborder" valign="top" width="58.58585858585859%" headers="mcps1.3.5.2.1.4.1.3 "><p id="obs_11_0013__p51771036433">The actual path of a symbolic link for a file or folder</p>
<ul id="obs_11_0013__ul1760719452487"><li id="obs_11_0013__li1607545154811">If this parameter is not specified and the file to be uploaded is a symbolic-link file whose target file does not exist, the exception message "The system cannot find the file specified" will be displayed in Windows OS, while the exception message "No such file or directory" will be displayed in macOS or Linux OS.</li><li id="obs_11_0013__li760794574813">Avoid the symbolic link loop of a folder, otherwise, the upload will exit due to panic. If you do not want the system to panic, set <strong id="obs_11_0013__b1626151403711">panicForSymbolicLinkCircle</strong> to <strong id="obs_11_0013__b89376169376">false</strong> in the configuration file.</li></ul>
</td>
</tr>
<tr id="obs_11_0013__row20808111443516"><td class="cellrowborder" valign="top" width="16.161616161616163%" headers="mcps1.3.5.2.1.4.1.1 "><p id="obs_11_0013__p78083143357">u</p>
</td>
<td class="cellrowborder" valign="top" width="25.252525252525253%" headers="mcps1.3.5.2.1.4.1.2 "><p id="obs_11_0013__p1480891414357">Optional (additional parameter)</p>
</td>
<td class="cellrowborder" valign="top" width="58.58585858585859%" headers="mcps1.3.5.2.1.4.1.3 "><p id="obs_11_0013__p578994017493">Indicates incremental upload.</p>
<p id="obs_11_0013__p20808141443516">If this parameter is set, each file can be uploaded only when it does not exist in the bucket, its size is different from the namesake one in the bucket, or it has the latest modification time.</p>
</td>
</tr>
<tr id="obs_11_0013__row14823182511325"><td class="cellrowborder" valign="top" width="16.161616161616163%" headers="mcps1.3.5.2.1.4.1.1 "><p id="obs_11_0013__p10823125153219">vlength</p>
</td>
<td class="cellrowborder" valign="top" width="25.252525252525253%" headers="mcps1.3.5.2.1.4.1.2 "><p id="obs_11_0013__p12641397348">Optional (additional parameter)</p>
</td>
<td class="cellrowborder" valign="top" width="58.58585858585859%" headers="mcps1.3.5.2.1.4.1.3 "><p id="obs_11_0013__p582315257326">After the upload completes, checks whether the sizes of the objects in the bucket are the same as those of the local files.</p>
</td>
</tr>
<tr id="obs_11_0013__row77547237323"><td class="cellrowborder" valign="top" width="16.161616161616163%" headers="mcps1.3.5.2.1.4.1.1 "><p id="obs_11_0013__p16754102323216">vmd5</p>
</td>
<td class="cellrowborder" valign="top" width="25.252525252525253%" headers="mcps1.3.5.2.1.4.1.2 "><p id="obs_11_0013__p9286153913341">Optional (additional parameter)</p>
</td>
<td class="cellrowborder" valign="top" width="58.58585858585859%" headers="mcps1.3.5.2.1.4.1.3 "><p id="obs_11_0013__p10755202313327">After the upload completes, checks whether the MD5 values of the objects in the bucket are the same as those of the local files.</p>
<ul id="obs_11_0013__ul114181919115212"><li id="obs_11_0013__li66129339527"><strong id="obs_11_0013__b1725915532512">If your object needs encryption, do not use this parameter.</strong></li><li id="obs_11_0013__li341891917526">If the size of the file or folder to be uploaded is too large, using this parameter will degrade the overall performance due to MD5 calculation.</li><li id="obs_11_0013__li641831912526">After the MD5 verification is successful, this parameter value is used for metadata <strong id="obs_11_0013__b7500152914718">x-obs-meta-md5chksum</strong>, for later MD5 verification during download or copy.</li></ul>
</td>
</tr>
<tr id="obs_11_0013__row14988181814356"><td class="cellrowborder" valign="top" width="16.161616161616163%" headers="mcps1.3.5.2.1.4.1.1 "><p id="obs_11_0013__p1098811817356">p</p>
</td>
<td class="cellrowborder" valign="top" width="25.252525252525253%" headers="mcps1.3.5.2.1.4.1.2 "><p id="obs_11_0013__p14989181813352">Optional (additional parameter)</p>
</td>
<td class="cellrowborder" valign="top" width="58.58585858585859%" headers="mcps1.3.5.2.1.4.1.3 "><p id="obs_11_0013__p13711848135315">The maximum number of concurrent uploads for a multipart upload</p>
<p id="obs_11_0013__p49897182353">The default value is the value of <strong id="obs_11_0013__b1717513331595">defaultParallels</strong> in the configuration file.</p>
</td>
</tr>
<tr id="obs_11_0013__row7456112216356"><td class="cellrowborder" valign="top" width="16.161616161616163%" headers="mcps1.3.5.2.1.4.1.1 "><p id="obs_11_0013__p1045612212352">threshold</p>
</td>
<td class="cellrowborder" valign="top" width="25.252525252525253%" headers="mcps1.3.5.2.1.4.1.2 "><p id="obs_11_0013__p74561122123519">Optional (additional parameter)</p>
</td>
<td class="cellrowborder" valign="top" width="58.58585858585859%" headers="mcps1.3.5.2.1.4.1.3 "><p id="obs_11_0013__p98591253175318">The threshold for enabling multipart upload. If the size of the file or folder to be uploaded is smaller than the threshold, upload it directly. Otherwise, a multipart upload is required.</p>
<p id="obs_11_0013__p114561522173511">The default value is the value of <strong id="obs_11_0013__b1231611213145">defaultBigfileThreshold</strong> in the configuration file.</p>
<p id="obs_11_0013__p652135811532">Unit: byte</p>
<p id="obs_11_0013__p165485818553">This parameter value can contain a unit, for example, <strong id="obs_11_0013__b1332844084815">1MB</strong> (indicating 1,048,576 bytes).</p>
<div class="note" id="obs_11_0013__note956121318501"><span class="notetitle"> NOTE: </span><div class="notebody"><p id="obs_11_0013__p988493111015">If you upload a file or folder directly, no part record is generated, and resumable transmission is not supported.</p>
</div></div>
</td>
</tr>
<tr id="obs_11_0013__row13242162823512"><td class="cellrowborder" valign="top" width="16.161616161616163%" headers="mcps1.3.5.2.1.4.1.1 "><p id="obs_11_0013__p324212285352">acl</p>
</td>
<td class="cellrowborder" valign="top" width="25.252525252525253%" headers="mcps1.3.5.2.1.4.1.2 "><p id="obs_11_0013__p82428286353">Optional (additional parameter)</p>
</td>
<td class="cellrowborder" valign="top" width="58.58585858585859%" headers="mcps1.3.5.2.1.4.1.3 "><p id="obs_11_0013__p16593194315565">The access control policies that can be specified for objects when uploading files.</p>
<p id="obs_11_0013__p16811512123619">Possible values are:</p>
<ul id="obs_11_0013__ul1273864144412"><li id="obs_11_0013__li17738649445"><strong id="obs_11_0013__b1593519169162">private</strong>: Only users granted permissions by the object ACL can access the object.</li><li id="obs_11_0013__li1551213137447"><strong id="obs_11_0013__b112021387177">public-read</strong>: Anyone can read objects in the bucket.</li><li id="obs_11_0013__li1287691813449"><strong id="obs_11_0013__b189694511712">public-read-write</strong>: Anyone can read, write, or delete objects in the bucket.</li><li id="obs_11_0013__li427919615012"><strong id="obs_11_0013__b21251133181">bucket-owner-full-control</strong>: Only the bucket owner has full control over objects in the bucket.</li></ul>
</td>
</tr>
<tr id="obs_11_0013__row10780184745015"><td class="cellrowborder" valign="top" width="16.161616161616163%" headers="mcps1.3.5.2.1.4.1.1 "><p id="obs_11_0013__p19533119154211">sc</p>
</td>
<td class="cellrowborder" valign="top" width="25.252525252525253%" headers="mcps1.3.5.2.1.4.1.2 "><p id="obs_11_0013__p4533191944218">Optional (additional parameter)</p>
</td>
<td class="cellrowborder" valign="top" width="58.58585858585859%" headers="mcps1.3.5.2.1.4.1.3 "><p id="obs_11_0013__p44215055914">The storage classes of objects that can be specified when uploading files</p>
<p id="obs_11_0013__p86547153813">Possible values are:</p>
<ul id="obs_11_0013__ul175651814214"><li id="obs_11_0013__li1256512172114"><strong id="obs_11_0013__b15357854249">standard</strong>: Standard storage class. It features low access latency and high throughput, and is applicable to storing frequently accessed data (multiple accesses per month) or data that is smaller than 1 MB.</li><li id="obs_11_0013__li10565181142113"><strong id="obs_11_0013__b769551614253">warm</strong>: Warm storage class. It is ideal for storing infrequently accessed (less than 12 times a year) data, but when needed, the access has to be fast.</li><li id="obs_11_0013__li756616110216"><strong id="obs_11_0013__b367421919259">cold</strong>: Cold storage class. It provides secure, durable, and inexpensive storage for rarely-accessed (once a year) data.</li></ul>
</td>
</tr>
<tr id="obs_11_0013__row15476193193517"><td class="cellrowborder" valign="top" width="16.161616161616163%" headers="mcps1.3.5.2.1.4.1.1 "><p id="obs_11_0013__p15476113117359">meta</p>
</td>
<td class="cellrowborder" valign="top" width="25.252525252525253%" headers="mcps1.3.5.2.1.4.1.2 "><p id="obs_11_0013__p3476173116357">Optional (additional parameter)</p>
</td>
<td class="cellrowborder" valign="top" width="58.58585858585859%" headers="mcps1.3.5.2.1.4.1.3 "><p id="obs_11_0013__p1989915710016">The standard or user-defined metadata that can be specified during file upload</p>
<ul id="obs_11_0013__ul01131372111"><li id="obs_11_0013__li11132372016">Standard metadata includes <strong id="obs_11_0013__b18133162722311">Content-Type</strong>, <strong id="obs_11_0013__b13133527192313">Content-Encoding</strong>, <strong id="obs_11_0013__b111331127122310">Cache-Control</strong>, <strong id="obs_11_0013__b11133162792313">Content-Disposition</strong>, <strong id="obs_11_0013__b7133827192316">Content-Language</strong> and <strong id="obs_11_0013__b8133152732311">Expires</strong>.</li><li id="obs_11_0013__li878422619215">User-defined metadata must be in the format of <em id="obs_11_0013__i1230382119491">key:value</em>. Multiple user-defined metadata items are separated by number signs (#), for example, <em id="obs_11_0013__i64961235184917">key1:value1</em><strong id="obs_11_0013__b204961835174915">#</strong><em id="obs_11_0013__i1849773516498">key2:value2</em><strong id="obs_11_0013__b8497735114917">#</strong><em id="obs_11_0013__i24985356495">key3:value3</em>, which indicates that the file uploaded to the bucket contains three groups of user-defined metadata: <em id="obs_11_0013__i8498835154911">key1:value1</em>, <em id="obs_11_0013__i349914355491">key2:value2</em>, and <em id="obs_11_0013__i449983524919">key3:value3</em>.</li></ul>
</td>
</tr>
<tr id="obs_11_0013__row1898318335357"><td class="cellrowborder" valign="top" width="16.161616161616163%" headers="mcps1.3.5.2.1.4.1.1 "><p id="obs_11_0013__p139834336354">ps</p>
</td>
<td class="cellrowborder" valign="top" width="25.252525252525253%" headers="mcps1.3.5.2.1.4.1.2 "><p id="obs_11_0013__p20983173343511">Optional (additional parameter)</p>
</td>
<td class="cellrowborder" valign="top" width="58.58585858585859%" headers="mcps1.3.5.2.1.4.1.3 "><p id="obs_11_0013__p161953211218">The size of each part in a multipart upload task</p>
<ul id="obs_11_0013__ul1595728151510"><li id="obs_11_0013__li568441015155">The default value is the value of <strong id="obs_11_0013__b133091203392">defaultPartSize</strong> in the configuration file. The parameter can be set to <strong id="obs_11_0013__b138041245143818">auto</strong>. In this case, obsutil automatically configures the part size for each multipart task based on the source file size.</li><li id="obs_11_0013__li42601437111518">Range: <strong id="obs_11_0013__b14286122974417">100KB</strong> to <strong id="obs_11_0013__b213443115445">5GB</strong></li><li id="obs_11_0013__li1976515611152">Unit: byte. This parameter value can contain a unit, for example, <strong id="obs_11_0013__b11367121764512">1MB</strong> (indicating 1,048,576 bytes).</li></ul>
</td>
</tr>
<tr id="obs_11_0013__row83017445358"><td class="cellrowborder" valign="top" width="16.161616161616163%" headers="mcps1.3.5.2.1.4.1.1 "><p id="obs_11_0013__p83084493510">cpd</p>
</td>
<td class="cellrowborder" valign="top" width="25.252525252525253%" headers="mcps1.3.5.2.1.4.1.2 "><p id="obs_11_0013__p830044143513">Optional (additional parameter)</p>
</td>
<td class="cellrowborder" valign="top" width="58.58585858585859%" headers="mcps1.3.5.2.1.4.1.3 "><p id="obs_11_0013__p730944183517">The folder where the part records reside. The default value is <strong id="obs_11_0013__b6834171804617">.obsutil_checkpoint</strong>, the subfolder in the home directory of the user who executes obsutil commands.</p>
<p id="obs_11_0013__p942205114266">A part record is generated during a multipart upload and saved to the <strong id="obs_11_0013__b314713491541">upload</strong> subfolder. After the upload succeeds, its part record is deleted automatically. If the upload fails or is suspended, the system attempts to resume the task according to its part record when you perform the upload the next time.</p>
</td>
</tr>
<tr id="obs_11_0013__row1747449123515"><td class="cellrowborder" valign="top" width="16.161616161616163%" headers="mcps1.3.5.2.1.4.1.1 "><p id="obs_11_0013__p1047849113513">r</p>
</td>
<td class="cellrowborder" valign="top" width="25.252525252525253%" headers="mcps1.3.5.2.1.4.1.2 "><p id="obs_11_0013__p1647749153515">Mandatory for uploading a folder (additional parameter)</p>
<p id="obs_11_0013__p75945581749">Optional for uploading multiple files/folders</p>
</td>
<td class="cellrowborder" valign="top" width="58.58585858585859%" headers="mcps1.3.5.2.1.4.1.3 "><p id="obs_11_0013__p119531818122311">Recursively uploads all files and subfolders within a folder.</p>
</td>
</tr>
<tr id="obs_11_0013__row45081155113516"><td class="cellrowborder" valign="top" width="16.161616161616163%" headers="mcps1.3.5.2.1.4.1.1 "><p id="obs_11_0013__p7508105553515">f</p>
</td>
<td class="cellrowborder" valign="top" width="25.252525252525253%" headers="mcps1.3.5.2.1.4.1.2 "><p id="obs_11_0013__p450895519351">Optional for uploading a folder or multiple files/folders (additional parameter)</p>
</td>
<td class="cellrowborder" valign="top" width="58.58585858585859%" headers="mcps1.3.5.2.1.4.1.3 "><p id="obs_11_0013__p972417362487">Runs in force mode.</p>
</td>
</tr>
<tr id="obs_11_0013__row20127634366"><td class="cellrowborder" valign="top" width="16.161616161616163%" headers="mcps1.3.5.2.1.4.1.1 "><p id="obs_11_0013__p51273333618">j</p>
</td>
<td class="cellrowborder" valign="top" width="25.252525252525253%" headers="mcps1.3.5.2.1.4.1.2 "><p id="obs_11_0013__p989613496247">Optional for uploading a folder or multiple files/folders (additional parameter)</p>
</td>
<td class="cellrowborder" valign="top" width="58.58585858585859%" headers="mcps1.3.5.2.1.4.1.3 "><p id="obs_11_0013__p112661531143816">The maximum number of concurrent tasks for uploading a folder. The default value is the value of <strong id="obs_11_0013__b98238381222">defaultJobs</strong> in the configuration file.</p>
<div class="note" id="obs_11_0013__note891964620819"><span class="notetitle"> NOTE: </span><div class="notebody"><p id="obs_11_0013__p1091964618820">The value is ensured to be greater than or equal to 1.</p>
</div></div>
</td>
</tr>
<tr id="obs_11_0013__row191914363329"><td class="cellrowborder" valign="top" width="16.161616161616163%" headers="mcps1.3.5.2.1.4.1.1 "><p id="obs_11_0013__p119283683216">msm</p>
</td>
<td class="cellrowborder" valign="top" width="25.252525252525253%" headers="mcps1.3.5.2.1.4.1.2 "><p id="obs_11_0013__p10192183618322">Mandatory for uploading multiple files/folders (additional parameter)</p>
</td>
<td class="cellrowborder" valign="top" width="58.58585858585859%" headers="mcps1.3.5.2.1.4.1.3 "><p id="obs_11_0013__p1023319845920">Enables the mode for uploading multiple files/folders. Possible values are <strong id="obs_11_0013__b08451816451">1</strong> and <strong id="obs_11_0013__b14515134114513">2</strong>.</p>
<ul id="obs_11_0013__ul649613229296"><li id="obs_11_0013__li949632210291">If <strong id="obs_11_0013__b13745191585812">msm</strong> is set to <strong id="obs_11_0013__b1574561535820">1</strong>, the source URL indicates a list of file/folder names separated by commas.</li><li id="obs_11_0013__li8496112272912">If <strong id="obs_11_0013__b1655917225911">msm</strong> is set to <strong id="obs_11_0013__b16560325593">2</strong>, the source URL indicates a file containing a list of file/folder names.</li><li id="obs_11_0013__li104961122182918">If the file or folder name already contains commas (,), do not set <strong id="obs_11_0013__b14359937175914">msm</strong> to <strong id="obs_11_0013__b835933713597">1</strong>.</li><li id="obs_11_0013__li1549611226296">If parameter <strong id="obs_11_0013__b125771751135911">r</strong> is not set, the folders in the list will not be uploaded.</li></ul>
</td>
</tr>
<tr id="obs_11_0013__row152961440116"><td class="cellrowborder" valign="top" width="16.161616161616163%" headers="mcps1.3.5.2.1.4.1.1 "><p id="obs_11_0013__p93091157917">exclude</p>
</td>
<td class="cellrowborder" valign="top" width="25.252525252525253%" headers="mcps1.3.5.2.1.4.1.2 "><p id="obs_11_0013__p1631217571015">Optional for uploading a folder or multiple files/folders (additional parameter)</p>
</td>
<td class="cellrowborder" valign="top" width="58.58585858585859%" headers="mcps1.3.5.2.1.4.1.3 "><p id="obs_11_0013__p63147571114">The file matching patterns that are excluded. After this parameter is specified, if the name of the file to be uploaded matches the value of this parameter, the file is skipped. For example, if this parameter is set to <strong id="obs_11_0013__b897203671315">*.txt</strong>, all files whose names end with <strong id="obs_11_0013__b33720197253">.txt</strong> are skipped and not uploaded.</p>
<ul id="obs_11_0013__ul188401919153518"><li id="obs_11_0013__li1055251820408">An asterisk (*) matches any number of characters. For instance, <strong id="obs_11_0013__b4298182662410">abc*.txt</strong> matches all files whose names start with <strong id="obs_11_0013__b16124565243">abc</strong>, contain any number of characters in the middle, and end with <strong id="obs_11_0013__b17421163415255">.txt</strong>.</li><li id="obs_11_0013__li684071918350">A question mark (?) matches any single character. For instance, <strong id="obs_11_0013__b137631023102811">abc?.txt</strong> matches all files whose names start with <strong id="obs_11_0013__b17361153912288">abc</strong>, contain any single character in the middle, and end with <strong id="obs_11_0013__b436173962811">.txt</strong>.</li><li id="obs_11_0013__li084081993510">You can use <strong id="obs_11_0013__b11191451123019">\*</strong> to represent <strong id="obs_11_0013__b51191151103015">*</strong> and <strong id="obs_11_0013__b71191951183014">\?</strong> to represent <strong id="obs_11_0013__b14119135163018">?</strong>.</li><li id="obs_11_0013__li1810485220428">Multiple <strong id="obs_11_0013__b19245162783112">exclude</strong> parameters can be specified, for example, <strong id="obs_11_0013__b132461627153119">-exclude=*.xxx -exclude=*.xxx</strong>.</li></ul>
<p id="obs_11_0013__p12375415107"><strong id="obs_11_0013__b4209145153115">Restrictions</strong>:</p>
<p id="obs_11_0013__p20329121444718">The matching pattern takes effect only for files in the folder.</p>
<div class="note" id="obs_11_0013__note1882615604315"><span class="notetitle"> NOTE: </span><div class="notebody"><ul id="obs_11_0013__ul19839181204319"><li id="obs_11_0013__li12839131264317">You are advised to use quotation marks for the matching pattern to prevent special characters from being escaped by the OS and leading to unexpected results. Use single quotation marks for Linux or macOS and double quotation marks for Windows.</li><li id="obs_11_0013__li2839171212434">The matching pattern applies to the absolute file path (including the file name and file directory).</li></ul>
</div></div>
</td>
</tr>
<tr id="obs_11_0013__row15404620173616"><td class="cellrowborder" valign="top" width="16.161616161616163%" headers="mcps1.3.5.2.1.4.1.1 "><p id="obs_11_0013__p64040209360">include</p>
</td>
<td class="cellrowborder" valign="top" width="25.252525252525253%" headers="mcps1.3.5.2.1.4.1.2 "><p id="obs_11_0013__p1856190112516">Optional for uploading a folder or multiple files/folders (additional parameter)</p>
</td>
<td class="cellrowborder" valign="top" width="58.58585858585859%" headers="mcps1.3.5.2.1.4.1.3 "><p id="obs_11_0013__p85831634179">The file matching patterns that are included. After this parameter is specified, if the name of the file to be uploaded matches the value of this parameter, the file is uploaded. For example, if this parameter is set to <strong id="obs_11_0013__b6220434418">*.txt</strong>, all files whose names end with <strong id="obs_11_0013__b152743144">.txt</strong> are uploaded.</p>
<ul id="obs_11_0013__ul169281816194618"><li id="obs_11_0013__li1992814168465">An asterisk (*) matches any number of characters. For instance, <strong id="obs_11_0013__b1412054523115">abc*.txt</strong> matches all files whose names start with <strong id="obs_11_0013__b16120104512317">abc</strong>, contain any number of characters in the middle, and end with <strong id="obs_11_0013__b14120134515316">.txt</strong>.</li><li id="obs_11_0013__li1592891618462">A question mark (?) matches any single character. For instance, <strong id="obs_11_0013__b33371048113115">abc?.txt</strong> matches all files whose names start with <strong id="obs_11_0013__b2033719482314">abc</strong>, contain any single character in the middle, and end with <strong id="obs_11_0013__b1337164815312">.txt</strong>.</li><li id="obs_11_0013__li18928111611466">You can use <strong id="obs_11_0013__b169912414233">\*</strong> to represent <strong id="obs_11_0013__b5699174102318">*</strong> and <strong id="obs_11_0013__b1770034118239">\?</strong> to represent <strong id="obs_11_0013__b77005419235">?</strong>.</li><li id="obs_11_0013__li1892861615466">Multiple <strong id="obs_11_0013__b1140910589351">include</strong> parameters can be specified, for example, <strong id="obs_11_0013__b9409658193511">-include=*.xxx -include=*.xxx</strong>.</li></ul>
<p id="obs_11_0013__p2094855175020"><strong id="obs_11_0013__b1052374912311">Restrictions</strong>:</p>
<ul id="obs_11_0013__ul19542137205019"><li id="obs_11_0013__li1654213718504">The matching pattern takes effect only for files in the folder.</li><li id="obs_11_0013__li12852141815019">If both the <strong id="obs_11_0013__b157531221152812">exclude</strong> and <strong id="obs_11_0013__b17111524162819">include</strong> parameters are configured, the <strong id="obs_11_0013__b2535153717295">exclude</strong> rules are applied first. If the name of a file to be uploaded does not match <strong id="obs_11_0013__b17585205718232">exclude</strong>, OBS checks whether the file name matches <strong id="obs_11_0013__b753192018306">include</strong>. If yes, the file is uploaded. If no, the file is skipped.</li></ul>
<p id="obs_11_0013__p11421136184615"><strong id="obs_11_0013__b55661663211">Example:</strong></p>
<pre class="screen" id="obs_11_0013__screen18471711115414">./obsutil cp /localpath/ obs://test/ -include=/localpath/2022-12-09/* -f -r</pre>
<p id="obs_11_0013__p128247549531">This command uploads files that are under <strong id="obs_11_0013__b16402537153216">localpath</strong> and start with <strong id="obs_11_0013__b1240273718327">/localpath/2022-12-09/</strong> to bucket <strong id="obs_11_0013__b1640273723218">test</strong>.</p>
<div class="note" id="obs_11_0013__note6126191912710"><span class="notetitle"> NOTE: </span><div class="notebody"><ul id="obs_11_0013__ul144557173539"><li id="obs_11_0013__li37112635220">You are advised to use quotation marks for the matching pattern to prevent special characters from being escaped by the OS and leading to unexpected results. Use single quotation marks for Linux or macOS and double quotation marks for Windows.</li><li id="obs_11_0013__li4721926185215">The matching pattern applies to the absolute file path (including the file name and file directory).</li></ul>
</div></div>
</td>
</tr>
<tr id="obs_11_0013__row1233214161803"><td class="cellrowborder" valign="top" width="16.161616161616163%" headers="mcps1.3.5.2.1.4.1.1 "><p id="obs_11_0013__p193331816903">at</p>
</td>
<td class="cellrowborder" valign="top" width="25.252525252525253%" headers="mcps1.3.5.2.1.4.1.2 "><p id="obs_11_0013__p13333111612018">Optional for uploading a folder or multiple files/folders (additional parameter)</p>
</td>
<td class="cellrowborder" valign="top" width="58.58585858585859%" headers="mcps1.3.5.2.1.4.1.3 "><p id="obs_11_0013__p33335164016">Indicates that only the files whose latest access time is within the value of <strong id="obs_11_0013__b9758743469">timeRange</strong> are uploaded.</p>
<p id="obs_11_0013__p175873775620">This parameter must be used together with <strong id="obs_11_0013__b24271316351">timeRange</strong>.</p>
</td>
</tr>
<tr id="obs_11_0013__row489843319190"><td class="cellrowborder" valign="top" width="16.161616161616163%" headers="mcps1.3.5.2.1.4.1.1 "><p id="obs_11_0013__p68984333198">disableDirObject</p>
</td>
<td class="cellrowborder" valign="top" width="25.252525252525253%" headers="mcps1.3.5.2.1.4.1.2 "><p id="obs_11_0013__p08991330193">Optional for uploading multiple folders (additional parameter)</p>
</td>
<td class="cellrowborder" valign="top" width="58.58585858585859%" headers="mcps1.3.5.2.1.4.1.3 "><p id="obs_11_0013__p9899183312192">Indicates the folders themselves are not uploaded as an object. Configuring this parameter can avoid uploading empty folders to a bucket. If a folder contains files, the files will be uploaded and the original path format is retained.</p>
</td>
</tr>
<tr id="obs_11_0013__row147961525193919"><td class="cellrowborder" valign="top" width="16.161616161616163%" headers="mcps1.3.5.2.1.4.1.1 "><p id="obs_11_0013__p10475132743915">timeRange</p>
</td>
<td class="cellrowborder" valign="top" width="25.252525252525253%" headers="mcps1.3.5.2.1.4.1.2 "><p id="obs_11_0013__p1664510223494">Optional for uploading a folder or multiple files/folders (additional parameter)</p>
</td>
<td class="cellrowborder" valign="top" width="58.58585858585859%" headers="mcps1.3.5.2.1.4.1.3 "><p id="obs_11_0013__p447514276391">The time range matching pattern when uploading files. Only files whose latest modification time is within the configured time range are uploaded.</p>
<p id="obs_11_0013__p138074294535">This pattern has a lower priority than the file matching patterns (<strong id="obs_11_0013__b162911291513">exclude</strong>/<strong id="obs_11_0013__b1845513312516">include</strong>). That is, the time range matching pattern is executed after the configured file matching patterns.</p>
<ul id="obs_11_0013__ul14334173714218"><li id="obs_11_0013__li03341237427">Time in the matching pattern is the UTC time.</li><li id="obs_11_0013__li525317516314">The matching time range is represented in <em id="obs_11_0013__i1423514014413">time1</em><strong id="obs_11_0013__b1023524019442">-</strong><em id="obs_11_0013__i1623564016448">time2</em>, where <em id="obs_11_0013__i2023524016447">time1</em> must be earlier than or the same as <em id="obs_11_0013__i42353404440">time2</em>. The time format is <em id="obs_11_0013__i823654014448">yyyyMMddHHmmss</em>.</li><li id="obs_11_0013__li15253251631">Automatic formatting is supported. For example, <em id="obs_11_0013__i1983412217475">yyyyMMdd</em> is equivalent to <em id="obs_11_0013__i841619311472">yyyyMMdd</em><strong id="obs_11_0013__b4493134194710">000000</strong>, and <em id="obs_11_0013__i197983824718">yyyyMM</em> is equivalent to <em id="obs_11_0013__i71038423477">yyyyMM</em><strong id="obs_11_0013__b171924512474">01000000</strong>.</li><li id="obs_11_0013__li14253185339">If this parameter is set to <strong id="obs_11_0013__b279854154719">*-</strong><em id="obs_11_0013__i680185474714">time2</em>, all files whose last modification time is earlier than <em id="obs_11_0013__i1080654164718">time2</em> are matched. If it is set to <em id="obs_11_0013__i1580554134715">time1</em><strong id="obs_11_0013__b481554104710">-*</strong>, all files whose last modification time is later than <em id="obs_11_0013__i2081135413479">time1</em> are matched.</li></ul>
</td>
</tr>
<tr id="obs_11_0013__row81211271351"><td class="cellrowborder" valign="top" width="16.161616161616163%" headers="mcps1.3.5.2.1.4.1.1 "><p id="obs_11_0013__p10122175516">mf</p>
</td>
<td class="cellrowborder" valign="top" width="25.252525252525253%" headers="mcps1.3.5.2.1.4.1.2 "><p id="obs_11_0013__p1562018121550">Optional (additional parameter)</p>
</td>
<td class="cellrowborder" valign="top" width="58.58585858585859%" headers="mcps1.3.5.2.1.4.1.3 "><p id="obs_11_0013__p31226718512">Indicates that the name matching pattern (<strong id="obs_11_0013__b175395333510">include</strong> or <strong id="obs_11_0013__b15150138193510">exclude</strong>) and the time matching pattern (<strong id="obs_11_0013__b181069271354">timeRange</strong>) also take effect on folders.</p>
</td>
</tr>
<tr id="obs_11_0013__row1015315386301"><td class="cellrowborder" valign="top" width="16.161616161616163%" headers="mcps1.3.5.2.1.4.1.1 "><p id="obs_11_0013__p13911642133014">o</p>
</td>
<td class="cellrowborder" valign="top" width="25.252525252525253%" headers="mcps1.3.5.2.1.4.1.2 "><p id="obs_11_0013__p0913194217303">Optional (additional parameter)</p>
</td>
<td class="cellrowborder" valign="top" width="58.58585858585859%" headers="mcps1.3.5.2.1.4.1.3 "><p id="obs_11_0013__p136841674517">The folder that stores the result files. After the command is executed, result files (possibly success, failure, and warning files) will be created in the specified folder.</p>
<p id="obs_11_0013__p139151442123019">The default value is <strong id="obs_11_0013__b6776156111315">.obsutil_output</strong>, a subfolder in the user's home directory where obsutil commands are executed.</p>
<ul id="obs_11_0013__ul1938211254515"><li id="obs_11_0013__li2092115541966">A result file should be named as follows: <strong id="obs_11_0013__b156465362598">cp_{succeed | failed | warning}_report_</strong><em id="obs_11_0013__i164683611597">time</em><strong id="obs_11_0013__b764619369594">_</strong><em id="obs_11_0013__i3646153695913">TaskId</em><strong id="obs_11_0013__b20646036165919">.txt</strong>.</li><li id="obs_11_0013__li1742813102712">By default, the maximum size of a single result file is 30 MB. You can set the maximum size by configuring <strong id="obs_11_0013__b1514543335">recordMaxLogSize</strong> in the configuration file.</li><li id="obs_11_0013__li1738317251851">By default, the maximum number of result files that can be retained is 1,024. You can set the maximum number by configuring <strong id="obs_11_0013__b2089113154614">recordBackups</strong> in the configuration file.</li><li id="obs_11_0013__li133831325958">If there are multiple folders and files and you need to confirm the details of a failed task, refer to the failure result file <strong id="obs_11_0013__b5396121718320">cp_failed_report_</strong><em id="obs_11_0013__i1639621714325">time</em><strong id="obs_11_0013__b1739631753215">_</strong><em id="obs_11_0013__i203979172328">TaskId</em><strong id="obs_11_0013__b1639718176326">.txt</strong> in the result folder and the <a href="obs_11_0056.html">log files</a> in the log path.</li></ul>
</td>
</tr>
<tr id="obs_11_0013__row14488193110173"><td class="cellrowborder" valign="top" width="16.161616161616163%" headers="mcps1.3.5.2.1.4.1.1 "><p id="obs_11_0013__p114391014518">bucket-cname</p>
</td>
<td class="cellrowborder" valign="top" width="25.252525252525253%" headers="mcps1.3.5.2.1.4.1.2 "><p id="obs_11_0013__p4143210950">Optional (additional parameter)</p>
</td>
<td class="cellrowborder" valign="top" width="58.58585858585859%" headers="mcps1.3.5.2.1.4.1.3 "><p id="obs_11_0013__p16143610251">The user-defined domain name bound to the bucket</p>
<div class="note" id="obs_11_0013__note16256574591"><span class="notetitle"> NOTE: </span><div class="notebody"><p id="obs_11_0013__p172595719595">This parameter is only supported by obsutil 5.7.9 and later.</p>
</div></div>
</td>
</tr>
<tr id="obs_11_0013__row979195743411"><td class="cellrowborder" valign="top" width="16.161616161616163%" headers="mcps1.3.5.2.1.4.1.1 "><p id="obs_11_0013__p153951131317">config</p>
</td>
<td class="cellrowborder" valign="top" width="25.252525252525253%" headers="mcps1.3.5.2.1.4.1.2 "><p id="obs_11_0013__p12395135316">Optional (additional parameter)</p>
</td>
<td class="cellrowborder" valign="top" width="58.58585858585859%" headers="mcps1.3.5.2.1.4.1.3 "><p id="obs_11_0013__obs_11_0008_p1750111452317">The user-defined configuration file for executing the current command. For details about parameters that can be configured, see <a href="obs_11_0035.html">Configuration Parameters</a>.</p>
</td>
</tr>
<tr id="obs_11_0013__row173941339995"><td class="cellrowborder" valign="top" width="16.161616161616163%" headers="mcps1.3.5.2.1.4.1.1 "><p id="obs_11_0013__p1966666191820">payer</p>
</td>
<td class="cellrowborder" valign="top" width="25.252525252525253%" headers="mcps1.3.5.2.1.4.1.2 "><p id="obs_11_0013__p1266611611820">Optional (additional parameter)</p>
</td>
<td class="cellrowborder" valign="top" width="58.58585858585859%" headers="mcps1.3.5.2.1.4.1.3 "><p id="obs_11_0013__p1166617619181">Specifies that requester pays is enabled.</p>
</td>
</tr>
</tbody>
</table>
</div>
</div>
<div class="section" id="obs_11_0013__section6926520122416"><a name="obs_11_0013__section6926520122416"></a><a name="section6926520122416"></a><h4 class="sectiontitle">Response</h4>
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="obs_11_0013__table992610203244" frame="border" border="1" rules="all"><thead align="left"><tr id="obs_11_0013__row892913208248"><th align="left" class="cellrowborder" valign="top" width="21.73%" id="mcps1.3.6.2.1.3.1.1"><p id="obs_11_0013__p1392992019245">Field</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="78.27%" id="mcps1.3.6.2.1.3.1.2"><p id="obs_11_0013__p19318207246">Description</p>
</th>
</tr>
</thead>
<tbody><tr id="obs_11_0013__row79320208248"><td class="cellrowborder" valign="top" width="21.73%" headers="mcps1.3.6.2.1.3.1.1 "><p id="obs_11_0013__p1093217203246">Parallel</p>
</td>
<td class="cellrowborder" valign="top" width="78.27%" headers="mcps1.3.6.2.1.3.1.2 "><p id="obs_11_0013__p18753151115409">The parameter <strong id="obs_11_0013__b19168162103414">-p</strong> in the request</p>
</td>
</tr>
<tr id="obs_11_0013__row1753615812247"><td class="cellrowborder" valign="top" width="21.73%" headers="mcps1.3.6.2.1.3.1.1 "><p id="obs_11_0013__p15536155820245">Jobs</p>
</td>
<td class="cellrowborder" valign="top" width="78.27%" headers="mcps1.3.6.2.1.3.1.2 "><p id="obs_11_0013__p575213111407">The parameter <strong id="obs_11_0013__b153685413416">-j</strong> in the request</p>
</td>
</tr>
<tr id="obs_11_0013__row98643152253"><td class="cellrowborder" valign="top" width="21.73%" headers="mcps1.3.6.2.1.3.1.1 "><p id="obs_11_0013__p8864415102517">Threshold</p>
</td>
<td class="cellrowborder" valign="top" width="78.27%" headers="mcps1.3.6.2.1.3.1.2 "><p id="obs_11_0013__p0751611114014">The parameter <strong id="obs_11_0013__b179171568359">-threshold</strong> in the request</p>
</td>
</tr>
<tr id="obs_11_0013__row14992172352513"><td class="cellrowborder" valign="top" width="21.73%" headers="mcps1.3.6.2.1.3.1.1 "><p id="obs_11_0013__p69926234252">PartSize</p>
</td>
<td class="cellrowborder" valign="top" width="78.27%" headers="mcps1.3.6.2.1.3.1.2 "><p id="obs_11_0013__p3250135316288">The parameter <strong id="obs_11_0013__b995901313915">-ps</strong> in the request</p>
</td>
</tr>
<tr id="obs_11_0013__row1272082862513"><td class="cellrowborder" valign="top" width="21.73%" headers="mcps1.3.6.2.1.3.1.1 "><p id="obs_11_0013__p4720528142516">Exclude</p>
</td>
<td class="cellrowborder" valign="top" width="78.27%" headers="mcps1.3.6.2.1.3.1.2 "><p id="obs_11_0013__p1874911115406">The parameter <strong id="obs_11_0013__b17340175311350">-exclude</strong> in the request</p>
</td>
</tr>
<tr id="obs_11_0013__row48453315255"><td class="cellrowborder" valign="top" width="21.73%" headers="mcps1.3.6.2.1.3.1.1 "><p id="obs_11_0013__p14845531172510">Include</p>
</td>
<td class="cellrowborder" valign="top" width="78.27%" headers="mcps1.3.6.2.1.3.1.2 "><p id="obs_11_0013__p87261611104018">The parameter <strong id="obs_11_0013__b89716773613">-include</strong> in the request</p>
</td>
</tr>
<tr id="obs_11_0013__row34663591518"><td class="cellrowborder" valign="top" width="21.73%" headers="mcps1.3.6.2.1.3.1.1 "><p id="obs_11_0013__p164668597512">TimeRange</p>
</td>
<td class="cellrowborder" valign="top" width="78.27%" headers="mcps1.3.6.2.1.3.1.2 "><p id="obs_11_0013__p846715915511">The parameter <strong id="obs_11_0013__b1172697415">-timeRange</strong> in the request</p>
</td>
</tr>
<tr id="obs_11_0013__row140161714377"><td class="cellrowborder" valign="top" width="21.73%" headers="mcps1.3.6.2.1.3.1.1 "><p id="obs_11_0013__p11402017193717">VerifyLength</p>
</td>
<td class="cellrowborder" valign="top" width="78.27%" headers="mcps1.3.6.2.1.3.1.2 "><p id="obs_11_0013__p1440201715372">The parameter <strong id="obs_11_0013__b14826192963717">-vlength</strong> in the request</p>
</td>
</tr>
<tr id="obs_11_0013__row582401713379"><td class="cellrowborder" valign="top" width="21.73%" headers="mcps1.3.6.2.1.3.1.1 "><p id="obs_11_0013__p88242017193718">VerifyMd5</p>
</td>
<td class="cellrowborder" valign="top" width="78.27%" headers="mcps1.3.6.2.1.3.1.2 "><p id="obs_11_0013__p1782461773716">The parameter <strong id="obs_11_0013__b197032038173712">-vmd5</strong> in the request</p>
</td>
</tr>
<tr id="obs_11_0013__row876382643711"><td class="cellrowborder" valign="top" width="21.73%" headers="mcps1.3.6.2.1.3.1.1 "><p id="obs_11_0013__p147636267379">CheckpointDir</p>
</td>
<td class="cellrowborder" valign="top" width="78.27%" headers="mcps1.3.6.2.1.3.1.2 "><p id="obs_11_0013__p6763142603718">The parameter <strong id="obs_11_0013__b74971747123719">-cpd</strong> in the request</p>
</td>
</tr>
<tr id="obs_11_0013__row55591628103716"><td class="cellrowborder" valign="top" width="21.73%" headers="mcps1.3.6.2.1.3.1.1 "><p id="obs_11_0013__p1555915282373">OutputDir</p>
</td>
<td class="cellrowborder" valign="top" width="78.27%" headers="mcps1.3.6.2.1.3.1.2 "><p id="obs_11_0013__p9559728133714">The parameter <strong id="obs_11_0013__b3350195715375">-o</strong> in the request</p>
</td>
</tr>
<tr id="obs_11_0013__row195514813612"><td class="cellrowborder" valign="top" width="21.73%" headers="mcps1.3.6.2.1.3.1.1 "><p id="obs_11_0013__p5956748113617">ArcDir</p>
</td>
<td class="cellrowborder" valign="top" width="78.27%" headers="mcps1.3.6.2.1.3.1.2 "><p id="obs_11_0013__p1095674853610">The parameter <strong id="obs_11_0013__b900092597">-arcDir</strong> in the request</p>
</td>
</tr>
<tr id="obs_11_0013__row1016394416383"><td class="cellrowborder" valign="top" width="21.73%" headers="mcps1.3.6.2.1.3.1.1 "><p id="obs_11_0013__p17163844123820">Succeed count</p>
</td>
<td class="cellrowborder" valign="top" width="78.27%" headers="mcps1.3.6.2.1.3.1.2 "><p id="obs_11_0013__p2016364413383">The number of successful tasks</p>
</td>
</tr>
<tr id="obs_11_0013__row6534144620386"><td class="cellrowborder" valign="top" width="21.73%" headers="mcps1.3.6.2.1.3.1.1 "><p id="obs_11_0013__p1253444614387">Failed count</p>
</td>
<td class="cellrowborder" valign="top" width="78.27%" headers="mcps1.3.6.2.1.3.1.2 "><p id="obs_11_0013__p11534114619383">The number of failed tasks</p>
</td>
</tr>
<tr id="obs_11_0013__row677892931514"><td class="cellrowborder" valign="top" width="21.73%" headers="mcps1.3.6.2.1.3.1.1 "><p id="obs_11_0013__p677822951511">Skip count</p>
</td>
<td class="cellrowborder" valign="top" width="78.27%" headers="mcps1.3.6.2.1.3.1.2 "><p id="obs_11_0013__p668013391033">The number of tasks that are skipped during incremental upload, download, or copy, and synchronous upload, download, or copy.</p>
<div class="note" id="obs_11_0013__note5200341631"><span class="notetitle"> NOTE: </span><div class="notebody"><p id="obs_11_0013__p120211411639">Skipped tasks are recorded into successful tasks.</p>
</div></div>
</td>
</tr>
<tr id="obs_11_0013__row12422201513596"><td class="cellrowborder" valign="top" width="21.73%" headers="mcps1.3.6.2.1.3.1.1 "><p id="obs_11_0013__p1642251535915">Warning count</p>
</td>
<td class="cellrowborder" valign="top" width="78.27%" headers="mcps1.3.6.2.1.3.1.2 "><p id="obs_11_0013__p342201525916">The number of tasks that are executed successfully but contain warnings.</p>
<div class="note" id="obs_11_0013__note1584392192611"><span class="notetitle"> NOTE: </span><div class="notebody"><ul id="obs_11_0013__ul258175613303"><li id="obs_11_0013__li758225614307">The task for which a warning is generated may be a failure or a success, which needs to be further determined according to the corresponding result list.</li><li id="obs_11_0013__li3453558123010">The number of tasks that generate warnings is independent of the number of successful or failed tasks. The total number of tasks is the number of successful tasks plus the number of failed tasks.</li></ul>
</div></div>
</td>
</tr>
<tr id="obs_11_0013__row849215496713"><td class="cellrowborder" valign="top" width="21.73%" headers="mcps1.3.6.2.1.3.1.1 "><p id="obs_11_0013__p18493144912719">Succeed bytes</p>
</td>
<td class="cellrowborder" valign="top" width="78.27%" headers="mcps1.3.6.2.1.3.1.2 "><p id="obs_11_0013__p949320491272">The number of bytes that are successfully uploaded or downloaded.</p>
</td>
</tr>
<tr id="obs_11_0013__row12341111614385"><td class="cellrowborder" valign="top" width="21.73%" headers="mcps1.3.6.2.1.3.1.1 "><p id="obs_11_0013__p1734191619388">max cost</p>
</td>
<td class="cellrowborder" valign="top" width="78.27%" headers="mcps1.3.6.2.1.3.1.2 "><p id="obs_11_0013__p18341201623819">The maximum duration of all tasks, in ms</p>
</td>
</tr>
<tr id="obs_11_0013__row19779133153819"><td class="cellrowborder" valign="top" width="21.73%" headers="mcps1.3.6.2.1.3.1.1 "><p id="obs_11_0013__p12779113112387">min cost</p>
</td>
<td class="cellrowborder" valign="top" width="78.27%" headers="mcps1.3.6.2.1.3.1.2 "><p id="obs_11_0013__p187791531203811">The minimum duration of all tasks, in ms</p>
</td>
</tr>
<tr id="obs_11_0013__row205051240163810"><td class="cellrowborder" valign="top" width="21.73%" headers="mcps1.3.6.2.1.3.1.1 "><p id="obs_11_0013__p550514083813">average cost</p>
</td>
<td class="cellrowborder" valign="top" width="78.27%" headers="mcps1.3.6.2.1.3.1.2 "><p id="obs_11_0013__p6505204083811">The average duration of all tasks, in ms</p>
</td>
</tr>
<tr id="obs_11_0013__row1429016433910"><td class="cellrowborder" valign="top" width="21.73%" headers="mcps1.3.6.2.1.3.1.1 "><p id="obs_11_0013__p142905433917">average tps</p>
</td>
<td class="cellrowborder" valign="top" width="78.27%" headers="mcps1.3.6.2.1.3.1.2 "><p id="obs_11_0013__p3290104113915">The average number of tasks completed per second</p>
</td>
</tr>
<tr id="obs_11_0013__row537634713394"><td class="cellrowborder" valign="top" width="21.73%" headers="mcps1.3.6.2.1.3.1.1 "><p id="obs_11_0013__p203761947153916">Task id</p>
</td>
<td class="cellrowborder" valign="top" width="78.27%" headers="mcps1.3.6.2.1.3.1.2 "><p id="obs_11_0013__p3376144723919">The unique ID of an operation, which is used to search for the result file generated for a batch task</p>
</td>
</tr>
</tbody>
</table>
</div>
</div>
</div>
<div>
<div class="familylinks">
<div class="parentlink"><strong>Parent topic:</strong> <a href="obs_11_0012.html">Object Commands</a></div>
</div>
</div>
View Git Blame Copy Permalink