yexinru/doc-exports
1
0
Fork 0
forked from docs/doc-exports
Code Pull Requests Activity

OBS Util 0309 Verion

Browse Source 
Reviewed-by: Sabelnikov, Dmitriy <dmitriy.sabelnikov@t-systems.com>
Co-authored-by: weihongmin1 <weihongmin1@huawei.com>
Co-committed-by: weihongmin1 <weihongmin1@huawei.com>
This commit is contained in:
Wei, Hongmin
2026-03-27 12:15:19 +00:00
committed by zuul
parent 8f53a840be
commit c4291b1dd5
64 changed files with 383 additions and 334 deletions
Download Patch File Download Diff File Expand all files Collapse all files

46
docs/obs/tool-obsutil/ALL_META.TXT.json
View File

File diff suppressed because it is too large Load Diff

42
docs/obs/tool-obsutil/CLASS.TXT.json
View File

File diff suppressed because it is too large Load Diff

8
docs/obs/tool-obsutil/obs_11_0000.html
View File

@ -8,7 +8,13 @@
</th> </th>
</tr> </tr>
</thead> </thead>
<tbody><tr id="obs_11_0000__row9868833136"><td class="cellrowborder" valign="top" width="24.240000000000002%" headers="mcps1.3.1.1.3.1.1 "><p id="obs_11_0000__p188681235133">2026-02-12</p> <tbody><tr id="obs_11_0000__row168718222396"><td class="cellrowborder" valign="top" width="24.240000000000002%" headers="mcps1.3.1.1.3.1.1 "><p id="obs_11_0000__p13687142213398">2026-02-28</p>
</td>
<td class="cellrowborder" valign="top" width="75.76%" headers="mcps1.3.1.1.3.1.2 "><p id="obs_11_0000__p17687142283915">This issue is the third official release.</p>
<p id="obs_11_0000__p11457183513917">Updated <a href="obs_11_0061.html">Creating Access Keys (AK and SK)</a>, <a href="obs_11_0005.html">Initializing the Configuration</a>, <a href="obs_11_0006.html">Quick Start</a>, <a href="obs_11_0066.html">Using the obsutil help Command to Search for Functions</a>, <a href="obs_11_0077.html">Why Does obsutil Show a Different Total Object Size Than OBS Console?</a>, and <a href="obs_11_0035.html">Configuration Parameters</a>.</p>
</td>
</tr>
<tr id="obs_11_0000__row9868833136"><td class="cellrowborder" valign="top" width="24.240000000000002%" headers="mcps1.3.1.1.3.1.1 "><p id="obs_11_0000__p188681235133">2026-02-12</p>
</td> </td>
<td class="cellrowborder" valign="top" width="75.76%" headers="mcps1.3.1.1.3.1.2 "><p id="obs_11_0000__p0160139137">This issue is the third official release.</p> <td class="cellrowborder" valign="top" width="75.76%" headers="mcps1.3.1.1.3.1.2 "><p id="obs_11_0000__p0160139137">This issue is the third official release.</p>
<p id="obs_11_0000__p1228521151312">Updated <a href="obs_11_0003.html">Downloading and Installing obsutil</a> by adding obsutil signature files.</p> <p id="obs_11_0000__p1228521151312">Updated <a href="obs_11_0003.html">Downloading and Installing obsutil</a> by adding obsutil signature files.</p>

6
docs/obs/tool-obsutil/obs_11_0001.html
View File

@ -62,9 +62,9 @@
</table> </table>
</div> </div>
</div> </div>
<div class="section" id="obs_11_0001__section547113329618"><h4 class="sectiontitle">Command Line Structures</h4><p id="obs_11_0001__p236115413127">Below describes how to use commands in obsutil:</p> <div class="section" id="obs_11_0001__section547113329618"><h4 class="sectiontitle">Command Line Structure</h4><p id="obs_11_0001__p236115413127">Below describes how to use commands in obsutil:</p>
<ul id="obs_11_0001__ul76317975017"><li id="obs_11_0001__li116359175019">In Windows<p id="obs_11_0001__p1790953211619"><a name="obs_11_0001__li116359175019"></a><a name="li116359175019"></a><strong id="obs_11_0001__b15672515141519">obsutil </strong><em id="obs_11_0001__i103686209158">command</em> <em id="obs_11_0001__i20561425151511">[parameters...]</em> <em id="obs_11_0001__i634062931511">[options...]</em></p> <ul id="obs_11_0001__ul76317975017"><li id="obs_11_0001__li116359175019">Windows<p id="obs_11_0001__p1790953211619"><a name="obs_11_0001__li116359175019"></a><a name="li116359175019"></a><strong id="obs_11_0001__b15672515141519">obsutil </strong><em id="obs_11_0001__i103686209158">command</em> <em id="obs_11_0001__i20561425151511">[parameters...]</em> <em id="obs_11_0001__i634062931511">[options...]</em></p>
</li><li id="obs_11_0001__li11399121645012">In Linux or macOS<p id="obs_11_0001__p2143927135012"><a name="obs_11_0001__li11399121645012"></a><a name="li11399121645012"></a><strong id="obs_11_0001__b12431423202411"><strong id="obs_11_0001__b9243142317241">./</strong>obsutil </strong><em id="obs_11_0001__i10743162417246">command [parameters...] [options...]</em></p> </li><li id="obs_11_0001__li11399121645012">macOS or Linux<p id="obs_11_0001__p2143927135012"><a name="obs_11_0001__li11399121645012"></a><a name="li11399121645012"></a><strong id="obs_11_0001__b12431423202411"><strong id="obs_11_0001__b9243142317241">./</strong>obsutil </strong><em id="obs_11_0001__i10743162417246">command [parameters...] [options...]</em></p>
</li></ul> </li></ul>
<div class="note" id="obs_11_0001__note243793631714"><img src="public_sys-resources/note_3.0-en-us.png"><span class="notetitle"> </span><div class="notebody"><ul id="obs_11_0001__ul1941842151711"><li id="obs_11_0001__li139411442151716"><em id="obs_11_0001__i5488114417405">command</em> indicates the command to execute, for example, <strong id="obs_11_0001__b1419719384206">ls</strong> or <strong id="obs_11_0001__b619911380202">cp</strong>.</li><li id="obs_11_0001__li3148110101815"><em id="obs_11_0001__i0884172519426">parameters</em> indicates mandatory parameters, for example, the bucket name during bucket creation.</li><li id="obs_11_0001__li10580165711819"><em id="obs_11_0001__i19267611164315">options</em> indicates optional parameters. They must start with a hyphen (-).</li><li id="obs_11_0001__li18236578264">Square brackets ([]) are not part of a command. Remove them before executing a specific command.</li><li id="obs_11_0001__li138084514549">You must escape special characters (including &amp; &lt; &gt; and spaces) in a command using quotation marks. Single quotation marks are for Linux or macOS, and double quotation marks for Windows.</li><li id="obs_11_0001__li1599012256714">You can pass additional parameters in the <strong id="obs_11_0001__b2035734912219">-</strong><em id="obs_11_0001__i876825022212">key</em><strong id="obs_11_0001__b1784219591225">=</strong><em id="obs_11_0001__i66911162317">value</em> or <strong id="obs_11_0001__b1927130112310">-</strong><em id="obs_11_0001__i13931830152311">key</em><strong id="obs_11_0001__b1113863692318"> </strong><em id="obs_11_0001__i1999553715238">value</em> format, for example, <strong id="obs_11_0001__b1079615911207">-acl=private</strong>, or <strong id="obs_11_0001__b15798195902013">-acl private</strong>. Both formats are the same. Choose one as you like.</li><li id="obs_11_0001__li1172724912524">In Windows, you can execute <strong id="obs_11_0001__b19656615163910">obsutil.exe</strong> to enter interactive mode. In this mode, you can run <em id="obs_11_0001__i127091507427">command [parameters...] [options...]</em> where <strong id="obs_11_0001__b20857143624016">obsutil</strong> is not needed. Below gives an example:<pre class="screen" id="obs_11_0001__screen1512410439281">Enter "exit" or "quit" to logout <div class="note" id="obs_11_0001__note243793631714"><img src="public_sys-resources/note_3.0-en-us.png"><span class="notetitle"> </span><div class="notebody"><ul id="obs_11_0001__ul1941842151711"><li id="obs_11_0001__li139411442151716"><em id="obs_11_0001__i5488114417405">command</em> indicates the command to execute, for example, <strong id="obs_11_0001__b1419719384206">ls</strong> or <strong id="obs_11_0001__b619911380202">cp</strong>.</li><li id="obs_11_0001__li3148110101815"><em id="obs_11_0001__i0884172519426">parameters</em> indicates mandatory parameters, for example, the bucket name during bucket creation.</li><li id="obs_11_0001__li10580165711819"><em id="obs_11_0001__i19267611164315">options</em> indicates optional parameters. They must start with a hyphen (-).</li><li id="obs_11_0001__li18236578264">Square brackets ([]) are not part of a command. Remove them before executing a specific command.</li><li id="obs_11_0001__li138084514549">You must escape special characters (including &amp; &lt; &gt; and spaces) in a command using quotation marks. Single quotation marks are for Linux or macOS, and double quotation marks for Windows.</li><li id="obs_11_0001__li1599012256714">You can pass additional parameters in the <strong id="obs_11_0001__b2035734912219">-</strong><em id="obs_11_0001__i876825022212">key</em><strong id="obs_11_0001__b1784219591225">=</strong><em id="obs_11_0001__i66911162317">value</em> or <strong id="obs_11_0001__b1927130112310">-</strong><em id="obs_11_0001__i13931830152311">key</em><strong id="obs_11_0001__b1113863692318"> </strong><em id="obs_11_0001__i1999553715238">value</em> format, for example, <strong id="obs_11_0001__b1079615911207">-acl=private</strong>, or <strong id="obs_11_0001__b15798195902013">-acl private</strong>. Both formats are the same. Choose one as you like.</li><li id="obs_11_0001__li1172724912524">In Windows, you can execute <strong id="obs_11_0001__b19656615163910">obsutil.exe</strong> to enter interactive mode. In this mode, you can run <em id="obs_11_0001__i127091507427">command [parameters...] [options...]</em> where <strong id="obs_11_0001__b20857143624016">obsutil</strong> is not needed. Below gives an example:<pre class="screen" id="obs_11_0001__screen1512410439281">Enter "exit" or "quit" to logout
Enter "help" or "help command" to show help docs Enter "help" or "help command" to show help docs

18
docs/obs/tool-obsutil/obs_11_0005.html
View File

@ -5,11 +5,11 @@
<div class="section" id="obs_11_0005__section1544634913019"><h4 class="sectiontitle">Prerequisites</h4><ul id="obs_11_0005__ul3307083115"><li id="obs_11_0005__li13331143810546">You have obtained the enabled <a href="https://docs.otc.t-systems.com/en-us/endpoint/index.html" target="_blank" rel="noopener noreferrer">regions and endpoints</a> of OBS.</li><li id="obs_11_0005__li160201215412">You have obtained the AK/SK. For details, see <a href="obs_11_0061.html">Creating Access Keys (AK and SK)</a>.</li></ul> <div class="section" id="obs_11_0005__section1544634913019"><h4 class="sectiontitle">Prerequisites</h4><ul id="obs_11_0005__ul3307083115"><li id="obs_11_0005__li13331143810546">You have obtained the enabled <a href="https://docs.otc.t-systems.com/en-us/endpoint/index.html" target="_blank" rel="noopener noreferrer">regions and endpoints</a> of OBS.</li><li id="obs_11_0005__li160201215412">You have obtained the AK/SK. For details, see <a href="obs_11_0061.html">Creating Access Keys (AK and SK)</a>.</li></ul>
</div> </div>
<div class="section" id="obs_11_0005__section14490194733410"><h4 class="sectiontitle">obsutil Initialization Methods</h4><p id="obs_11_0005__p109891024174713">Run the <strong id="obs_11_0005__b39661038174512">config</strong> command (for more information about <strong id="obs_11_0005__b1223416587496">config</strong>, see <a href="obs_11_0023.html">Updating a Configuration File</a>):</p> <div class="section" id="obs_11_0005__section14490194733410"><h4 class="sectiontitle">obsutil Initialization Methods</h4><p id="obs_11_0005__p109891024174713">Run the <strong id="obs_11_0005__b39661038174512">config</strong> command (for more information about <strong id="obs_11_0005__b1223416587496">config</strong>, see <a href="obs_11_0023.html">Updating a Configuration File</a>):</p>
<ul id="obs_11_0005__ul61467020416"><li id="obs_11_0005__li41466014413">In Windows<p id="obs_11_0005__p154381470487"><a name="obs_11_0005__li41466014413"></a><a name="li41466014413"></a>Using a permanent AK/SK pair:</p> <ul id="obs_11_0005__ul61467020416"><li id="obs_11_0005__li41466014413">Windows<p id="obs_11_0005__p154381470487"><a name="obs_11_0005__li41466014413"></a><a name="li41466014413"></a>Using a permanent AK/SK pair:</p>
<pre class="screen" id="obs_11_0005__screen176751638361">obsutil config -i=xxxxx -k=xxxxx -e=xxxxx</pre> <pre class="screen" id="obs_11_0005__screen176751638361">obsutil config -i=xxxxx -k=xxxxx -e=xxxxx</pre>
<p id="obs_11_0005__p122011204261">Using a temporary AK/SK pair and a security token:</p> <p id="obs_11_0005__p122011204261">Using a temporary AK/SK pair and a security token:</p>
<pre class="screen" id="obs_11_0005__screen7639102752610">obsutil config -i=xxxxx -k=<em id="obs_11_0005__i20121144719345">xxxxx</em> -t=xxxxx -e=xxxxx</pre> <pre class="screen" id="obs_11_0005__screen7639102752610">obsutil config -i=xxxxx -k=<em id="obs_11_0005__i20121144719345">xxxxx</em> -t=xxxxx -e=xxxxx</pre>
</li><li id="obs_11_0005__li12890105114113">In Linux or macOS<p id="obs_11_0005__p1622461714917"><a name="obs_11_0005__li12890105114113"></a><a name="li12890105114113"></a>Using a permanent AK/SK pair:</p> </li><li id="obs_11_0005__li12890105114113">macOS or Linux<p id="obs_11_0005__p1622461714917"><a name="obs_11_0005__li12890105114113"></a><a name="li12890105114113"></a>Using a permanent AK/SK pair:</p>
<pre class="screen" id="obs_11_0005__screen9505151944110">./obsutil config -i=xxxxx -k=xxxx -e=xxxxx</pre> <pre class="screen" id="obs_11_0005__screen9505151944110">./obsutil config -i=xxxxx -k=xxxx -e=xxxxx</pre>
<p id="obs_11_0005__p1728355511287">Using a temporary AK/SK pair and a security token:</p> <p id="obs_11_0005__p1728355511287">Using a temporary AK/SK pair and a security token:</p>
<pre class="screen" id="obs_11_0005__screen32837557285">./obsutil config -i=xxxxx -k=xxxxx -t=xxxxx -e=xxxxx</pre> <pre class="screen" id="obs_11_0005__screen32837557285">./obsutil config -i=xxxxx -k=xxxxx -t=xxxxx -e=xxxxx</pre>
@ -54,8 +54,8 @@
</table> </table>
</div> </div>
</li></ul> </li></ul>
<div class="note" id="obs_11_0005__note2079015364428"><img src="public_sys-resources/note_3.0-en-us.png"><span class="notetitle"> </span><div class="notebody"><ul id="obs_11_0005__ul638485021317"><li id="obs_11_0005__li113841350191318">After the command is executed, there will be the <strong id="obs_11_0005__b357824115483">.obsutilconfig</strong> file created in the directory (<strong id="obs_11_0005__b19132142519516">~</strong> in Linux or macOS or <strong id="obs_11_0005__b2068008133912">C:\Users\&lt;</strong><em id="obs_11_0005__i4423103398">username</em><strong id="obs_11_0005__b3680187392">&gt;</strong> in Windows) where obsutil commands run. This file contains all the configuration information of obsutil.</li><li id="obs_11_0005__li1730003073815">For details about the parameters in the <strong id="obs_11_0005__b6761106191512">.obsutilconfig</strong> file, see <a href="obs_11_0035.html">Configuration Parameters</a>.</li><li id="obs_11_0005__li1517115240588">The <strong id="obs_11_0005__b121971437183911">.obsutilconfig</strong> file contains the AK/SK information, so it is hidden by default to prevent leakage. To query this file, run the following command in the directory where obsutil commands run.<ul id="obs_11_0005__ul1697953825917"><li id="obs_11_0005__li16256183465919">In Windows<pre class="screen" id="obs_11_0005__screen18944803016">dir </pre> <div class="note" id="obs_11_0005__note2079015364428"><img src="public_sys-resources/note_3.0-en-us.png"><span class="notetitle"> </span><div class="notebody"><ul id="obs_11_0005__ul638485021317"><li id="obs_11_0005__li113841350191318">After the command is executed, there will be the <strong id="obs_11_0005__b357824115483">.obsutilconfig</strong> file created in the directory (<strong id="obs_11_0005__b19132142519516">~</strong> in Linux or macOS or <strong id="obs_11_0005__b2068008133912">C:\Users\&lt;</strong><em id="obs_11_0005__i4423103398">username</em><strong id="obs_11_0005__b3680187392">&gt;</strong> in Windows) where obsutil commands run. This file contains all the configuration information of obsutil.</li><li id="obs_11_0005__li1730003073815">For details about the parameters in the <strong id="obs_11_0005__b6761106191512">.obsutilconfig</strong> file, see <a href="obs_11_0035.html">Configuration Parameters</a>.</li><li id="obs_11_0005__li1517115240588">The <strong id="obs_11_0005__b121971437183911">.obsutilconfig</strong> file contains the AK/SK information, so it is hidden by default to prevent leakage. To query this file, run the following command in the directory where you execute obsutil commands.<ul id="obs_11_0005__ul1697953825917"><li id="obs_11_0005__li16256183465919">Windows<pre class="screen" id="obs_11_0005__screen18944803016">dir </pre>
</li><li id="obs_11_0005__li5935164319598">In Linux or macOS<pre class="screen" id="obs_11_0005__screen167813510213">ls -a </pre> </li><li id="obs_11_0005__li5935164319598">macOS or Linux<pre class="screen" id="obs_11_0005__screen167813510213">ls -a </pre>
<p id="obs_11_0005__p63978307717">or</p> <p id="obs_11_0005__p63978307717">or</p>
<pre class="screen" id="obs_11_0005__screen1264154213717">ls -al</pre> <pre class="screen" id="obs_11_0005__screen1264154213717">ls -al</pre>
</li></ul> </li></ul>
@ -63,7 +63,7 @@
</div></div> </div></div>
</div> </div>
<p id="obs_11_0005__p1185854131714">Method 3: Initialize obsutil in interactive mode.</p> <p id="obs_11_0005__p1185854131714">Method 3: Initialize obsutil in interactive mode.</p>
<ul id="obs_11_0005__ul99281545103710"><li id="obs_11_0005__li2265314184418">In Windows<p id="obs_11_0005__p141032044164918"><a name="obs_11_0005__li2265314184418"></a><a name="li2265314184418"></a>Using a permanent AK/SK pair (you do not need to enter a token, and press <strong id="obs_11_0005__b747871310014">Enter</strong> to skip it):</p> <ul id="obs_11_0005__ul99281545103710"><li id="obs_11_0005__li2265314184418">Windows<p id="obs_11_0005__p141032044164918"><a name="obs_11_0005__li2265314184418"></a><a name="li2265314184418"></a>Using a permanent AK/SK pair (you do not need to enter a token, and just press <strong id="obs_11_0005__b747871310014">Enter</strong> to skip it):</p>
<pre class="screen" id="obs_11_0005__screen215462974415">obsutil config -interactive <pre class="screen" id="obs_11_0005__screen215462974415">obsutil config -interactive
Please input your ak: Please input your ak:
@ -94,7 +94,7 @@ Config file url:
C:\Users\tools\.obsutilconfig C:\Users\tools\.obsutilconfig
Update config file successfully!</pre> Update config file successfully!</pre>
</li><li id="obs_11_0005__li79161684410">In Linux or macOS<p id="obs_11_0005__p5925151115016"><a name="obs_11_0005__li79161684410"></a><a name="li79161684410"></a>Using a permanent AK/SK pair (you do not need to enter a token, and press <strong id="obs_11_0005__b12678229285">Enter</strong> to skip it):</p> </li><li id="obs_11_0005__li79161684410">macOS or Linux<p id="obs_11_0005__p5925151115016"><a name="obs_11_0005__li79161684410"></a><a name="li79161684410"></a>Using a permanent AK/SK pair (you do not need to enter a token, and press <strong id="obs_11_0005__b12678229285">Enter</strong> to skip it):</p>
<pre class="screen" id="obs_11_0005__screen630683194413">./obsutil config -interactive <pre class="screen" id="obs_11_0005__screen630683194413">./obsutil config -interactive
Please input your ak: Please input your ak:
@ -127,11 +127,11 @@ Config file url:
Update config file successfully!</pre> Update config file successfully!</pre>
</li></ul> </li></ul>
<div class="section" id="obs_11_0005__section1048170135411"><h4 class="sectiontitle">Checking the Connectivity</h4><p id="obs_11_0005__p199015385416">After the initial configuration is complete, run the following command to check the connectivity:</p> <div class="section" id="obs_11_0005__section1048170135411"><h4 class="sectiontitle">Checking the Connectivity</h4><p id="obs_11_0005__p199015385416">After the initial configuration is complete, run the following command to check the connectivity:</p>
<ul id="obs_11_0005__ul173105390185"><li id="obs_11_0005__li173101239121813">In Windows<pre class="screen" id="obs_11_0005__screen18391205165">obsutil ls -s</pre> <ul id="obs_11_0005__ul173105390185"><li id="obs_11_0005__li173101239121813">Windows<pre class="screen" id="obs_11_0005__screen18391205165">obsutil ls -s</pre>
</li><li id="obs_11_0005__li681934171911">In Linux or macOS<pre class="screen" id="obs_11_0005__screen54471715121916">./obsutil ls -s</pre> </li><li id="obs_11_0005__li681934171911">macOS or Linux<pre class="screen" id="obs_11_0005__screen54471715121916">./obsutil ls -s</pre>
</li></ul> </li></ul>
<p id="obs_11_0005__p1452915815368">Check the command output:</p> <p id="obs_11_0005__p1452915815368">Check the command output:</p>
<ul id="obs_11_0005__ul157631931518"><li id="obs_11_0005__li376181991519">If it contains "Bucket number", the configuration is correct.</li><li id="obs_11_0005__li10711119141614">If it contains "Http status [403]", the access keys are wrong.</li><li id="obs_11_0005__li19649103911919">If it contains "A connection attempt failed", OBS cannot be connected. Then, check the network condition.</li><li id="obs_11_0005__li13706544314">If it contains "Error: cloud_url [url] is not in well format", the domain name to be accessed is incorrect. Check the domain name in the configuration file.</li></ul> <ul id="obs_11_0005__ul157631931518"><li id="obs_11_0005__li376181991519">If it contains "Bucket number", the configuration is correct.</li><li id="obs_11_0005__li10711119141614">If it contains "Http status [403]", the access keys may be incorrect.</li><li id="obs_11_0005__li19649103911919">If it contains "A connection attempt failed", OBS cannot be connected. Then, check the network condition.</li><li id="obs_11_0005__li13706544314">If it contains "Error: cloud_url [url] is not in well format", the domain name to be accessed is incorrect. Check the domain name in the configuration file.</li></ul>
<div class="note" id="obs_11_0005__note127231141123"><img src="public_sys-resources/note_3.0-en-us.png"><span class="notetitle"> </span><div class="notebody"><p id="obs_11_0005__p37231141721">If the command output contains "Http status [403]", you may not have the required permissions for obtaining the bucket list. A further analysis is required to identify the root cause.</p> <div class="note" id="obs_11_0005__note127231141123"><img src="public_sys-resources/note_3.0-en-us.png"><span class="notetitle"> </span><div class="notebody"><p id="obs_11_0005__p37231141721">If the command output contains "Http status [403]", you may not have the required permissions for obtaining the bucket list. A further analysis is required to identify the root cause.</p>
</div></div> </div></div>
</div> </div>

4
docs/obs/tool-obsutil/obs_11_0006.html
View File

@ -1,8 +1,8 @@
<a name="obs_11_0006"></a><a name="obs_11_0006"></a> <a name="obs_11_0006"></a><a name="obs_11_0006"></a>
<h1 class="topictitle1">Quick Start</h1> <h1 class="topictitle1">Quick Start</h1>
<div id="body1543223109231"><p id="obs_11_0006__p139221232154714">This section uses the Linux OS as an example to describe how to use obsutil to perform basic operations in OBS. For details, see .</p> <div id="body1543223109231"><p id="obs_11_0006__p139221232154714">This section uses Linux as an example to describe how to use obsutil to perform basic operations in OBS.</p>
<div class="section" id="obs_11_0006__section16839141103914"><h4 class="sectiontitle">Prerequisites</h4><ul id="obs_11_0006__ul5731242256"><li id="obs_11_0006__li67313421456">You have obtained obsutil and completed <a href="obs_11_0005.html">initial configuration</a>.</li><li id="obs_11_0006__li167459436511">The directory saving obsutil is accessed.</li></ul> <div class="section" id="obs_11_0006__section16839141103914"><h4 class="sectiontitle">Prerequisites</h4><ul id="obs_11_0006__ul5731242256"><li id="obs_11_0006__li67313421456">You have obtained obsutil and completed <a href="obs_11_0005.html">initial configuration</a>.</li><li id="obs_11_0006__li167459436511">You are in the directory where obsutil is located.</li></ul>
</div> </div>
<div class="section" id="obs_11_0006__section135809001613"><h4 class="sectiontitle">Procedure</h4><ol id="obs_11_0006__ol3968102411523"><li id="obs_11_0006__li396882414524"><span>Run the <strong id="obs_11_0006__b5989104805118">./obsutil mb obs://bucket-test</strong> command to create a bucket named <strong id="obs_11_0006__b132621652192518">bucket-test</strong> in the region.</span><p><pre class="screen" id="obs_11_0006__screen13835524185118"><strong id="obs_11_0006__b69984416325">./obsutil mb obs://bucket-test</strong> <div class="section" id="obs_11_0006__section135809001613"><h4 class="sectiontitle">Procedure</h4><ol id="obs_11_0006__ol3968102411523"><li id="obs_11_0006__li396882414524"><span>Run the <strong id="obs_11_0006__b5989104805118">./obsutil mb obs://bucket-test</strong> command to create a bucket named <strong id="obs_11_0006__b132621652192518">bucket-test</strong> in the region.</span><p><pre class="screen" id="obs_11_0006__screen13835524185118"><strong id="obs_11_0006__b69984416325">./obsutil mb obs://bucket-test</strong>

2
docs/obs/tool-obsutil/obs_11_0008.html
View File

@ -5,7 +5,7 @@
<div class="note" id="obs_11_0008__note722632711349"><img src="public_sys-resources/note_3.0-en-us.png"><span class="notetitle"> </span><div class="notebody"><p id="obs_11_0008__p766115412477">If you create a bucket and name it the same as an existing one in the same account and region, no error will be reported and status code 200 is returned. The bucket properties comply with those set in the first creation request. In other cases, creating a bucket with the same name as an existing one will receive the status code 409, indicating that the bucket already exists.</p> <div class="note" id="obs_11_0008__note722632711349"><img src="public_sys-resources/note_3.0-en-us.png"><span class="notetitle"> </span><div class="notebody"><p id="obs_11_0008__p766115412477">If you create a bucket and name it the same as an existing one in the same account and region, no error will be reported and status code 200 is returned. The bucket properties comply with those set in the first creation request. In other cases, creating a bucket with the same name as an existing one will receive the status code 409, indicating that the bucket already exists.</p>
</div></div> </div></div>
</div> </div>
<div class="section" id="obs_11_0008__section1220752192216"><h4 class="sectiontitle">Command Line Structures</h4><ul id="obs_11_0008__ul832417119303"><li id="obs_11_0008__li19324181113010">Windows<pre class="screen" id="obs_11_0008__screen69741218113010">obsutil mb obs://bucket [-fs] [-acl=xxx] [-sc=xxx] [-location=xxx] [-config=xxx] </pre> <div class="section" id="obs_11_0008__section1220752192216"><h4 class="sectiontitle">Command Line Structure</h4><ul id="obs_11_0008__ul832417119303"><li id="obs_11_0008__li19324181113010">Windows<pre class="screen" id="obs_11_0008__screen69741218113010">obsutil mb obs://bucket [-fs] [-acl=xxx] [-sc=xxx] [-location=xxx] [-config=xxx] </pre>
</li><li id="obs_11_0008__li1476086143015">macOS or Linux<pre class="screen" id="obs_11_0008__screen82451326103012">./obsutil mb obs://bucket [-fs] [-acl=xxx] [-sc=xxx] [-location=xxx] [-config=xxx] </pre> </li><li id="obs_11_0008__li1476086143015">macOS or Linux<pre class="screen" id="obs_11_0008__screen82451326103012">./obsutil mb obs://bucket [-fs] [-acl=xxx] [-sc=xxx] [-location=xxx] [-config=xxx] </pre>
</li></ul> </li></ul>
</div> </div>

8
docs/obs/tool-obsutil/obs_11_0009.html
View File

@ -3,11 +3,11 @@
<h1 class="topictitle1">Listing Buckets</h1> <h1 class="topictitle1">Listing Buckets</h1>
<div id="body1542440101580"><div class="section" id="obs_11_0009__section1479112110815"><h4 class="sectiontitle">Function</h4><p id="obs_11_0009__p07733388177">You can use this command to obtain the bucket list. In the list, bucket names are displayed in lexicographical order.</p> <div id="body1542440101580"><div class="section" id="obs_11_0009__section1479112110815"><h4 class="sectiontitle">Function</h4><p id="obs_11_0009__p07733388177">You can use this command to obtain the bucket list. In the list, bucket names are displayed in lexicographical order.</p>
</div> </div>
<div class="section" id="obs_11_0009__section1220752192216"><h4 class="sectiontitle">Command Line Structure</h4><ul id="obs_11_0009__ul45221840132020"><li id="obs_11_0009__li12524194015203">In Windows<pre class="screen" id="obs_11_0009__screen1959918571209">obsutil ls [-s] [-sc] [-du] [-fs] [-j=1] [-limit=1] [-config=xxx] </pre> <div class="section" id="obs_11_0009__section1220752192216"><h4 class="sectiontitle">Command Line Structure</h4><ul id="obs_11_0009__ul45221840132020"><li id="obs_11_0009__li12524194015203">Windows<pre class="screen" id="obs_11_0009__screen1959918571209">obsutil ls [-s] [-sc] [-du] [-fs] [-j=1] [-limit=1] [-config=xxx] </pre>
</li><li id="obs_11_0009__li8135134682010">In Linux or macOS<pre class="screen" id="obs_11_0009__screen18417544214">./obsutil ls [-s] [-sc] [-du] [-fs] [-j=1] [-limit=1] [-config=xxx] </pre> </li><li id="obs_11_0009__li8135134682010">macOS or Linux<pre class="screen" id="obs_11_0009__screen18417544214">./obsutil ls [-s] [-sc] [-du] [-fs] [-j=1] [-limit=1] [-config=xxx] </pre>
</li></ul> </li></ul>
</div> </div>
<div class="section" id="obs_11_0009__section1364541974317"><h4 class="sectiontitle">Examples</h4><ul id="obs_11_0009__ul6645219174310"><li id="obs_11_0009__li36461519174314">Take the Windows OS as an example. Run the <strong id="obs_11_0009__b129741610194715">obsutil ls -limit=5</strong> command to obtain the bucket list.<pre class="screen" id="obs_11_0009__screen2646161915433"><strong id="obs_11_0009__b36461519194313">obsutil ls -limit=5</strong> <div class="section" id="obs_11_0009__section1364541974317"><h4 class="sectiontitle">Examples</h4><ul id="obs_11_0009__ul6645219174310"><li id="obs_11_0009__li36461519174314">In Windows, run <strong id="obs_11_0009__b129741610194715">obsutil ls -limit=5</strong> to obtain the bucket list.<pre class="screen" id="obs_11_0009__screen2646161915433"><strong id="obs_11_0009__b36461519194313">obsutil ls -limit=5</strong>
Start at 2024-09-29 07:58:46.0506904 +0000 UTC Start at 2024-09-29 07:58:46.0506904 +0000 UTC
Bucket CreationDate Location BucketType Bucket CreationDate Location BucketType
@ -54,7 +54,7 @@ Bucket number : 5</pre>
<td class="cellrowborder" valign="top" width="33.2%" headers="mcps1.3.4.2.1.4.1.2 "><p id="obs_11_0009__p171337309410">Optional (additional parameter). It must be used together with <strong id="obs_11_0009__b770944718612">sc</strong>.</p> <td class="cellrowborder" valign="top" width="33.2%" headers="mcps1.3.4.2.1.4.1.2 "><p id="obs_11_0009__p171337309410">Optional (additional parameter). It must be used together with <strong id="obs_11_0009__b770944718612">sc</strong>.</p>
</td> </td>
<td class="cellrowborder" valign="top" width="48.730000000000004%" headers="mcps1.3.4.2.1.4.1.3 "><p id="obs_11_0009__p1513363013419">The maximum number of concurrent tasks for querying the bucket storage class. The default value is the value of <strong id="obs_11_0009__b129310433513">defaultJobs</strong> in the configuration file.</p> <td class="cellrowborder" valign="top" width="48.730000000000004%" headers="mcps1.3.4.2.1.4.1.3 "><p id="obs_11_0009__p1513363013419">The maximum number of concurrent tasks for querying the bucket storage class. The default value is the value of <strong id="obs_11_0009__b129310433513">defaultJobs</strong> in the configuration file.</p>
<div class="note" id="obs_11_0009__note891964620819"><span class="notetitle"> NOTE: </span><div class="notebody"><p id="obs_11_0009__p1091964618820">The value is ensured to be greater than or equal to 1.</p> <div class="note" id="obs_11_0009__note891964620819"><span class="notetitle"> NOTE: </span><div class="notebody"><p id="obs_11_0009__p1091964618820">The tool ensures that this value is at least 1.</p>
</div></div> </div></div>
</td> </td>
</tr> </tr>

8
docs/obs/tool-obsutil/obs_11_0010.html
View File

@ -3,12 +3,12 @@
<h1 class="topictitle1">Querying Bucket Properties</h1> <h1 class="topictitle1">Querying Bucket Properties</h1>
<div id="body1542440101580"><div class="section" id="obs_11_0010__section1479112110815"><h4 class="sectiontitle">Function</h4><p id="obs_11_0010__p119916332368">You can use this command to query the basic properties of a bucket, including its default storage class, region, version ID, storage usage, bucket quota, whether it supports POSIX, and the number of objects in the bucket.</p> <div id="body1542440101580"><div class="section" id="obs_11_0010__section1479112110815"><h4 class="sectiontitle">Function</h4><p id="obs_11_0010__p119916332368">You can use this command to query the basic properties of a bucket, including its default storage class, region, version ID, storage usage, bucket quota, whether it supports POSIX, and the number of objects in the bucket.</p>
</div> </div>
<div class="section" id="obs_11_0010__section1220752192216"><h4 class="sectiontitle">Command Line Structure</h4><ul id="obs_11_0010__ul16881135652116"><li id="obs_11_0010__li1688113567217">In Windows<pre class="screen" id="obs_11_0010__screen862114142213">obsutil stat obs://bucket [-acl] [-bf=xxx] [-config=xxx] [-payer=xxx]</pre> <div class="section" id="obs_11_0010__section1220752192216"><h4 class="sectiontitle">Command Line Structure</h4><ul id="obs_11_0010__ul16881135652116"><li id="obs_11_0010__li1688113567217">Windows<pre class="screen" id="obs_11_0010__screen862114142213">obsutil stat obs://bucket [-acl] [-bf=xxx] [-config=xxx] [-payer=xxx]</pre>
</li><li id="obs_11_0010__li24662114224">In Linux or macOS<pre class="screen" id="obs_11_0010__screen19225192119226">./obsutil stat obs://bucket [-acl] [-bf=xxx] [-config=xxx] </li><li id="obs_11_0010__li24662114224">macOS or Linux<pre class="screen" id="obs_11_0010__screen19225192119226">./obsutil stat obs://bucket [-acl] [-bf=xxx] [-config=xxx]
[-payer=xxx]</pre> [-payer=xxx]</pre>
</li></ul> </li></ul>
</div> </div>
<div class="section" id="obs_11_0010__section1902103654319"><h4 class="sectiontitle">Examples</h4><ul id="obs_11_0010__ul99021136104310"><li id="obs_11_0010__li2902143644316">Take the Windows OS as an example. Run the <strong id="obs_11_0010__b1749332852013">obsutil stat obs://bucket-test</strong> command to query the basic properties of bucket <strong id="obs_11_0010__b1290120442537">bucket-test</strong>.<pre class="screen" id="obs_11_0010__screen19902113617433"><strong id="obs_11_0010__b190233618430">obsutil stat obs://bucket-test</strong> <div class="section" id="obs_11_0010__section1902103654319"><h4 class="sectiontitle">Examples</h4><ul id="obs_11_0010__ul99021136104310"><li id="obs_11_0010__li2902143644316">In Windows, run <strong id="obs_11_0010__b1749332852013">obsutil stat obs://bucket-test</strong> to query the basic properties of the <strong id="obs_11_0010__b1290120442537">bucket-test</strong> bucket.<pre class="screen" id="obs_11_0010__screen19902113617433"><strong id="obs_11_0010__b190233618430">obsutil stat obs://bucket-test</strong>
Start at 2024-09-29 07:58:46.0506904 +0000 UTC Start at 2024-09-29 07:58:46.0506904 +0000 UTC
@ -82,6 +82,8 @@ Quota:
<td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.4.2.1.4.1.2 "><p id="obs_11_0010__p1266611611820">Optional (additional parameter)</p> <td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.4.2.1.4.1.2 "><p id="obs_11_0010__p1266611611820">Optional (additional parameter)</p>
</td> </td>
<td class="cellrowborder" valign="top" width="57.99999999999999%" headers="mcps1.3.4.2.1.4.1.3 "><p id="obs_11_0010__p1166617619181">Specifies that requester pays is enabled.</p> <td class="cellrowborder" valign="top" width="57.99999999999999%" headers="mcps1.3.4.2.1.4.1.3 "><p id="obs_11_0010__p1166617619181">Specifies that requester pays is enabled.</p>
<p id="obs_11_0010__p13214143095512"><strong id="obs_11_0010__b1059312444440">Range</strong>:</p>
<p id="obs_11_0010__p13744112545515">requester</p>
</td> </td>
</tr> </tr>
</tbody> </tbody>

8
docs/obs/tool-obsutil/obs_11_0011.html
View File

@ -5,11 +5,11 @@
<div class="note" id="obs_11_0011__note1711716215438"><img src="public_sys-resources/note_3.0-en-us.png"><span class="notetitle"> </span><div class="notebody"><p id="obs_11_0011__p1611722112431">To delete a non-empty bucket, run the commands in <a href="obs_11_0020.html">Deleting a Multipart Upload Task</a> and <a href="obs_11_0021.html">Deleting an Object</a> to clear the bucket, and then run the following command to delete the bucket.</p> <div class="note" id="obs_11_0011__note1711716215438"><img src="public_sys-resources/note_3.0-en-us.png"><span class="notetitle"> </span><div class="notebody"><p id="obs_11_0011__p1611722112431">To delete a non-empty bucket, run the commands in <a href="obs_11_0020.html">Deleting a Multipart Upload Task</a> and <a href="obs_11_0021.html">Deleting an Object</a> to clear the bucket, and then run the following command to delete the bucket.</p>
</div></div> </div></div>
</div> </div>
<div class="section" id="obs_11_0011__section1220752192216"><h4 class="sectiontitle">Command Line Structure</h4><ul id="obs_11_0011__ul244723415233"><li id="obs_11_0011__li14447534112318">In Windows<pre class="screen" id="obs_11_0011__screen14572446102313">obsutil rm obs://bucket [-f] [-config=xxx] </pre> <div class="section" id="obs_11_0011__section1220752192216"><h4 class="sectiontitle">Command Line Structure</h4><ul id="obs_11_0011__ul244723415233"><li id="obs_11_0011__li14447534112318">Windows<pre class="screen" id="obs_11_0011__screen14572446102313">obsutil rm obs://bucket [-f] [-config=xxx] </pre>
</li><li id="obs_11_0011__li15751935112310">In Linux or macOS<pre class="screen" id="obs_11_0011__screen172710523237">./obsutil rm obs://bucket [-f] [-config=xxx] </pre> </li><li id="obs_11_0011__li15751935112310">macOS or Linux<pre class="screen" id="obs_11_0011__screen172710523237">./obsutil rm obs://bucket [-f] [-config=xxx] </pre>
</li></ul> </li></ul>
</div> </div>
<div class="section" id="obs_11_0011__section105489664410"><h4 class="sectiontitle">Examples</h4><ul id="obs_11_0011__ul0548196134413"><li id="obs_11_0011__li1548146114410">Take the Windows OS as an example. Run the <strong id="obs_11_0011__b1749332852013">obsutil rm obs://bucket-test</strong> command to delete bucket <strong id="obs_11_0011__b1590635151018">bucket-test</strong>.<pre class="screen" id="obs_11_0011__screen154996164419"><strong id="obs_11_0011__b954936184420">obsutil rm obs://bucket-test</strong> <div class="section" id="obs_11_0011__section105489664410"><h4 class="sectiontitle">Examples</h4><ul id="obs_11_0011__ul0548196134413"><li id="obs_11_0011__li1548146114410">In Windows, run <strong id="obs_11_0011__b1749332852013">obsutil rm obs://bucket-test</strong> to delete bucket <strong id="obs_11_0011__b1590635151018">bucket-test</strong>.<pre class="screen" id="obs_11_0011__screen154996164419"><strong id="obs_11_0011__b954936184420">obsutil rm obs://bucket-test</strong>
Start at 2024-09-30 07:58:33.736622 +0000 UTC Start at 2024-09-30 07:58:33.736622 +0000 UTC
@ -53,6 +53,8 @@ Delete bucket [bucket-test] successfully!</pre>
<td class="cellrowborder" valign="top" width="28.28282828282828%" headers="mcps1.3.4.2.1.4.1.2 "><p id="obs_11_0011__p1266611611820">Optional (additional parameter)</p> <td class="cellrowborder" valign="top" width="28.28282828282828%" headers="mcps1.3.4.2.1.4.1.2 "><p id="obs_11_0011__p1266611611820">Optional (additional parameter)</p>
</td> </td>
<td class="cellrowborder" valign="top" width="55.55555555555556%" headers="mcps1.3.4.2.1.4.1.3 "><p id="obs_11_0011__p1166617619181">Specifies that requester pays is enabled.</p> <td class="cellrowborder" valign="top" width="55.55555555555556%" headers="mcps1.3.4.2.1.4.1.3 "><p id="obs_11_0011__p1166617619181">Specifies that requester pays is enabled.</p>
<p id="obs_11_0011__p13214143095512"><strong id="obs_11_0011__b164097469734524">Range</strong>:</p>
<p id="obs_11_0011__p13744112545515">requester</p>
</td> </td>
</tr> </tr>
</tbody> </tbody>

24
docs/obs/tool-obsutil/obs_11_0013.html
View File

@ -5,15 +5,15 @@
<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 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>
</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 class="section" id="obs_11_0013__section144331226124017"><h4 class="sectiontitle">Constraints</h4><p id="obs_11_0013__p146878203226">obsutil has size limits on uploaded files or folders. You can upload empty files or folders of 0 bytes. A single file can be up to 5 GB in normal upload or up to 48.8 TB in multipart upload.</p>
</div> </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> <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">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__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> </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 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> </div></div>
</li></ul> </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__li7461142911245">macOS or Linux<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__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> </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 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>
@ -21,7 +21,7 @@
</li></ul> </li></ul>
</li></ul> </li></ul>
</div> </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> <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">In Windows, run <strong id="obs_11_0013__b457411313143">obsutil cp d:\temp\test.txt obs://bucket-test/key</strong> to upload the <strong id="obs_11_0013__b13351626289">test.txt</strong> file from the <strong id="obs_11_0013__b184796717283">temp</strong> directory on 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 to <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 Start at 2024-09-30 08:11:41.6724827 +0000 UTC
Parallel: 5 Jobs: 5 Parallel: 5 Jobs: 5
@ -32,7 +32,7 @@ CheckpointDir: C:\Users\Administrator\.obsutil_checkpoint
[====================================================] 100.00% 1.68 MB/s 8.46MB/8.46MB 5s [====================================================] 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> 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> </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> <ul id="obs_11_0013__ul1582881116275"><li id="obs_11_0013__li158285115275">In Windows, run <strong id="obs_11_0013__b153291461773">obsutil cp d:\temp obs://bucket-test -f -r</strong> to recursively upload all files and subfolders in the <strong id="obs_11_0013__b730152817319">temp</strong> directory on 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 Start at 2024-09-30 08:14:12.1406275 +0000 UTC
Parallel: 5 Jobs: 5 Parallel: 5 Jobs: 5
@ -152,7 +152,7 @@ Task id: 104786c8-27c2-48fc-bc6a-5886596fb0ed</pre>
<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 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>
<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> <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> <p id="obs_11_0013__p20808141443516">When this parameter is set, each file is compared with the object at the corresponding path in the bucket. A file is uploaded only when the object does not exist, the object size differs from the file size, or the object was last modified earlier than the file.</p>
</td> </td>
</tr> </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> <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>
@ -195,7 +195,7 @@ Task id: 104786c8-27c2-48fc-bc6a-5886596fb0ed</pre>
<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 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>
<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> <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> <p id="obs_11_0013__p16811512123619">The value can be:</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> <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> </td>
</tr> </tr>
@ -204,7 +204,7 @@ Task id: 104786c8-27c2-48fc-bc6a-5886596fb0ed</pre>
<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 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>
<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> <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> <p id="obs_11_0013__p86547153813">The value can be:</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> <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> </td>
</tr> </tr>
@ -252,7 +252,7 @@ Task id: 104786c8-27c2-48fc-bc6a-5886596fb0ed</pre>
<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 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>
<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> <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 class="note" id="obs_11_0013__note891964620819"><span class="notetitle"> NOTE: </span><div class="notebody"><p id="obs_11_0013__p1091964618820">The tool ensures that this value is at least 1.</p>
</div></div> </div></div>
</td> </td>
</tr> </tr>
@ -352,6 +352,8 @@ Task id: 104786c8-27c2-48fc-bc6a-5886596fb0ed</pre>
<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 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>
<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 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>
<p id="obs_11_0013__p13214143095512"><strong id="obs_11_0013__b42738001334541">Range</strong>:</p>
<p id="obs_11_0013__p13744112545515">requester</p>
</td> </td>
</tr> </tr>
</tbody> </tbody>
@ -397,7 +399,7 @@ Task id: 104786c8-27c2-48fc-bc6a-5886596fb0ed</pre>
</tr> </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> <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>
<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 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__b2103441080">-timeRange</strong> in the request</p>
</td> </td>
</tr> </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> <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>
@ -422,7 +424,7 @@ Task id: 104786c8-27c2-48fc-bc6a-5886596fb0ed</pre>
</tr> </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> <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>
<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 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__b1739135411">-arcDir</strong> in the request</p>
</td> </td>
</tr> </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> <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>

18
docs/obs/tool-obsutil/obs_11_0014.html
View File

@ -3,11 +3,11 @@
<h1 class="topictitle1">Listing Objects</h1> <h1 class="topictitle1">Listing Objects</h1>
<div id="body1542943180896"><div class="section" id="obs_11_0014__section1479112110815"><h4 class="sectiontitle">Function</h4><p id="obs_11_0014__p178478162456">You can use this command to query objects or object versions in a bucket. All objects are listed in lexicographical order by object name and version ID.</p> <div id="body1542943180896"><div class="section" id="obs_11_0014__section1479112110815"><h4 class="sectiontitle">Function</h4><p id="obs_11_0014__p178478162456">You can use this command to query objects or object versions in a bucket. All objects are listed in lexicographical order by object name and version ID.</p>
</div> </div>
<div class="section" id="obs_11_0014__section1220752192216"><h4 class="sectiontitle">Command Line Structure</h4><ul id="obs_11_0014__ul17832169163716"><li id="obs_11_0014__li383219919376">In Windows<pre class="screen" id="obs_11_0014__screen461020247370">obsutil ls obs://bucket[/prefix] [-s] [-d][-fs] [-v] [-du] [-marker=xxx] [-versionIdMarker=xxx] [-bf=xxx] [-limit=1] [-config=xxx] </pre> <div class="section" id="obs_11_0014__section1220752192216"><h4 class="sectiontitle">Command Line Structure</h4><ul id="obs_11_0014__ul17832169163716"><li id="obs_11_0014__li383219919376">Windows<pre class="screen" id="obs_11_0014__screen461020247370">obsutil ls obs://bucket[/prefix] [-s] [-d][-fs] [-v] [-du] [-marker=xxx] [-versionIdMarker=xxx] [-bf=xxx] [-limit=1] [-config=xxx] </pre>
</li><li id="obs_11_0014__li126121614103718">In Linux or macOS<pre class="screen" id="obs_11_0014__screen13336143183713">./obsutil ls obs://bucket[/prefix] [-s][-fs] [-d] [-v] [-du] [-marker=xxx] [-versionIdMarker=xxx] [-bf=xxx] [-limit=1] [-config=xxx] </pre> </li><li id="obs_11_0014__li126121614103718">macOS or Linux<pre class="screen" id="obs_11_0014__screen13336143183713">./obsutil ls obs://bucket[/prefix] [-s][-fs] [-d] [-v] [-du] [-marker=xxx] [-versionIdMarker=xxx] [-bf=xxx] [-limit=1] [-config=xxx] </pre>
</li></ul> </li></ul>
</div> </div>
<div class="section" id="obs_11_0014__section0398183023616"><h4 class="sectiontitle">Examples</h4><ul id="obs_11_0014__ul8399163013612"><li id="obs_11_0014__li639953014362">Example 1: Take the Windows OS as an example. Run the <strong id="obs_11_0014__b1749332852013">obsutil ls obs://bucket-test -limit=10</strong> command to list objects in the bucket.<pre class="screen" id="obs_11_0014__screen8399430143612"><strong id="obs_11_0014__b163995307365">obsutil ls obs://bucket-test -limit=10</strong> <div class="section" id="obs_11_0014__section0398183023616"><h4 class="sectiontitle">Examples</h4><ul id="obs_11_0014__ul8399163013612"><li id="obs_11_0014__li639953014362">Example 1: In Windows, run <strong id="obs_11_0014__b1749332852013">obsutil ls obs://bucket-test -limit=10</strong> to list a limited number of objects in the bucket.<pre class="screen" id="obs_11_0014__screen8399430143612"><strong id="obs_11_0014__b163995307365">obsutil ls obs://bucket-test -limit=10</strong>
Start at 2024-09-30 08:18:50.0592788 +0000 UTC Start at 2024-09-30 08:18:50.0592788 +0000 UTC
Listing objects . Listing objects .
@ -39,7 +39,7 @@ Next marker: api/except.txt
Folder number: 1 Folder number: 1
File number: 9</pre> File number: 9</pre>
</li></ul> </li></ul>
<ul id="obs_11_0014__ul240233011365"><li id="obs_11_0014__li3771142851512">Example 2: Take the Windows OS as an example. Run the <strong id="obs_11_0014__b63981935113015">obsutil ls obs://bucket-test2</strong> command to list objects in the bucket.<pre class="screen" id="obs_11_0014__screen11137105216153"><strong id="obs_11_0014__b10422051151910">obsutil ls obs://bucket-test2</strong> <ul id="obs_11_0014__ul240233011365"><li id="obs_11_0014__li3771142851512">Example 2: In Windows, run <strong id="obs_11_0014__b63981935113015">obsutil ls obs://bucket-test2</strong> to list all objects in the bucket.<pre class="screen" id="obs_11_0014__screen11137105216153"><strong id="obs_11_0014__b10422051151910">obsutil ls obs://bucket-test2</strong>
Start at 2024-09-30 08:21:06.6300221 +0000 UTC Start at 2024-09-30 08:21:06.6300221 +0000 UTC
Listing objects . Listing objects .
@ -58,7 +58,7 @@ obs://bucket-test2/<em id="obs_11_0014__i165161583210">New text file</em>.txt
Total size of bucket: 200B Total size of bucket: 200B
Folder number: 0 Folder number: 0
File number: 4</pre> File number: 4</pre>
</li><li id="obs_11_0014__li147065182011">Example 3: Take the Windows OS as an example. Run the <strong id="obs_11_0014__b18937345945">obsutil ls obs://bucket-test2/prefix</strong> command to list objects whose name prefix is <strong id="obs_11_0014__b1831620531512">prefix</strong> in the bucket.<pre class="screen" id="obs_11_0014__screen63047194215"><strong id="obs_11_0014__b33041419162117">obsutil ls obs://bucket-test2/prefix</strong> </li><li id="obs_11_0014__li147065182011">Example 3: In Windows, run <strong id="obs_11_0014__b18937345945">obsutil ls obs://bucket-test2/prefix</strong> to list objects whose name prefix is <strong id="obs_11_0014__b1831620531512">prefix</strong> in the bucket.<pre class="screen" id="obs_11_0014__screen63047194215"><strong id="obs_11_0014__b33041419162117">obsutil ls obs://bucket-test2/prefix</strong>
Start at 2024-09-30 08:24:36.7057148 +0000 UTC Start at 2024-09-30 08:24:36.7057148 +0000 UTC
Listing objects . Listing objects .
@ -147,7 +147,7 @@ File number: 2</pre>
</td> </td>
<td class="cellrowborder" valign="top" width="26.16%" headers="mcps1.3.4.2.1.4.1.2 "><p id="obs_11_0014__p10301510184317">Optional (additional parameter)</p> <td class="cellrowborder" valign="top" width="26.16%" headers="mcps1.3.4.2.1.4.1.2 "><p id="obs_11_0014__p10301510184317">Optional (additional parameter)</p>
</td> </td>
<td class="cellrowborder" valign="top" width="55.65%" headers="mcps1.3.4.2.1.4.1.3 "><p id="obs_11_0014__p1930171012438">The display formats of bytes in the listing result. Possible values are:</p> <td class="cellrowborder" valign="top" width="55.65%" headers="mcps1.3.4.2.1.4.1.3 "><p id="obs_11_0014__p1930171012438">The display formats of bytes in the listing result. The value can be:</p>
<ul id="obs_11_0014__ul1273864144412"><li id="obs_11_0014__li17738649445">human-readable</li><li id="obs_11_0014__li1551213137447">raw</li></ul> <ul id="obs_11_0014__ul1273864144412"><li id="obs_11_0014__li17738649445">human-readable</li><li id="obs_11_0014__li1551213137447">raw</li></ul>
<div class="note" id="obs_11_0014__note11602143394810"><span class="notetitle"> NOTE: </span><div class="notebody"><p id="obs_11_0014__p6603633154818">If this parameter is not configured, the display format of bytes in the result is determined by the <strong id="obs_11_0014__b12496171034012">humanReadableFormat</strong> parameter in the configuration file.</p> <div class="note" id="obs_11_0014__note11602143394810"><span class="notetitle"> NOTE: </span><div class="notebody"><p id="obs_11_0014__p6603633154818">If this parameter is not configured, the display format of bytes in the result is determined by the <strong id="obs_11_0014__b12496171034012">humanReadableFormat</strong> parameter in the configuration file.</p>
</div></div> </div></div>
@ -160,7 +160,7 @@ File number: 2</pre>
<td class="cellrowborder" valign="top" width="55.65%" headers="mcps1.3.4.2.1.4.1.3 "><p id="obs_11_0014__p1934012791815">Quickly returns the total size of listed objects, without displaying detailed object information. This parameter can be used together with other parameters.</p> <td class="cellrowborder" valign="top" width="55.65%" headers="mcps1.3.4.2.1.4.1.3 "><p id="obs_11_0014__p1934012791815">Quickly returns the total size of listed objects, without displaying detailed object information. This parameter can be used together with other parameters.</p>
<div class="note" id="obs_11_0014__note15561346153618"><span class="notetitle"> NOTE: </span><div class="notebody"><p id="obs_11_0014__p1561446173617">If there are too many objects listed, wait for a while.</p> <div class="note" id="obs_11_0014__note15561346153618"><span class="notetitle"> NOTE: </span><div class="notebody"><p id="obs_11_0014__p1561446173617">If there are too many objects listed, wait for a while.</p>
</div></div> </div></div>
<div class="caution" id="obs_11_0014__note1756975243612"><span class="cautiontitle"> CAUTION: </span><div class="cautionbody"><ul id="obs_11_0014__ul0180655133620"><li id="obs_11_0014__li84645618366">This parameter is only supported by obsutil 5.4.6 and later.</li></ul> <div class="caution" id="obs_11_0014__note1756975243612"><span class="cautiontitle"> CAUTION: </span><div class="cautionbody"><p id="obs_11_0014__p105317202020">This parameter is only supported by obsutil 5.4.6 and later.</p>
</div></div> </div></div>
</td> </td>
</tr> </tr>
@ -194,6 +194,8 @@ File number: 2</pre>
<td class="cellrowborder" valign="top" width="26.16%" headers="mcps1.3.4.2.1.4.1.2 "><p id="obs_11_0014__p1266611611820">Optional (additional parameter)</p> <td class="cellrowborder" valign="top" width="26.16%" headers="mcps1.3.4.2.1.4.1.2 "><p id="obs_11_0014__p1266611611820">Optional (additional parameter)</p>
</td> </td>
<td class="cellrowborder" valign="top" width="55.65%" headers="mcps1.3.4.2.1.4.1.3 "><p id="obs_11_0014__p1166617619181">Specifies that requester pays is enabled.</p> <td class="cellrowborder" valign="top" width="55.65%" headers="mcps1.3.4.2.1.4.1.3 "><p id="obs_11_0014__p1166617619181">Specifies that requester pays is enabled.</p>
<p id="obs_11_0014__p13214143095512"><strong id="obs_11_0014__b2174895234546">Range</strong>:</p>
<p id="obs_11_0014__p13744112545515">requester</p>
</td> </td>
</tr> </tr>
</tbody> </tbody>
@ -224,7 +226,7 @@ File number: 2</pre>
</tr> </tr>
<tr id="obs_11_0014__row14992172352513"><td class="cellrowborder" valign="top" width="21.7%" headers="mcps1.3.5.2.1.3.1.1 "><p id="obs_11_0014__p69926234252">StorageClass</p> <tr id="obs_11_0014__row14992172352513"><td class="cellrowborder" valign="top" width="21.7%" headers="mcps1.3.5.2.1.3.1.1 "><p id="obs_11_0014__p69926234252">StorageClass</p>
</td> </td>
<td class="cellrowborder" valign="top" width="78.3%" headers="mcps1.3.5.2.1.3.1.2 "><p id="obs_11_0014__p3250135316288">The storage class of an object. Possible values are:</p> <td class="cellrowborder" valign="top" width="78.3%" headers="mcps1.3.5.2.1.3.1.2 "><p id="obs_11_0014__p3250135316288">The storage class of an object. The value can be:</p>
<ul id="obs_11_0014__ul175651814214"><li id="obs_11_0014__li1256512172114"><strong id="obs_11_0014__b498911125493">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_0014__li10565181142113"><strong id="obs_11_0014__b634413354914">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_0014__li756616110216"><strong id="obs_11_0014__b662163616499">cold</strong>: Cold storage class. It provides secure, durable, and inexpensive storage for rarely-accessed (once a year) data.</li></ul> <ul id="obs_11_0014__ul175651814214"><li id="obs_11_0014__li1256512172114"><strong id="obs_11_0014__b498911125493">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_0014__li10565181142113"><strong id="obs_11_0014__b634413354914">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_0014__li756616110216"><strong id="obs_11_0014__b662163616499">cold</strong>: Cold storage class. It provides secure, durable, and inexpensive storage for rarely-accessed (once a year) data.</li></ul>
</td> </td>
</tr> </tr>

12
docs/obs/tool-obsutil/obs_11_0015.html
View File

@ -3,11 +3,11 @@
<h1 class="topictitle1">Querying Object Properties</h1> <h1 class="topictitle1">Querying Object Properties</h1>
<div id="body1542943180896"><div class="section" id="obs_11_0015__section444185010363"><h4 class="sectiontitle">Function</h4><p id="obs_11_0015__p582517539363">You can use this command to query the basic properties of an object.</p> <div id="body1542943180896"><div class="section" id="obs_11_0015__section444185010363"><h4 class="sectiontitle">Function</h4><p id="obs_11_0015__p582517539363">You can use this command to query the basic properties of an object.</p>
</div> </div>
<div class="section" id="obs_11_0015__section1220752192216"><h4 class="sectiontitle">Command Line Structure</h4><ul id="obs_11_0015__ul0881135973713"><li id="obs_11_0015__li988185914376">In Windows<pre class="screen" id="obs_11_0015__screen12694238385">obsutil stat obs://bucket/key [-acl][-bf=xxx] [-config=xxx] </pre> <div class="section" id="obs_11_0015__section1220752192216"><h4 class="sectiontitle">Command Line Structure</h4><ul id="obs_11_0015__ul0881135973713"><li id="obs_11_0015__li988185914376">Windows<pre class="screen" id="obs_11_0015__screen12694238385">obsutil stat obs://bucket/key [-acl][-bf=xxx] [-config=xxx] </pre>
</li><li id="obs_11_0015__li24704153817">In Linux or macOS<pre class="screen" id="obs_11_0015__screen937611292388">./obsutil stat obs://bucket/key [-acl][-bf=xxx] [-config=xxx] </pre> </li><li id="obs_11_0015__li24704153817">macOS or Linux<pre class="screen" id="obs_11_0015__screen937611292388">./obsutil stat obs://bucket/key [-acl][-bf=xxx] [-config=xxx] </pre>
</li></ul> </li></ul>
</div> </div>
<div class="section" id="obs_11_0015__section765204912352"><h4 class="sectiontitle">Examples</h4><ul id="obs_11_0015__ul1965184915352"><li id="obs_11_0015__li106664918359">Take the Windows OS as an example. Run the <strong id="obs_11_0015__b457411313143">obsutil stat obs://bucket-test/key</strong> command to query the basic properties of an object.<pre class="screen" id="obs_11_0015__screen26654953516"><strong id="obs_11_0015__b1366349173516">obsutil stat obs://bucket-test/key</strong> <div class="section" id="obs_11_0015__section765204912352"><h4 class="sectiontitle">Examples</h4><ul id="obs_11_0015__ul1965184915352"><li id="obs_11_0015__li106664918359">In Windows, run <strong id="obs_11_0015__b457411313143">obsutil stat obs://bucket-test/key</strong> to query the basic properties of an object.<pre class="screen" id="obs_11_0015__screen26654953516"><strong id="obs_11_0015__b1366349173516">obsutil stat obs://bucket-test/key</strong>
Start at 2024-09-25 04:48:10.1147483 +0000 UTC Start at 2024-09-25 04:48:10.1147483 +0000 UTC
@ -63,7 +63,7 @@ Metadata:
</td> </td>
<td class="cellrowborder" valign="top" width="27%" headers="mcps1.3.4.2.1.4.1.2 "><p id="obs_11_0015__p10301510184317">Optional (additional parameter)</p> <td class="cellrowborder" valign="top" width="27%" headers="mcps1.3.4.2.1.4.1.2 "><p id="obs_11_0015__p10301510184317">Optional (additional parameter)</p>
</td> </td>
<td class="cellrowborder" valign="top" width="56.00000000000001%" headers="mcps1.3.4.2.1.4.1.3 "><p id="obs_11_0015__p1930171012438">The display format of the object size (in bytes). Possible values are:</p> <td class="cellrowborder" valign="top" width="56.00000000000001%" headers="mcps1.3.4.2.1.4.1.3 "><p id="obs_11_0015__p1930171012438">The display format of the object size (in bytes). The value can be:</p>
<ul id="obs_11_0015__en-us_topic_0000001871061785_obs_11_0010_ul1273864144412"><li id="obs_11_0015__en-us_topic_0000001871061785_obs_11_0010_li17738649445"><strong id="obs_11_0015__b94884120914">human-readable</strong>: The object size is displayed in a human-readable format. For example, the object size is displayed in KB, MB, GB, or TB (for instance, 1 GB), rather than in bytes (for instance, 1,073,741,824 bytes, which is a very large number).</li><li id="obs_11_0015__en-us_topic_0000001871061785_obs_11_0010_li1551213137447"><strong id="obs_11_0015__b9290171613917">raw</strong>: The number of bytes is displayed without any conversion or formatting. For example, if the space occupied by an object is 1 GB, the object size is displayed as 1,073,741,824 bytes.</li></ul> <ul id="obs_11_0015__en-us_topic_0000001871061785_obs_11_0010_ul1273864144412"><li id="obs_11_0015__en-us_topic_0000001871061785_obs_11_0010_li17738649445"><strong id="obs_11_0015__b94884120914">human-readable</strong>: The object size is displayed in a human-readable format. For example, the object size is displayed in KB, MB, GB, or TB (for instance, 1 GB), rather than in bytes (for instance, 1,073,741,824 bytes, which is a very large number).</li><li id="obs_11_0015__en-us_topic_0000001871061785_obs_11_0010_li1551213137447"><strong id="obs_11_0015__b9290171613917">raw</strong>: The number of bytes is displayed without any conversion or formatting. For example, if the space occupied by an object is 1 GB, the object size is displayed as 1,073,741,824 bytes.</li></ul>
<p id="obs_11_0015__p66619355810">For common users, the <strong id="obs_11_0015__b1561011483917">human-readable</strong> format is easier to understand. For scenarios where accurate calculation or automatic processing is required, the <strong id="obs_11_0015__b771641951010">raw</strong> format is more suitable.</p> <p id="obs_11_0015__p66619355810">For common users, the <strong id="obs_11_0015__b1561011483917">human-readable</strong> format is easier to understand. For scenarios where accurate calculation or automatic processing is required, the <strong id="obs_11_0015__b771641951010">raw</strong> format is more suitable.</p>
<p id="obs_11_0015__p65632013016">If this parameter is not configured, the display format of the object size (in bytes) is determined by the <strong id="obs_11_0015__b5904932181014">humanReadableFormat</strong> parameter in the configuration file.</p> <p id="obs_11_0015__p65632013016">If this parameter is not configured, the display format of the object size (in bytes) is determined by the <strong id="obs_11_0015__b5904932181014">humanReadableFormat</strong> parameter in the configuration file.</p>
@ -90,6 +90,8 @@ Metadata:
<td class="cellrowborder" valign="top" width="27%" headers="mcps1.3.4.2.1.4.1.2 "><p id="obs_11_0015__p1266611611820">Optional (additional parameter)</p> <td class="cellrowborder" valign="top" width="27%" headers="mcps1.3.4.2.1.4.1.2 "><p id="obs_11_0015__p1266611611820">Optional (additional parameter)</p>
</td> </td>
<td class="cellrowborder" valign="top" width="56.00000000000001%" headers="mcps1.3.4.2.1.4.1.3 "><p id="obs_11_0015__p1166617619181">Specifies that requester pays is enabled.</p> <td class="cellrowborder" valign="top" width="56.00000000000001%" headers="mcps1.3.4.2.1.4.1.3 "><p id="obs_11_0015__p1166617619181">Specifies that requester pays is enabled.</p>
<p id="obs_11_0015__p13214143095512"><strong id="obs_11_0015__b73005520334543">Range</strong>:</p>
<p id="obs_11_0015__p13744112545515">requester</p>
</td> </td>
</tr> </tr>
</tbody> </tbody>
@ -122,7 +124,7 @@ Metadata:
<tr id="obs_11_0015__row11100149145919"><td class="cellrowborder" valign="top" width="21.67%" headers="mcps1.3.5.2.1.3.1.1 "><p id="obs_11_0015__p210114914596">StorageClass</p> <tr id="obs_11_0015__row11100149145919"><td class="cellrowborder" valign="top" width="21.67%" headers="mcps1.3.5.2.1.3.1.1 "><p id="obs_11_0015__p210114914596">StorageClass</p>
</td> </td>
<td class="cellrowborder" valign="top" width="78.33%" headers="mcps1.3.5.2.1.3.1.2 "><p id="obs_11_0015__p11011093596">The storage class of the object</p> <td class="cellrowborder" valign="top" width="78.33%" headers="mcps1.3.5.2.1.3.1.2 "><p id="obs_11_0015__p11011093596">The storage class of the object</p>
<p id="obs_11_0015__en-us_topic_0000001871061785_obs_11_0041_p86547153813">Possible values are:</p> <p id="obs_11_0015__en-us_topic_0000001871061785_obs_11_0041_p86547153813">The value can be:</p>
<ul id="obs_11_0015__en-us_topic_0000001871061785_obs_11_0041_ul175651814214"><li id="obs_11_0015__en-us_topic_0000001871061785_obs_11_0041_li1256512172114"><strong id="obs_11_0015__b1944917476157">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_0015__en-us_topic_0000001871061785_obs_11_0041_li10565181142113"><strong id="obs_11_0015__b26841581179">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_0015__en-us_topic_0000001871061785_obs_11_0041_li756616110216"><strong id="obs_11_0015__b18144101301815">cold</strong>: Cold storage class. It provides secure, durable, and inexpensive storage for rarely-accessed (once a year) data. <strong id="obs_11_0015__b14308135617219">For an object whose storage class is cold, restore the object first and then specify its storage class.</strong></li></ul> <ul id="obs_11_0015__en-us_topic_0000001871061785_obs_11_0041_ul175651814214"><li id="obs_11_0015__en-us_topic_0000001871061785_obs_11_0041_li1256512172114"><strong id="obs_11_0015__b1944917476157">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_0015__en-us_topic_0000001871061785_obs_11_0041_li10565181142113"><strong id="obs_11_0015__b26841581179">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_0015__en-us_topic_0000001871061785_obs_11_0041_li756616110216"><strong id="obs_11_0015__b18144101301815">cold</strong>: Cold storage class. It provides secure, durable, and inexpensive storage for rarely-accessed (once a year) data. <strong id="obs_11_0015__b14308135617219">For an object whose storage class is cold, restore the object first and then specify its storage class.</strong></li></ul>
</td> </td>
</tr> </tr>

16
docs/obs/tool-obsutil/obs_11_0016.html
View File

@ -5,23 +5,23 @@
<div class="note" id="obs_11_0016__note3598947145714"><img src="public_sys-resources/note_3.0-en-us.png"><span class="notetitle"> </span><div class="notebody"><ul id="obs_11_0016__ul963183695212"><li id="obs_11_0016__li9877143719529">Object content cannot be read during restoration.</li><li id="obs_11_0016__li186311736165217">After an object is restored, the time it requires before the object can be downloaded depends on the OBS server.</li></ul> <div class="note" id="obs_11_0016__note3598947145714"><img src="public_sys-resources/note_3.0-en-us.png"><span class="notetitle"> </span><div class="notebody"><ul id="obs_11_0016__ul963183695212"><li id="obs_11_0016__li9877143719529">Object content cannot be read during restoration.</li><li id="obs_11_0016__li186311736165217">After an object is restored, the time it requires before the object can be downloaded depends on the OBS server.</li></ul>
</div></div> </div></div>
</div> </div>
<div class="section" id="obs_11_0016__section1220752192216"><h4 class="sectiontitle">Command Line Structure</h4><ul id="obs_11_0016__ul32951416429"><li id="obs_11_0016__li142951434215">In Windows<ul id="obs_11_0016__ul5962113824220"><li id="obs_11_0016__li8499215164214">Restoring an object<pre class="screen" id="obs_11_0016__screen16977161084320">obsutil restore obs://bucket/key [-d=1] [-t=xxx] [-versionId=xxx] [-fr] [-o=xxx] [-config=xxx] </pre> <div class="section" id="obs_11_0016__section1220752192216"><h4 class="sectiontitle">Command Line Structure</h4><ul id="obs_11_0016__ul32951416429"><li id="obs_11_0016__li142951434215">Windows<ul id="obs_11_0016__ul5962113824220"><li id="obs_11_0016__li8499215164214">Restoring an object<pre class="screen" id="obs_11_0016__screen16977161084320">obsutil restore obs://bucket/key [-d=1] [-t=xxx] [-versionId=xxx] [-fr] [-o=xxx] [-config=xxx] </pre>
</li><li id="obs_11_0016__li8697240164212">Restoring objects in batches<pre class="screen" id="obs_11_0016__screen11339921144314">obsutil restore obs://bucket[/key] -r [-f] [-v] [-d=1] [-t=xxx] [-o=xxx] [-j=1] [-config=xxx] </pre> </li><li id="obs_11_0016__li8697240164212">Restoring objects in batches<pre class="screen" id="obs_11_0016__screen11339921144314">obsutil restore obs://bucket[/key] -r [-f] [-v] [-d=1] [-t=xxx] [-o=xxx] [-j=1] [-config=xxx] </pre>
</li><li id="obs_11_0016__li92911844165118">Restoring all objects in a specific directory at a time<pre class="screen" id="obs_11_0016__screen129971754523">obsutil restore obs://bucket/folder/ -r [-f] [-v] [-d=1] [-t=xxx] [-o=xxx] [-j=1] [-config=xxx] </pre> </li><li id="obs_11_0016__li92911844165118">Restoring all objects in a specific directory at a time<pre class="screen" id="obs_11_0016__screen129971754523">obsutil restore obs://bucket/folder/ -r [-f] [-v] [-d=1] [-t=xxx] [-o=xxx] [-j=1] [-config=xxx] </pre>
</li></ul> </li></ul>
</li><li id="obs_11_0016__li127625913427">In Linux or macOS<ul id="obs_11_0016__ul4131155724212"><li id="obs_11_0016__li194641957154213">Restoring an object<pre class="screen" id="obs_11_0016__screen3230328154320">./obsutil restore obs://bucket/key [-d=1] [-t=xxx] [-versionId=xxx] [-fr] [-o=xxx] [-config=xxx] </pre> </li><li id="obs_11_0016__li127625913427">macOS or Linux<ul id="obs_11_0016__ul4131155724212"><li id="obs_11_0016__li194641957154213">Restoring an object<pre class="screen" id="obs_11_0016__screen3230328154320">./obsutil restore obs://bucket/key [-d=1] [-t=xxx] [-versionId=xxx] [-fr] [-o=xxx] [-config=xxx] </pre>
</li><li id="obs_11_0016__li20465957124217">Restoring objects in batches<pre class="screen" id="obs_11_0016__screen893173654318">./obsutil restore obs://bucket[/key] -r [-f] [-v] [-d=1] [-t=xxx] [-o=xxx] [-j=1] [-config=xxx] </pre> </li><li id="obs_11_0016__li20465957124217">Restoring objects in batches<pre class="screen" id="obs_11_0016__screen893173654318">./obsutil restore obs://bucket[/key] -r [-f] [-v] [-d=1] [-t=xxx] [-o=xxx] [-j=1] [-config=xxx] </pre>
</li></ul> </li></ul>
<ul id="obs_11_0016__ul206769221528"><li id="obs_11_0016__li1196143525216">Restoring all objects in a specific directory at a time<pre class="screen" id="obs_11_0016__screen1096163595219">./obsutil restore obs://bucket/folder/ -r [-f] [-v] [-d=1] [-t=xxx] [-o=xxx] [-j=1] [-config=xxx] </pre> <ul id="obs_11_0016__ul206769221528"><li id="obs_11_0016__li1196143525216">Restoring all objects in a specific directory at a time<pre class="screen" id="obs_11_0016__screen1096163595219">./obsutil restore obs://bucket/folder/ -r [-f] [-v] [-d=1] [-t=xxx] [-o=xxx] [-j=1] [-config=xxx] </pre>
</li></ul> </li></ul>
</li></ul> </li></ul>
</div> </div>
<div class="section" id="obs_11_0016__section149663134016"><h4 class="sectiontitle">Examples</h4><ul id="obs_11_0016__ul1696103154019"><li id="obs_11_0016__li59611312407">Take the Windows OS as an example. Run the <strong id="obs_11_0016__b457411313143">obsutil restore obs://bucket-test/key</strong> command to restore a single object whose storage class is <strong id="obs_11_0016__b10181512122112">cold</strong>.<pre class="screen" id="obs_11_0016__screen10968318408"><strong id="obs_11_0016__b39603164016">obsutil restore obs://bucket-test/key</strong> <div class="section" id="obs_11_0016__section149663134016"><h4 class="sectiontitle">Examples</h4><ul id="obs_11_0016__ul1696103154019"><li id="obs_11_0016__li59611312407">In Windows, run <strong id="obs_11_0016__b2557350152320">obsutil restore obs://bucket-test/key</strong> to restore a single object whose storage class is <strong id="obs_11_0016__b105576505234">cold</strong>.<pre class="screen" id="obs_11_0016__screen10968318408"><strong id="obs_11_0016__b39603164016">obsutil restore obs://bucket-test/key</strong>
Start at 2024-09-30 08:56:17.9537365 +0000 UTC Start at 2024-09-30 08:56:17.9537365 +0000 UTC
Start to restore object [key] in the bucket [bucket-test] successfully, cost [252] ms, request id [0000019242250F754015F23EE0B7876E]</pre> Start to restore object [key] in the bucket [bucket-test] successfully, cost [252] ms, request id [0000019242250F754015F23EE0B7876E]</pre>
</li></ul> </li></ul>
<ul id="obs_11_0016__ul59617311406"><li id="obs_11_0016__li8961237402">Take the Windows OS as an example. Run the <strong id="obs_11_0016__b18473949377">obsutil restore obs://bucket-test -r -f</strong> command to restore objects whose storage class is <strong id="obs_11_0016__b19660057122113">cold</strong> in the bucket in batches.<pre class="screen" id="obs_11_0016__screen6966311401"><strong id="obs_11_0016__b59693124011">obsutil restore obs://bucket-test -r -f</strong> <ul id="obs_11_0016__ul59617311406"><li id="obs_11_0016__li8961237402">In Windows, run <strong id="obs_11_0016__b18473949377">obsutil restore obs://bucket-test -r -f</strong> to restore all objects whose storage class is <strong id="obs_11_0016__b19660057122113">cold</strong> in the bucket.<pre class="screen" id="obs_11_0016__screen6966311401"><strong id="obs_11_0016__b59693124011">obsutil restore obs://bucket-test -r -f</strong>
Start at 2024-09-30 08:57:11.3565648 +0000 UTC Start at 2024-09-30 08:57:11.3565648 +0000 UTC
[================================================] 100.00% 3s [================================================] 100.00% 3s
@ -67,9 +67,9 @@ Task id: 96f104ee-d0bf-40ff-95dd-31dec0d8f4f4</pre>
</td> </td>
<td class="cellrowborder" valign="top" width="24.7%" headers="mcps1.3.4.2.1.4.1.2 "><p id="obs_11_0016__p97961933415">Optional (additional parameter)</p> <td class="cellrowborder" valign="top" width="24.7%" headers="mcps1.3.4.2.1.4.1.2 "><p id="obs_11_0016__p97961933415">Optional (additional parameter)</p>
</td> </td>
<td class="cellrowborder" valign="top" width="58.46%" headers="mcps1.3.4.2.1.4.1.3 "><p id="obs_11_0016__p579611319412">The options for restoring objects. Possible values are:</p> <td class="cellrowborder" valign="top" width="58.46%" headers="mcps1.3.4.2.1.4.1.3 "><p id="obs_11_0016__p579611319412">The options for restoring objects. The value can be:</p>
<ul id="obs_11_0016__ul1273864144412"><li id="obs_11_0016__li17738649445">standard</li><li id="obs_11_0016__li1551213137447">expedited</li></ul> <ul id="obs_11_0016__ul1273864144412"><li id="obs_11_0016__li17738649445">standard</li><li id="obs_11_0016__li1551213137447">expedited</li></ul>
<div class="note" id="obs_11_0016__note1980113505431"><span class="notetitle"> NOTE: </span><div class="notebody"><ul id="obs_11_0016__ul6317738122314"><li id="obs_11_0016__li19111451105011"><strong id="obs_11_0016__b36431959192913">expedited</strong> indicates that objects can be quickly restored from Archive storage within 1 to 5 minutes.</li><li id="obs_11_0016__li117461746195015"><strong id="obs_11_0016__b062812120306">standard</strong> indicates that objects can be restored from Archive storage within 3 to 5 hours.</li><li id="obs_11_0016__li668453914234">If this parameter is not configured, an expedited restore is used by default.</li></ul> <div class="note" id="obs_11_0016__note1980113505431"><span class="notetitle"> NOTE: </span><div class="notebody"><ul id="obs_11_0016__ul6317738122314"><li id="obs_11_0016__li19111451105011"><strong id="obs_11_0016__b36431959192913">expedited</strong> indicates that objects can be quickly restored from Archive storage within one to five minutes.</li><li id="obs_11_0016__li117461746195015"><strong id="obs_11_0016__b062812120306">standard</strong> indicates that objects can be restored from Archive storage within three to five hours.</li><li id="obs_11_0016__li668453914234">If this parameter is not configured, an expedited restore is used by default.</li></ul>
</div></div> </div></div>
</td> </td>
</tr> </tr>
@ -123,7 +123,7 @@ Task id: 96f104ee-d0bf-40ff-95dd-31dec0d8f4f4</pre>
<td class="cellrowborder" valign="top" width="24.7%" headers="mcps1.3.4.2.1.4.1.2 "><p id="obs_11_0016__p19177173320483">Optional for batch restoring objects whose storage class is <strong id="obs_11_0016__b488113297181">cold</strong> (additional parameter)</p> <td class="cellrowborder" valign="top" width="24.7%" headers="mcps1.3.4.2.1.4.1.2 "><p id="obs_11_0016__p19177173320483">Optional for batch restoring objects whose storage class is <strong id="obs_11_0016__b488113297181">cold</strong> (additional parameter)</p>
</td> </td>
<td class="cellrowborder" valign="top" width="58.46%" headers="mcps1.3.4.2.1.4.1.3 "><p id="obs_11_0016__p2549177181312">The maximum number of concurrent tasks for batch restoring objects whose storage class is <strong id="obs_11_0016__b10998114415196">cold</strong>. The default value is the value of <strong id="obs_11_0016__b1080653133415">defaultJobs</strong> in the configuration file.</p> <td class="cellrowborder" valign="top" width="58.46%" headers="mcps1.3.4.2.1.4.1.3 "><p id="obs_11_0016__p2549177181312">The maximum number of concurrent tasks for batch restoring objects whose storage class is <strong id="obs_11_0016__b10998114415196">cold</strong>. The default value is the value of <strong id="obs_11_0016__b1080653133415">defaultJobs</strong> in the configuration file.</p>
<div class="note" id="obs_11_0016__note891964620819"><span class="notetitle"> NOTE: </span><div class="notebody"><p id="obs_11_0016__p1091964618820">The value is ensured to be greater than or equal to 1.</p> <div class="note" id="obs_11_0016__note891964620819"><span class="notetitle"> NOTE: </span><div class="notebody"><p id="obs_11_0016__p1091964618820">The tool ensures that this value is at least 1.</p>
</div></div> </div></div>
</td> </td>
</tr> </tr>
@ -139,6 +139,8 @@ Task id: 96f104ee-d0bf-40ff-95dd-31dec0d8f4f4</pre>
<td class="cellrowborder" valign="top" width="24.7%" headers="mcps1.3.4.2.1.4.1.2 "><p id="obs_11_0016__p1266611611820">Optional (additional parameter)</p> <td class="cellrowborder" valign="top" width="24.7%" headers="mcps1.3.4.2.1.4.1.2 "><p id="obs_11_0016__p1266611611820">Optional (additional parameter)</p>
</td> </td>
<td class="cellrowborder" valign="top" width="58.46%" headers="mcps1.3.4.2.1.4.1.3 "><p id="obs_11_0016__p1166617619181">Specifies that requester pays is enabled.</p> <td class="cellrowborder" valign="top" width="58.46%" headers="mcps1.3.4.2.1.4.1.3 "><p id="obs_11_0016__p1166617619181">Specifies that requester pays is enabled.</p>
<p id="obs_11_0016__p13214143095512"><strong id="obs_11_0016__b179851009834555">Range</strong>:</p>
<p id="obs_11_0016__p13744112545515">requester</p>
</td> </td>
</tr> </tr>
</tbody> </tbody>

22
docs/obs/tool-obsutil/obs_11_0017.html
View File

@ -5,18 +5,18 @@
<div class="notice" id="obs_11_0017__note780411406113"><span class="noticetitle"><img src="public_sys-resources/notice_3.0-en-us.png"> </span><div class="noticebody"><ul id="obs_11_0017__ul151501843918"><li id="obs_11_0017__li14647135493">Do not change the source objects in the OBS bucket when copying a single object or objects in batches. Otherwise, the operation may fail or data may be inconsistent.</li><li id="obs_11_0017__li13468105916126">To copy objects, you must have the read permission on the objects to be copied and the write permission on the destination bucket.</li><li id="obs_11_0017__li1327016311351">If the client-side cross-region replication function is not enabled, ensure that the source bucket and destination bucket are in the same region.</li><li id="obs_11_0017__li1676103010184">If the source bucket is a parallel file system (supporting POSIX), the destination bucket must also be a parallel file system.</li></ul> <div class="notice" id="obs_11_0017__note780411406113"><span class="noticetitle"><img src="public_sys-resources/notice_3.0-en-us.png"> </span><div class="noticebody"><ul id="obs_11_0017__ul151501843918"><li id="obs_11_0017__li14647135493">Do not change the source objects in the OBS bucket when copying a single object or objects in batches. Otherwise, the operation may fail or data may be inconsistent.</li><li id="obs_11_0017__li13468105916126">To copy objects, you must have the read permission on the objects to be copied and the write permission on the destination bucket.</li><li id="obs_11_0017__li1327016311351">If the client-side cross-region replication function is not enabled, ensure that the source bucket and destination bucket are in the same region.</li><li id="obs_11_0017__li1676103010184">If the source bucket is a parallel file system (supporting POSIX), the destination bucket must also be a parallel file system.</li></ul>
</div></div> </div></div>
</div> </div>
<div class="section" id="obs_11_0017__section13559175715545"><h4 class="sectiontitle">Constraints</h4><ul id="obs_11_0017__ul185711112115517"><li id="obs_11_0017__li1957111125554">The source path and destination path cannot be the same.</li><li id="obs_11_0017__li178092965514">The source path and destination path cannot be overlapped either.<ul id="obs_11_0017__ul978316368554"><li id="obs_11_0017__li187831436205513">If the source path overlaps with the prefix of the destination path, recursive replication applies.</li><li id="obs_11_0017__li10853155135510">If the destination path overlaps with the prefix of the source path, the replication may overwrite objects in the source path.</li></ul> <div class="section" id="obs_11_0017__section13559175715545"><h4 class="sectiontitle">Constraints</h4><ul id="obs_11_0017__ul185711112115517"><li id="obs_11_0017__li1957111125554">The source and destination paths cannot be the same.</li><li id="obs_11_0017__li178092965514">The source and destination paths cannot be nested during a batch copy.<ul id="obs_11_0017__ul978316368554"><li id="obs_11_0017__li187831436205513">If the destination path has the source path as its prefix, recursive copy may occur.</li><li id="obs_11_0017__li10853155135510">If the source path has the destination path as its prefix, overwriting may occur.</li></ul>
</li></ul> </li></ul>
</div> </div>
<div class="section" id="obs_11_0017__section49408320267"><h4 class="sectiontitle">Command Line Structure</h4><ul id="obs_11_0017__ul9634193211493"><li id="obs_11_0017__li1763473234917">In Windows<ul id="obs_11_0017__ul10693164464919"><li id="obs_11_0017__li9351943114915">Copying a single object<pre class="screen" id="obs_11_0017__screen17782164918497">obsutil cp obs://srcbucket/key obs://dstbucket/[dest] [-dryRun][-u] [-crr] [-vlength] [-vmd5] [-p=1] [-threshold=52428800] [-versionId=xxx] [-acl=xxx] [-sc=xxx] [-meta=aaa:bbb#ccc:ddd] [-ps=auto] [-cpd=xxx] [-fr] [-o=xxx] [-config=xxx] </pre> <div class="section" id="obs_11_0017__section49408320267"><h4 class="sectiontitle">Command Line Structure</h4><ul id="obs_11_0017__ul9634193211493"><li id="obs_11_0017__li1763473234917">Windows<ul id="obs_11_0017__ul10693164464919"><li id="obs_11_0017__li9351943114915">Copying a single object<pre class="screen" id="obs_11_0017__screen17782164918497">obsutil cp obs://srcbucket/key obs://dstbucket/[dest] [-dryRun][-u] [-crr] [-vlength] [-vmd5] [-p=1] [-threshold=52428800] [-versionId=xxx] [-acl=xxx] [-sc=xxx] [-meta=aaa:bbb#ccc:ddd] [-ps=auto] [-cpd=xxx] [-fr] [-o=xxx] [-config=xxx] </pre>
</li><li id="obs_11_0017__li4878129135017">Copying objects in batches<pre class="screen" id="obs_11_0017__screen15740822175019">obsutil cp obs://srcbucket[/key] obs://dstbucket[/dest] -r [-dryRun][-f] [-flat] [-u] [-crr] [-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_0017__li4878129135017">Copying objects in batches<pre class="screen" id="obs_11_0017__screen15740822175019">obsutil cp obs://srcbucket[/key] obs://dstbucket[/dest] -r [-dryRun][-f] [-flat] [-u] [-crr] [-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></ul> </li></ul>
</li><li id="obs_11_0017__li245683714917">In Linux or macOS<ul id="obs_11_0017__ul20620193216509"><li id="obs_11_0017__li896314506">Copying a single object<pre class="screen" id="obs_11_0017__screen18891658135018">./obsutil cp obs://srcbucket/key obs://dstbucket/[dest] [-dryRun] [-u] [-crr] [-vlength] [-vmd5] [-p=1] [-threshold=52428800] [-versionId=xxx] [-acl=xxx] [-sc=xxx] [-meta=aaa:bbb#ccc:ddd] [-ps=auto] [-cpd=xxx] [-fr] [-o=xxx] [-config=xxx] </pre> </li><li id="obs_11_0017__li245683714917">macOS or Linux<ul id="obs_11_0017__ul20620193216509"><li id="obs_11_0017__li896314506">Copying a single object<pre class="screen" id="obs_11_0017__screen18891658135018">./obsutil cp obs://srcbucket/key obs://dstbucket/[dest] [-dryRun] [-u] [-crr] [-vlength] [-vmd5] [-p=1] [-threshold=52428800] [-versionId=xxx] [-acl=xxx] [-sc=xxx] [-meta=aaa:bbb#ccc:ddd] [-ps=auto] [-cpd=xxx] [-fr] [-o=xxx] [-config=xxx] </pre>
</li><li id="obs_11_0017__li1964513913507">Copying objects in batches<pre class="screen" id="obs_11_0017__screen161391565118">./obsutil cp obs://srcbucket[/key] obs://dstbucket[/dest] -r [-dryRun] [-f] [-flat] [-u] [-crr] [-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_0017__li1964513913507">Copying objects in batches<pre class="screen" id="obs_11_0017__screen161391565118">./obsutil cp obs://srcbucket[/key] obs://dstbucket[/dest] -r [-dryRun] [-f] [-flat] [-u] [-crr] [-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></ul> </li></ul>
</li></ul> </li></ul>
</div> </div>
<div class="section" id="obs_11_0017__section11979141376"><h4 class="sectiontitle">Examples</h4><ul id="obs_11_0017__ul159791243371"><li id="obs_11_0017__li10979144103711">Take the Windows OS as an example. Run the <strong id="obs_11_0017__b2045410523317">obsutil cp obs://bucket-test/key obs://bucket-test2</strong> command to copy a single object.<pre class="screen" id="obs_11_0017__screen697934163715"><strong id="obs_11_0017__b11979194183717">obsutil cp obs://bucket-test/key obs://bucket-test2</strong> <div class="section" id="obs_11_0017__section11979141376"><h4 class="sectiontitle">Examples</h4><ul id="obs_11_0017__ul159791243371"><li id="obs_11_0017__li10979144103711">In Windows, run <strong id="obs_11_0017__b2045410523317">obsutil cp obs://bucket-test/key obs://bucket-test2</strong> to copy a single object.<pre class="screen" id="obs_11_0017__screen697934163715"><strong id="obs_11_0017__b11979194183717">obsutil cp obs://bucket-test/key obs://bucket-test2</strong>
Start at 2024-09-30 08:30:09.0815415 +0000 UTC Start at 2024-09-30 08:30:09.0815415 +0000 UTC
Parallel: 3 Jobs: 3 Parallel: 3 Jobs: 3
@ -28,7 +28,7 @@ Waiting for the copied key to be completed on server side.
Copy successfully, 19B, obs://bucket-test/key --&gt; obs://bucket-test2/key Copy successfully, 19B, obs://bucket-test/key --&gt; obs://bucket-test2/key
ext.txt, cost [1708], status [200], request id [00000192420D227E4017336A12F1DC22]</pre> ext.txt, cost [1708], status [200], request id [00000192420D227E4017336A12F1DC22]</pre>
</li></ul> </li></ul>
<ul id="obs_11_0017__ul15980144113716"><li id="obs_11_0017__li19807412372">Take the Windows OS as an example. Run the <strong id="obs_11_0017__b350045510522">obsutil cp obs://bucket-test/temp/ obs://bucket-test2 -f -r</strong> command to copy objects in batches.<pre class="screen" id="obs_11_0017__screen898013411373"><strong id="obs_11_0017__b149801145372">obsutil cp obs://bucket-test/temp/ obs://bucket-test2 -r -f</strong> <ul id="obs_11_0017__ul15980144113716"><li id="obs_11_0017__li19807412372">In Windows, run <strong id="obs_11_0017__b350045510522">obsutil cp obs://bucket-test/temp/ obs://bucket-test2 -f -r</strong> to copy objects in batches.<pre class="screen" id="obs_11_0017__screen898013411373"><strong id="obs_11_0017__b149801145372">obsutil cp obs://bucket-test/temp/ obs://bucket-test2 -r -f</strong>
Start at 2024-09-30 08:34:02.7819703 +0000 UTC Start at 2024-09-30 08:34:02.7819703 +0000 UTC
Parallel: 5 Jobs: 5 Parallel: 5 Jobs: 5
@ -176,7 +176,7 @@ Task id: 0476929d-9d23-4dc5-b2f8-0a0493f027c5</pre>
<td class="cellrowborder" valign="top" width="18.529999999999998%" headers="mcps1.3.5.2.1.4.1.2 "><p id="obs_11_0017__p17648193011318">Optional (additional parameter)</p> <td class="cellrowborder" valign="top" width="18.529999999999998%" headers="mcps1.3.5.2.1.4.1.2 "><p id="obs_11_0017__p17648193011318">Optional (additional parameter)</p>
</td> </td>
<td class="cellrowborder" valign="top" width="63.9%" headers="mcps1.3.5.2.1.4.1.3 "><p id="obs_11_0017__p653253852912">The access control policies for destination objects that can be specified when copying objects</p> <td class="cellrowborder" valign="top" width="63.9%" headers="mcps1.3.5.2.1.4.1.3 "><p id="obs_11_0017__p653253852912">The access control policies for destination objects that can be specified when copying objects</p>
<p id="obs_11_0017__p16650163083117">Possible values are:</p> <p id="obs_11_0017__p16650163083117">The value can be:</p>
<ul id="obs_11_0017__obs_11_0013_ul1273864144412"><li id="obs_11_0017__obs_11_0013_li17738649445"><strong id="obs_11_0017__b579024524018">private</strong>: Only users granted permissions by the object ACL can access the object.</li><li id="obs_11_0017__obs_11_0013_li1551213137447"><strong id="obs_11_0017__b910784219548">public-read</strong>: Anyone can read objects in the bucket.</li><li id="obs_11_0017__obs_11_0013_li1287691813449"><strong id="obs_11_0017__b1228115675418">public-read-write</strong>: Anyone can read, write, or delete objects in the bucket.</li><li id="obs_11_0017__obs_11_0013_li427919615012"><strong id="obs_11_0017__b15215968348">bucket-owner-full-control</strong>: Only the bucket owner has full control over objects in the bucket.</li></ul> <ul id="obs_11_0017__obs_11_0013_ul1273864144412"><li id="obs_11_0017__obs_11_0013_li17738649445"><strong id="obs_11_0017__b579024524018">private</strong>: Only users granted permissions by the object ACL can access the object.</li><li id="obs_11_0017__obs_11_0013_li1551213137447"><strong id="obs_11_0017__b910784219548">public-read</strong>: Anyone can read objects in the bucket.</li><li id="obs_11_0017__obs_11_0013_li1287691813449"><strong id="obs_11_0017__b1228115675418">public-read-write</strong>: Anyone can read, write, or delete objects in the bucket.</li><li id="obs_11_0017__obs_11_0013_li427919615012"><strong id="obs_11_0017__b15215968348">bucket-owner-full-control</strong>: Only the bucket owner has full control over objects in the bucket.</li></ul>
</td> </td>
</tr> </tr>
@ -185,7 +185,7 @@ Task id: 0476929d-9d23-4dc5-b2f8-0a0493f027c5</pre>
<td class="cellrowborder" valign="top" width="18.529999999999998%" headers="mcps1.3.5.2.1.4.1.2 "><p id="obs_11_0017__p134681525175117">Optional (additional parameter)</p> <td class="cellrowborder" valign="top" width="18.529999999999998%" headers="mcps1.3.5.2.1.4.1.2 "><p id="obs_11_0017__p134681525175117">Optional (additional parameter)</p>
</td> </td>
<td class="cellrowborder" valign="top" width="63.9%" headers="mcps1.3.5.2.1.4.1.3 "><p id="obs_11_0017__p359119568292">The storage classes of the destination objects that can be specified when copying objects</p> <td class="cellrowborder" valign="top" width="63.9%" headers="mcps1.3.5.2.1.4.1.3 "><p id="obs_11_0017__p359119568292">The storage classes of the destination objects that can be specified when copying objects</p>
<p id="obs_11_0017__p04731025135114">Possible values are:</p> <p id="obs_11_0017__p04731025135114">The value can be:</p>
<ul id="obs_11_0017__obs_11_0013_ul175651814214"><li id="obs_11_0017__obs_11_0013_li1256512172114"><strong id="obs_11_0017__b08451537131011">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_0017__obs_11_0013_li10565181142113"><strong id="obs_11_0017__b3747789321">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_0017__obs_11_0013_li756616110216"><strong id="obs_11_0017__b1681591116321">cold</strong>: Cold storage class. It provides secure, durable, and inexpensive storage for rarely-accessed (once a year) data.</li></ul> <ul id="obs_11_0017__obs_11_0013_ul175651814214"><li id="obs_11_0017__obs_11_0013_li1256512172114"><strong id="obs_11_0017__b08451537131011">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_0017__obs_11_0013_li10565181142113"><strong id="obs_11_0017__b3747789321">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_0017__obs_11_0013_li756616110216"><strong id="obs_11_0017__b1681591116321">cold</strong>: Cold storage class. It provides secure, durable, and inexpensive storage for rarely-accessed (once a year) data.</li></ul>
</td> </td>
</tr> </tr>
@ -234,7 +234,7 @@ Task id: 0476929d-9d23-4dc5-b2f8-0a0493f027c5</pre>
<td class="cellrowborder" valign="top" width="63.9%" headers="mcps1.3.5.2.1.4.1.3 "><p id="obs_11_0017__p4699130153112">The maximum number of concurrent tasks for copying objects in batches. The default value is the value of <strong id="obs_11_0017__b6802155075017">defaultJobs</strong> in the configuration file.</p> <td class="cellrowborder" valign="top" width="63.9%" headers="mcps1.3.5.2.1.4.1.3 "><p id="obs_11_0017__p4699130153112">The maximum number of concurrent tasks for copying objects in batches. The default value is the value of <strong id="obs_11_0017__b6802155075017">defaultJobs</strong> in the configuration file.</p>
<div class="caution" id="obs_11_0017__note68031812122019"><span class="cautiontitle"> CAUTION: </span><div class="cautionbody"><p id="obs_11_0017__obs_11_0017_p1383211014413">For an inter-bucket replication task that does not include the <strong id="obs_11_0017__obs_11_0017_b4449164054017">crr</strong> parameter, the maximum allowable value for this parameter is 10,000.</p> <div class="caution" id="obs_11_0017__note68031812122019"><span class="cautiontitle"> CAUTION: </span><div class="cautionbody"><p id="obs_11_0017__obs_11_0017_p1383211014413">For an inter-bucket replication task that does not include the <strong id="obs_11_0017__obs_11_0017_b4449164054017">crr</strong> parameter, the maximum allowable value for this parameter is 10,000.</p>
</div></div> </div></div>
<div class="note" id="obs_11_0017__note891964620819"><span class="notetitle"> NOTE: </span><div class="notebody"><p id="obs_11_0017__p1091964618820">The value is ensured to be greater than or equal to 1.</p> <div class="note" id="obs_11_0017__note891964620819"><span class="notetitle"> NOTE: </span><div class="notebody"><p id="obs_11_0017__p1091964618820">The tool ensures that this value is at least 1.</p>
</div></div> </div></div>
</td> </td>
</tr> </tr>
@ -246,7 +246,7 @@ Task id: 0476929d-9d23-4dc5-b2f8-0a0493f027c5</pre>
<ul id="obs_11_0017__obs_11_0013_ul188401919153518"><li id="obs_11_0017__obs_11_0013_li1055251820408">An asterisk (*) matches any number of characters. For instance, <strong id="obs_11_0017__b2058017863715">abc*.txt</strong> matches all files whose names start with <strong id="obs_11_0017__b3580118183714">abc</strong>, contain any number of characters in the middle, and end with <strong id="obs_11_0017__b1958013817370">.txt</strong>.</li><li id="obs_11_0017__obs_11_0013_li684071918350">A question mark (?) matches any single character. For instance, <strong id="obs_11_0017__b177511103715">abc?.txt</strong> matches all files whose names start with <strong id="obs_11_0017__b4776171116373">abc</strong>, contain any single character in the middle, and end with <strong id="obs_11_0017__b0776131117372">.txt</strong>.</li><li id="obs_11_0017__obs_11_0013_li084081993510">You can use <strong id="obs_11_0017__b195611236113816">\*</strong> to represent <strong id="obs_11_0017__b3561113673817">*</strong> and <strong id="obs_11_0017__b175611836133819">\?</strong> to represent <strong id="obs_11_0017__b5561183615388">?</strong>.</li><li id="obs_11_0017__obs_11_0013_li1810485220428">Multiple <strong id="obs_11_0017__b1094917471383">exclude</strong> parameters can be specified, for example, <strong id="obs_11_0017__b19491947163818">-exclude=*.xxx -exclude=*.xxx</strong>.</li></ul> <ul id="obs_11_0017__obs_11_0013_ul188401919153518"><li id="obs_11_0017__obs_11_0013_li1055251820408">An asterisk (*) matches any number of characters. For instance, <strong id="obs_11_0017__b2058017863715">abc*.txt</strong> matches all files whose names start with <strong id="obs_11_0017__b3580118183714">abc</strong>, contain any number of characters in the middle, and end with <strong id="obs_11_0017__b1958013817370">.txt</strong>.</li><li id="obs_11_0017__obs_11_0013_li684071918350">A question mark (?) matches any single character. For instance, <strong id="obs_11_0017__b177511103715">abc?.txt</strong> matches all files whose names start with <strong id="obs_11_0017__b4776171116373">abc</strong>, contain any single character in the middle, and end with <strong id="obs_11_0017__b0776131117372">.txt</strong>.</li><li id="obs_11_0017__obs_11_0013_li084081993510">You can use <strong id="obs_11_0017__b195611236113816">\*</strong> to represent <strong id="obs_11_0017__b3561113673817">*</strong> and <strong id="obs_11_0017__b175611836133819">\?</strong> to represent <strong id="obs_11_0017__b5561183615388">?</strong>.</li><li id="obs_11_0017__obs_11_0013_li1810485220428">Multiple <strong id="obs_11_0017__b1094917471383">exclude</strong> parameters can be specified, for example, <strong id="obs_11_0017__b19491947163818">-exclude=*.xxx -exclude=*.xxx</strong>.</li></ul>
<p id="obs_11_0017__obs_11_0013_p12375415107"><strong id="obs_11_0017__b2250427390">Restrictions</strong>:</p> <p id="obs_11_0017__obs_11_0013_p12375415107"><strong id="obs_11_0017__b2250427390">Restrictions</strong>:</p>
<p id="obs_11_0017__obs_11_0013_p20329121444718">This matching pattern applies only to objects whose names do not end with a slash (/).</p> <p id="obs_11_0017__obs_11_0013_p20329121444718">This matching pattern applies only to objects whose names do not end with a slash (/).</p>
<div class="note" id="obs_11_0017__obs_11_0013_note1882615604315"><span class="notetitle"> NOTE: </span><div class="notebody"><ul id="obs_11_0017__obs_11_0013_ul19839181204319"><li id="obs_11_0017__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_0017__obs_11_0013_li2839171212434">The matching pattern applies to the absolute path of an object, including the object name prefix and object name starting from the root directory. For example, if the path of an object in the bucket is <strong id="obs_11_0017__b9338153824018">obs://bucket/src1/src2/test.txt</strong>, then the absolute path of the object is <strong id="obs_11_0017__b14338143819408">src1/src2/test.txt</strong>.</li></ul> <div class="note" id="obs_11_0017__obs_11_0013_note1882615604315"><span class="notetitle"> NOTE: </span><div class="notebody"><ul id="obs_11_0017__obs_11_0013_ul19839181204319"><li id="obs_11_0017__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_0017__obs_11_0013_li2839171212434">The matching pattern applies to the object's absolute path, which includes the object name prefix and the object name starting from the root directory. For example, if an object's path in the bucket is <strong id="obs_11_0017__b05601306013">obs://bucket/src1/src2/test.txt</strong>, its absolute path is <strong id="obs_11_0017__b15601401408">src1/src2/test.txt</strong>.</li></ul>
</div></div> </div></div>
</td> </td>
</tr> </tr>
@ -261,7 +261,7 @@ Task id: 0476929d-9d23-4dc5-b2f8-0a0493f027c5</pre>
<p id="obs_11_0017__obs_11_0013_p11421136184615"><strong id="obs_11_0017__b117962022165313">Example:</strong></p> <p id="obs_11_0017__obs_11_0013_p11421136184615"><strong id="obs_11_0017__b117962022165313">Example:</strong></p>
<pre class="screen" id="obs_11_0017__obs_11_0013_screen18471711115414">./obsutil cp obs://src-bucket/ obs://target-bucket/ -include=/src-object/* -f -r</pre> <pre class="screen" id="obs_11_0017__obs_11_0013_screen18471711115414">./obsutil cp obs://src-bucket/ obs://target-bucket/ -include=/src-object/* -f -r</pre>
<p id="obs_11_0017__obs_11_0013_p128247549531">This command copies files whose names start with <strong id="obs_11_0017__b160119442469">src-object/</strong> from the <strong id="obs_11_0017__b77669387461">src-bucket</strong> bucket to the <strong id="obs_11_0017__b15782175394610">target-bucket</strong> bucket.</p> <p id="obs_11_0017__obs_11_0013_p128247549531">This command copies files whose names start with <strong id="obs_11_0017__b160119442469">src-object/</strong> from the <strong id="obs_11_0017__b77669387461">src-bucket</strong> bucket to the <strong id="obs_11_0017__b15782175394610">target-bucket</strong> bucket.</p>
<div class="note" id="obs_11_0017__obs_11_0013_note6126191912710"><span class="notetitle"> NOTE: </span><div class="notebody"><ul id="obs_11_0017__obs_11_0013_ul144557173539"><li id="obs_11_0017__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_0017__obs_11_0013_li4721926185215">The matching pattern applies to the absolute path of an object, including the object name prefix and object name starting from the root directory. For example, if the path of an object in the bucket is <strong id="obs_11_0017__b12567846195614">obs://bucket/src1/src2/test.txt</strong>, then the absolute path of the object is <strong id="obs_11_0017__b456712468565">src1/src2/test.txt</strong>.</li></ul> <div class="note" id="obs_11_0017__obs_11_0013_note6126191912710"><span class="notetitle"> NOTE: </span><div class="notebody"><ul id="obs_11_0017__obs_11_0013_ul144557173539"><li id="obs_11_0017__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_0017__obs_11_0013_li4721926185215">The matching pattern applies to the object's absolute path, which includes the object name prefix and the object name starting from the root directory. For example, if an object's path in the bucket is <strong id="obs_11_0017__b1330225904">obs://bucket/src1/src2/test.txt</strong>, its absolute path is <strong id="obs_11_0017__b7302451014">src1/src2/test.txt</strong>.</li></ul>
</div></div> </div></div>
</td> </td>
</tr> </tr>
@ -312,6 +312,8 @@ Task id: 0476929d-9d23-4dc5-b2f8-0a0493f027c5</pre>
<td class="cellrowborder" valign="top" width="18.529999999999998%" headers="mcps1.3.5.2.1.4.1.2 "><p id="obs_11_0017__p1266611611820">Optional (additional parameter)</p> <td class="cellrowborder" valign="top" width="18.529999999999998%" headers="mcps1.3.5.2.1.4.1.2 "><p id="obs_11_0017__p1266611611820">Optional (additional parameter)</p>
</td> </td>
<td class="cellrowborder" valign="top" width="63.9%" headers="mcps1.3.5.2.1.4.1.3 "><p id="obs_11_0017__p1166617619181">Specifies that requester pays is enabled.</p> <td class="cellrowborder" valign="top" width="63.9%" headers="mcps1.3.5.2.1.4.1.3 "><p id="obs_11_0017__p1166617619181">Specifies that requester pays is enabled.</p>
<p id="obs_11_0017__p13214143095512"><strong id="obs_11_0017__b43366312934547">Range</strong>:</p>
<p id="obs_11_0017__p13744112545515">requester</p>
</td> </td>
</tr> </tr>
</tbody> </tbody>

26
docs/obs/tool-obsutil/obs_11_0018.html
View File

@ -5,15 +5,15 @@
<div class="notice" id="obs_11_0018__note780411406113"><span class="noticetitle"><img src="public_sys-resources/notice_3.0-en-us.png"> </span><div class="noticebody"><ul id="obs_11_0018__ul562142691216"><li id="obs_11_0018__li156218269126">Do not change the source objects in the OBS bucket when downloading a single object or objects in batches. Otherwise, the download may fail or data may be inconsistent.</li></ul> <div class="notice" id="obs_11_0018__note780411406113"><span class="noticetitle"><img src="public_sys-resources/notice_3.0-en-us.png"> </span><div class="noticebody"><ul id="obs_11_0018__ul562142691216"><li id="obs_11_0018__li156218269126">Do not change the source objects in the OBS bucket when downloading a single object or objects in batches. Otherwise, the download may fail or data may be inconsistent.</li></ul>
</div></div> </div></div>
</div> </div>
<div class="section" id="obs_11_0018__section19587175622519"><h4 class="sectiontitle">Command Line Structure</h4><ul id="obs_11_0018__ul4348115485212"><li id="obs_11_0018__li034819548529">In Windows<ul id="obs_11_0018__ul14371109125314"><li id="obs_11_0018__li645116618536">Downloading a single object<pre class="screen" id="obs_11_0018__screen2021764195319">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] </pre> <div class="section" id="obs_11_0018__section19587175622519"><h4 class="sectiontitle">Command Line Structure</h4><ul id="obs_11_0018__ul4348115485212"><li id="obs_11_0018__li034819548529">Windows<ul id="obs_11_0018__ul14371109125314"><li id="obs_11_0018__li645116618536">Downloading a single object<pre class="screen" id="obs_11_0018__screen2021764195319">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] </pre>
</li><li id="obs_11_0018__li18337131475317">Downloading objects in batches<pre class="screen" id="obs_11_0018__screen15467124815533">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] </pre> </li><li id="obs_11_0018__li18337131475317">Downloading objects in batches<pre class="screen" id="obs_11_0018__screen15467124815533">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] </pre>
</li></ul> </li></ul>
</li><li id="obs_11_0018__li4476145885216">In Linux or macOS<ul id="obs_11_0018__ul10651133045317"><li id="obs_11_0018__li252718313536">Downloading a single object<pre class="screen" id="obs_11_0018__screen970919582539">./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] </pre> </li><li id="obs_11_0018__li4476145885216">macOS or Linux<ul id="obs_11_0018__ul10651133045317"><li id="obs_11_0018__li252718313536">Downloading a single object<pre class="screen" id="obs_11_0018__screen970919582539">./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] </pre>
</li><li id="obs_11_0018__li952883111532">Downloading objects in batches<pre class="screen" id="obs_11_0018__screen2398117135418">./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] </pre> </li><li id="obs_11_0018__li952883111532">Downloading objects in batches<pre class="screen" id="obs_11_0018__screen2398117135418">./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] </pre>
</li></ul> </li></ul>
</li></ul> </li></ul>
</div> </div>
<div class="section" id="obs_11_0018__section61282320386"><h4 class="sectiontitle">Examples</h4><ul id="obs_11_0018__ul161281934388"><li id="obs_11_0018__li81281030385">Take the Windows OS as an example. Run the <strong id="obs_11_0018__b73482127375">obsutil cp obs://bucket-test/key</strong> <strong id="obs_11_0018__b11350312103713">d:\temp\test.txt</strong> command to download a single object.<pre class="screen" id="obs_11_0018__screen1612812353810"><strong id="obs_11_0018__b17128123133817">obsutil cp obs://bucket-test/key</strong> <strong id="obs_11_0018__b14128153143814">d:\temp\test.txt</strong> <div class="section" id="obs_11_0018__section61282320386"><h4 class="sectiontitle">Examples</h4><ul id="obs_11_0018__ul161281934388"><li id="obs_11_0018__li81281030385">In Windows, run <strong id="obs_11_0018__b73482127375">obsutil cp obs://bucket-test/key</strong> <strong id="obs_11_0018__b11350312103713">d:\temp\test.txt</strong> to download a single object.<pre class="screen" id="obs_11_0018__screen1612812353810"><strong id="obs_11_0018__b17128123133817">obsutil cp obs://bucket-test/key</strong> <strong id="obs_11_0018__b14128153143814">d:\temp\test.txt</strong>
Start at 2024-09-30 08:39:34.180766 +0000 UTC Start at 2024-09-30 08:39:34.180766 +0000 UTC
Parallel: 5 Jobs: 5 Parallel: 5 Jobs: 5
@ -23,9 +23,9 @@ CheckpointDir: xxxx
TempFileDir: xxxx TempFileDir: xxxx
[==========================================] 100.00% 4.86 KB/s 8.46MB/8.46MB 0s [==========================================] 100.00% 4.86 KB/s 8.46MB/8.46MB 0s
Download successfully, 8.46MB, obs://bucket-test/key --&gt; d:\temp\test.txtt, cost [41], status [200], request id [000001924215BEC84019EDF4044A5451]</pre> Download successfully, 8.46MB, obs://bucket-test/key --&gt; d:\temp\test.txt, cost [41], status [200], request id [000001924215BEC84019EDF4044A5451]</pre>
</li></ul> </li></ul>
<ul id="obs_11_0018__ul312917315381"><li id="obs_11_0018__li012910317381">Take the Windows OS as an example. Run the <strong id="obs_11_0018__b1837091253712">obsutil cp obs://bucket-test/temp d:\ -f -r</strong> command to download objects in batches.<pre class="screen" id="obs_11_0018__screen1212913133818"><strong id="obs_11_0018__b191293323811">obsutil cp obs://bucket-test/temp <strong id="obs_11_0018__b612916318383">d:\</strong> -f -r</strong> <ul id="obs_11_0018__ul312917315381"><li id="obs_11_0018__li012910317381">In Windows, run <strong id="obs_11_0018__b1837091253712">obsutil cp obs://bucket-test/temp d:\ -f -r</strong> to download objects in batches.<pre class="screen" id="obs_11_0018__screen1212913133818"><strong id="obs_11_0018__b191293323811">obsutil cp obs://bucket-test/temp <strong id="obs_11_0018__b612916318383">d:\</strong> -f -r</strong>
Start at 2024-09-30 08:41:56.0306522 +0000 UTC Start at 2024-09-30 08:41:56.0306522 +0000 UTC
Parallel: 5 Jobs: 5 Parallel: 5 Jobs: 5
@ -79,7 +79,7 @@ Task id: 3066a4b0-4d21-4929-bb84-4829c32cbd0f</pre>
<tr id="obs_11_0018__row1584114513535"><td class="cellrowborder" valign="top" width="17.17171717171717%" headers="mcps1.3.4.2.1.4.1.1 "><p id="obs_11_0018__p17585144585310">key</p> <tr id="obs_11_0018__row1584114513535"><td class="cellrowborder" valign="top" width="17.17171717171717%" headers="mcps1.3.4.2.1.4.1.1 "><p id="obs_11_0018__p17585144585310">key</p>
</td> </td>
<td class="cellrowborder" valign="top" width="26.26262626262626%" headers="mcps1.3.4.2.1.4.1.2 "><p id="obs_11_0018__p10783112824619">Mandatory for downloading an object</p> <td class="cellrowborder" valign="top" width="26.26262626262626%" headers="mcps1.3.4.2.1.4.1.2 "><p id="obs_11_0018__p10783112824619">Mandatory for downloading an object</p>
<p id="obs_11_0018__p19201728661">Optional for downloading objects in a batch</p> <p id="obs_11_0018__p19201728661">Optional for downloading objects in batches</p>
</td> </td>
<td class="cellrowborder" valign="top" width="56.56565656565656%" headers="mcps1.3.4.2.1.4.1.3 "><p id="obs_11_0018__p0588134575318">The name of the object to be downloaded, or the name prefix of the objects to be downloaded in batches</p> <td class="cellrowborder" valign="top" width="56.56565656565656%" headers="mcps1.3.4.2.1.4.1.3 "><p id="obs_11_0018__p0588134575318">The name of the object to be downloaded, or the name prefix of the objects to be downloaded in batches</p>
<p id="obs_11_0018__p10591154565315">This parameter cannot be left blank when downloading an object. The saving and naming rules are as follows:</p> <p id="obs_11_0018__p10591154565315">This parameter cannot be left blank when downloading an object. The saving and naming rules are as follows:</p>
@ -124,7 +124,7 @@ Task id: 3066a4b0-4d21-4929-bb84-4829c32cbd0f</pre>
</td> </td>
<td class="cellrowborder" valign="top" width="26.26262626262626%" headers="mcps1.3.4.2.1.4.1.2 "><p id="obs_11_0018__p10601174595317">Optional (additional parameter)</p> <td class="cellrowborder" valign="top" width="26.26262626262626%" headers="mcps1.3.4.2.1.4.1.2 "><p id="obs_11_0018__p10601174595317">Optional (additional parameter)</p>
</td> </td>
<td class="cellrowborder" valign="top" width="56.56565656565656%" headers="mcps1.3.4.2.1.4.1.3 "><p id="obs_11_0018__p1260204518534">Indicates incremental download. If this parameter is set, each object can be downloaded only when it does not exist in the local path, its size is different from the namesake one in the local path, or it has the latest modification time.</p> <td class="cellrowborder" valign="top" width="56.56565656565656%" headers="mcps1.3.4.2.1.4.1.3 "><p id="obs_11_0018__p1260204518534">Indicates incremental download. When this parameter is set, each object is compared with the file at the corresponding local path. An object is downloaded only when the file does not exist, the file size differs from the object size, or the file was last modified earlier than the object.</p>
</td> </td>
</tr> </tr>
<tr id="obs_11_0018__row9603194595311"><td class="cellrowborder" valign="top" width="17.17171717171717%" headers="mcps1.3.4.2.1.4.1.1 "><p id="obs_11_0018__p1605745105311">vlength</p> <tr id="obs_11_0018__row9603194595311"><td class="cellrowborder" valign="top" width="17.17171717171717%" headers="mcps1.3.4.2.1.4.1.1 "><p id="obs_11_0018__p1605745105311">vlength</p>
@ -205,7 +205,7 @@ Task id: 3066a4b0-4d21-4929-bb84-4829c32cbd0f</pre>
<td class="cellrowborder" valign="top" width="26.26262626262626%" headers="mcps1.3.4.2.1.4.1.2 "><p id="obs_11_0018__p19305175612615">Optional for downloading objects in batches (additional parameter)</p> <td class="cellrowborder" valign="top" width="26.26262626262626%" headers="mcps1.3.4.2.1.4.1.2 "><p id="obs_11_0018__p19305175612615">Optional for downloading objects in batches (additional parameter)</p>
</td> </td>
<td class="cellrowborder" valign="top" width="56.56565656565656%" headers="mcps1.3.4.2.1.4.1.3 "><p id="obs_11_0018__p17665114555311">The maximum number of concurrent tasks for downloading objects in a batch. The default value is the value of <strong id="obs_11_0018__b27577263238">defaultJobs</strong> in the configuration file.</p> <td class="cellrowborder" valign="top" width="56.56565656565656%" headers="mcps1.3.4.2.1.4.1.3 "><p id="obs_11_0018__p17665114555311">The maximum number of concurrent tasks for downloading objects in a batch. The default value is the value of <strong id="obs_11_0018__b27577263238">defaultJobs</strong> in the configuration file.</p>
<div class="note" id="obs_11_0018__note891964620819"><span class="notetitle"> NOTE: </span><div class="notebody"><p id="obs_11_0018__p1091964618820">The value is ensured to be greater than or equal to 1.</p> <div class="note" id="obs_11_0018__note891964620819"><span class="notetitle"> NOTE: </span><div class="notebody"><p id="obs_11_0018__p1091964618820">The tool ensures that this value is at least 1.</p>
</div></div> </div></div>
</td> </td>
</tr> </tr>
@ -216,7 +216,7 @@ Task id: 3066a4b0-4d21-4929-bb84-4829c32cbd0f</pre>
<td class="cellrowborder" valign="top" width="56.56565656565656%" headers="mcps1.3.4.2.1.4.1.3 "><p id="obs_11_0018__p16666614131519">The matching patterns of source objects that are excluded, for example, <strong id="obs_11_0018__b14546165310472">*.txt</strong></p> <td class="cellrowborder" valign="top" width="56.56565656565656%" headers="mcps1.3.4.2.1.4.1.3 "><p id="obs_11_0018__p16666614131519">The matching patterns of source objects that are excluded, for example, <strong id="obs_11_0018__b14546165310472">*.txt</strong></p>
<div class="note" id="obs_11_0018__note145284716208"><span class="notetitle"> NOTE: </span><div class="notebody"><ul id="obs_11_0018__ul05604713204"><li id="obs_11_0018__li14580477208">The asterisk (*) represents any group of characters, and the question mark (?) represents any single character. For instance, <strong id="obs_11_0018__b68461455154720">abc*.txt</strong> indicates any file whose name starts with <strong id="obs_11_0018__b0847175564713">abc</strong> and ends with <strong id="obs_11_0018__b11848125564714">.txt</strong>.</li><li id="obs_11_0018__li10293181913349">You can use <strong id="obs_11_0018__b1894173812108">\*</strong> to represent <strong id="obs_11_0018__b689573881013">*</strong> and <strong id="obs_11_0018__b2089518388106">\?</strong> to represent <strong id="obs_11_0018__b1789683815103">?</strong>.</li><li id="obs_11_0018__li20603473203">If the name of the object to be downloaded matches the value of this parameter, the object is skipped.</li></ul> <div class="note" id="obs_11_0018__note145284716208"><span class="notetitle"> NOTE: </span><div class="notebody"><ul id="obs_11_0018__ul05604713204"><li id="obs_11_0018__li14580477208">The asterisk (*) represents any group of characters, and the question mark (?) represents any single character. For instance, <strong id="obs_11_0018__b68461455154720">abc*.txt</strong> indicates any file whose name starts with <strong id="obs_11_0018__b0847175564713">abc</strong> and ends with <strong id="obs_11_0018__b11848125564714">.txt</strong>.</li><li id="obs_11_0018__li10293181913349">You can use <strong id="obs_11_0018__b1894173812108">\*</strong> to represent <strong id="obs_11_0018__b689573881013">*</strong> and <strong id="obs_11_0018__b2089518388106">\?</strong> to represent <strong id="obs_11_0018__b1789683815103">?</strong>.</li><li id="obs_11_0018__li20603473203">If the name of the object to be downloaded matches the value of this parameter, the object is skipped.</li></ul>
</div></div> </div></div>
<div class="notice" id="obs_11_0018__note179117549207"><span class="noticetitle"> NOTICE: </span><div class="noticebody"><ul id="obs_11_0018__ul877892116516"><li id="obs_11_0018__li1517310321518">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_0018__li1371214438918">The matching pattern applies to the absolute path of an object, including the object name prefix and object name starting from the root directory. For example, if the path of an object in the bucket is <strong id="obs_11_0018__b8572151512274">obs://bucket/src1/src2/test.txt</strong>, then the absolute path of the object is <strong id="obs_11_0018__b9573115102713">src1/src2/test.txt</strong>.</li><li id="obs_11_0018__li1148165015513">This matching pattern applies only to objects whose names do not end with a slash (/).</li><li id="obs_11_0018__li5291112193110">Multiple <strong id="obs_11_0018__b781994645114">exclude</strong> parameters can be specified, for example, <strong id="obs_11_0018__b19882163117512">-exclude=*.xxx -exclude=*.xxx</strong>.</li></ul> <div class="notice" id="obs_11_0018__note179117549207"><span class="noticetitle"> NOTICE: </span><div class="noticebody"><ul id="obs_11_0018__ul877892116516"><li id="obs_11_0018__li1517310321518">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_0018__li1371214438918">The matching pattern applies to the object's absolute path, which includes the object name prefix and the object name starting from the root directory. For example, if an object's path in the bucket is <strong id="obs_11_0018__b8904203112210">obs://bucket/src1/src2/test.txt</strong>, its absolute path is <strong id="obs_11_0018__b2904123120215">src1/src2/test.txt</strong>.</li><li id="obs_11_0018__li1148165015513">This matching pattern applies only to objects whose names do not end with a slash (/).</li><li id="obs_11_0018__li5291112193110">Multiple <strong id="obs_11_0018__b781994645114">exclude</strong> parameters can be specified, for example, <strong id="obs_11_0018__b19882163117512">-exclude=*.xxx -exclude=*.xxx</strong>.</li></ul>
</div></div> </div></div>
</td> </td>
</tr> </tr>
@ -225,9 +225,9 @@ Task id: 3066a4b0-4d21-4929-bb84-4829c32cbd0f</pre>
<td class="cellrowborder" valign="top" width="26.26262626262626%" headers="mcps1.3.4.2.1.4.1.2 "><p id="obs_11_0018__p966784516533">Optional for downloading objects in batches (additional parameter)</p> <td class="cellrowborder" valign="top" width="26.26262626262626%" headers="mcps1.3.4.2.1.4.1.2 "><p id="obs_11_0018__p966784516533">Optional for downloading objects in batches (additional parameter)</p>
</td> </td>
<td class="cellrowborder" valign="top" width="56.56565656565656%" headers="mcps1.3.4.2.1.4.1.3 "><p id="obs_11_0018__p37071730153119">Specifies what formats of objects can be downloaded. If this parameter is set to <strong id="obs_11_0018__b96815203277">*.jpg</strong>, only objects in the <strong id="obs_11_0018__b54113373356">.jpg</strong> format can be downloaded.</p> <td class="cellrowborder" valign="top" width="56.56565656565656%" headers="mcps1.3.4.2.1.4.1.3 "><p id="obs_11_0018__p37071730153119">Specifies what formats of objects can be downloaded. If this parameter is set to <strong id="obs_11_0018__b96815203277">*.jpg</strong>, only objects in the <strong id="obs_11_0018__b54113373356">.jpg</strong> format can be downloaded.</p>
<div class="note" id="obs_11_0018__note195168716220"><span class="notetitle"> NOTE: </span><div class="notebody"><ul id="obs_11_0018__ul752013715229"><li id="obs_11_0018__li135211772221">The asterisk (*) represents any group of characters, and the question mark (?) represents any single character.</li><li id="obs_11_0018__li151801324163419">You can use <strong id="obs_11_0018__b96364102108">\*</strong> to represent <strong id="obs_11_0018__b136376101104">*</strong> and <strong id="obs_11_0018__b2638710121019">\?</strong> to represent <strong id="obs_11_0018__b1263991081017">?</strong>.</li><li id="obs_11_0018__li201739642420">Only after identifying that the name of the file to be downloaded does not match the value of <strong id="obs_11_0018__b14699101251018">exclude</strong>, the system checks whether the file name matches the value of this parameter. If yes, the file is downloaded. If not, the file is skipped.</li></ul> <div class="note" id="obs_11_0018__note195168716220"><span class="notetitle"> NOTE: </span><div class="notebody"><ul id="obs_11_0018__ul752013715229"><li id="obs_11_0018__li135211772221">The asterisk (*) represents any group of characters, and the question mark (?) represents any single character.</li><li id="obs_11_0018__li151801324163419">You can use <strong id="obs_11_0018__b96364102108">\*</strong> to represent <strong id="obs_11_0018__b136376101104">*</strong> and <strong id="obs_11_0018__b2638710121019">\?</strong> to represent <strong id="obs_11_0018__b1263991081017">?</strong>.</li><li id="obs_11_0018__li201739642420">The <strong id="obs_11_0018__b1936116309710">exclude</strong> rule is applied first. If the name of the object to be downloaded does not match the <strong id="obs_11_0018__b636114301770">exclude</strong> rule, the system then checks whether the object name matches this parameter. If it does, the object is downloaded; if it does not, the object is skipped.</li></ul>
</div></div> </div></div>
<div class="notice" id="obs_11_0018__note9270217202212"><span class="noticetitle"> NOTICE: </span><div class="noticebody"><ul id="obs_11_0018__ul1329413124584"><li id="obs_11_0018__li14294512115812">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_0018__li5744647391">The matching pattern applies to the absolute path of an object, including the object name prefix and object name starting from the root directory. For example, if the path of an object in the bucket is <strong id="obs_11_0018__b14412319182712">obs://bucket/src1/src2/test.txt</strong>, then the absolute path of the object is <strong id="obs_11_0018__b14412121942719">src1/src2/test.txt</strong>.</li><li id="obs_11_0018__li19166484914">This matching pattern applies only to objects whose names do not end with a slash (/).</li><li id="obs_11_0018__li1635081043119">Multiple <strong id="obs_11_0018__b3341521513">include</strong> parameters can be specified, for example, <strong id="obs_11_0018__b108056474514">-include=*.xxx -include=*.xxx</strong>.</li></ul> <div class="notice" id="obs_11_0018__note9270217202212"><span class="noticetitle"> NOTICE: </span><div class="noticebody"><ul id="obs_11_0018__ul1329413124584"><li id="obs_11_0018__li14294512115812">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_0018__li5744647391">The matching pattern applies to the object's absolute path, which includes the object name prefix and the object name starting from the root directory. For example, if an object's path in the bucket is <strong id="obs_11_0018__b141493363215">obs://bucket/src1/src2/test.txt</strong>, its absolute path is <strong id="obs_11_0018__b0149133614214">src1/src2/test.txt</strong>.</li><li id="obs_11_0018__li19166484914">This matching pattern applies only to objects whose names do not end with a slash (/).</li><li id="obs_11_0018__li1635081043119">Multiple <strong id="obs_11_0018__b3341521513">include</strong> parameters can be specified, for example, <strong id="obs_11_0018__b108056474514">-include=*.xxx -include=*.xxx</strong>.</li></ul>
</div></div> </div></div>
</td> </td>
</tr> </tr>
@ -237,7 +237,7 @@ Task id: 3066a4b0-4d21-4929-bb84-4829c32cbd0f</pre>
</td> </td>
<td class="cellrowborder" valign="top" width="56.56565656565656%" headers="mcps1.3.4.2.1.4.1.3 "><p id="obs_11_0018__p16963940134813">The time range matching pattern when downloading objects. Only objects whose latest modification time is within the configured time range are downloaded.</p> <td class="cellrowborder" valign="top" width="56.56565656565656%" headers="mcps1.3.4.2.1.4.1.3 "><p id="obs_11_0018__p16963940134813">The time range matching pattern when downloading objects. Only objects whose latest modification time is within the configured time range are downloaded.</p>
<p id="obs_11_0018__p338461155315">This pattern has a lower priority than the object matching patterns (<strong id="obs_11_0018__b239512331936">exclude</strong>/<strong id="obs_11_0018__b33978336316">include</strong>). That is, the time range matching pattern is executed after the configured object matching patterns.</p> <p id="obs_11_0018__p338461155315">This pattern has a lower priority than the object matching patterns (<strong id="obs_11_0018__b239512331936">exclude</strong>/<strong id="obs_11_0018__b33978336316">include</strong>). That is, the time range matching pattern is executed after the configured object matching patterns.</p>
<div class="note" id="obs_11_0018__note8766915165919"><span class="notetitle"> NOTE: </span><div class="notebody"><ul id="obs_11_0018__ul19272430145915"><li id="obs_11_0018__li12731730115918">The matching time range is represented in <em id="obs_11_0018__i7149142272719">time1</em><strong id="obs_11_0018__b17149422192717">-</strong><em id="obs_11_0018__i8149162242711">time2</em>, where <em id="obs_11_0018__i61506224276">time1</em> must be earlier than or the same as <em id="obs_11_0018__i201501622202716">time2</em>. The time format is <em id="obs_11_0018__i4151722102717">yyyyMMddHHmmss</em>.</li><li id="obs_11_0018__li32731530185916">Automatic formatting is supported. For example, yyyyMMdd is equivalent to yyyyMMdd000000, and yyyyMM is equivalent to yyyyMM01000000.</li><li id="obs_11_0018__li5185481610">If this parameter is set to <strong id="obs_11_0018__b1156152520273">*-</strong><em id="obs_11_0018__i856132562720">time2</em>, all files whose latest modification time is earlier than <em id="obs_11_0018__i857132511273">time2</em> are matched. If it is set to <em id="obs_11_0018__i205812582712">time1</em><strong id="obs_11_0018__b559225112719">-*</strong>, all files whose latest modification time is later than <em id="obs_11_0018__i15608259273">time1</em> are matched.</li></ul> <div class="note" id="obs_11_0018__note8766915165919"><span class="notetitle"> NOTE: </span><div class="notebody"><ul id="obs_11_0018__ul19272430145915"><li id="obs_11_0018__li12731730115918">The matching time range is represented in <em id="obs_11_0018__i7149142272719">time1</em><strong id="obs_11_0018__b17149422192717">-</strong><em id="obs_11_0018__i8149162242711">time2</em>, where <em id="obs_11_0018__i61506224276">time1</em> must be earlier than or the same as <em id="obs_11_0018__i201501622202716">time2</em>. The time format is <em id="obs_11_0018__i4151722102717">yyyyMMddHHmmss</em>.</li><li id="obs_11_0018__li32731530185916">Automatic formatting is supported. For example, yyyyMMdd is equivalent to yyyyMMdd000000, and yyyyMM is equivalent to yyyyMM01000000.</li><li id="obs_11_0018__li5185481610">If this parameter is set to <strong id="obs_11_0018__b5771944105516">*-</strong><em id="obs_11_0018__i147711244175518">time2</em>, all files whose last modification time is earlier than <em id="obs_11_0018__i1777114416559">time2</em> are matched. If it is set to <em id="obs_11_0018__i8771154411552">time1</em><strong id="obs_11_0018__b19771104414558">-*</strong>, all files whose last modification time is later than <em id="obs_11_0018__i18771344155510">time1</em> are matched.</li></ul>
</div></div> </div></div>
<div class="notice" id="obs_11_0018__note1078981817591"><span class="noticetitle"> NOTICE: </span><div class="noticebody"><ul id="obs_11_0018__ul881073612597"><li id="obs_11_0018__li1740024105917">Time in the matching pattern is the UTC time.</li><li id="obs_11_0018__li58105368598">This matching pattern applies only to objects whose names do not end with a slash (/).</li></ul> <div class="notice" id="obs_11_0018__note1078981817591"><span class="noticetitle"> NOTICE: </span><div class="noticebody"><ul id="obs_11_0018__ul881073612597"><li id="obs_11_0018__li1740024105917">Time in the matching pattern is the UTC time.</li><li id="obs_11_0018__li58105368598">This matching pattern applies only to objects whose names do not end with a slash (/).</li></ul>
</div></div> </div></div>
@ -281,6 +281,8 @@ Task id: 3066a4b0-4d21-4929-bb84-4829c32cbd0f</pre>
<td class="cellrowborder" valign="top" width="26.26262626262626%" headers="mcps1.3.4.2.1.4.1.2 "><p id="obs_11_0018__p1266611611820">Optional (additional parameter)</p> <td class="cellrowborder" valign="top" width="26.26262626262626%" headers="mcps1.3.4.2.1.4.1.2 "><p id="obs_11_0018__p1266611611820">Optional (additional parameter)</p>
</td> </td>
<td class="cellrowborder" valign="top" width="56.56565656565656%" headers="mcps1.3.4.2.1.4.1.3 "><p id="obs_11_0018__p1166617619181">Specifies that requester pays is enabled.</p> <td class="cellrowborder" valign="top" width="56.56565656565656%" headers="mcps1.3.4.2.1.4.1.3 "><p id="obs_11_0018__p1166617619181">Specifies that requester pays is enabled.</p>
<p id="obs_11_0018__p13214143095512"><strong id="obs_11_0018__b52518882934551">Range</strong>:</p>
<p id="obs_11_0018__p13744112545515">requester</p>
</td> </td>
</tr> </tr>
</tbody> </tbody>

8
docs/obs/tool-obsutil/obs_11_0019.html
View File

@ -3,11 +3,11 @@
<h1 class="topictitle1">Listing Multipart Upload Tasks</h1> <h1 class="topictitle1">Listing Multipart Upload Tasks</h1>
<div id="body1543218301375"><div class="section" id="obs_11_0019__section12810504216"><h4 class="sectiontitle">Function</h4><p id="obs_11_0019__p9999175242119">You can use this command to query multipart upload tasks in a bucket.</p> <div id="body1543218301375"><div class="section" id="obs_11_0019__section12810504216"><h4 class="sectiontitle">Function</h4><p id="obs_11_0019__p9999175242119">You can use this command to query multipart upload tasks in a bucket.</p>
</div> </div>
<div class="section" id="obs_11_0019__section315294314215"><h4 class="sectiontitle">Command Line Structure</h4><ul id="obs_11_0019__ul58796448547"><li id="obs_11_0019__li0879164435415">In Windows<pre class="screen" id="obs_11_0019__screen446719211557">obsutil ls obs://bucket[/prefix] [-s] [-d] -m [-a] [-uploadIdMarker=xxx] [-marker=xxx] [-limit=1] [-config=xxx] </pre> <div class="section" id="obs_11_0019__section315294314215"><h4 class="sectiontitle">Command Line Structure</h4><ul id="obs_11_0019__ul58796448547"><li id="obs_11_0019__li0879164435415">Windows<pre class="screen" id="obs_11_0019__screen446719211557">obsutil ls obs://bucket[/prefix] [-s] [-d] -m [-a] [-uploadIdMarker=xxx] [-marker=xxx] [-limit=1] [-config=xxx] </pre>
</li><li id="obs_11_0019__li5449164865411">In Linux or macOS<pre class="screen" id="obs_11_0019__screen1717420915512">./obsutil ls obs://bucket[/prefix] [-s] [-d] -m [-a] [-uploadIdMarker=xxx] [-marker=xxx] [-limit=1] [-config=xxx] </pre> </li><li id="obs_11_0019__li5449164865411">macOS or Linux<pre class="screen" id="obs_11_0019__screen1717420915512">./obsutil ls obs://bucket[/prefix] [-s] [-d] -m [-a] [-uploadIdMarker=xxx] [-marker=xxx] [-limit=1] [-config=xxx] </pre>
</li></ul> </li></ul>
</div> </div>
<div class="section" id="obs_11_0019__section69087220415"><h4 class="sectiontitle">Examples</h4><ul id="obs_11_0019__ul1690813221410"><li id="obs_11_0019__li7908182213412">Take the Windows OS as an example. Run the <strong id="obs_11_0019__b1749332852013">obsutil ls obs://bucket-test -m -limit=10</strong> command to query the multipart upload tasks in the bucket.<pre class="screen" id="obs_11_0019__screen13908182217418"><strong id="obs_11_0019__b139081122144120">obsutil ls obs://bucket-test -m -limit=10</strong> <div class="section" id="obs_11_0019__section69087220415"><h4 class="sectiontitle">Examples</h4><ul id="obs_11_0019__ul1690813221410"><li id="obs_11_0019__li7908182213412">In Windows, run <strong id="obs_11_0019__b1749332852013">obsutil ls obs://bucket-test -m -limit=10</strong> to list the multipart upload tasks in the bucket.<pre class="screen" id="obs_11_0019__screen13908182217418"><strong id="obs_11_0019__b139081122144120">obsutil ls obs://bucket-test -m -limit=10</strong>
Listing multipart uploads. Listing multipart uploads.
@ -129,6 +129,8 @@ Upload number: 6</pre>
<td class="cellrowborder" valign="top" width="25.252525252525253%" headers="mcps1.3.4.2.1.4.1.2 "><p id="obs_11_0019__p1266611611820">Optional (additional parameter)</p> <td class="cellrowborder" valign="top" width="25.252525252525253%" headers="mcps1.3.4.2.1.4.1.2 "><p id="obs_11_0019__p1266611611820">Optional (additional parameter)</p>
</td> </td>
<td class="cellrowborder" valign="top" width="56.565656565656575%" headers="mcps1.3.4.2.1.4.1.3 "><p id="obs_11_0019__p1166617619181">Specifies that requester pays is enabled.</p> <td class="cellrowborder" valign="top" width="56.565656565656575%" headers="mcps1.3.4.2.1.4.1.3 "><p id="obs_11_0019__p1166617619181">Specifies that requester pays is enabled.</p>
<p id="obs_11_0019__p13214143095512"><strong id="obs_11_0019__b11065945713460">Range</strong>:</p>
<p id="obs_11_0019__p13744112545515">requester</p>
</td> </td>
</tr> </tr>
</tbody> </tbody>

12
docs/obs/tool-obsutil/obs_11_0020.html
View File

@ -3,15 +3,15 @@
<h1 class="topictitle1">Deleting a Multipart Upload Task</h1> <h1 class="topictitle1">Deleting a Multipart Upload Task</h1>
<div id="body1542440101580"><div class="section" id="obs_11_0020__section1479112110815"><h4 class="sectiontitle">Function</h4><ul id="obs_11_0020__ul61984520588"><li id="obs_11_0020__li12198352584">You can use this command to delete a multipart upload task in a specified bucket by using the multipart upload ID.</li><li id="obs_11_0020__li91980516581">You can also use this command to delete multipart upload tasks in batches based on a specified object name prefix.</li></ul> <div id="body1542440101580"><div class="section" id="obs_11_0020__section1479112110815"><h4 class="sectiontitle">Function</h4><ul id="obs_11_0020__ul61984520588"><li id="obs_11_0020__li12198352584">You can use this command to delete a multipart upload task in a specified bucket by using the multipart upload ID.</li><li id="obs_11_0020__li91980516581">You can also use this command to delete multipart upload tasks in batches based on a specified object name prefix.</li></ul>
</div> </div>
<div class="section" id="obs_11_0020__section1220752192216"><h4 class="sectiontitle">Command Line Structure</h4><ul id="obs_11_0020__ul3951713145815"><li id="obs_11_0020__li119511113105810">In Windows<ul id="obs_11_0020__ul193328254584"><li id="obs_11_0020__li18441223155818">Deleting a single multipart upload task<pre class="screen" id="obs_11_0020__screen3547465593">obsutil abort obs://bucket/key -u=xxx [-f] [-fr] [-o=xxx] [-config=xxx] </pre> <div class="section" id="obs_11_0020__section1220752192216"><h4 class="sectiontitle">Command Line Structure</h4><ul id="obs_11_0020__ul3951713145815"><li id="obs_11_0020__li119511113105810">Windows<ul id="obs_11_0020__ul193328254584"><li id="obs_11_0020__li18441223155818">Deleting a single multipart upload task<pre class="screen" id="obs_11_0020__screen3547465593">obsutil abort obs://bucket/key -u=xxx [-f] [-fr] [-o=xxx] [-config=xxx] </pre>
</li><li id="obs_11_0020__li20491337155820">Deleting multipart upload tasks in batches<pre class="screen" id="obs_11_0020__screen9940161019596">obsutil abort obs://bucket[/key] -r [-f] [-o=xxx] [-j=1] [-config=xxx] </pre> </li><li id="obs_11_0020__li20491337155820">Deleting multipart upload tasks in batches<pre class="screen" id="obs_11_0020__screen9940161019596">obsutil abort obs://bucket[/key] -r [-f] [-o=xxx] [-j=1] [-config=xxx] </pre>
</li></ul> </li></ul>
</li><li id="obs_11_0020__li14461418135812">In Linux or macOS<ul id="obs_11_0020__ul105417065911"><li id="obs_11_0020__li59871095914">Deleting a single multipart upload task<pre class="screen" id="obs_11_0020__screen1754563812598">./obsutil abort obs://bucket/key -u=xxx [-f] [-fr] [-o=xxx] [-config=xxx] </pre> </li><li id="obs_11_0020__li14461418135812">macOS or Linux<ul id="obs_11_0020__ul105417065911"><li id="obs_11_0020__li59871095914">Deleting a single multipart upload task<pre class="screen" id="obs_11_0020__screen1754563812598">./obsutil abort obs://bucket/key -u=xxx [-f] [-fr] [-o=xxx] [-config=xxx] </pre>
</li><li id="obs_11_0020__li149897015598">Deleting multipart upload tasks in batches<pre class="screen" id="obs_11_0020__screen17222141813595">./obsutil abort obs://bucket[/key] -r [-f] [-o=xxx] [-j=1] [-config=xxx] </pre> </li><li id="obs_11_0020__li149897015598">Deleting multipart upload tasks in batches<pre class="screen" id="obs_11_0020__screen17222141813595">./obsutil abort obs://bucket[/key] -r [-f] [-o=xxx] [-j=1] [-config=xxx] </pre>
</li></ul> </li></ul>
</li></ul> </li></ul>
</div> </div>
<div class="section" id="obs_11_0020__section173791391418"><h4 class="sectiontitle">Examples</h4><ul id="obs_11_0020__ul838053915412"><li id="obs_11_0020__li73801039104117">Take the Windows OS as an example. Run the <strong id="obs_11_0020__b457411313143">obsutil abort obs://bucket-test/key -u=xxx -f</strong> command to delete a single multipart upload task.<pre class="screen" id="obs_11_0020__screen9380539124119"><strong id="obs_11_0020__b338023924119">obsutil abort obs://bucket-test/key -u=xxx -f</strong> <div class="section" id="obs_11_0020__section173791391418"><h4 class="sectiontitle">Examples</h4><ul id="obs_11_0020__ul838053915412"><li id="obs_11_0020__li73801039104117">In Windows, run <strong id="obs_11_0020__b457411313143">obsutil abort obs://bucket-test/key -u=xxx -f</strong> to delete a single multipart upload.<pre class="screen" id="obs_11_0020__screen9380539124119"><strong id="obs_11_0020__b338023924119">obsutil abort obs://bucket-test/key -u=xxx -f</strong>
Start at 2024-10-08 01:25:55.6771288 +0000 UTC Start at 2024-10-08 01:25:55.6771288 +0000 UTC
@ -21,7 +21,7 @@ Metrics [max cost:54 ms, min cost:54 ms, average cost:54.00 ms, average tps:8.77
Task id: 4972589c-c775-41be-a288-bbee3edaaee9</pre> Task id: 4972589c-c775-41be-a288-bbee3edaaee9</pre>
</li></ul> </li></ul>
<ul id="obs_11_0020__ul18380163916417"><li id="obs_11_0020__li0380639184111">Take the Windows OS as an example. Run the <strong id="obs_11_0020__b153291461773">obsutil abort obs://bucket-test -r -f</strong> command to delete all multipart upload tasks in the bucket in batches.<pre class="screen" id="obs_11_0020__screen1538013912413"><strong id="obs_11_0020__b14380163916412">obsutil abort obs://bucket-test -r -f</strong> <ul id="obs_11_0020__ul18380163916417"><li id="obs_11_0020__li0380639184111">In Windows, run <strong id="obs_11_0020__b153291461773">obsutil abort obs://bucket-test -r -f</strong> to delete all multipart uploads in the bucket in batches.<pre class="screen" id="obs_11_0020__screen1538013912413"><strong id="obs_11_0020__b14380163916412">obsutil abort obs://bucket-test -r -f</strong>
Start at 2024-10-08 01:28:29.1980739 +0000 UTC Start at 2024-10-08 01:28:29.1980739 +0000 UTC
[-----------------------------------------------] 100.00% tps:2924.55 3/3 202ms [-----------------------------------------------] 100.00% tps:2924.55 3/3 202ms
@ -92,7 +92,7 @@ Task id: cd2fd08e-fc31-47d9-b4b0-9f9a3376435f</pre>
<td class="cellrowborder" valign="top" width="28.000000000000004%" headers="mcps1.3.4.2.1.4.1.2 "><p id="obs_11_0020__p17745112212488">Optional for deleting multipart upload tasks (additional parameter)</p> <td class="cellrowborder" valign="top" width="28.000000000000004%" headers="mcps1.3.4.2.1.4.1.2 "><p id="obs_11_0020__p17745112212488">Optional for deleting multipart upload tasks (additional parameter)</p>
</td> </td>
<td class="cellrowborder" valign="top" width="55.00000000000001%" headers="mcps1.3.4.2.1.4.1.3 "><p id="obs_11_0020__p47481922194811">The maximum number of concurrent tasks for deleting multipart uploads in batches. The default value is the value of <strong id="obs_11_0020__b16444613907">defaultJobs</strong> in the configuration file.</p> <td class="cellrowborder" valign="top" width="55.00000000000001%" headers="mcps1.3.4.2.1.4.1.3 "><p id="obs_11_0020__p47481922194811">The maximum number of concurrent tasks for deleting multipart uploads in batches. The default value is the value of <strong id="obs_11_0020__b16444613907">defaultJobs</strong> in the configuration file.</p>
<div class="note" id="obs_11_0020__note891964620819"><span class="notetitle"> NOTE: </span><div class="notebody"><p id="obs_11_0020__p1091964618820">The value is ensured to be greater than or equal to 1.</p> <div class="note" id="obs_11_0020__note891964620819"><span class="notetitle"> NOTE: </span><div class="notebody"><p id="obs_11_0020__p1091964618820">The tool ensures that this value is at least 1.</p>
</div></div> </div></div>
</td> </td>
</tr> </tr>
@ -117,6 +117,8 @@ Task id: cd2fd08e-fc31-47d9-b4b0-9f9a3376435f</pre>
<td class="cellrowborder" valign="top" width="28.000000000000004%" headers="mcps1.3.4.2.1.4.1.2 "><p id="obs_11_0020__p1266611611820">Optional (additional parameter)</p> <td class="cellrowborder" valign="top" width="28.000000000000004%" headers="mcps1.3.4.2.1.4.1.2 "><p id="obs_11_0020__p1266611611820">Optional (additional parameter)</p>
</td> </td>
<td class="cellrowborder" valign="top" width="55.00000000000001%" headers="mcps1.3.4.2.1.4.1.3 "><p id="obs_11_0020__p1166617619181">Specifies that requester pays is enabled.</p> <td class="cellrowborder" valign="top" width="55.00000000000001%" headers="mcps1.3.4.2.1.4.1.3 "><p id="obs_11_0020__p1166617619181">Specifies that requester pays is enabled.</p>
<p id="obs_11_0020__p13214143095512"><strong id="obs_11_0020__b17245448343462">Range</strong>:</p>
<p id="obs_11_0020__p13744112545515">requester</p>
</td> </td>
</tr> </tr>
</tbody> </tbody>

14
docs/obs/tool-obsutil/obs_11_0021.html
View File

@ -8,21 +8,21 @@
<div class="section" id="obs_11_0021__section69267287212"><h4 class="sectiontitle">Important Notes</h4><p id="obs_11_0021__p199621934152117">In big data scenarios, parallel file systems usually have deep directory levels and each directory has a large number of files. In such case, deleting directories from parallel file systems may fail due to timeout. To address this problem, you are advised to delete directories in either of the following ways:</p> <div class="section" id="obs_11_0021__section69267287212"><h4 class="sectiontitle">Important Notes</h4><p id="obs_11_0021__p199621934152117">In big data scenarios, parallel file systems usually have deep directory levels and each directory has a large number of files. In such case, deleting directories from parallel file systems may fail due to timeout. To address this problem, you are advised to delete directories in either of the following ways:</p>
<ol id="obs_11_0021__ol241910394217"><li id="obs_11_0021__li19419113913214">On the Hadoop client that has OBSA, an OBS client plugin, embedded, run the <strong id="obs_11_0021__b1366215332450">hadoop fs - rmr obs://{</strong><em id="obs_11_0021__i866283304512">Name of a parallel file system</em><strong id="obs_11_0021__b9662143314455">}/{</strong><em id="obs_11_0021__i126628330455">Directory name</em><strong id="obs_11_0021__b10662133317453">}</strong> command.</li><li id="obs_11_0021__li13438134152113">Configure a lifecycle rule for directories so that they can be deleted in background based on the preset lifecycle rule.</li></ol> <ol id="obs_11_0021__ol241910394217"><li id="obs_11_0021__li19419113913214">On the Hadoop client that has OBSA, an OBS client plugin, embedded, run the <strong id="obs_11_0021__b1366215332450">hadoop fs - rmr obs://{</strong><em id="obs_11_0021__i866283304512">Name of a parallel file system</em><strong id="obs_11_0021__b9662143314455">}/{</strong><em id="obs_11_0021__i126628330455">Directory name</em><strong id="obs_11_0021__b10662133317453">}</strong> command.</li><li id="obs_11_0021__li13438134152113">Configure a lifecycle rule for directories so that they can be deleted in background based on the preset lifecycle rule.</li></ol>
</div> </div>
<div class="section" id="obs_11_0021__section1220752192216"><h4 class="sectiontitle">Command Line Structure</h4><ul id="obs_11_0021__ul2281182518013"><li id="obs_11_0021__li10281142517014">In Windows<ul id="obs_11_0021__ul179971435609"><li id="obs_11_0021__li21937346020">Deleting a single object<pre class="screen" id="obs_11_0021__screen13232122112117">obsutil rm obs://bucket/key [-f] [-versionId=xxx] [-fr] [-o=xxx] [-config=xxx] </pre> <div class="section" id="obs_11_0021__section1220752192216"><h4 class="sectiontitle">Command Line Structure</h4><ul id="obs_11_0021__ul2281182518013"><li id="obs_11_0021__li10281142517014">Windows<ul id="obs_11_0021__ul179971435609"><li id="obs_11_0021__li21937346020">Deleting a single object<pre class="screen" id="obs_11_0021__screen13232122112117">obsutil rm obs://bucket/key [-f] [-versionId=xxx] [-fr] [-o=xxx] [-config=xxx] </pre>
</li><li id="obs_11_0021__li1224416522001">Deleting objects in batches<pre class="screen" id="obs_11_0021__screen113425251415">obsutil rm obs://bucket/[key] -r [-j=1] [-f] [-v] [-o=xxx] [-config=xxx] </pre> </li><li id="obs_11_0021__li1224416522001">Deleting objects in batches<pre class="screen" id="obs_11_0021__screen113425251415">obsutil rm obs://bucket/[key] -r [-j=1] [-f] [-v] [-o=xxx] [-config=xxx] </pre>
</li></ul> </li></ul>
</li><li id="obs_11_0021__li9116229409">In Linux or macOS<ul id="obs_11_0021__ul1946101412110"><li id="obs_11_0021__li15246140120">Deleting a single object<pre class="screen" id="obs_11_0021__screen18977281317">./obsutil rm obs://bucket/key [-f] [-versionId=xxx] [-fr] [-o=xxx] [-config=xxx] </pre> </li><li id="obs_11_0021__li9116229409">macOS or Linux<ul id="obs_11_0021__ul1946101412110"><li id="obs_11_0021__li15246140120">Deleting a single object<pre class="screen" id="obs_11_0021__screen18977281317">./obsutil rm obs://bucket/key [-f] [-versionId=xxx] [-fr] [-o=xxx] [-config=xxx] </pre>
</li><li id="obs_11_0021__li952519141419">Deleting objects in batches<pre class="screen" id="obs_11_0021__screen260123212116">./obsutil rm obs://bucket/[key] -r [-j=1] [-f] [-v] [-o=xxx] [-config=xxx] </pre> </li><li id="obs_11_0021__li952519141419">Deleting objects in batches<pre class="screen" id="obs_11_0021__screen260123212116">./obsutil rm obs://bucket/[key] -r [-j=1] [-f] [-v] [-o=xxx] [-config=xxx] </pre>
</li></ul> </li></ul>
</li></ul> </li></ul>
</div> </div>
<div class="section" id="obs_11_0021__section18901940123814"><h4 class="sectiontitle">Examples</h4><ul id="obs_11_0021__ul5901140173813"><li id="obs_11_0021__li1791174073812">Take the Windows OS as an example. Run the <strong id="obs_11_0021__b457411313143">obsutil rm obs://bucket-test/key -f</strong> command to delete a single object named <strong id="obs_11_0021__b1977114720274">key</strong> in bucket <strong id="obs_11_0021__b22063411284">bucket-test</strong>.<pre class="screen" id="obs_11_0021__screen491194016382"><strong id="obs_11_0021__b691140163811">obsutil rm obs://bucket-test/key -f</strong> <div class="section" id="obs_11_0021__section18901940123814"><h4 class="sectiontitle">Examples</h4><ul id="obs_11_0021__ul5901140173813"><li id="obs_11_0021__li1791174073812">In Windows, run <strong id="obs_11_0021__b457411313143">obsutil rm obs://bucket-test/key -f</strong> to delete the <strong id="obs_11_0021__b1977114720274">key</strong> object in bucket <strong id="obs_11_0021__b22063411284">bucket-test</strong>.<pre class="screen" id="obs_11_0021__screen491194016382"><strong id="obs_11_0021__b691140163811">obsutil rm obs://bucket-test/key -f</strong>
Start at 2024-09-25 04:48:10.1147483 +0000 UTC Start at 2024-09-25 04:48:10.1147483 +0000 UTC
Delete object [key] in the bucket [bucket-test] successfully, cost [152], request id [0000016979E1D2B2860BB5181229C72C]</pre> Delete object [key] in the bucket [bucket-test] successfully, cost [152], request id [0000016979E1D2B2860BB5181229C72C]</pre>
</li></ul> </li></ul>
<ul id="obs_11_0021__ul1391134012387"><li id="obs_11_0021__li89116406386">Take the Windows OS as an example. Run the <strong id="obs_11_0021__b153291461773">obsutil rm obs://bucket-test -r -f</strong> command to delete all objects in bucket <strong id="obs_11_0021__b12534613192812">bucket-test</strong>.<pre class="screen" id="obs_11_0021__screen1791940163811"><strong id="obs_11_0021__b1691104010383">obsutil rm obs://bucket-test -r -f</strong> <ul id="obs_11_0021__ul1391134012387"><li id="obs_11_0021__li89116406386">In Windows, run <strong id="obs_11_0021__b153291461773">obsutil rm obs://bucket-test -r -f</strong> to delete all objects in bucket <strong id="obs_11_0021__b12534613192812">bucket-test</strong>.<pre class="screen" id="obs_11_0021__screen1791940163811"><strong id="obs_11_0021__b1691104010383">obsutil rm obs://bucket-test -r -f</strong>
Start at 2024-09-30 08:46:55.5335644 +0000 UTC Start at 2024-09-30 08:46:55.5335644 +0000 UTC
[===============================================] 100.00% 21s [===============================================] 100.00% 21s
@ -30,7 +30,7 @@ Succeed count: 1313 Failed count: 0
Task id: 95936984-f81a-441a-bba0-1fd8254d9241</pre> Task id: 95936984-f81a-441a-bba0-1fd8254d9241</pre>
</li></ul> </li></ul>
</div> </div>
<ul id="obs_11_0021__ul20705811466"><li id="obs_11_0021__li77051164617">Take the Windows OS as an example. Run the <strong id="obs_11_0021__b152541388407">obsutil rm obs://bucket-test/key -r -f</strong> command to delete all objects and folders prefixed with <strong id="obs_11_0021__b4997141754018">key</strong> in bucket <strong id="obs_11_0021__b1290272618405">bucket-test</strong>.<pre class="screen" id="obs_11_0021__screen67059174618"><strong id="obs_11_0021__b8705114461">obsutil rm obs://bucket-test/key -r -f</strong> <ul id="obs_11_0021__ul20705811466"><li id="obs_11_0021__li77051164617">In Windows, run <strong id="obs_11_0021__b152541388407">obsutil rm obs://bucket-test/key -r -f</strong> to delete all objects and folders prefixed with <strong id="obs_11_0021__b4997141754018">key</strong> in bucket <strong id="obs_11_0021__b1290272618405">bucket-test</strong>.<pre class="screen" id="obs_11_0021__screen67059174618"><strong id="obs_11_0021__b8705114461">obsutil rm obs://bucket-test/key -r -f</strong>
Start at 2024-09-30 08:49:09.5602115 +0000 UTC Start at 2024-09-30 08:49:09.5602115 +0000 UTC
[===============================================] 100.00% 21s [===============================================] 100.00% 21s
@ -98,7 +98,7 @@ Task id: 79ab59ec-7e00-4f22-8c88-465faa834125</pre>
<td class="cellrowborder" valign="top" width="19.38%" headers="mcps1.3.6.2.1.4.1.2 "><p id="obs_11_0021__p19305175612615">Optional for deleting objects in batches (additional parameter)</p> <td class="cellrowborder" valign="top" width="19.38%" headers="mcps1.3.6.2.1.4.1.2 "><p id="obs_11_0021__p19305175612615">Optional for deleting objects in batches (additional parameter)</p>
</td> </td>
<td class="cellrowborder" valign="top" width="64.31%" headers="mcps1.3.6.2.1.4.1.3 "><p id="obs_11_0021__p17665114555311">The maximum number of concurrent tasks for deleting objects in batches. The default value is the value of <strong id="obs_11_0021__b1268754012466">defaultJobs</strong> in the configuration file.</p> <td class="cellrowborder" valign="top" width="64.31%" headers="mcps1.3.6.2.1.4.1.3 "><p id="obs_11_0021__p17665114555311">The maximum number of concurrent tasks for deleting objects in batches. The default value is the value of <strong id="obs_11_0021__b1268754012466">defaultJobs</strong> in the configuration file.</p>
<div class="note" id="obs_11_0021__note891964620819"><span class="notetitle"> NOTE: </span><div class="notebody"><p id="obs_11_0021__p1091964618820">The value is ensured to be greater than or equal to 1.</p> <div class="note" id="obs_11_0021__note891964620819"><span class="notetitle"> NOTE: </span><div class="notebody"><p id="obs_11_0021__p1091964618820">The tool ensures that this value is at least 1.</p>
</div></div> </div></div>
</td> </td>
</tr> </tr>
@ -139,6 +139,8 @@ Task id: 79ab59ec-7e00-4f22-8c88-465faa834125</pre>
<td class="cellrowborder" valign="top" width="19.38%" headers="mcps1.3.6.2.1.4.1.2 "><p id="obs_11_0021__p1266611611820">Optional (additional parameter)</p> <td class="cellrowborder" valign="top" width="19.38%" headers="mcps1.3.6.2.1.4.1.2 "><p id="obs_11_0021__p1266611611820">Optional (additional parameter)</p>
</td> </td>
<td class="cellrowborder" valign="top" width="64.31%" headers="mcps1.3.6.2.1.4.1.3 "><p id="obs_11_0021__p1166617619181">Specifies that requester pays is enabled.</p> <td class="cellrowborder" valign="top" width="64.31%" headers="mcps1.3.6.2.1.4.1.3 "><p id="obs_11_0021__p1166617619181">Specifies that requester pays is enabled.</p>
<p id="obs_11_0021__p13214143095512"><strong id="obs_11_0021__b28315444334553">Range</strong>:</p>
<p id="obs_11_0021__p13744112545515">requester</p>
</td> </td>
</tr> </tr>
</tbody> </tbody>

8
docs/obs/tool-obsutil/obs_11_0023.html
View File

@ -4,11 +4,11 @@
<div id="body1542440101580"><div class="section" id="obs_11_0023__section1479112110815"><h4 class="sectiontitle">Function</h4><p id="obs_11_0023__p383175684016">You can update items in the <strong id="obs_11_0023__b6913161817">.obsutilconfig</strong> file, including the endpoint, AK, SK, and token.</p> <div id="body1542440101580"><div class="section" id="obs_11_0023__section1479112110815"><h4 class="sectiontitle">Function</h4><p id="obs_11_0023__p383175684016">You can update items in the <strong id="obs_11_0023__b6913161817">.obsutilconfig</strong> file, including the endpoint, AK, SK, and token.</p>
<p id="obs_11_0023__p11772825481"><a href="obs_11_0035.html">Configuration Parameters</a> describes parameters in the <strong id="obs_11_0023__b1292416325715">.obsutilconfig</strong> file.</p> <p id="obs_11_0023__p11772825481"><a href="obs_11_0035.html">Configuration Parameters</a> describes parameters in the <strong id="obs_11_0023__b1292416325715">.obsutilconfig</strong> file.</p>
</div> </div>
<div class="section" id="obs_11_0023__section1220752192216"><h4 class="sectiontitle">Command Line Structure</h4><ul id="obs_11_0023__ul10922428121013"><li id="obs_11_0023__li79221528121010">In Windows<pre class="screen" id="obs_11_0023__screen1230482601819">obsutil config -interactive [-crr] [-config=xxx]</pre> <div class="section" id="obs_11_0023__section1220752192216"><h4 class="sectiontitle">Command Line Structure</h4><ul id="obs_11_0023__ul10922428121013"><li id="obs_11_0023__li79221528121010">Windows<pre class="screen" id="obs_11_0023__screen1230482601819">obsutil config -interactive [-crr] [-config=xxx]</pre>
</li><li id="obs_11_0023__li106087324101">In Linux or macOS<pre class="screen" id="obs_11_0023__screen82312020141914">./obsutil config -interactive [-crr] [-config=xxx]</pre> </li><li id="obs_11_0023__li106087324101">macOS or Linux<pre class="screen" id="obs_11_0023__screen82312020141914">./obsutil config -interactive [-crr] [-config=xxx]</pre>
</li></ul> </li></ul>
</div> </div>
<div class="section" id="obs_11_0023__section16155112411445"><h4 class="sectiontitle">Examples</h4><ul id="obs_11_0023__ul155769421319"><li id="obs_11_0023__li115761746133">Take Windows as an example. Run the <strong id="obs_11_0023__b369616289395">obsutil config -interactive</strong> command to update the access keys and OBS endpoint in the default configuration file.<pre class="screen" id="obs_11_0023__screen41561524164419"><strong id="obs_11_0023__b1415632419447">obsutil config -interactive</strong> <div class="section" id="obs_11_0023__section16155112411445"><h4 class="sectiontitle">Examples</h4><ul id="obs_11_0023__ul155769421319"><li id="obs_11_0023__li115761746133">In Windows, run <strong id="obs_11_0023__b369616289395">obsutil config -interactive</strong> to update the access keys and OBS endpoint in the default configuration file.<pre class="screen" id="obs_11_0023__screen41561524164419"><strong id="obs_11_0023__b1415632419447">obsutil config -interactive</strong>
Please input your ak: Please input your ak:
xxxxxxxxxxxxxxxxxxxxxxxxx xxxxxxxxxxxxxxxxxxxxxxxxx
@ -22,7 +22,7 @@ Config file url:
C:\Users\tools\.obsutilconfig C:\Users\tools\.obsutilconfig
Update config file successfully!</pre> Update config file successfully!</pre>
</li><li id="obs_11_0023__li1760158161313">Take Linux as an example. Run the <strong id="obs_11_0023__b127711743182719">./obsutil config -interactive</strong> command to update the access keys and OBS endpoint in the default configuration file.<pre class="screen" id="obs_11_0023__screen237717508120"><strong id="obs_11_0023__b037713505122">./obsutil config -interactive</strong> </li><li id="obs_11_0023__li1760158161313">In Linux, run <strong id="obs_11_0023__b127711743182719">./obsutil config -interactive</strong> to update the access keys and OBS endpoint in the default configuration file.<pre class="screen" id="obs_11_0023__screen237717508120"><strong id="obs_11_0023__b037713505122">./obsutil config -interactive</strong>
Please input your ak: Please input your ak:
xxxxxxxxxxxxxxxxxxxxxxxxx xxxxxxxxxxxxxxxxxxxxxxxxx

6
docs/obs/tool-obsutil/obs_11_0024.html
View File

@ -3,11 +3,11 @@
<h1 class="topictitle1">Deleting Part Records</h1> <h1 class="topictitle1">Deleting Part Records</h1>
<div id="body1542440101580"><div class="section" id="obs_11_0024__section1479112110815"><h4 class="sectiontitle">Function</h4><p id="obs_11_0024__p11772825481">You can use this command to delete part records from a specified directory.</p> <div id="body1542440101580"><div class="section" id="obs_11_0024__section1479112110815"><h4 class="sectiontitle">Function</h4><p id="obs_11_0024__p11772825481">You can use this command to delete part records from a specified directory.</p>
</div> </div>
<div class="section" id="obs_11_0024__section1220752192216"><h4 class="sectiontitle">Command Line Structure</h4><ul id="obs_11_0024__ul8701213201118"><li id="obs_11_0024__li27013135110">In Windows<pre class="screen" id="obs_11_0024__screen8653829141115">obsutil clear [checkpoint_dir] [-u] [-d] [-c] [-config=xxx] </pre> <div class="section" id="obs_11_0024__section1220752192216"><h4 class="sectiontitle">Command Line Structure</h4><ul id="obs_11_0024__ul8701213201118"><li id="obs_11_0024__li27013135110">Windows<pre class="screen" id="obs_11_0024__screen8653829141115">obsutil clear [checkpoint_dir] [-u] [-d] [-c] [-config=xxx] </pre>
</li><li id="obs_11_0024__li14931417171112">In Linux or macOS<pre class="screen" id="obs_11_0024__screen36512381111">./obsutil clear [checkpoint_dir] [-u] [-d] [-c] [-config=xxx] </pre> </li><li id="obs_11_0024__li14931417171112">macOS or Linux<pre class="screen" id="obs_11_0024__screen36512381111">./obsutil clear [checkpoint_dir] [-u] [-d] [-c] [-config=xxx] </pre>
</li></ul> </li></ul>
</div> </div>
<div class="section" id="obs_11_0024__section571274494420"><h4 class="sectiontitle">Examples</h4><ul id="obs_11_0024__ul1771284454418"><li id="obs_11_0024__li197121444144411">Take the Windows OS as an example. Run the <strong id="obs_11_0024__b369616289395">obsutil clear -u</strong> command to delete the part records of multipart upload tasks in the default directory.<pre class="screen" id="obs_11_0024__screen14712144424410"><strong id="obs_11_0024__b14713124416448">obsutil clear -u</strong> <div class="section" id="obs_11_0024__section571274494420"><h4 class="sectiontitle">Examples</h4><ul id="obs_11_0024__ul1771284454418"><li id="obs_11_0024__li197121444144411">In Windows, run <strong id="obs_11_0024__b369616289395">obsutil clear -u</strong> to delete the checkpoint files for multipart uploads in the default directory.<pre class="screen" id="obs_11_0024__screen14712144424410"><strong id="obs_11_0024__b14713124416448">obsutil clear -u</strong>
Clear checkpoint files for uploading in folder [xxxxx] Clear checkpoint files for uploading in folder [xxxxx]
Start at 2024-10-08 01:49:37.6541204 +0000 UTC Start at 2024-10-08 01:49:37.6541204 +0000 UTC

6
docs/obs/tool-obsutil/obs_11_0025.html
View File

@ -3,11 +3,11 @@
<h1 class="topictitle1">Viewing Command Help Information</h1> <h1 class="topictitle1">Viewing Command Help Information</h1>
<div id="body1542440101580"><div class="section" id="obs_11_0025__section1479112110815"><h4 class="sectiontitle">Function</h4><p id="obs_11_0025__p11772825481">You can use this command to view the commands supported by obsutil or view the help information of a specific command.</p> <div id="body1542440101580"><div class="section" id="obs_11_0025__section1479112110815"><h4 class="sectiontitle">Function</h4><p id="obs_11_0025__p11772825481">You can use this command to view the commands supported by obsutil or view the help information of a specific command.</p>
</div> </div>
<div class="section" id="obs_11_0025__section1220752192216"><h4 class="sectiontitle">Command Line Structure</h4><ul id="obs_11_0025__ul6597155717117"><li id="obs_11_0025__li175971857171111">In Windows<pre class="screen" id="obs_11_0025__screen137711012124">obsutil help [command]</pre> <div class="section" id="obs_11_0025__section1220752192216"><h4 class="sectiontitle">Command Line Structure</h4><ul id="obs_11_0025__ul6597155717117"><li id="obs_11_0025__li175971857171111">Windows<pre class="screen" id="obs_11_0025__screen137711012124">obsutil help [command]</pre>
</li><li id="obs_11_0025__li645617111126">In Linux or macOS<pre class="screen" id="obs_11_0025__screen1589616151121">./obsutil help [command]</pre> </li><li id="obs_11_0025__li645617111126">macOS or Linux<pre class="screen" id="obs_11_0025__screen1589616151121">./obsutil help [command]</pre>
</li></ul> </li></ul>
</div> </div>
<div class="section" id="obs_11_0025__section18536152154510"><h4 class="sectiontitle">Examples</h4><ul id="obs_11_0025__ul753613224518"><li id="obs_11_0025__li145361729450">Take the Windows OS as an example. Run the <strong id="obs_11_0025__b8729656142010">obsutil help mb</strong> command to view the help information about the command for creating a bucket.<pre class="screen" id="obs_11_0025__screen553662114519"><strong id="obs_11_0025__b353611254511">obsutil help mb</strong> <div class="section" id="obs_11_0025__section18536152154510"><h4 class="sectiontitle">Examples</h4><ul id="obs_11_0025__ul753613224518"><li id="obs_11_0025__li145361729450">In Windows, run <strong id="obs_11_0025__b8729656142010">obsutil help mb</strong> to view the help information for the command that creates a bucket.<pre class="screen" id="obs_11_0025__screen553662114519"><strong id="obs_11_0025__b353611254511">obsutil help mb</strong>
Summary: Summary:
create a bucket with the specified parameters create a bucket with the specified parameters

6
docs/obs/tool-obsutil/obs_11_0026.html
View File

@ -3,11 +3,11 @@
<h1 class="topictitle1">Querying the Version Number</h1> <h1 class="topictitle1">Querying the Version Number</h1>
<div id="body1542440101580"><div class="section" id="obs_11_0026__section1479112110815"><h4 class="sectiontitle">Function</h4><p id="obs_11_0026__p11772825481">You can use this command to query the current version of obsutil.</p> <div id="body1542440101580"><div class="section" id="obs_11_0026__section1479112110815"><h4 class="sectiontitle">Function</h4><p id="obs_11_0026__p11772825481">You can use this command to query the current version of obsutil.</p>
</div> </div>
<div class="section" id="obs_11_0026__section1220752192216"><h4 class="sectiontitle">Command Line Structure</h4><ul id="obs_11_0026__ul15143334141212"><li id="obs_11_0026__li19143634121216">In Windows<pre class="screen" id="obs_11_0026__screen445811487122">obsutil version</pre> <div class="section" id="obs_11_0026__section1220752192216"><h4 class="sectiontitle">Command Line Structure</h4><ul id="obs_11_0026__ul15143334141212"><li id="obs_11_0026__li19143634121216">Windows<pre class="screen" id="obs_11_0026__screen445811487122">obsutil version</pre>
</li><li id="obs_11_0026__li1572043717123">In Linux or macOS<pre class="screen" id="obs_11_0026__screen1627105541213">./obsutil version</pre> </li><li id="obs_11_0026__li1572043717123">macOS or Linux<pre class="screen" id="obs_11_0026__screen1627105541213">./obsutil version</pre>
</li></ul> </li></ul>
</div> </div>
<div class="section" id="obs_11_0026__section15899161919244"><h4 class="sectiontitle">Examples</h4><p id="obs_11_0026__p2085423874611">Take the Windows OS as an example.</p> <div class="section" id="obs_11_0026__section15899161919244"><h4 class="sectiontitle">Examples</h4><p id="obs_11_0026__p2085423874611">In Windows, run the following command to view a version number.</p>
<pre class="screen" id="obs_11_0026__screen1917381703"><strong id="obs_11_0026__b19991745205">obsutil version</strong> <pre class="screen" id="obs_11_0026__screen1917381703"><strong id="obs_11_0026__b19991745205">obsutil version</strong>
obsutil version:5.1.9, obssdk version:2.2.12 obsutil version:5.1.9, obssdk version:2.2.12

18
docs/obs/tool-obsutil/obs_11_0028.html
View File

@ -10,21 +10,21 @@
<span style="color:#666600;">├──</span> src3 <span style="color:#666600;">├──</span> src3
<span style="color:#666600;">└──</span> test3.txt</pre> <span style="color:#666600;">└──</span> test3.txt</pre>
<p id="obs_11_0028__p17877103915256">Based on the preceding folder structure, different upload scenarios require different commands.</p> <p id="obs_11_0028__p17877103915256">Based on the preceding folder structure, different upload scenarios require different commands.</p>
<ul id="obs_11_0028__ul65731417913"><li id="obs_11_0028__li757312411492">To upload the <strong id="obs_11_0028__b2197851144">test3.txt</strong> file in the local <strong id="obs_11_0028__b112921377146">src1</strong> folder to the root directory of bucket <strong id="obs_11_0028__b38540751513">bucket-test</strong>, the command is as follows:<pre class="screen" id="obs_11_0028__screen97071023143413">./obsutil cp /src1/test3.txt obs://bucket-test</pre> <ul id="obs_11_0028__ul65731417913"><li id="obs_11_0028__li757312411492">To upload the <strong id="obs_11_0028__b2197851144">test3.txt</strong> file from the local <strong id="obs_11_0028__b112921377146">src1</strong> folder to the root directory of the <strong id="obs_11_0028__b38540751513">bucket-test</strong> bucket, use the following command:<pre class="screen" id="obs_11_0028__screen97071023143413">./obsutil cp /src1/test3.txt obs://bucket-test</pre>
<p id="obs_11_0028__p19189123203414">After the upload completes, the following object is generated in the bucket:</p> <p id="obs_11_0028__p19189123203414">After the upload completes, the following object is generated in the bucket:</p>
<pre class="screen" id="obs_11_0028__screen1493988173511">./obs://bucket-test/test3.txt</pre> <pre class="screen" id="obs_11_0028__screen1493988173511">./obs://bucket-test/test3.txt</pre>
</li><li id="obs_11_0028__li35730411890">To upload the <strong id="obs_11_0028__b137212416161">test3.txt</strong> file in the local <strong id="obs_11_0028__b275132415166">src1</strong> folder to the root directory of bucket <strong id="obs_11_0028__b37762414162">bucket-test</strong> and rename it to <strong id="obs_11_0028__b178862174171">aaa.txt</strong>, the command is as follows:<pre class="screen" id="obs_11_0028__screen960762624417">./obsutil cp /src1/test3.txt obs://bucket-test/aaa.txt</pre> </li><li id="obs_11_0028__li35730411890">To upload the <strong id="obs_11_0028__b137212416161">test3.txt</strong> file from the local <strong id="obs_11_0028__b275132415166">src1</strong> folder to the root directory of the <strong id="obs_11_0028__b37762414162">bucket-test</strong> bucket and rename it to <strong id="obs_11_0028__b178862174171">aaa.txt</strong>, use the following command:<pre class="screen" id="obs_11_0028__screen960762624417">./obsutil cp /src1/test3.txt obs://bucket-test/aaa.txt</pre>
<p id="obs_11_0028__p16543202916444">After the upload completes, the following object is generated in the bucket:</p> <p id="obs_11_0028__p16543202916444">After the upload completes, the following object is generated in the bucket:</p>
<pre class="screen" id="obs_11_0028__screen15482115134419">./obs://bucket-test/aaa.txt</pre> <pre class="screen" id="obs_11_0028__screen15482115134419">./obs://bucket-test/aaa.txt</pre>
</li><li id="obs_11_0028__li1057354116912">To upload the <strong id="obs_11_0028__b986263041720">test3.txt</strong> file in the local <strong id="obs_11_0028__b14865123015176">src1</strong> folder to the <strong id="obs_11_0028__b322232241816">src</strong> folder in bucket <strong id="obs_11_0028__b2867123071715">bucket-test</strong>, the command is as follows:<pre class="screen" id="obs_11_0028__screen1925185964516">./obsutil cp /src1/test3.txt obs://bucket-test/src/</pre> </li><li id="obs_11_0028__li1057354116912">To upload the <strong id="obs_11_0028__b986263041720">test3.txt</strong> file from the local <strong id="obs_11_0028__b14865123015176">src1</strong> folder to the <strong id="obs_11_0028__b322232241816">src</strong> folder in the <strong id="obs_11_0028__b2867123071715">bucket-test</strong> bucket, use the following command:<pre class="screen" id="obs_11_0028__screen1925185964516">./obsutil cp /src1/test3.txt obs://bucket-test/src/</pre>
<p id="obs_11_0028__p78768120461">After the upload completes, the following object is generated in the bucket:</p> <p id="obs_11_0028__p78768120461">After the upload completes, the following object is generated in the bucket:</p>
<pre class="screen" id="obs_11_0028__screen123251322154610">./obs://bucket-test/src/test3.txt</pre> <pre class="screen" id="obs_11_0028__screen123251322154610">./obs://bucket-test/src/test3.txt</pre>
</li><li id="obs_11_0028__li55739411691">To recursively upload the entire local <strong id="obs_11_0028__b318920179194">src2</strong> folder to the root directory of bucket <strong id="obs_11_0028__b27287475225">bucket-test</strong> in force mode, the command is as follows:<pre class="screen" id="obs_11_0028__screen13999192254816">./obsutil cp /src1/src2 obs://bucket-test -r -f</pre> </li><li id="obs_11_0028__li55739411691">To recursively upload the entire local <strong id="obs_11_0028__b318920179194">src2</strong> folder to the root directory of the <strong id="obs_11_0028__b27287475225">bucket-test</strong> bucket in force mode, use the following command:<pre class="screen" id="obs_11_0028__screen13999192254816">./obsutil cp /src1/src2 obs://bucket-test -r -f</pre>
<p id="obs_11_0028__p448583494818">After the upload completes, the following objects are generated in the bucket:</p> <p id="obs_11_0028__p448583494818">After the upload completes, the following objects are generated in the bucket:</p>
<pre class="screen" id="obs_11_0028__screen114981544114811">obs://bucket-test/src2/ <pre class="screen" id="obs_11_0028__screen114981544114811">obs://bucket-test/src2/
obs://bucket-test/src2/test1.txt obs://bucket-test/src2/test1.txt
obs://bucket-test/src2/test2.txt</pre> obs://bucket-test/src2/test2.txt</pre>
</li><li id="obs_11_0028__li4573134118920">To recursively upload the entire local <strong id="obs_11_0028__b04415293278">src1</strong> folder to the <strong id="obs_11_0028__b15883817152812">src</strong> folder in bucket <strong id="obs_11_0028__b1444442917271">bucket-test</strong> in force mode, the command is as follows:<pre class="screen" id="obs_11_0028__screen583411509104">./obsutil cp /src1 obs://bucket-test/src -r -f</pre> </li><li id="obs_11_0028__li4573134118920">To recursively upload the entire local <strong id="obs_11_0028__b04415293278">src1</strong> folder to the <strong id="obs_11_0028__b15883817152812">src</strong> folder in the <strong id="obs_11_0028__b1444442917271">bucket-test</strong> bucket in force mode, use the following command:<pre class="screen" id="obs_11_0028__screen583411509104">./obsutil cp /src1 obs://bucket-test/src -r -f</pre>
<p id="obs_11_0028__p15323162710105">After the upload completes, the following objects are generated in the bucket:</p> <p id="obs_11_0028__p15323162710105">After the upload completes, the following objects are generated in the bucket:</p>
<pre class="screen" id="obs_11_0028__screen149581934141019">obs://bucket-test/src/src1/ <pre class="screen" id="obs_11_0028__screen149581934141019">obs://bucket-test/src/src1/
obs://bucket-test/src/src1/src2/ obs://bucket-test/src/src1/src2/
@ -32,7 +32,7 @@ obs://bucket-test/src/src1/src2/test1.txt
obs://bucket-test/src/src1/src2/test2.txt obs://bucket-test/src/src1/src2/test2.txt
obs://bucket-test/src/src1/src3/ obs://bucket-test/src/src1/src3/
obs://bucket-test/src/src1/test3.txt</pre> obs://bucket-test/src/src1/test3.txt</pre>
</li><li id="obs_11_0028__li1357310411914">To recursively upload the all files and subfolders in the local <strong id="obs_11_0028__b1313313602818">src1</strong> folder to the <strong id="obs_11_0028__b313423662813">src</strong> folder in bucket <strong id="obs_11_0028__b613513619282">bucket-test</strong> in force mode, the command is as follows:<pre class="screen" id="obs_11_0028__screen1359032111119">./obsutil cp /src1 obs://bucket-test/src -r -f -flat</pre> </li><li id="obs_11_0028__li1357310411914">To recursively upload all files and subfolders from the local <strong id="obs_11_0028__b1313313602818">src1</strong> folder to the <strong id="obs_11_0028__b313423662813">src</strong> folder in the <strong id="obs_11_0028__b613513619282">bucket-test</strong> bucket in force mode, use the following command:<pre class="screen" id="obs_11_0028__screen1359032111119">./obsutil cp /src1 obs://bucket-test/src -r -f -flat</pre>
<p id="obs_11_0028__p121271656496">After the upload completes, the following objects are generated in the bucket:</p> <p id="obs_11_0028__p121271656496">After the upload completes, the following objects are generated in the bucket:</p>
<pre class="screen" id="obs_11_0028__screen9749104014106">obs://bucket-test/src/ <pre class="screen" id="obs_11_0028__screen9749104014106">obs://bucket-test/src/
obs://bucket-test/src/src2/ obs://bucket-test/src/src2/
@ -40,7 +40,7 @@ obs://bucket-test/src/src2/test1.txt
obs://bucket-test/src/src2/test2.txt obs://bucket-test/src/src2/test2.txt
obs://bucket-test/src/src3/ obs://bucket-test/src/src3/
obs://bucket-test/src/test3.txt</pre> obs://bucket-test/src/test3.txt</pre>
</li><li id="obs_11_0028__li1763215581321">To upload the <strong id="obs_11_0028__b2560161913219">file1</strong> file to the <strong id="obs_11_0028__b25216326210">bucket-test</strong> bucket, and resume the upload if the upload fails, run the following commands:<pre class="screen" id="obs_11_0028__screen1993515139149">./obsutil cp /file1 obs://bucket-test/file -f</pre> </li><li id="obs_11_0028__li1763215581321">To upload the local <strong id="obs_11_0028__b2560161913219">file1</strong> file to the <strong id="obs_11_0028__b25216326210">bucket-test</strong> bucket and resume the upload if it fails, use the following command:<pre class="screen" id="obs_11_0028__screen1993515139149">./obsutil cp /file1 obs://bucket-test/file -f</pre>
<p id="obs_11_0028__p1274123318144">The upload fails. The command output is as follows:</p> <p id="obs_11_0028__p1274123318144">The upload fails. The command output is as follows:</p>
<pre class="screen" id="obs_11_0028__screen96275241911"><strong id="obs_11_0028__b35758137149">./obsutil cp /file1 obs://bucket-test/file</strong> -f <pre class="screen" id="obs_11_0028__screen96275241911"><strong id="obs_11_0028__b35758137149">./obsutil cp /file1 obs://bucket-test/file</strong> -f
@ -59,7 +59,7 @@ CheckpointDir: xxxx
[====================================================] 100% 307.42MB/s 4.88GB/4.88GB 5.308s [====================================================] 100% 307.42MB/s 4.88GB/4.88GB 5.308s
Upload successfully, 4.88GB, n/a, /file1 --&gt; obs://bucket-test/file, cost [6325], status [200], request id [xxxxx]</pre> Upload successfully, 4.88GB, n/a, /file1 --&gt; obs://bucket-test/file, cost [6325], status [200], request id [xxxxx]</pre>
</li><li id="obs_11_0028__li204025347139">To incrementally upload all files from the local <strong id="obs_11_0028__b2008360290">src1</strong> folder to the <strong id="obs_11_0028__b18465481662">src</strong> directory of bucket <strong id="obs_11_0028__b267945270">bucket-test</strong>, the command is as follows:<pre class="screen" id="obs_11_0028__screen429204818613">./obsutil cp /src1 obs://bucket-test/src -f -r -u</pre> </li><li id="obs_11_0028__li204025347139">To incrementally upload all files and subfolders from the local <strong id="obs_11_0028__b377781779">src1</strong> folder to the <strong id="obs_11_0028__b18465481662">src</strong> directory of the <strong id="obs_11_0028__b1700818307">bucket-test</strong> bucket, use the following command:<pre class="screen" id="obs_11_0028__screen429204818613">./obsutil cp /src1 obs://bucket-test/src -f -r -u</pre>
<p id="obs_11_0028__p3867257142218">Four objects are successfully uploaded, one of which is a new object. The command output contains <strong id="obs_11_0028__b2080320211075">Skip count</strong>.</p> <p id="obs_11_0028__p3867257142218">Four objects are successfully uploaded, one of which is a new object. The command output contains <strong id="obs_11_0028__b2080320211075">Skip count</strong>.</p>
<pre class="screen" id="obs_11_0028__screen711816312237"><strong id="obs_11_0028__b71191310232">./obsutil cp /src1 obs://bucket-test/src</strong> -f -r -u</pre> <pre class="screen" id="obs_11_0028__screen711816312237"><strong id="obs_11_0028__b71191310232">./obsutil cp /src1 obs://bucket-test/src</strong> -f -r -u</pre>
<pre class="screen" id="obs_11_0028__screen31198314233">Start at 2024-10-08 02:00:18.8906532 +0000 UTC <pre class="screen" id="obs_11_0028__screen31198314233">Start at 2024-10-08 02:00:18.8906532 +0000 UTC
@ -74,7 +74,7 @@ OutputDir: xxxx
Succeed count: 4 Failed count: 0 Skip count: 3 Succeed count: 4 Failed count: 0 Skip count: 3
Succeed bytes: 2.09KB Succeed bytes: 2.09KB
Metrics [max cost:6 ms, min cost:6 ms, average cost:1.50 ms, average tps:52.63, transferred size :2.09KB]</pre> Metrics [max cost:6 ms, min cost:6 ms, average cost:1.50 ms, average tps:52.63, transferred size :2.09KB]</pre>
</li><li id="obs_11_0028__li2897203195717">Run the following command to exclude the <strong id="obs_11_0028__b1062322135120">src2</strong> folder (including all files and folders contained) when uploading the <strong id="obs_11_0028__b10131656185417">src1</strong> folder:<pre class="screen" id="obs_11_0028__screen862914360547">./obsutil cp /src1 obs://bucket-test/src -exclude "*src1/src2*" -f -r -mf</pre> </li><li id="obs_11_0028__li2897203195717">To exclude the <strong id="obs_11_0028__b1528151018231">src2</strong> folder (along with all of its contents) when uploading the <strong id="obs_11_0028__b71341811237">src1</strong> folder, use the following command:<pre class="screen" id="obs_11_0028__screen862914360547">./obsutil cp /src1 obs://bucket-test/src -exclude "*src1/src2*" -f -r -mf</pre>
<p id="obs_11_0028__p1167442118577">Five objects are successfully uploaded, and the upload information contains <strong id="obs_11_0028__b198807291512">exclude</strong> and the specific content.</p> <p id="obs_11_0028__p1167442118577">Five objects are successfully uploaded, and the upload information contains <strong id="obs_11_0028__b198807291512">exclude</strong> and the specific content.</p>
<pre class="screen" id="obs_11_0028__screen1431438135811">./obsutil cp /src1 obs://bucket-test/src -exclude "*src1/src2*" -f -r -mf <pre class="screen" id="obs_11_0028__screen1431438135811">./obsutil cp /src1 obs://bucket-test/src -exclude "*src1/src2*" -f -r -mf
Start at 2024-10-08 02:04:27.7752009 +0000 UTC Start at 2024-10-08 02:04:27.7752009 +0000 UTC

12
docs/obs/tool-obsutil/obs_11_0029.html
View File

@ -16,27 +16,27 @@ obs://bucket-test/src2/test8.txt
obs://bucket-test/src2/src3/ obs://bucket-test/src2/src3/
obs://bucket-test/src2/src3/test9.txt</pre> obs://bucket-test/src2/src3/test9.txt</pre>
<p id="obs_11_0029__p0873101916261">Based on the structure of objects in the bucket, different download scenarios require different commands.</p> <p id="obs_11_0029__p0873101916261">Based on the structure of objects in the bucket, different download scenarios require different commands.</p>
<ul id="obs_11_0029__ul174731818476"><li id="obs_11_0029__li1830605242615">To download the <strong id="obs_11_0029__b10644143692215">test1.txt</strong> file from bucket <strong id="obs_11_0029__b106981022236">bucket-test</strong> to the local <strong id="obs_11_0029__b7255151910231">src1</strong> folder, the command is as follows:<pre class="screen" id="obs_11_0029__screen1824094893113">./obsutil cp obs://bucket-test/test1.txt /src1</pre> <ul id="obs_11_0029__ul174731818476"><li id="obs_11_0029__li1830605242615">To download the <strong id="obs_11_0029__b10644143692215">test1.txt</strong> file from the <strong id="obs_11_0029__b106981022236">bucket-test</strong> bucket to the local <strong id="obs_11_0029__b7255151910231">src1</strong> folder, use the following command:<pre class="screen" id="obs_11_0029__screen1824094893113">./obsutil cp obs://bucket-test/test1.txt /src1</pre>
<p id="obs_11_0029__p398225316315">After the download is complete, the following file is generated on the local PC:</p> <p id="obs_11_0029__p398225316315">After the download is complete, the following file is generated on the local PC:</p>
<pre class="screen" id="obs_11_0029__screen251512321320"><span style="color:#666600;">└──</span> src1 <pre class="screen" id="obs_11_0029__screen251512321320"><span style="color:#666600;">└──</span> src1
<span style="color:#666600;">└──</span> test1.txt</pre> <span style="color:#666600;">└──</span> test1.txt</pre>
</li><li id="obs_11_0029__li116837346319">Run the following command to download the <strong id="obs_11_0029__b12949322173019">test1.txt</strong> file to your local PC. If there is no <strong id="obs_11_0029__b139502022103014">test.txt</strong> on the local PC, the <strong id="obs_11_0029__b209519221304">test1.txt</strong> file is directly downloaded and you can rename it to <strong id="obs_11_0029__b19951132218304">test.txt</strong>. If <strong id="obs_11_0029__b395252293015">test.txt</strong> already exists, <strong id="obs_11_0029__b1495372217305">test1.txt</strong> is downloaded and overwrites the original local <strong id="obs_11_0029__b195316227307">test.txt</strong> file after renaming.<pre class="screen" id="obs_11_0029__screen18345312154212">./obsutil cp obs://bucket-test/test1.txt /test.txt</pre> </li><li id="obs_11_0029__li116837346319">To download the <strong id="obs_11_0029__b12949322173019">test1.txt</strong> file from the <strong id="obs_11_0029__b579884432415">bucket-test</strong> bucket to your local PC, use the following command. If <strong id="obs_11_0029__b139502022103014">test.txt</strong> does not exist locally, the <strong id="obs_11_0029__b209519221304">test1.txt</strong> file will be downloaded and saved as <strong id="obs_11_0029__b19951132218304">test.txt</strong>. If <strong id="obs_11_0029__b395252293015">test.txt</strong> already exists, the download will overwrite it with the contents of <strong id="obs_11_0029__b27891132133819">test1.txt</strong>.<pre class="screen" id="obs_11_0029__screen18345312154212">./obsutil cp obs://bucket-test/test1.txt /test.txt</pre>
<p id="obs_11_0029__p664518192425">After the download is complete, the following file is generated on the local PC:</p> <p id="obs_11_0029__p664518192425">After the download is complete, the following file is generated on the local PC:</p>
<pre class="screen" id="obs_11_0029__screen719113424214"><span style="color:#666600;">└──</span> test.txt</pre> <pre class="screen" id="obs_11_0029__screen719113424214"><span style="color:#666600;">└──</span> test.txt</pre>
</li><li id="obs_11_0029__li1261911034212">To recursively download the entire <strong id="obs_11_0029__b692395819425">src2</strong> folder from bucket <strong id="obs_11_0029__b20771274471">bucket-test</strong> to the local <strong id="obs_11_0029__b109242582427">src1</strong> folder in force mode, the command is as follows:<pre class="screen" id="obs_11_0029__screen17906155535618">./obsutil cp obs://bucket-test/src2 /src1 -r -f</pre> </li><li id="obs_11_0029__li1261911034212">To recursively download the entire <strong id="obs_11_0029__b692395819425">src2</strong> folder from the <strong id="obs_11_0029__b20771274471">bucket-test</strong> bucket to the local <strong id="obs_11_0029__b109242582427">src1</strong> folder in force mode, use the following command:<pre class="screen" id="obs_11_0029__screen17906155535618">./obsutil cp obs://bucket-test/src2 /src1 -r -f</pre>
<p id="obs_11_0029__p11605111105719">After the download is complete, the following files are generated on the local PC:</p> <p id="obs_11_0029__p11605111105719">After the download is complete, the following files are generated on the local PC:</p>
<pre class="screen" id="obs_11_0029__screen91301738185716"><span style="color:#666600;">└──</span> src1 <pre class="screen" id="obs_11_0029__screen91301738185716"><span style="color:#666600;">└──</span> src1
<span style="color:#666600;">└──</span> src2 <span style="color:#666600;">└──</span> src2
<span style="color:#666600;"> ├──</span> src3 <span style="color:#666600;"> ├──</span> src3
<span style="color:#666600;"> └──</span> test9.txt <span style="color:#666600;"> └──</span> test9.txt
<span style="color:#666600;"> └──</span> test8.txt</pre> <span style="color:#666600;"> └──</span> test8.txt</pre>
</li><li id="obs_11_0029__li1218311447562">To recursively download all files and subfolders in the <strong id="obs_11_0029__b195612824910">src2</strong> folder from bucket <strong id="obs_11_0029__b759112812491">bucket-test</strong> to the local <strong id="obs_11_0029__b196062812497">src1</strong> folder in force mode, the command is as follows:<pre class="screen" id="obs_11_0029__screen129059169590">./obsutil cp obs://bucket-test/src2 /src1 -r -f -flat</pre> </li><li id="obs_11_0029__li1218311447562">To recursively download all files and subfolders from the <strong id="obs_11_0029__b195612824910">src2</strong> folder of the <strong id="obs_11_0029__b759112812491">bucket-test</strong> bucket to the local <strong id="obs_11_0029__b196062812497">src1</strong> folder in force mode, use the following command:<pre class="screen" id="obs_11_0029__screen129059169590">./obsutil cp obs://bucket-test/src2 /src1 -r -f -flat</pre>
<p id="obs_11_0029__p7171129202">After the download is complete, the following files are generated on the local PC:</p> <p id="obs_11_0029__p7171129202">After the download is complete, the following files are generated on the local PC:</p>
<pre class="screen" id="obs_11_0029__screen1565013581502"><span style="color:#666600;">└──</span> src1 <pre class="screen" id="obs_11_0029__screen1565013581502"><span style="color:#666600;">└──</span> src1
<span style="color:#666600;"> ├──</span> src3 <span style="color:#666600;"> ├──</span> src3
<span style="color:#666600;"> └──</span> test9.txt <span style="color:#666600;"> └──</span> test9.txt
<span style="color:#666600;">└──</span> test8.txt</pre> <span style="color:#666600;">└──</span> test8.txt</pre>
</li><li id="obs_11_0029__li13172115610584">To recursively download the all objects in bucket <strong id="obs_11_0029__b589718805516">bucket-test</strong> to the local <strong id="obs_11_0029__b1789718845517">src0</strong> folder in force mode, the command is as follows:<pre class="screen" id="obs_11_0029__screen6155127538">./obsutil cp obs://bucket-test /src0 -r -f</pre> </li><li id="obs_11_0029__li13172115610584">To recursively download all objects from the <strong id="obs_11_0029__b589718805516">bucket-test</strong> bucket to the local <strong id="obs_11_0029__b1789718845517">src0</strong> folder in force mode, use the following command:<pre class="screen" id="obs_11_0029__screen6155127538">./obsutil cp obs://bucket-test /src0 -r -f</pre>
<p id="obs_11_0029__p1093315343315">After the download is complete, the following files are generated on the local PC:</p> <p id="obs_11_0029__p1093315343315">After the download is complete, the following files are generated on the local PC:</p>
<pre class="screen" id="obs_11_0029__screen77316291358"><span style="color:#666600;">└──</span> src0 <pre class="screen" id="obs_11_0029__screen77316291358"><span style="color:#666600;">└──</span> src0
<span style="color:#666600;"> ├──</span> test1.txt <span style="color:#666600;"> ├──</span> test1.txt
@ -51,7 +51,7 @@ obs://bucket-test/src2/src3/test9.txt</pre>
<span style="color:#666600;">├──</span> src3 <span style="color:#666600;">├──</span> src3
<span style="color:#666600;"> └──</span> test9.txt <span style="color:#666600;"> └──</span> test9.txt
<span style="color:#666600;"> └──</span> test8.txt</pre> <span style="color:#666600;"> └──</span> test8.txt</pre>
</li><li id="obs_11_0029__li2897203195717">Run the following command to exclude the <strong id="obs_11_0029__b1599122866">src2</strong> folder (including all files and folders contained) when downloading the <strong id="obs_11_0029__b10991121662">src1</strong> folder from the <strong id="obs_11_0029__b929020391761">bucket-test</strong> bucket:<pre class="screen" id="obs_11_0029__screen862914360547">./obsutil cp obs://bucket-test/src1/ src1 -exclude "*src1/src2*" -r -f -mf</pre> </li><li id="obs_11_0029__li2897203195717">To exclude the <strong id="obs_11_0029__b1599122866">src2</strong> folder (including all of its contents) when downloading the <strong id="obs_11_0029__b10991121662">src1</strong> folder from the <strong id="obs_11_0029__b929020391761">bucket-test</strong> bucket, use the following command:<pre class="screen" id="obs_11_0029__screen862914360547">./obsutil cp obs://bucket-test/src1/ src1 -exclude "*src1/src2*" -r -f -mf</pre>
<p id="obs_11_0029__p1167442118577">Four objects are successfully downloaded, and the download information contains <strong id="obs_11_0029__b1726517432060">exclude</strong> and the specific content.</p> <p id="obs_11_0029__p1167442118577">Four objects are successfully downloaded, and the download information contains <strong id="obs_11_0029__b1726517432060">exclude</strong> and the specific content.</p>
<pre class="screen" id="obs_11_0029__screen1431438135811">./obsutil cp obs://bucket-test/src1/ src1 -exclude "*src1/src2*" -r -f -mf <pre class="screen" id="obs_11_0029__screen1431438135811">./obsutil cp obs://bucket-test/src1/ src1 -exclude "*src1/src2*" -r -f -mf

10
docs/obs/tool-obsutil/obs_11_0030.html
View File

@ -16,22 +16,22 @@ obs://bucket-src/src2/test8.txt
obs://bucket-src/src2/src3/ obs://bucket-src/src2/src3/
obs://bucket-src/src2/src3/test9.txt</pre> obs://bucket-src/src2/src3/test9.txt</pre>
<p id="obs_11_0030__p4490143842915">Based on the structure of objects in the bucket, different copy scenarios require different commands.</p> <p id="obs_11_0030__p4490143842915">Based on the structure of objects in the bucket, different copy scenarios require different commands.</p>
<ul id="obs_11_0030__ul174731818476"><li id="obs_11_0030__li23391442113117">To copy the <strong id="obs_11_0030__b195901924133613">test1.txt</strong> file from bucket <strong id="obs_11_0030__b38601828143610">bucket-src</strong> to bucket <strong id="obs_11_0030__b1679284483610">bucket-dest</strong>, the command is as follows:<pre class="screen" id="obs_11_0030__screen134701607338">./obsutil cp obs://bucket-src/test1.txt obs://bucket-dest</pre> <ul id="obs_11_0030__ul174731818476"><li id="obs_11_0030__li23391442113117">To copy the <strong id="obs_11_0030__b195901924133613">test1.txt</strong> file from the <strong id="obs_11_0030__b38601828143610">bucket-src</strong> bucket to the <strong id="obs_11_0030__b1679284483610">bucket-dest</strong> bucket, use the following command:<pre class="screen" id="obs_11_0030__screen134701607338">./obsutil cp obs://bucket-src/test1.txt obs://bucket-dest</pre>
<p id="obs_11_0030__p421814820337">After the copy is complete, the following object is generated in bucket <strong id="obs_11_0030__b54714489394">bucket-dest</strong>:</p> <p id="obs_11_0030__p421814820337">After the copy is complete, the following object is generated in bucket <strong id="obs_11_0030__b54714489394">bucket-dest</strong>:</p>
<pre class="screen" id="obs_11_0030__screen24831326184214">obs://bucket-dest/test1.txt</pre> <pre class="screen" id="obs_11_0030__screen24831326184214">obs://bucket-dest/test1.txt</pre>
</li><li id="obs_11_0030__li156448133217">To copy the content of the <strong id="obs_11_0030__b143881558173911">test1.txt</strong> file in bucket <strong id="obs_11_0030__b939385813916">bucket-src</strong> to the <strong id="obs_11_0030__b1688312918441">text.txt</strong> file in bucket <strong id="obs_11_0030__b5397105823910">bucket-dest</strong>, the command is as follows:<pre class="screen" id="obs_11_0030__screen35103318446">./obsutil cp obs://bucket-src/test1.txt obs://bucket-dest/test.txt</pre> </li><li id="obs_11_0030__li156448133217">To copy the contents of the <strong id="obs_11_0030__b143881558173911">test1.txt</strong> file in the <strong id="obs_11_0030__b939385813916">bucket-src</strong> bucket to the <strong id="obs_11_0030__b1688312918441">test.txt</strong> file in the <strong id="obs_11_0030__b5397105823910">bucket-dest</strong> bucket, use the following command:<pre class="screen" id="obs_11_0030__screen35103318446">./obsutil cp obs://bucket-src/test1.txt obs://bucket-dest/test.txt</pre>
<p id="obs_11_0030__p2355435104418">After the copy is complete, the following object is generated in bucket <strong id="obs_11_0030__b9841532124517">bucket-dest</strong>:</p> <p id="obs_11_0030__p2355435104418">After the copy is complete, the following object is generated in bucket <strong id="obs_11_0030__b9841532124517">bucket-dest</strong>:</p>
<pre class="screen" id="obs_11_0030__screen1131134814447">obs://bucket-dest/test.txt</pre> <pre class="screen" id="obs_11_0030__screen1131134814447">obs://bucket-dest/test.txt</pre>
</li><li id="obs_11_0030__li49953160445">To copy the <strong id="obs_11_0030__b778384264516">test1.txt</strong> file in bucket <strong id="obs_11_0030__b67842425459">bucket-src</strong> to the <strong id="obs_11_0030__b37851942114517">text</strong> folder in bucket <strong id="obs_11_0030__b978654213456">bucket-dest</strong>, the command is as follows:<pre class="screen" id="obs_11_0030__screen13166164513203">./obsutil cp obs://bucket-src/test1.txt obs://bucket-dest/test/</pre> </li><li id="obs_11_0030__li49953160445">To copy the <strong id="obs_11_0030__b778384264516">test1.txt</strong> file in the <strong id="obs_11_0030__b67842425459">bucket-src</strong> bucket to the <strong id="obs_11_0030__b37851942114517">test</strong> folder in the <strong id="obs_11_0030__b978654213456">bucket-dest</strong> bucket, use the following command:<pre class="screen" id="obs_11_0030__screen13166164513203">./obsutil cp obs://bucket-src/test1.txt obs://bucket-dest/test/</pre>
<p id="obs_11_0030__p187128417465">After the copy is complete, the following object is generated in bucket <strong id="obs_11_0030__b1620903104819">bucket-dest</strong>:</p> <p id="obs_11_0030__p187128417465">After the copy is complete, the following object is generated in bucket <strong id="obs_11_0030__b1620903104819">bucket-dest</strong>:</p>
<pre class="screen" id="obs_11_0030__screen1078720511468">obs://bucket-dest/test/test1.txt</pre> <pre class="screen" id="obs_11_0030__screen1078720511468">obs://bucket-dest/test/test1.txt</pre>
</li><li id="obs_11_0030__li133851558134412">Run the following command to recursively copy the entire <strong id="obs_11_0030__b1861203810489">src2</strong> folder in bucket <strong id="obs_11_0030__b13711436124914">bucket-src</strong> to bucket <strong id="obs_11_0030__b206583811487">bucket-dest</strong> in force mode:<pre class="screen" id="obs_11_0030__screen107719526203">./obsutil cp obs://bucket-src/src2 obs://bucket-dest -r -f</pre> </li><li id="obs_11_0030__li133851558134412">To recursively copy the entire <strong id="obs_11_0030__b19491192912296">src2</strong> folder from the <strong id="obs_11_0030__b13711436124914">bucket-src</strong> bucket to the <strong id="obs_11_0030__b206583811487">bucket-dest</strong> bucket in force mode, use the following command:<pre class="screen" id="obs_11_0030__screen107719526203">./obsutil cp obs://bucket-src/src2 obs://bucket-dest -r -f</pre>
<p id="obs_11_0030__p2062213345403">After the copy is complete, the following objects are generated in bucket <strong id="obs_11_0030__b116361229125017">bucket-dest</strong>:</p> <p id="obs_11_0030__p2062213345403">After the copy is complete, the following objects are generated in bucket <strong id="obs_11_0030__b116361229125017">bucket-dest</strong>:</p>
<pre class="screen" id="obs_11_0030__screen18781194620460">obs://bucket-dest/src2/ <pre class="screen" id="obs_11_0030__screen18781194620460">obs://bucket-dest/src2/
obs://bucket-dest/src2/test8.txt obs://bucket-dest/src2/test8.txt
obs://bucket-dest/src2/src3/ obs://bucket-dest/src2/src3/
obs://bucket-dest/src2/src3/test9.txt</pre> obs://bucket-dest/src2/src3/test9.txt</pre>
</li><li id="obs_11_0030__li1668483194517">To recursively copy all files and subfolders in the <strong id="obs_11_0030__b887214398506">src2</strong> folder in bucket <strong id="obs_11_0030__b9875153913503">bucket-src</strong> to bucket <strong id="obs_11_0030__b887815399507">bucket-dest</strong> in force mode, the command is as follows:<pre class="screen" id="obs_11_0030__screen18112009214">./obsutil cp obs://bucket-src/src2 obs://bucket-dest -r -f -flat</pre> </li><li id="obs_11_0030__li1668483194517">To recursively copy all files and subfolders from the <strong id="obs_11_0030__b887214398506">src2</strong> folder in the <strong id="obs_11_0030__b9875153913503">bucket-src</strong> bucket to the <strong id="obs_11_0030__b887815399507">bucket-dest</strong> bucket in force mode, use the following command:<pre class="screen" id="obs_11_0030__screen18112009214">./obsutil cp obs://bucket-src/src2 obs://bucket-dest -r -f -flat</pre>
<p id="obs_11_0030__p11489103718404">After the copy is complete, the following objects are generated in bucket <strong id="obs_11_0030__b196018720517">bucket-dest</strong>:</p> <p id="obs_11_0030__p11489103718404">After the copy is complete, the following objects are generated in bucket <strong id="obs_11_0030__b196018720517">bucket-dest</strong>:</p>
<pre class="screen" id="obs_11_0030__screen8497114114461">obs://bucket-dest/test8.txt <pre class="screen" id="obs_11_0030__screen8497114114461">obs://bucket-dest/test8.txt
obs://bucket-dest/src3/ obs://bucket-dest/src3/

6
docs/obs/tool-obsutil/obs_11_0031.html
View File

@ -14,17 +14,17 @@ obs://bucket-test/src1/test7.txt
obs://bucket-test/src2/ obs://bucket-test/src2/
obs://bucket-test/src2/test8.txt</pre> obs://bucket-test/src2/test8.txt</pre>
<p id="obs_11_0031__p6890155720220">Based on the structure of objects in the bucket, different object listing scenarios require different commands.</p> <p id="obs_11_0031__p6890155720220">Based on the structure of objects in the bucket, different object listing scenarios require different commands.</p>
<ul id="obs_11_0031__ul174731818476"><li id="obs_11_0031__li97601771879">To list three objects in bucket <strong id="obs_11_0031__b10740311310">bucket-test</strong>, the command is as follows:<pre class="screen" id="obs_11_0031__screen663013515912">./obsutil ls obs://bucket-test -limit=3</pre> <ul id="obs_11_0031__ul174731818476"><li id="obs_11_0031__li97601771879">To list three objects in the <strong id="obs_11_0031__b10740311310">bucket-test</strong> bucket, use the following command:<pre class="screen" id="obs_11_0031__screen663013515912">./obsutil ls obs://bucket-test -limit=3</pre>
<p id="obs_11_0031__p163819424915">The returned result is listed in lexicographical order by object name and version ID as follows:</p> <p id="obs_11_0031__p163819424915">The returned result is listed in lexicographical order by object name and version ID as follows:</p>
<pre class="screen" id="obs_11_0031__screen1413213287128">obs://bucket-test/test1.txt <pre class="screen" id="obs_11_0031__screen1413213287128">obs://bucket-test/test1.txt
obs://bucket-test/test2.txt obs://bucket-test/test2.txt
obs://bucket-test/test3.txt</pre> obs://bucket-test/test3.txt</pre>
</li><li id="obs_11_0031__li63641711819">To list three objects following <strong id="obs_11_0031__b49378207255">test3.txt</strong> in bucket <strong id="obs_11_0031__b169781540112311">bucket-test</strong>, the command is as follows:<pre class="screen" id="obs_11_0031__screen16647138191720">./obsutil ls obs://bucket-test -limit=3 -marker=test3.txt</pre> </li><li id="obs_11_0031__li63641711819">To list the three objects that come after <strong id="obs_11_0031__b49378207255">test3.txt</strong> in the <strong id="obs_11_0031__b169781540112311">bucket-test</strong> bucket, use the following command:<pre class="screen" id="obs_11_0031__screen16647138191720">./obsutil ls obs://bucket-test -limit=3 -marker=test3.txt</pre>
<p id="obs_11_0031__p338414270177">The returned result is listed in lexicographical order by object name and version ID as follows:</p> <p id="obs_11_0031__p338414270177">The returned result is listed in lexicographical order by object name and version ID as follows:</p>
<pre class="screen" id="obs_11_0031__screen9165534181813">obs://bucket-test/test4.txt <pre class="screen" id="obs_11_0031__screen9165534181813">obs://bucket-test/test4.txt
obs://bucket-test/test5.txt obs://bucket-test/test5.txt
obs://bucket-test/test6.txt</pre> obs://bucket-test/test6.txt</pre>
</li><li id="obs_11_0031__li6423193851816">To list the files and subdirectories in the root directory of bucket <strong id="obs_11_0031__b11694201513294">bucket-test</strong> in non-recursive mode, that is, files in the subdirectories are not listed, the command is as follows:<pre class="screen" id="obs_11_0031__screen5833109165713">./obsutil ls obs://bucket-test -d</pre> </li><li id="obs_11_0031__li6423193851816">To list the files and subdirectories in the root directory of the <strong id="obs_11_0031__b11694201513294">bucket-test</strong> bucket in non-recursive mode, meaning files inside subdirectories are not listed, use the following command:<pre class="screen" id="obs_11_0031__screen5833109165713">./obsutil ls obs://bucket-test -d</pre>
<p id="obs_11_0031__p7917133819528">The returned result is listed in lexicographical order by object name and version ID as follows:</p> <p id="obs_11_0031__p7917133819528">The returned result is listed in lexicographical order by object name and version ID as follows:</p>
<pre class="screen" id="obs_11_0031__screen1534182520569">obs://bucket-test/test1.txt <pre class="screen" id="obs_11_0031__screen1534182520569">obs://bucket-test/test1.txt
obs://bucket-test/test2.txt obs://bucket-test/test2.txt

4
docs/obs/tool-obsutil/obs_11_0032.html
View File

@ -11,12 +11,12 @@ obs://bucket-test/src1/
obs://bucket-test/src1/task4.txt uploadid5 obs://bucket-test/src1/task4.txt uploadid5
obs://bucket-test/src2/ obs://bucket-test/src2/
obs://bucket-test/src2/task5.txt uploadid6</pre> obs://bucket-test/src2/task5.txt uploadid6</pre>
<ul id="obs_11_0032__ul174731818476"><li id="obs_11_0032__li439345014019">Run the following command to list three multipart upload tasks in bucket <strong id="obs_11_0032__b245610293418">bucket-test</strong>:<pre class="screen" id="obs_11_0032__screen8875601439">./obsutil ls obs://bucket-test -m -limit=3</pre> <ul id="obs_11_0032__ul174731818476"><li id="obs_11_0032__li439345014019">To list three multipart upload tasks in the <strong id="obs_11_0032__b245610293418">bucket-test</strong> bucket, use the following command:<pre class="screen" id="obs_11_0032__screen8875601439">./obsutil ls obs://bucket-test -m -limit=3</pre>
<p id="obs_11_0032__p9306746318">The returned result is listed in lexicographical order by object name as follows:</p> <p id="obs_11_0032__p9306746318">The returned result is listed in lexicographical order by object name as follows:</p>
<pre class="screen" id="obs_11_0032__screen157442318310">obs://bucket-test/task1.txt uploadid1 <pre class="screen" id="obs_11_0032__screen157442318310">obs://bucket-test/task1.txt uploadid1
obs://bucket-test/task1.txt uploadid2 obs://bucket-test/task1.txt uploadid2
obs://bucket-test/task2.txt uploadid3</pre> obs://bucket-test/task2.txt uploadid3</pre>
</li><li id="obs_11_0032__li17287144811211">To list the rest multipart upload tasks following <strong id="obs_11_0032__b231462818104">uploadid1</strong>, the command is as follows:<pre class="screen" id="obs_11_0032__screen89067480710">./obsutil ls obs://bucket-test -m -limit=3 -marker=task1.txt -uploadIdMarker=uploadid1</pre> </li><li id="obs_11_0032__li17287144811211">To list the remaining multipart upload tasks that follow <strong id="obs_11_0032__b610493413392">uploadid1</strong>, use the following command:<pre class="screen" id="obs_11_0032__screen89067480710">./obsutil ls obs://bucket-test -m -limit=3 -marker=task1.txt -uploadIdMarker=uploadid1</pre>
<p id="obs_11_0032__p08249101476">The returned result is listed in lexicographical order by object name and upload ID as follows:</p> <p id="obs_11_0032__p08249101476">The returned result is listed in lexicographical order by object name and upload ID as follows:</p>
<pre class="screen" id="obs_11_0032__screen873812618711">obs://bucket-test/task1.txt uploadid2 <pre class="screen" id="obs_11_0032__screen873812618711">obs://bucket-test/task1.txt uploadid2
obs://bucket-test/task2.txt uploadid3 obs://bucket-test/task2.txt uploadid3

2
docs/obs/tool-obsutil/obs_11_0033.html
View File

@ -22,7 +22,7 @@
</li> </li>
<li class="ulchildlink"><strong><a href="obs_11_0039.html">Using obsutil to Replicate Data Across Regions on the Client Side</a></strong><br> <li class="ulchildlink"><strong><a href="obs_11_0039.html">Using obsutil to Replicate Data Across Regions on the Client Side</a></strong><br>
</li> </li>
<li class="ulchildlink"><strong><a href="obs_11_0073.html">Limiting the Upload and Download Rate for obsutil</a></strong><br> <li class="ulchildlink"><strong><a href="obs_11_0073.html">Limiting the Upload and Download Rates for obsutil</a></strong><br>
</li> </li>
</ul> </ul>
</div> </div>

6
docs/obs/tool-obsutil/obs_11_0035.html
View File

@ -313,7 +313,7 @@ faultTolerantMode=&lt;value&gt;</pre>
<td class="cellrowborder" valign="top" width="8.28082808280828%" headers="mcps1.3.5.2.5.1.2 "><p id="obs_11_0035__p649419526116">Optional</p> <td class="cellrowborder" valign="top" width="8.28082808280828%" headers="mcps1.3.5.2.5.1.2 "><p id="obs_11_0035__p649419526116">Optional</p>
</td> </td>
<td class="cellrowborder" valign="top" width="41.47414741474147%" headers="mcps1.3.5.2.5.1.3 "><p id="obs_11_0035__p185241522185012">Absolute path of obsutil logs. The value must be a file path. The default value is the path of the <strong id="obs_11_0035__b164821925161310">obsutil.log</strong> file in the subfolder <strong id="obs_11_0035__b64831625141316">.obsutil_log</strong> of the user's home directory (<strong id="obs_11_0035__b948413257137">HOME</strong> in Linux or macOS and <strong id="obs_11_0035__b9485825161311">C:\Users\</strong><em id="obs_11_0035__i348552514132">&lt;Username&gt;</em> in Windows).</p> <td class="cellrowborder" valign="top" width="41.47414741474147%" headers="mcps1.3.5.2.5.1.3 "><p id="obs_11_0035__p185241522185012">Absolute path of obsutil logs. The value must be a file path. The default value is the path of the <strong id="obs_11_0035__b164821925161310">obsutil.log</strong> file in the subfolder <strong id="obs_11_0035__b64831625141316">.obsutil_log</strong> of the user's home directory (<strong id="obs_11_0035__b948413257137">HOME</strong> in Linux or macOS and <strong id="obs_11_0035__b9485825161311">C:\Users\</strong><em id="obs_11_0035__i348552514132">&lt;Username&gt;</em> in Windows).</p>
<div class="note" id="obs_11_0035__note853813419401"><span class="notetitle"> NOTE: </span><div class="notebody"><ul id="obs_11_0035__ul19891125164011"><li id="obs_11_0035__li189165164015">If this parameter is left blank, no obsutil log is generated.</li><li id="obs_11_0035__li14891858403">The path must be a file path and cannot be a folder path.</li><li id="obs_11_0035__li1189113516408">After the obsutil log function is enabled, all logs generated during commands executing are saved in the obsutil log file for problem analysis and location.</li><li id="obs_11_0035__li18891356408">Ensure that the user who runs the command has the read and write permissions on the path.</li></ul> <div class="note" id="obs_11_0035__note853813419401"><span class="notetitle"> NOTE: </span><div class="notebody"><ul id="obs_11_0035__ul19891125164011"><li id="obs_11_0035__li189165164015">If this parameter is left blank, no obsutil log is generated.</li><li id="obs_11_0035__li14891858403">The path must be a file path and cannot be a folder path.</li><li id="obs_11_0035__li1189113516408">After obsutil logging is enabled, all logs generated during command execution are saved to the obsutil log file for problem analysis and troubleshooting.</li><li id="obs_11_0035__li18891356408">Ensure that the user who runs the command has the read and write permissions on the path.</li></ul>
</div></div> </div></div>
<div class="notice" id="obs_11_0035__note2669149184013"><span class="noticetitle"> NOTICE: </span><div class="noticebody"><p id="obs_11_0035__p146691794409">If multiple obsutil processes are running at the same time, log files may fail to be written concurrently. In this case, add parameter <strong id="obs_11_0035__b88101327217">-config</strong> when running commands to configure an independent configuration file for each process.</p> <div class="notice" id="obs_11_0035__note2669149184013"><span class="noticetitle"> NOTICE: </span><div class="noticebody"><p id="obs_11_0035__p146691794409">If multiple obsutil processes are running at the same time, log files may fail to be written concurrently. In this case, add parameter <strong id="obs_11_0035__b88101327217">-config</strong> when running commands to configure an independent configuration file for each process.</p>
</div></div> </div></div>
@ -370,6 +370,8 @@ faultTolerantMode=&lt;value&gt;</pre>
<td class="cellrowborder" valign="top" width="8.28082808280828%" headers="mcps1.3.5.2.5.1.2 "><p id="obs_11_0035__p1549141116442">Optional</p> <td class="cellrowborder" valign="top" width="8.28082808280828%" headers="mcps1.3.5.2.5.1.2 "><p id="obs_11_0035__p1549141116442">Optional</p>
</td> </td>
<td class="cellrowborder" valign="top" width="41.47414741474147%" headers="mcps1.3.5.2.5.1.3 "><p id="obs_11_0035__p8465154124517">Maximum number of result files of successful or failed batch tasks that can be retained. The default value is <strong id="obs_11_0035__b17807175974414">1024</strong>.</p> <td class="cellrowborder" valign="top" width="41.47414741474147%" headers="mcps1.3.5.2.5.1.3 "><p id="obs_11_0035__p8465154124517">Maximum number of result files of successful or failed batch tasks that can be retained. The default value is <strong id="obs_11_0035__b17807175974414">1024</strong>.</p>
<div class="caution" id="obs_11_0035__note173331316736"><span class="cautiontitle"> CAUTION: </span><div class="cautionbody"><p id="obs_11_0035__p123331316739">This parameter applies only to a single command. When <em id="obs_11_0035__i17635164205515">N</em> tasks are run, the current directory will contain up to <em id="obs_11_0035__i235612825518">N</em> × 1024 result files by default.</p>
</div></div>
</td> </td>
<td class="cellrowborder" valign="top" width="25.27252725272527%" headers="mcps1.3.5.2.5.1.4 "><p id="obs_11_0035__p182945034313">N/A</p> <td class="cellrowborder" valign="top" width="25.27252725272527%" headers="mcps1.3.5.2.5.1.4 "><p id="obs_11_0035__p182945034313">N/A</p>
</td> </td>
@ -406,7 +408,7 @@ faultTolerantMode=&lt;value&gt;</pre>
<td class="cellrowborder" valign="top" width="8.28082808280828%" headers="mcps1.3.5.2.5.1.2 "><p id="obs_11_0035__p55168208221">Optional</p> <td class="cellrowborder" valign="top" width="8.28082808280828%" headers="mcps1.3.5.2.5.1.2 "><p id="obs_11_0035__p55168208221">Optional</p>
</td> </td>
<td class="cellrowborder" valign="top" width="41.47414741474147%" headers="mcps1.3.5.2.5.1.3 "><p id="obs_11_0035__p85161420112219">Language of the help documents. Options are as follows:</p> <td class="cellrowborder" valign="top" width="41.47414741474147%" headers="mcps1.3.5.2.5.1.3 "><p id="obs_11_0035__p85161420112219">Language of the help documents. Options are as follows:</p>
<ul id="obs_11_0035__ul105883424222"><li id="obs_11_0035__li135881042132211">Chinese</li><li id="obs_11_0035__li18684447182220">English</li></ul> <ul id="obs_11_0035__ul105883424222"><li id="obs_11_0035__li15749195112201">English</li><li id="obs_11_0035__li135881042132211">Chinese</li></ul>
<p id="obs_11_0035__p44701718758">The default value is <strong id="obs_11_0035__b194381111583">English</strong>.</p> <p id="obs_11_0035__p44701718758">The default value is <strong id="obs_11_0035__b194381111583">English</strong>.</p>
</td> </td>
<td class="cellrowborder" valign="top" width="25.27252725272527%" headers="mcps1.3.5.2.5.1.4 "><p id="obs_11_0035__p36381835122210">N/A</p> <td class="cellrowborder" valign="top" width="25.27252725272527%" headers="mcps1.3.5.2.5.1.4 "><p id="obs_11_0035__p36381835122210">N/A</p>

22
docs/obs/tool-obsutil/obs_11_0036.html
View File

@ -3,11 +3,11 @@
<h1 class="topictitle1">Resuming a Failed Upload Task</h1> <h1 class="topictitle1">Resuming a Failed Upload Task</h1>
<div id="body1545008187874"><div class="section" id="obs_11_0036__section1479112110815"><h4 class="sectiontitle">Function</h4><p id="obs_11_0036__p11772825481">You can use this command to resume a failed upload task based on the task ID.</p> <div id="body1545008187874"><div class="section" id="obs_11_0036__section1479112110815"><h4 class="sectiontitle">Function</h4><p id="obs_11_0036__p11772825481">You can use this command to resume a failed upload task based on the task ID.</p>
</div> </div>
<div class="section" id="obs_11_0036__section1220752192216"><h4 class="sectiontitle">Command Line Structure</h4><ul id="obs_11_0036__ul2098662312412"><li id="obs_11_0036__li198632362414">In Windows<pre class="screen" id="obs_11_0036__screen13477182952517">obsutil cp -recover=xxx [-arcDir=xxx] [-dryRun] [-f] [-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] [-clear] [-config=xxx] </pre> <div class="section" id="obs_11_0036__section1220752192216"><h4 class="sectiontitle">Command Line Structure</h4><ul id="obs_11_0036__ul2098662312412"><li id="obs_11_0036__li198632362414">Windows<pre class="screen" id="obs_11_0036__screen13477182952517">obsutil cp -recover=xxx [-arcDir=xxx] [-dryRun] [-f] [-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] [-clear] [-config=xxx] </pre>
</li><li id="obs_11_0036__li7461142911245">In Linux or macOS<pre class="screen" id="obs_11_0036__screen13485493273">./obsutil cp -recover=xxx [-arcDir=xxx] [-dryRun] [-f] [-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] [-clear] [-config=xxx] </pre> </li><li id="obs_11_0036__li7461142911245">macOS or Linux<pre class="screen" id="obs_11_0036__screen13485493273">./obsutil cp -recover=xxx [-arcDir=xxx] [-dryRun] [-f] [-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] [-clear] [-config=xxx] </pre>
</li></ul> </li></ul>
</div> </div>
<div class="section" id="obs_11_0036__section030102484018"><h4 class="sectiontitle">Examples</h4><ul id="obs_11_0036__ul830102410405"><li id="obs_11_0036__li4309246406">Take the Windows OS as an example. Run the <strong id="obs_11_0036__b153291461773">obsutil cp -recover 104786c8-27c2-48fc-bc6a-5886596fb0ed -f</strong> command to resume the failed upload task.<pre class="screen" id="obs_11_0036__screen430102484013"><strong id="obs_11_0036__b1830112420401">obsutil cp <strong id="obs_11_0036__b1830182414400">-recover 104786c8-27c2-48fc-bc6a-5886596fb0ed</strong> -f</strong> <div class="section" id="obs_11_0036__section030102484018"><h4 class="sectiontitle">Examples</h4><ul id="obs_11_0036__ul830102410405"><li id="obs_11_0036__li4309246406">In Windows, run <strong id="obs_11_0036__b153291461773">obsutil cp -recover 104786c8-27c2-48fc-bc6a-5886596fb0ed -f</strong> to resume a failed upload.<pre class="screen" id="obs_11_0036__screen430102484013"><strong id="obs_11_0036__b1830112420401">obsutil cp <strong id="obs_11_0036__b1830182414400">-recover 104786c8-27c2-48fc-bc6a-5886596fb0ed</strong> -f</strong>
Start at 2024-10-08 01:10:07.3809685 +0000 UTC Start at 2024-10-08 01:10:07.3809685 +0000 UTC
Parallel: 5 Jobs: 5 Parallel: 5 Jobs: 5
@ -41,7 +41,7 @@ Task id: a628d6da-c562-4a1f-b687-4fa125de0dc3</pre>
<td class="cellrowborder" valign="top" width="26.262626262626267%" headers="mcps1.3.4.2.1.4.1.2 "><p id="obs_11_0036__p198304351672">Mandatory (additional parameter)</p> <td class="cellrowborder" valign="top" width="26.262626262626267%" headers="mcps1.3.4.2.1.4.1.2 "><p id="obs_11_0036__p198304351672">Mandatory (additional parameter)</p>
</td> </td>
<td class="cellrowborder" valign="top" width="58.58585858585859%" headers="mcps1.3.4.2.1.4.1.3 "><p id="obs_11_0036__p188308358715">The ID of the upload task to be resumed</p> <td class="cellrowborder" valign="top" width="58.58585858585859%" headers="mcps1.3.4.2.1.4.1.3 "><p id="obs_11_0036__p188308358715">The ID of the upload task to be resumed</p>
<div class="note" id="obs_11_0036__note10332165610814"><span class="notetitle"> NOTE: </span><div class="notebody"><ul id="obs_11_0036__ul625425894"><li id="obs_11_0036__li132547517913">You can obtain the task ID after an upload task is complete, or query it based on the file name of the <a href="obs_11_0057.html">result list</a>. A task ID is the 36 characters, excluding the suffix <strong id="obs_11_0036__b18232828387">.txt</strong>.</li><li id="obs_11_0036__li141241341171212">You can locate the upload task to be resumed in the folder where the result files reside. For details about the path of the result folder, see additional parameter <strong id="obs_11_0036__b1845116713389">o</strong>.</li></ul> <div class="note" id="obs_11_0036__note10332165610814"><span class="notetitle"> NOTE: </span><div class="notebody"><ul id="obs_11_0036__ul625425894"><li id="obs_11_0036__li132547517913">You can obtain the task ID after an upload task is complete. You can also retrieve it from the <a href="obs_11_0057.html">result list</a> file name, where the task ID is the last 36 characters after the <strong id="obs_11_0036__b18232828387">.txt</strong> suffix is removed.</li><li id="obs_11_0036__li141241341171212">You can locate the upload task to be resumed in the folder where the result files reside. For details about the path of the result folder, see additional parameter <strong id="obs_11_0036__b1845116713389">o</strong>.</li></ul>
</div></div> </div></div>
</td> </td>
</tr> </tr>
@ -104,7 +104,7 @@ Task id: a628d6da-c562-4a1f-b687-4fa125de0dc3</pre>
</td> </td>
<td class="cellrowborder" valign="top" width="26.262626262626267%" headers="mcps1.3.4.2.1.4.1.2 "><p id="obs_11_0036__p82428286353">Optional (additional parameter)</p> <td class="cellrowborder" valign="top" width="26.262626262626267%" headers="mcps1.3.4.2.1.4.1.2 "><p id="obs_11_0036__p82428286353">Optional (additional parameter)</p>
</td> </td>
<td class="cellrowborder" valign="top" width="58.58585858585859%" headers="mcps1.3.4.2.1.4.1.3 "><p id="obs_11_0036__p16811512123619">The access control policies that can be specified when uploading files. Possible values are:</p> <td class="cellrowborder" valign="top" width="58.58585858585859%" headers="mcps1.3.4.2.1.4.1.3 "><p id="obs_11_0036__p16811512123619">The access control policies that can be specified when uploading files. The value can be:</p>
<ul id="obs_11_0036__ul1273864144412"><li id="obs_11_0036__li17738649445">private</li><li id="obs_11_0036__li1551213137447">public-read</li><li id="obs_11_0036__li1287691813449">public-read-write</li></ul> <ul id="obs_11_0036__ul1273864144412"><li id="obs_11_0036__li17738649445">private</li><li id="obs_11_0036__li1551213137447">public-read</li><li id="obs_11_0036__li1287691813449">public-read-write</li></ul>
<div class="note" id="obs_11_0036__note1790113183525"><span class="notetitle"> NOTE: </span><div class="notebody"><p id="obs_11_0036__p92982882916">The preceding three values indicate private read and write, public read, and public read and write.</p> <div class="note" id="obs_11_0036__note1790113183525"><span class="notetitle"> NOTE: </span><div class="notebody"><p id="obs_11_0036__p92982882916">The preceding three values indicate private read and write, public read, and public read and write.</p>
</div></div> </div></div>
@ -114,7 +114,7 @@ Task id: a628d6da-c562-4a1f-b687-4fa125de0dc3</pre>
</td> </td>
<td class="cellrowborder" valign="top" width="26.262626262626267%" headers="mcps1.3.4.2.1.4.1.2 "><p id="obs_11_0036__p4533191944218">Optional (additional parameter)</p> <td class="cellrowborder" valign="top" width="26.262626262626267%" headers="mcps1.3.4.2.1.4.1.2 "><p id="obs_11_0036__p4533191944218">Optional (additional parameter)</p>
</td> </td>
<td class="cellrowborder" valign="top" width="58.58585858585859%" headers="mcps1.3.4.2.1.4.1.3 "><p id="obs_11_0036__p86547153813">The storage classes of objects that can be specified when uploading files. Possible values are:</p> <td class="cellrowborder" valign="top" width="58.58585858585859%" headers="mcps1.3.4.2.1.4.1.3 "><p id="obs_11_0036__p86547153813">The storage classes of objects that can be specified when uploading files. The value can be:</p>
<ul id="obs_11_0036__ul175651814214"><li id="obs_11_0036__li1256512172114"><strong id="obs_11_0036__b11328362115">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_0036__li10565181142113"><strong id="obs_11_0036__b162491125163619">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_0036__li756616110216"><strong id="obs_11_0036__b740613216360">cold</strong>: Cold storage class. It provides secure, durable, and inexpensive storage for rarely-accessed (once a year) data.</li></ul> <ul id="obs_11_0036__ul175651814214"><li id="obs_11_0036__li1256512172114"><strong id="obs_11_0036__b11328362115">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_0036__li10565181142113"><strong id="obs_11_0036__b162491125163619">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_0036__li756616110216"><strong id="obs_11_0036__b740613216360">cold</strong>: Cold storage class. It provides secure, durable, and inexpensive storage for rarely-accessed (once a year) data.</li></ul>
</td> </td>
</tr> </tr>
@ -122,7 +122,7 @@ Task id: a628d6da-c562-4a1f-b687-4fa125de0dc3</pre>
</td> </td>
<td class="cellrowborder" valign="top" width="26.262626262626267%" headers="mcps1.3.4.2.1.4.1.2 "><p id="obs_11_0036__p3476173116357">Optional (additional parameter)</p> <td class="cellrowborder" valign="top" width="26.262626262626267%" headers="mcps1.3.4.2.1.4.1.2 "><p id="obs_11_0036__p3476173116357">Optional (additional parameter)</p>
</td> </td>
<td class="cellrowborder" valign="top" width="58.58585858585859%" headers="mcps1.3.4.2.1.4.1.3 "><p id="obs_11_0036__p1447673143520">The customized metadata that can be specified when uploading files. The format is <strong id="obs_11_0036__b5986113545112">key1:value1#key2:value2#key3:value3</strong>.</p> <td class="cellrowborder" valign="top" width="58.58585858585859%" headers="mcps1.3.4.2.1.4.1.3 "><p id="obs_11_0036__p1447673143520">The custom metadata that can be specified during file upload. The format is <strong id="obs_11_0036__b5986113545112">key1:value1#key2:value2#key3:value3</strong>.</p>
<div class="note" id="obs_11_0036__note2863162085514"><span class="notetitle"> NOTE: </span><div class="notebody"><p id="obs_11_0036__p686342013559">The preceding value indicates that the object in the bucket contains three groups of customized metadata after the file is uploaded: <strong id="obs_11_0036__b89423875116">key1:value1</strong>, <strong id="obs_11_0036__b5950387516">key2:value2</strong>, and <strong id="obs_11_0036__b179773875113">key3:value3</strong>.</p> <div class="note" id="obs_11_0036__note2863162085514"><span class="notetitle"> NOTE: </span><div class="notebody"><p id="obs_11_0036__p686342013559">The preceding value indicates that the object in the bucket contains three groups of customized metadata after the file is uploaded: <strong id="obs_11_0036__b89423875116">key1:value1</strong>, <strong id="obs_11_0036__b5950387516">key2:value2</strong>, and <strong id="obs_11_0036__b179773875113">key3:value3</strong>.</p>
</div></div> </div></div>
</td> </td>
@ -157,7 +157,7 @@ Task id: a628d6da-c562-4a1f-b687-4fa125de0dc3</pre>
<td class="cellrowborder" valign="top" width="26.262626262626267%" headers="mcps1.3.4.2.1.4.1.2 "><p id="obs_11_0036__p5361592215">Optional (additional parameter)</p> <td class="cellrowborder" valign="top" width="26.262626262626267%" headers="mcps1.3.4.2.1.4.1.2 "><p id="obs_11_0036__p5361592215">Optional (additional parameter)</p>
</td> </td>
<td class="cellrowborder" valign="top" width="58.58585858585859%" headers="mcps1.3.4.2.1.4.1.3 "><p id="obs_11_0036__p112661531143816">The maximum number of concurrent tasks for uploading a folder. The default value is the value of <strong id="obs_11_0036__b1837402371316">defaultJobs</strong> in the configuration file.</p> <td class="cellrowborder" valign="top" width="58.58585858585859%" headers="mcps1.3.4.2.1.4.1.3 "><p id="obs_11_0036__p112661531143816">The maximum number of concurrent tasks for uploading a folder. The default value is the value of <strong id="obs_11_0036__b1837402371316">defaultJobs</strong> in the configuration file.</p>
<div class="note" id="obs_11_0036__note891964620819"><span class="notetitle"> NOTE: </span><div class="notebody"><p id="obs_11_0036__p1091964618820">The value is ensured to be greater than or equal to 1.</p> <div class="note" id="obs_11_0036__note891964620819"><span class="notetitle"> NOTE: </span><div class="notebody"><p id="obs_11_0036__p1091964618820">The tool ensures that this value is at least 1.</p>
</div></div> </div></div>
</td> </td>
</tr> </tr>
@ -177,7 +177,7 @@ Task id: a628d6da-c562-4a1f-b687-4fa125de0dc3</pre>
<td class="cellrowborder" valign="top" width="26.262626262626267%" headers="mcps1.3.4.2.1.4.1.2 "><p id="obs_11_0036__p24515919220">Optional (additional parameter)</p> <td class="cellrowborder" valign="top" width="26.262626262626267%" headers="mcps1.3.4.2.1.4.1.2 "><p id="obs_11_0036__p24515919220">Optional (additional parameter)</p>
</td> </td>
<td class="cellrowborder" valign="top" width="58.58585858585859%" headers="mcps1.3.4.2.1.4.1.3 "><p id="obs_11_0036__p85831634179">The file matching patterns that are included, for example: <strong id="obs_11_0036__b735755210289">*.jpg</strong></p> <td class="cellrowborder" valign="top" width="58.58585858585859%" headers="mcps1.3.4.2.1.4.1.3 "><p id="obs_11_0036__p85831634179">The file matching patterns that are included, for example: <strong id="obs_11_0036__b735755210289">*.jpg</strong></p>
<div class="note" id="obs_11_0036__note6126191912710"><span class="notetitle"> NOTE: </span><div class="notebody"><ul id="obs_11_0036__ul144557173539"><li id="obs_11_0036__li104555174537">The asterisk (*) represents any group of characters, and the question mark (?) represents any single character.</li><li id="obs_11_0036__li19723114811337">You can use <strong id="obs_11_0036__b27721812565">**</strong> to represent <strong id="obs_11_0036__b127759121062">*</strong> and <strong id="obs_11_0036__b12776111211610">\?</strong> to represent <strong id="obs_11_0036__b97786122613">?</strong>.</li><li id="obs_11_0036__li442714198534">Only after identifying that the name of the file to be uploaded does not match the value of <strong id="obs_11_0036__b22581581369">exclude</strong>, the system checks whether the file name matches the value of this parameter. If yes, the file is uploaded. If not, the file is skipped.</li></ul> <div class="note" id="obs_11_0036__note6126191912710"><span class="notetitle"> NOTE: </span><div class="notebody"><ul id="obs_11_0036__ul144557173539"><li id="obs_11_0036__li104555174537">The asterisk (*) represents any group of characters, and the question mark (?) represents any single character.</li><li id="obs_11_0036__li19723114811337">You can use <strong id="obs_11_0036__b27721812565">**</strong> to represent <strong id="obs_11_0036__b127759121062">*</strong> and <strong id="obs_11_0036__b12776111211610">\?</strong> to represent <strong id="obs_11_0036__b97786122613">?</strong>.</li><li id="obs_11_0036__li442714198534">The <strong id="obs_11_0036__b1346102791317">exclude</strong> rule is applied first. If the name of the file to be uploaded does not match the <strong id="obs_11_0036__b046202781320">exclude</strong> rule, the system then checks whether the file name matches this parameter. If it does, the file is uploaded. If it does not, the file is skipped.</li></ul>
</div></div> </div></div>
<div class="notice" id="obs_11_0036__note7627205718163"><span class="noticetitle"> NOTICE: </span><div class="noticebody"><ul id="obs_11_0036__ul17172248195614"><li id="obs_11_0036__li4172114815566">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_0036__li572621113716">The matching pattern applies to the absolute file path (including the file name and file directory).</li><li id="obs_11_0036__li519218125713">The matching pattern applies only to files in a folder.</li><li id="obs_11_0036__li13384102123417">Multiple <strong id="obs_11_0036__b2068392211555">include</strong> parameters can be specified, for example, <strong id="obs_11_0036__b968392265516">-include=*.xxx -include=*.xxx</strong>.</li></ul> <div class="notice" id="obs_11_0036__note7627205718163"><span class="noticetitle"> NOTICE: </span><div class="noticebody"><ul id="obs_11_0036__ul17172248195614"><li id="obs_11_0036__li4172114815566">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_0036__li572621113716">The matching pattern applies to the absolute file path (including the file name and file directory).</li><li id="obs_11_0036__li519218125713">The matching pattern applies only to files in a folder.</li><li id="obs_11_0036__li13384102123417">Multiple <strong id="obs_11_0036__b2068392211555">include</strong> parameters can be specified, for example, <strong id="obs_11_0036__b968392265516">-include=*.xxx -include=*.xxx</strong>.</li></ul>
</div></div> </div></div>
@ -198,7 +198,7 @@ Task id: a628d6da-c562-4a1f-b687-4fa125de0dc3</pre>
</td> </td>
<td class="cellrowborder" valign="top" width="58.58585858585859%" headers="mcps1.3.4.2.1.4.1.3 "><p id="obs_11_0036__p16963940134813">The time range matching pattern when uploading files. Only files whose latest modification time is within the configured time range are uploaded.</p> <td class="cellrowborder" valign="top" width="58.58585858585859%" headers="mcps1.3.4.2.1.4.1.3 "><p id="obs_11_0036__p16963940134813">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_0036__p1879635019517">This pattern has a lower priority than the file matching patterns (<strong id="obs_11_0036__b37597075317">exclude</strong>/<strong id="obs_11_0036__b12760501539">include</strong>). That is, the time range matching pattern is executed after the configured file matching patterns.</p> <p id="obs_11_0036__p1879635019517">This pattern has a lower priority than the file matching patterns (<strong id="obs_11_0036__b37597075317">exclude</strong>/<strong id="obs_11_0036__b12760501539">include</strong>). That is, the time range matching pattern is executed after the configured file matching patterns.</p>
<div class="note" id="obs_11_0036__note8766915165919"><span class="notetitle"> NOTE: </span><div class="notebody"><ul id="obs_11_0036__ul19272430145915"><li id="obs_11_0036__li12731730115918">The matching time range is represented in <em id="obs_11_0036__i1525423112818">time1</em><strong id="obs_11_0036__b6526323172819">-</strong><em id="obs_11_0036__i3526192318288">time2</em>, where <em id="obs_11_0036__i1852711231288">time1</em> must be earlier than or the same as <em id="obs_11_0036__i1952818234281">time2</em>. The time format is <em id="obs_11_0036__i1752982319285">yyyyMMddHHmmss</em>.</li><li id="obs_11_0036__li32731530185916">Automatic formatting is supported. For example, yyyyMMdd is equivalent to yyyyMMdd000000, and yyyyMM is equivalent to yyyyMM01000000.</li><li id="obs_11_0036__li5185481610">If this parameter is set to <strong id="obs_11_0036__b114382718287">*-</strong><em id="obs_11_0036__i17443271283">time2</em>, all files whose latest modification time is earlier than <em id="obs_11_0036__i245727192819">time2</em> are matched. If it is set to <em id="obs_11_0036__i7467273285">time1</em><strong id="obs_11_0036__b346427132815">-*</strong>, all files whose latest modification time is later than <em id="obs_11_0036__i10472279282">time1</em> are matched.</li></ul> <div class="note" id="obs_11_0036__note8766915165919"><span class="notetitle"> NOTE: </span><div class="notebody"><ul id="obs_11_0036__ul19272430145915"><li id="obs_11_0036__li12731730115918">The matching time range is represented in <em id="obs_11_0036__i1525423112818">time1</em><strong id="obs_11_0036__b6526323172819">-</strong><em id="obs_11_0036__i3526192318288">time2</em>, where <em id="obs_11_0036__i1852711231288">time1</em> must be earlier than or the same as <em id="obs_11_0036__i1952818234281">time2</em>. The time format is <em id="obs_11_0036__i1752982319285">yyyyMMddHHmmss</em>.</li><li id="obs_11_0036__li32731530185916">Automatic formatting is supported. For example, yyyyMMdd is equivalent to yyyyMMdd000000, and yyyyMM is equivalent to yyyyMM01000000.</li><li id="obs_11_0036__li5185481610">If this parameter is set to <strong id="obs_11_0036__b234216229558">*-</strong><em id="obs_11_0036__i1434202245517">time2</em>, all files whose last modification time is earlier than <em id="obs_11_0036__i18342822155514">time2</em> are matched. If it is set to <em id="obs_11_0036__i7342022125519">time1</em><strong id="obs_11_0036__b1934252275518">-*</strong>, all files whose last modification time is later than <em id="obs_11_0036__i1034282210559">time1</em> are matched.</li></ul>
</div></div> </div></div>
<div class="notice" id="obs_11_0036__note1078981817591"><span class="noticetitle"> NOTICE: </span><div class="noticebody"><p id="obs_11_0036__p95781751171216">Time in the matching pattern is the UTC time.</p> <div class="notice" id="obs_11_0036__note1078981817591"><span class="noticetitle"> NOTICE: </span><div class="noticebody"><p id="obs_11_0036__p95781751171216">Time in the matching pattern is the UTC time.</p>
</div></div> </div></div>
@ -241,6 +241,8 @@ Task id: a628d6da-c562-4a1f-b687-4fa125de0dc3</pre>
<td class="cellrowborder" valign="top" width="26.262626262626267%" headers="mcps1.3.4.2.1.4.1.2 "><p id="obs_11_0036__p1266611611820">Optional (additional parameter)</p> <td class="cellrowborder" valign="top" width="26.262626262626267%" headers="mcps1.3.4.2.1.4.1.2 "><p id="obs_11_0036__p1266611611820">Optional (additional parameter)</p>
</td> </td>
<td class="cellrowborder" valign="top" width="58.58585858585859%" headers="mcps1.3.4.2.1.4.1.3 "><p id="obs_11_0036__p1166617619181">Specifies that requester pays is enabled.</p> <td class="cellrowborder" valign="top" width="58.58585858585859%" headers="mcps1.3.4.2.1.4.1.3 "><p id="obs_11_0036__p1166617619181">Specifies that requester pays is enabled.</p>
<p id="obs_11_0036__p13214143095512"><strong id="obs_11_0036__b116303714634556">Range</strong>:</p>
<p id="obs_11_0036__p13744112545515">requester</p>
</td> </td>
</tr> </tr>
</tbody> </tbody>

27
docs/obs/tool-obsutil/obs_11_0037.html
View File

@ -3,12 +3,13 @@
<h1 class="topictitle1">Resuming a Failed Copy Task</h1> <h1 class="topictitle1">Resuming a Failed Copy Task</h1>
<div id="body1545008187874"><div class="section" id="obs_11_0037__section1479112110815"><h4 class="sectiontitle">Function</h4><p id="obs_11_0037__p11772825481">You can use this command to resume a failed copy task based on the task ID.</p> <div id="body1545008187874"><div class="section" id="obs_11_0037__section1479112110815"><h4 class="sectiontitle">Function</h4><p id="obs_11_0037__p11772825481">You can use this command to resume a failed copy task based on the task ID.</p>
</div> </div>
<div class="section" id="obs_11_0037__section49408320267"><h4 class="sectiontitle">Command Line Structure</h4><ul id="obs_11_0037__ul9634193211493"><li id="obs_11_0037__li1763473234917">In Windows<pre class="screen" id="obs_11_0037__screen15740822175019">obsutil cp -recover=xxx [-dryRun] [-f] [-u] [-crr] [-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] [-clear] [-config=xxx] </pre> <div class="section" id="obs_11_0037__section49408320267"><h4 class="sectiontitle">Command Line Structure</h4><ul id="obs_11_0037__ul9634193211493"><li id="obs_11_0037__li1763473234917">Windows<pre class="screen" id="obs_11_0037__screen15740822175019">obsutil cp -recover=xxx [-dryRun] [-f] [-u] [-crr] [-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] [-clear] [-config=xxx] </pre>
</li><li id="obs_11_0037__li245683714917">In Linux or macOS<pre class="screen" id="obs_11_0037__screen161391565118">./obsutil cp -recover=xxx [-dryRun] [-f] [-u] [-crr] [-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] [-clear] [-config=xxx] </pre> </li><li id="obs_11_0037__li245683714917">macOS or Linux<pre class="screen" id="obs_11_0037__screen161391565118">./obsutil cp -recover=xxx [-dryRun] [-f] [-u] [-crr] [-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] [-clear] [-config=xxx] </pre>
</li></ul> </li></ul>
</div> </div>
<div class="section" id="obs_11_0037__section12454443104015"><h4 class="sectiontitle">Examples</h4><ul id="obs_11_0037__ul34541143114013"><li id="obs_11_0037__li44541643104010">Take the Windows OS as an example. Run the <strong id="obs_11_0037__b350045510522">obsutil cp -recover=0476929d-9d23-4dc5-b2f8-0a0493f027c5 -f</strong> command to copy objects in batches.<pre class="screen" id="obs_11_0037__screen12454843154017"><strong id="obs_11_0037__b1245414364014">obsutil cp <strong id="obs_11_0037__b16454194310404">-recover=0476929d-9d23-4dc5-b2f8-0a0493f027c5</strong> -f</strong></pre> <div class="section" id="obs_11_0037__section12454443104015"><h4 class="sectiontitle">Examples</h4><ul id="obs_11_0037__ul34541143114013"><li id="obs_11_0037__li44541643104010">In Windows, run <strong id="obs_11_0037__b350045510522">obsutil cp -recover=0476929d-9d23-4dc5-b2f8-0a0493f027c5 -f</strong> to resume a failed copy task.<pre class="screen" id="obs_11_0037__screen12934257181311">obsutil cp -recover=0476929d-9d23-4dc5-b2f8-0a0493f027c5 -f
<pre class="screen" id="obs_11_0037__screen12934257181311">Start at 2024-10-08 01:10:07.3809685 +0000 UTC
Start at 2024-10-08 01:10:07.3809685 +0000 UTC
Parallel: 5 Jobs: 5 Parallel: 5 Jobs: 5
Threshold: 50.00MB PartSize: auto Threshold: 50.00MB PartSize: auto
@ -41,7 +42,7 @@ Task id: a628d6da-c562-4a1f-b687-4fa125de0dc3</pre>
<td class="cellrowborder" valign="top" width="27%" headers="mcps1.3.4.2.1.4.1.2 "><p id="obs_11_0037__p198304351672">Mandatory (additional parameter)</p> <td class="cellrowborder" valign="top" width="27%" headers="mcps1.3.4.2.1.4.1.2 "><p id="obs_11_0037__p198304351672">Mandatory (additional parameter)</p>
</td> </td>
<td class="cellrowborder" valign="top" width="55.00000000000001%" headers="mcps1.3.4.2.1.4.1.3 "><p id="obs_11_0037__p188308358715">The ID of the copy task to be resumed</p> <td class="cellrowborder" valign="top" width="55.00000000000001%" headers="mcps1.3.4.2.1.4.1.3 "><p id="obs_11_0037__p188308358715">The ID of the copy task to be resumed</p>
<div class="note" id="obs_11_0037__note10332165610814"><span class="notetitle"> NOTE: </span><div class="notebody"><ul id="obs_11_0037__ul625425894"><li id="obs_11_0037__li132547517913">You can obtain the task ID after a copy task is complete, or query it based on the file name of the <a href="obs_11_0057.html">result list</a>. A task ID is the 36 characters, excluding the suffix <strong id="obs_11_0037__b1450191515251">.txt</strong>.</li><li id="obs_11_0037__li141241341171212">You can locate the copy task to be resumed in the folder where the result files reside. For details about the path of the result folder, see additional parameter <strong id="obs_11_0037__b1613810603917">o</strong>.</li></ul> <div class="note" id="obs_11_0037__note10332165610814"><span class="notetitle"> NOTE: </span><div class="notebody"><ul id="obs_11_0037__ul625425894"><li id="obs_11_0037__li132547517913">You can obtain the task ID after a copy task is complete. You can also retrieve it from the <a href="obs_11_0057.html">result list</a> file name, where the task ID is the last 36 characters after the <strong id="obs_11_0037__b1450191515251">.txt</strong> suffix is removed.</li><li id="obs_11_0037__li141241341171212">You can locate the copy task to be resumed in the folder where the result files reside. For details about the path of the result folder, see additional parameter <strong id="obs_11_0037__b1613810603917">o</strong>.</li></ul>
</div></div> </div></div>
</td> </td>
</tr> </tr>
@ -111,7 +112,7 @@ Task id: a628d6da-c562-4a1f-b687-4fa125de0dc3</pre>
</td> </td>
<td class="cellrowborder" valign="top" width="27%" headers="mcps1.3.4.2.1.4.1.2 "><p id="obs_11_0037__p17648193011318">Optional (additional parameter)</p> <td class="cellrowborder" valign="top" width="27%" headers="mcps1.3.4.2.1.4.1.2 "><p id="obs_11_0037__p17648193011318">Optional (additional parameter)</p>
</td> </td>
<td class="cellrowborder" valign="top" width="55.00000000000001%" headers="mcps1.3.4.2.1.4.1.3 "><p id="obs_11_0037__p16650163083117">The access control policies for destination objects that can be specified when copying objects. Possible values are:</p> <td class="cellrowborder" valign="top" width="55.00000000000001%" headers="mcps1.3.4.2.1.4.1.3 "><p id="obs_11_0037__p16650163083117">The access control policies for destination objects that can be specified when copying objects. The value can be:</p>
<ul id="obs_11_0037__ul0651183053115"><li id="obs_11_0037__li13652230153113">private</li><li id="obs_11_0037__li1965516308318">public-read</li><li id="obs_11_0037__li1265633023119">public-read-write</li></ul> <ul id="obs_11_0037__ul0651183053115"><li id="obs_11_0037__li13652230153113">private</li><li id="obs_11_0037__li1965516308318">public-read</li><li id="obs_11_0037__li1265633023119">public-read-write</li></ul>
<div class="note" id="obs_11_0037__note1790113183525"><span class="notetitle"> NOTE: </span><div class="notebody"><p id="obs_11_0037__p92982882916">The preceding three values indicate private read and write, public read, and public read and write.</p> <div class="note" id="obs_11_0037__note1790113183525"><span class="notetitle"> NOTE: </span><div class="notebody"><p id="obs_11_0037__p92982882916">The preceding three values indicate private read and write, public read, and public read and write.</p>
</div></div> </div></div>
@ -121,7 +122,7 @@ Task id: a628d6da-c562-4a1f-b687-4fa125de0dc3</pre>
</td> </td>
<td class="cellrowborder" valign="top" width="27%" headers="mcps1.3.4.2.1.4.1.2 "><p id="obs_11_0037__p134681525175117">Optional (additional parameter)</p> <td class="cellrowborder" valign="top" width="27%" headers="mcps1.3.4.2.1.4.1.2 "><p id="obs_11_0037__p134681525175117">Optional (additional parameter)</p>
</td> </td>
<td class="cellrowborder" valign="top" width="55.00000000000001%" headers="mcps1.3.4.2.1.4.1.3 "><p id="obs_11_0037__p04731025135114">The storage classes of the destination objects that can be specified when copying objects. Possible values are:</p> <td class="cellrowborder" valign="top" width="55.00000000000001%" headers="mcps1.3.4.2.1.4.1.3 "><p id="obs_11_0037__p04731025135114">The storage classes of the destination objects that can be specified when copying objects. The value can be:</p>
<ul id="obs_11_0037__ul175651814214"><li id="obs_11_0037__li1256512172114"><strong id="obs_11_0037__b26136149110">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_0037__li10565181142113"><strong id="obs_11_0037__b3763837133614">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_0037__li756616110216"><strong id="obs_11_0037__b18769174010360">cold</strong>: Cold storage class. It provides secure, durable, and inexpensive storage for rarely-accessed (once a year) data.</li></ul> <ul id="obs_11_0037__ul175651814214"><li id="obs_11_0037__li1256512172114"><strong id="obs_11_0037__b26136149110">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_0037__li10565181142113"><strong id="obs_11_0037__b3763837133614">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_0037__li756616110216"><strong id="obs_11_0037__b18769174010360">cold</strong>: Cold storage class. It provides secure, durable, and inexpensive storage for rarely-accessed (once a year) data.</li></ul>
</td> </td>
</tr> </tr>
@ -164,7 +165,7 @@ Task id: a628d6da-c562-4a1f-b687-4fa125de0dc3</pre>
<td class="cellrowborder" valign="top" width="27%" headers="mcps1.3.4.2.1.4.1.2 "><p id="obs_11_0037__p177527681919">Optional (additional parameter)</p> <td class="cellrowborder" valign="top" width="27%" headers="mcps1.3.4.2.1.4.1.2 "><p id="obs_11_0037__p177527681919">Optional (additional parameter)</p>
</td> </td>
<td class="cellrowborder" valign="top" width="55.00000000000001%" headers="mcps1.3.4.2.1.4.1.3 "><p id="obs_11_0037__p4699130153112">The maximum number of concurrent tasks for copying objects in batches. The default value is the value of <strong id="obs_11_0037__b9810812011">defaultJobs</strong> in the configuration file.</p> <td class="cellrowborder" valign="top" width="55.00000000000001%" headers="mcps1.3.4.2.1.4.1.3 "><p id="obs_11_0037__p4699130153112">The maximum number of concurrent tasks for copying objects in batches. The default value is the value of <strong id="obs_11_0037__b9810812011">defaultJobs</strong> in the configuration file.</p>
<div class="note" id="obs_11_0037__note891964620819"><span class="notetitle"> NOTE: </span><div class="notebody"><p id="obs_11_0037__p1091964618820">The value is ensured to be greater than or equal to 1.</p> <div class="note" id="obs_11_0037__note891964620819"><span class="notetitle"> NOTE: </span><div class="notebody"><p id="obs_11_0037__p1091964618820">The tool ensures that this value is at least 1.</p>
</div></div> </div></div>
</td> </td>
</tr> </tr>
@ -175,7 +176,7 @@ Task id: a628d6da-c562-4a1f-b687-4fa125de0dc3</pre>
<td class="cellrowborder" valign="top" width="55.00000000000001%" headers="mcps1.3.4.2.1.4.1.3 "><p id="obs_11_0037__p16666614131519">The matching patterns of source objects that are excluded, for example: <strong id="obs_11_0037__b8379101514451">*.txt</strong></p> <td class="cellrowborder" valign="top" width="55.00000000000001%" headers="mcps1.3.4.2.1.4.1.3 "><p id="obs_11_0037__p16666614131519">The matching patterns of source objects that are excluded, for example: <strong id="obs_11_0037__b8379101514451">*.txt</strong></p>
<div class="note" id="obs_11_0037__note145284716208"><span class="notetitle"> NOTE: </span><div class="notebody"><ul id="obs_11_0037__ul05604713204"><li id="obs_11_0037__li14580477208">The asterisk (*) represents any group of characters, and the question mark (?) represents any single character. For instance, <strong id="obs_11_0037__b2768131118911">abc*.txt</strong> indicates any file whose name starts with <strong id="obs_11_0037__b167705116919">abc</strong> and ends with <strong id="obs_11_0037__b277213112098">.txt</strong>.</li><li id="obs_11_0037__li16256511183416">You can use <strong id="obs_11_0037__b1319617136917">\*</strong> to represent <strong id="obs_11_0037__b1419715131995">*</strong> and <strong id="obs_11_0037__b31983131795">\?</strong> to represent <strong id="obs_11_0037__b12001513198">?</strong>.</li><li id="obs_11_0037__li20603473203">If the name of the object to be copied matches the value of this parameter, the object is skipped.</li></ul> <div class="note" id="obs_11_0037__note145284716208"><span class="notetitle"> NOTE: </span><div class="notebody"><ul id="obs_11_0037__ul05604713204"><li id="obs_11_0037__li14580477208">The asterisk (*) represents any group of characters, and the question mark (?) represents any single character. For instance, <strong id="obs_11_0037__b2768131118911">abc*.txt</strong> indicates any file whose name starts with <strong id="obs_11_0037__b167705116919">abc</strong> and ends with <strong id="obs_11_0037__b277213112098">.txt</strong>.</li><li id="obs_11_0037__li16256511183416">You can use <strong id="obs_11_0037__b1319617136917">\*</strong> to represent <strong id="obs_11_0037__b1419715131995">*</strong> and <strong id="obs_11_0037__b31983131795">\?</strong> to represent <strong id="obs_11_0037__b12001513198">?</strong>.</li><li id="obs_11_0037__li20603473203">If the name of the object to be copied matches the value of this parameter, the object is skipped.</li></ul>
</div></div> </div></div>
<div class="notice" id="obs_11_0037__note179117549207"><span class="noticetitle"> NOTICE: </span><div class="noticebody"><ul id="obs_11_0037__ul877892116516"><li id="obs_11_0037__li1517310321518">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_0037__li1324471816918">The matching pattern applies to the absolute path of an object, including the object name prefix and object name starting from the root directory. For example, if the path of an object in the bucket is <strong id="obs_11_0037__b114981623151511">obs://bucket/src1/src2/test.txt</strong>, then the absolute path of the object is <strong id="obs_11_0037__b1449912316155">src1/src2/test.txt</strong>.</li><li id="obs_11_0037__li1148165015513">This matching pattern applies only to objects whose names do not end with a slash (/).</li><li id="obs_11_0037__li919415167349">Multiple <strong id="obs_11_0037__b750818375912">exclude</strong> parameters can be specified, for example, <strong id="obs_11_0037__b150953105919">-exclude=*.xxx -exclude=*.xxx</strong>.</li></ul> <div class="notice" id="obs_11_0037__note179117549207"><span class="noticetitle"> NOTICE: </span><div class="noticebody"><ul id="obs_11_0037__ul877892116516"><li id="obs_11_0037__li1517310321518">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_0037__li1324471816918">The matching pattern applies to the object's absolute path, which includes the object name prefix and the object name starting from the root directory. For example, if an object's path in the bucket is <strong id="obs_11_0037__b177405214216">obs://bucket/src1/src2/test.txt</strong>, its absolute path is <strong id="obs_11_0037__b97401025210">src1/src2/test.txt</strong>.</li><li id="obs_11_0037__li1148165015513">This matching pattern applies only to objects whose names do not end with a slash (/).</li><li id="obs_11_0037__li919415167349">Multiple <strong id="obs_11_0037__b750818375912">exclude</strong> parameters can be specified, for example, <strong id="obs_11_0037__b150953105919">-exclude=*.xxx -exclude=*.xxx</strong>.</li></ul>
</div></div> </div></div>
</td> </td>
</tr> </tr>
@ -184,9 +185,9 @@ Task id: a628d6da-c562-4a1f-b687-4fa125de0dc3</pre>
<td class="cellrowborder" valign="top" width="27%" headers="mcps1.3.4.2.1.4.1.2 "><p id="obs_11_0037__p1275712617196">Optional (additional parameter)</p> <td class="cellrowborder" valign="top" width="27%" headers="mcps1.3.4.2.1.4.1.2 "><p id="obs_11_0037__p1275712617196">Optional (additional parameter)</p>
</td> </td>
<td class="cellrowborder" valign="top" width="55.00000000000001%" headers="mcps1.3.4.2.1.4.1.3 "><p id="obs_11_0037__p37071730153119">The matching patterns of source objects that are included, for example: <strong id="obs_11_0037__b164112244516">*.jpg</strong></p> <td class="cellrowborder" valign="top" width="55.00000000000001%" headers="mcps1.3.4.2.1.4.1.3 "><p id="obs_11_0037__p37071730153119">The matching patterns of source objects that are included, for example: <strong id="obs_11_0037__b164112244516">*.jpg</strong></p>
<div class="note" id="obs_11_0037__note195168716220"><span class="notetitle"> NOTE: </span><div class="notebody"><ul id="obs_11_0037__ul752013715229"><li id="obs_11_0037__li135211772221">The asterisk (*) represents any group of characters, and the question mark (?) represents any single character.</li><li id="obs_11_0037__li58571912163416">You can use <strong id="obs_11_0037__b675322113915">\*</strong> to represent <strong id="obs_11_0037__b117544215918">*</strong> and <strong id="obs_11_0037__b187551211199">\?</strong> to represent <strong id="obs_11_0037__b075672112917">?</strong>.</li><li id="obs_11_0037__li16523871227">Only after identifying that the name of the file to be copied does not match the value of <strong id="obs_11_0037__b135951230920">exclude</strong>, the system checks whether the file name matches the value of this parameter. If yes, the file is copied. If not, the file is skipped.</li></ul> <div class="note" id="obs_11_0037__note195168716220"><span class="notetitle"> NOTE: </span><div class="notebody"><ul id="obs_11_0037__ul752013715229"><li id="obs_11_0037__li135211772221">The asterisk (*) represents any group of characters, and the question mark (?) represents any single character.</li><li id="obs_11_0037__li58571912163416">You can use <strong id="obs_11_0037__b675322113915">\*</strong> to represent <strong id="obs_11_0037__b117544215918">*</strong> and <strong id="obs_11_0037__b187551211199">\?</strong> to represent <strong id="obs_11_0037__b075672112917">?</strong>.</li><li id="obs_11_0037__li16523871227">The <strong id="obs_11_0037__b13363657201319">exclude</strong> rule is applied first. If the name of the object to be copied does not match the <strong id="obs_11_0037__b136313577137">exclude</strong> rule, the system then checks whether the object name matches this parameter. If it does, the object is copied. If it does not, the object is skipped.</li></ul>
</div></div> </div></div>
<div class="notice" id="obs_11_0037__note9270217202212"><span class="noticetitle"> NOTICE: </span><div class="noticebody"><ul id="obs_11_0037__ul1514124145810"><li id="obs_11_0037__li214164165818">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_0037__li12963162113914">The matching pattern applies to the absolute path of an object, including the object name prefix and object name starting from the root directory. For example, if the path of an object in the bucket is <strong id="obs_11_0037__b1674042471518">obs://bucket/src1/src2/test.txt</strong>, then the absolute path of the object is <strong id="obs_11_0037__b12741112415152">src1/src2/test.txt</strong>.</li><li id="obs_11_0037__li337842215911">This matching pattern applies only to objects whose names do not end with a slash (/).</li><li id="obs_11_0037__li05841924133417">Multiple <strong id="obs_11_0037__b1959454185913">include</strong> parameters can be specified, for example, <strong id="obs_11_0037__b1859513425915">-include=*.xxx -include=*.xxx</strong>.</li></ul> <div class="notice" id="obs_11_0037__note9270217202212"><span class="noticetitle"> NOTICE: </span><div class="noticebody"><ul id="obs_11_0037__ul1514124145810"><li id="obs_11_0037__li214164165818">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_0037__li12963162113914">The matching pattern applies to the object's absolute path, which includes the object name prefix and the object name starting from the root directory. For example, if an object's path in the bucket is <strong id="obs_11_0037__b173541671827">obs://bucket/src1/src2/test.txt</strong>, its absolute path is <strong id="obs_11_0037__b1735415712211">src1/src2/test.txt</strong>.</li><li id="obs_11_0037__li337842215911">This matching pattern applies only to objects whose names do not end with a slash (/).</li><li id="obs_11_0037__li05841924133417">Multiple <strong id="obs_11_0037__b1959454185913">include</strong> parameters can be specified, for example, <strong id="obs_11_0037__b1859513425915">-include=*.xxx -include=*.xxx</strong>.</li></ul>
</div></div> </div></div>
</td> </td>
</tr> </tr>
@ -196,7 +197,7 @@ Task id: a628d6da-c562-4a1f-b687-4fa125de0dc3</pre>
</td> </td>
<td class="cellrowborder" valign="top" width="55.00000000000001%" headers="mcps1.3.4.2.1.4.1.3 "><p id="obs_11_0037__p16963940134813">The time range matching pattern when copying objects. Only objects whose latest modification time is within the configured time range are copied.</p> <td class="cellrowborder" valign="top" width="55.00000000000001%" headers="mcps1.3.4.2.1.4.1.3 "><p id="obs_11_0037__p16963940134813">The time range matching pattern when copying objects. Only objects whose latest modification time is within the configured time range are copied.</p>
<p id="obs_11_0037__p169680339524">This pattern has a lower priority than the object matching patterns (<strong id="obs_11_0037__b14528969560">exclude</strong>/<strong id="obs_11_0037__b6529116105611">include</strong>). That is, the time range matching pattern is executed after the configured object matching patterns.</p> <p id="obs_11_0037__p169680339524">This pattern has a lower priority than the object matching patterns (<strong id="obs_11_0037__b14528969560">exclude</strong>/<strong id="obs_11_0037__b6529116105611">include</strong>). That is, the time range matching pattern is executed after the configured object matching patterns.</p>
<div class="note" id="obs_11_0037__note8766915165919"><span class="notetitle"> NOTE: </span><div class="notebody"><ul id="obs_11_0037__ul19272430145915"><li id="obs_11_0037__li12731730115918">The matching time range is represented in <em id="obs_11_0037__i12207102781515">time1</em><strong id="obs_11_0037__b12208162761517">-</strong><em id="obs_11_0037__i152091827111518">time2</em>, where <em id="obs_11_0037__i11209827131514">time1</em> must be earlier than or the same as <em id="obs_11_0037__i321015277151">time2</em>. The time format is <em id="obs_11_0037__i1821017278155">yyyyMMddHHmmss</em>.</li><li id="obs_11_0037__li32731530185916">Automatic formatting is supported. For example, yyyyMMdd is equivalent to yyyyMMdd000000, and yyyyMM is equivalent to yyyyMM01000000.</li><li id="obs_11_0037__li5185481610">If this parameter is set to <strong id="obs_11_0037__b092117442158">*-</strong><em id="obs_11_0037__i9922644161514">time2</em>, all files whose latest modification time is earlier than <em id="obs_11_0037__i6922644151517">time2</em> are matched. If it is set to <em id="obs_11_0037__i1992354401516">time1</em><strong id="obs_11_0037__b1392364471518">-*</strong>, all files whose latest modification time is later than <em id="obs_11_0037__i69244440157">time1</em> are matched.</li></ul> <div class="note" id="obs_11_0037__note8766915165919"><span class="notetitle"> NOTE: </span><div class="notebody"><ul id="obs_11_0037__ul19272430145915"><li id="obs_11_0037__li12731730115918">The matching time range is represented in <em id="obs_11_0037__i12207102781515">time1</em><strong id="obs_11_0037__b12208162761517">-</strong><em id="obs_11_0037__i152091827111518">time2</em>, where <em id="obs_11_0037__i11209827131514">time1</em> must be earlier than or the same as <em id="obs_11_0037__i321015277151">time2</em>. The time format is <em id="obs_11_0037__i1821017278155">yyyyMMddHHmmss</em>.</li><li id="obs_11_0037__li32731530185916">Automatic formatting is supported. For example, yyyyMMdd is equivalent to yyyyMMdd000000, and yyyyMM is equivalent to yyyyMM01000000.</li><li id="obs_11_0037__li5185481610">If this parameter is set to <strong id="obs_11_0037__b168001331125519">*-</strong><em id="obs_11_0037__i168001731105519">time2</em>, all files whose last modification time is earlier than <em id="obs_11_0037__i168007318557">time2</em> are matched. If it is set to <em id="obs_11_0037__i2800193119557">time1</em><strong id="obs_11_0037__b17800103115555">-*</strong>, all files whose last modification time is later than <em id="obs_11_0037__i580073175512">time1</em> are matched.</li></ul>
</div></div> </div></div>
<div class="notice" id="obs_11_0037__note1078981817591"><span class="noticetitle"> NOTICE: </span><div class="noticebody"><ul id="obs_11_0037__ul881073612597"><li id="obs_11_0037__li1740024105917">Time in the matching pattern is the UTC time.</li><li id="obs_11_0037__li58105368598">This matching pattern applies only to objects whose names do not end with a slash (/).</li></ul> <div class="notice" id="obs_11_0037__note1078981817591"><span class="noticetitle"> NOTICE: </span><div class="noticebody"><ul id="obs_11_0037__ul881073612597"><li id="obs_11_0037__li1740024105917">Time in the matching pattern is the UTC time.</li><li id="obs_11_0037__li58105368598">This matching pattern applies only to objects whose names do not end with a slash (/).</li></ul>
</div></div> </div></div>
@ -239,6 +240,8 @@ Task id: a628d6da-c562-4a1f-b687-4fa125de0dc3</pre>
<td class="cellrowborder" valign="top" width="27%" headers="mcps1.3.4.2.1.4.1.2 "><p id="obs_11_0037__p1266611611820">Optional (additional parameter)</p> <td class="cellrowborder" valign="top" width="27%" headers="mcps1.3.4.2.1.4.1.2 "><p id="obs_11_0037__p1266611611820">Optional (additional parameter)</p>
</td> </td>
<td class="cellrowborder" valign="top" width="55.00000000000001%" headers="mcps1.3.4.2.1.4.1.3 "><p id="obs_11_0037__p1166617619181">Specifies that requester pays is enabled.</p> <td class="cellrowborder" valign="top" width="55.00000000000001%" headers="mcps1.3.4.2.1.4.1.3 "><p id="obs_11_0037__p1166617619181">Specifies that requester pays is enabled.</p>
<p id="obs_11_0037__p13214143095512"><strong id="obs_11_0037__b154057343334558">Range</strong>:</p>
<p id="obs_11_0037__p13744112545515">requester</p>
</td> </td>
</tr> </tr>
</tbody> </tbody>

22
docs/obs/tool-obsutil/obs_11_0038.html
View File

@ -3,11 +3,11 @@
<h1 class="topictitle1">Resuming a Failed Download Task</h1> <h1 class="topictitle1">Resuming a Failed Download Task</h1>
<div id="body1545008187874"><div class="section" id="obs_11_0038__section1479112110815"><h4 class="sectiontitle">Function</h4><p id="obs_11_0038__p11772825481">You can use this command to resume a failed download task based on the task ID.</p> <div id="body1545008187874"><div class="section" id="obs_11_0038__section1479112110815"><h4 class="sectiontitle">Function</h4><p id="obs_11_0038__p11772825481">You can use this command to resume a failed download task based on the task ID.</p>
</div> </div>
<div class="section" id="obs_11_0038__section19587175622519"><h4 class="sectiontitle">Command Line Structure</h4><ul id="obs_11_0038__ul4348115485212"><li id="obs_11_0038__li034819548529">In Windows<pre class="screen" id="obs_11_0038__screen15467124815533">obsutil cp -recover=xxx [-dryRun] [-tempFileDir=xxx] [-f] [-u] [-vlength] [-vmd5] [-j=1] [-p=1] [-threshold=52428800] [-ps=auto] [-include=*.xxx] [-exclude=*.xxx] [-timeRange=time1-time2] [-mf] [-o=xxx] [-cpd=xxx] [-clear] [-config=xxx] </pre> <div class="section" id="obs_11_0038__section19587175622519"><h4 class="sectiontitle">Command Line Structure</h4><ul id="obs_11_0038__ul4348115485212"><li id="obs_11_0038__li034819548529">Windows<pre class="screen" id="obs_11_0038__screen15467124815533">obsutil cp -recover=xxx [-dryRun] [-tempFileDir=xxx] [-f] [-u] [-vlength] [-vmd5] [-j=1] [-p=1] [-threshold=52428800] [-ps=auto] [-include=*.xxx] [-exclude=*.xxx] [-timeRange=time1-time2] [-mf] [-o=xxx] [-cpd=xxx] [-clear] [-config=xxx] </pre>
</li><li id="obs_11_0038__li4476145885216">In Linux or macOS<pre class="screen" id="obs_11_0038__screen2398117135418">./obsutil cp -recover=xxx [-dryRun] [-tempFileDir=xxx] [-f] [-u] [-vlength] [-vmd5] [-j=1] [-p=1] [-threshold=52428800] [-ps=auto] [-include=*.xxx] [-exclude=*.xxx] [-timeRange=time1-time2] [-mf] [-o=xxx] [-cpd=xxx] [-clear] [-config=xxx] </pre> </li><li id="obs_11_0038__li4476145885216">macOS or Linux<pre class="screen" id="obs_11_0038__screen2398117135418">./obsutil cp -recover=xxx [-dryRun] [-tempFileDir=xxx] [-f] [-u] [-vlength] [-vmd5] [-j=1] [-p=1] [-threshold=52428800] [-ps=auto] [-include=*.xxx] [-exclude=*.xxx] [-timeRange=time1-time2] [-mf] [-o=xxx] [-cpd=xxx] [-clear] [-config=xxx] </pre>
</li></ul> </li></ul>
</div> </div>
<div class="section" id="obs_11_0038__section577711134114"><h4 class="sectiontitle">Examples</h4><ul id="obs_11_0038__ul1077811116415"><li id="obs_11_0038__li167781417413">Take the Windows OS as an example. Run the <strong id="obs_11_0038__b1837091253712">obsutil cp -recover=3066a4b0-4d21-4929-bb84-4829c32cbd0f d:\ -f -r</strong> command to download objects in batches.<pre class="screen" id="obs_11_0038__screen19778141134113"><strong id="obs_11_0038__b1777801124112">obsutil cp -recover=3066a4b0-4d21-4929-bb84-4829c32cbd0f -f -r</strong> <div class="section" id="obs_11_0038__section577711134114"><h4 class="sectiontitle">Examples</h4><ul id="obs_11_0038__ul1077811116415"><li id="obs_11_0038__li167781417413">In Windows, run <strong id="obs_11_0038__b1837091253712">obsutil cp -recover=3066a4b0-4d21-4929-bb84-4829c32cbd0f d:\ -f -r</strong> to resume a failed download task.<pre class="screen" id="obs_11_0038__screen19778141134113"><strong id="obs_11_0038__b1777801124112">obsutil cp -recover=3066a4b0-4d21-4929-bb84-4829c32cbd0f -f -r</strong>
Start at 2024-10-08 01:10:07.3809685 +0000 UTC Start at 2024-10-08 01:10:07.3809685 +0000 UTC
Parallel: 5 Jobs: 5 Parallel: 5 Jobs: 5
@ -41,7 +41,7 @@ Task id: a628d6da-c562-4a1f-b687-4fa125de0dc3</pre>
<td class="cellrowborder" valign="top" width="27%" headers="mcps1.3.4.2.1.4.1.2 "><p id="obs_11_0038__p198304351672">Mandatory (additional parameter)</p> <td class="cellrowborder" valign="top" width="27%" headers="mcps1.3.4.2.1.4.1.2 "><p id="obs_11_0038__p198304351672">Mandatory (additional parameter)</p>
</td> </td>
<td class="cellrowborder" valign="top" width="55.00000000000001%" headers="mcps1.3.4.2.1.4.1.3 "><p id="obs_11_0038__p188308358715">The ID of the download task to be resumed</p> <td class="cellrowborder" valign="top" width="55.00000000000001%" headers="mcps1.3.4.2.1.4.1.3 "><p id="obs_11_0038__p188308358715">The ID of the download task to be resumed</p>
<div class="note" id="obs_11_0038__note10332165610814"><span class="notetitle"> NOTE: </span><div class="notebody"><ul id="obs_11_0038__ul625425894"><li id="obs_11_0038__li132547517913">You can obtain the task ID after a download task is complete, or query it based on the file name of the <a href="obs_11_0057.html">result list</a>. A task ID is the 36 characters, excluding the suffix <strong id="obs_11_0038__b11100256172511">.txt</strong>.</li><li id="obs_11_0038__li141241341171212">You can locate the download task to be resumed in the folder where the result files reside. For details about the path of the result folder, see additional parameter <strong id="obs_11_0038__b1213073355816">o</strong>.</li></ul> <div class="note" id="obs_11_0038__note10332165610814"><span class="notetitle"> NOTE: </span><div class="notebody"><ul id="obs_11_0038__ul625425894"><li id="obs_11_0038__li132547517913">You can obtain the task ID after a download task is complete. You can also retrieve it from the <a href="obs_11_0057.html">result list</a> file name, where the task ID is the last 36 characters after the <strong id="obs_11_0038__b11100256172511">.txt</strong> suffix is removed.</li><li id="obs_11_0038__li141241341171212">You can locate the download task to be resumed in the folder where the result files reside. For details about the path of the result folder, see additional parameter <strong id="obs_11_0038__b1213073355816">o</strong>.</li></ul>
</div></div> </div></div>
</td> </td>
</tr> </tr>
@ -65,7 +65,7 @@ Task id: a628d6da-c562-4a1f-b687-4fa125de0dc3</pre>
</td> </td>
<td class="cellrowborder" valign="top" width="27%" headers="mcps1.3.4.2.1.4.1.2 "><p id="obs_11_0038__p10601174595317">Optional (additional parameter)</p> <td class="cellrowborder" valign="top" width="27%" headers="mcps1.3.4.2.1.4.1.2 "><p id="obs_11_0038__p10601174595317">Optional (additional parameter)</p>
</td> </td>
<td class="cellrowborder" valign="top" width="55.00000000000001%" headers="mcps1.3.4.2.1.4.1.3 "><p id="obs_11_0038__p1260204518534">Indicates incremental download. If this parameter is set, each object can be downloaded only when it does not exist in the local path, its size is different from the namesake one in the local path, or it has the latest modification time.</p> <td class="cellrowborder" valign="top" width="55.00000000000001%" headers="mcps1.3.4.2.1.4.1.3 "><p id="obs_11_0038__p1260204518534">Indicates incremental download. When this parameter is set, each object is compared with the file at the corresponding local path. An object is downloaded only when the file does not exist, the file size differs from the object size, or the file was last modified earlier than the object.</p>
</td> </td>
</tr> </tr>
<tr id="obs_11_0038__row9603194595311"><td class="cellrowborder" valign="top" width="18%" headers="mcps1.3.4.2.1.4.1.1 "><p id="obs_11_0038__p1605745105311">vlength</p> <tr id="obs_11_0038__row9603194595311"><td class="cellrowborder" valign="top" width="18%" headers="mcps1.3.4.2.1.4.1.1 "><p id="obs_11_0038__p1605745105311">vlength</p>
@ -132,7 +132,7 @@ Task id: a628d6da-c562-4a1f-b687-4fa125de0dc3</pre>
<td class="cellrowborder" valign="top" width="27%" headers="mcps1.3.4.2.1.4.1.2 "><p id="obs_11_0038__p4719102092513">Optional (additional parameter)</p> <td class="cellrowborder" valign="top" width="27%" headers="mcps1.3.4.2.1.4.1.2 "><p id="obs_11_0038__p4719102092513">Optional (additional parameter)</p>
</td> </td>
<td class="cellrowborder" valign="top" width="55.00000000000001%" headers="mcps1.3.4.2.1.4.1.3 "><p id="obs_11_0038__p17665114555311">The maximum number of concurrent tasks for downloading objects in a batch. The default value is the value of <strong id="obs_11_0038__b862721920247">defaultJobs</strong> in the configuration file.</p> <td class="cellrowborder" valign="top" width="55.00000000000001%" headers="mcps1.3.4.2.1.4.1.3 "><p id="obs_11_0038__p17665114555311">The maximum number of concurrent tasks for downloading objects in a batch. The default value is the value of <strong id="obs_11_0038__b862721920247">defaultJobs</strong> in the configuration file.</p>
<div class="note" id="obs_11_0038__note891964620819"><span class="notetitle"> NOTE: </span><div class="notebody"><p id="obs_11_0038__p1091964618820">The value is ensured to be greater than or equal to 1.</p> <div class="note" id="obs_11_0038__note891964620819"><span class="notetitle"> NOTE: </span><div class="notebody"><p id="obs_11_0038__p1091964618820">The tool ensures that this value is at least 1.</p>
</div></div> </div></div>
</td> </td>
</tr> </tr>
@ -143,7 +143,7 @@ Task id: a628d6da-c562-4a1f-b687-4fa125de0dc3</pre>
<td class="cellrowborder" valign="top" width="55.00000000000001%" headers="mcps1.3.4.2.1.4.1.3 "><p id="obs_11_0038__p16666614131519">The matching patterns of source objects that are excluded, for example: <strong id="obs_11_0038__b514617286497">*.txt</strong></p> <td class="cellrowborder" valign="top" width="55.00000000000001%" headers="mcps1.3.4.2.1.4.1.3 "><p id="obs_11_0038__p16666614131519">The matching patterns of source objects that are excluded, for example: <strong id="obs_11_0038__b514617286497">*.txt</strong></p>
<div class="note" id="obs_11_0038__note145284716208"><span class="notetitle"> NOTE: </span><div class="notebody"><ul id="obs_11_0038__ul05604713204"><li id="obs_11_0038__li14580477208">The asterisk (*) represents any group of characters, and the question mark (?) represents any single character. For instance, <strong id="obs_11_0038__b17220124561010">abc*.txt</strong> indicates any file whose name starts with <strong id="obs_11_0038__b1922154518107">abc</strong> and ends with <strong id="obs_11_0038__b1122313450103">.txt</strong>.</li><li id="obs_11_0038__li1128963020341">You can use <strong id="obs_11_0038__b1734764681019">\*</strong> to represent <strong id="obs_11_0038__b834814619103">*</strong> and <strong id="obs_11_0038__b19349646101016">\?</strong> to represent <strong id="obs_11_0038__b83501467102">?</strong>.</li><li id="obs_11_0038__li20603473203">If the name of the object to be downloaded matches the value of this parameter, the object is skipped.</li></ul> <div class="note" id="obs_11_0038__note145284716208"><span class="notetitle"> NOTE: </span><div class="notebody"><ul id="obs_11_0038__ul05604713204"><li id="obs_11_0038__li14580477208">The asterisk (*) represents any group of characters, and the question mark (?) represents any single character. For instance, <strong id="obs_11_0038__b17220124561010">abc*.txt</strong> indicates any file whose name starts with <strong id="obs_11_0038__b1922154518107">abc</strong> and ends with <strong id="obs_11_0038__b1122313450103">.txt</strong>.</li><li id="obs_11_0038__li1128963020341">You can use <strong id="obs_11_0038__b1734764681019">\*</strong> to represent <strong id="obs_11_0038__b834814619103">*</strong> and <strong id="obs_11_0038__b19349646101016">\?</strong> to represent <strong id="obs_11_0038__b83501467102">?</strong>.</li><li id="obs_11_0038__li20603473203">If the name of the object to be downloaded matches the value of this parameter, the object is skipped.</li></ul>
</div></div> </div></div>
<div class="notice" id="obs_11_0038__note179117549207"><span class="noticetitle"> NOTICE: </span><div class="noticebody"><ul id="obs_11_0038__ul877892116516"><li id="obs_11_0038__li1517310321518">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_0038__li1790011591794">The matching pattern applies to the absolute path of an object, including the object name prefix and object name starting from the root directory. For example, if the path of an object in the bucket is <strong id="obs_11_0038__b36591141163013">obs://bucket/src1/src2/test.txt</strong>, then the absolute path of the object is <strong id="obs_11_0038__b66591141183017">src1/src2/test.txt</strong>.</li><li id="obs_11_0038__li1148165015513">This matching pattern applies only to objects whose names do not end with a slash (/).</li><li id="obs_11_0038__li14625193483418">Multiple <strong id="obs_11_0038__b127761529185913">exclude</strong> parameters can be specified, for example, <strong id="obs_11_0038__b77813296599">-exclude=*.xxx -exclude=*.xxx</strong>.</li></ul> <div class="notice" id="obs_11_0038__note179117549207"><span class="noticetitle"> NOTICE: </span><div class="noticebody"><ul id="obs_11_0038__ul877892116516"><li id="obs_11_0038__li1517310321518">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_0038__li1790011591794">The matching pattern applies to the object's absolute path, which includes the object name prefix and the object name starting from the root directory. For example, if an object's path in the bucket is <strong id="obs_11_0038__b925517223216">obs://bucket/src1/src2/test.txt</strong>, its absolute path is <strong id="obs_11_0038__b72557221213">src1/src2/test.txt</strong>.</li><li id="obs_11_0038__li1148165015513">This matching pattern applies only to objects whose names do not end with a slash (/).</li><li id="obs_11_0038__li14625193483418">Multiple <strong id="obs_11_0038__b127761529185913">exclude</strong> parameters can be specified, for example, <strong id="obs_11_0038__b77813296599">-exclude=*.xxx -exclude=*.xxx</strong>.</li></ul>
</div></div> </div></div>
</td> </td>
</tr> </tr>
@ -152,9 +152,9 @@ Task id: a628d6da-c562-4a1f-b687-4fa125de0dc3</pre>
<td class="cellrowborder" valign="top" width="27%" headers="mcps1.3.4.2.1.4.1.2 "><p id="obs_11_0038__p127271520102517">Optional (additional parameter)</p> <td class="cellrowborder" valign="top" width="27%" headers="mcps1.3.4.2.1.4.1.2 "><p id="obs_11_0038__p127271520102517">Optional (additional parameter)</p>
</td> </td>
<td class="cellrowborder" valign="top" width="55.00000000000001%" headers="mcps1.3.4.2.1.4.1.3 "><p id="obs_11_0038__p37071730153119">The matching patterns of source objects that are included, for example: <strong id="obs_11_0038__b1775843510490">*.jpg</strong></p> <td class="cellrowborder" valign="top" width="55.00000000000001%" headers="mcps1.3.4.2.1.4.1.3 "><p id="obs_11_0038__p37071730153119">The matching patterns of source objects that are included, for example: <strong id="obs_11_0038__b1775843510490">*.jpg</strong></p>
<div class="note" id="obs_11_0038__note195168716220"><span class="notetitle"> NOTE: </span><div class="notebody"><ul id="obs_11_0038__ul752013715229"><li id="obs_11_0038__li135211772221">The asterisk (*) represents any group of characters, and the question mark (?) represents any single character.</li><li id="obs_11_0038__li1123713483418">You can use <strong id="obs_11_0038__b422113173113">\*</strong> to represent <strong id="obs_11_0038__b102221617101111">*</strong> and <strong id="obs_11_0038__b202231817151112">\?</strong> to represent <strong id="obs_11_0038__b11224117141111">?</strong>.</li><li id="obs_11_0038__li16523871227">Only after identifying that the name of the file to be downloaded does not match the value of <strong id="obs_11_0038__b1874141931111">exclude</strong>, the system checks whether the file name matches the value of this parameter. If yes, the file is downloaded. If not, the file is skipped.</li></ul> <div class="note" id="obs_11_0038__note195168716220"><span class="notetitle"> NOTE: </span><div class="notebody"><ul id="obs_11_0038__ul752013715229"><li id="obs_11_0038__li135211772221">The asterisk (*) represents any group of characters, and the question mark (?) represents any single character.</li><li id="obs_11_0038__li1123713483418">You can use <strong id="obs_11_0038__b422113173113">\*</strong> to represent <strong id="obs_11_0038__b102221617101111">*</strong> and <strong id="obs_11_0038__b202231817151112">\?</strong> to represent <strong id="obs_11_0038__b11224117141111">?</strong>.</li><li id="obs_11_0038__li16523871227">The <strong id="obs_11_0038__b38391746141">exclude</strong> rule is applied first. If the name of the object to be downloaded does not match the <strong id="obs_11_0038__b1783964181417">exclude</strong> rule, the system then checks whether the object name matches this parameter. If it does, the object is downloaded; if it does not, the object is skipped.</li></ul>
</div></div> </div></div>
<div class="notice" id="obs_11_0038__note9270217202212"><span class="noticetitle"> NOTICE: </span><div class="noticebody"><ul id="obs_11_0038__ul12136162112586"><li id="obs_11_0038__li1413716213586">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_0038__li6647193171013">The matching pattern applies to the absolute path of an object, including the object name prefix and object name starting from the root directory. For example, if the path of an object in the bucket is <strong id="obs_11_0038__b19602164573017">obs://bucket/src1/src2/test.txt</strong>, then the absolute path of the object is <strong id="obs_11_0038__b1060314520305">src1/src2/test.txt</strong>.</li><li id="obs_11_0038__li15234151014">This matching pattern applies only to objects whose names do not end with a slash (/).</li><li id="obs_11_0038__li193031540113413">Multiple <strong id="obs_11_0038__b1144183025920">include</strong> parameters can be specified, for example, <strong id="obs_11_0038__b1744253018591">-include=*.xxx -include=*.xxx</strong>.</li></ul> <div class="notice" id="obs_11_0038__note9270217202212"><span class="noticetitle"> NOTICE: </span><div class="noticebody"><ul id="obs_11_0038__ul12136162112586"><li id="obs_11_0038__li1413716213586">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_0038__li6647193171013">The matching pattern applies to the object's absolute path, which includes the object name prefix and the object name starting from the root directory. For example, if an object's path in the bucket is <strong id="obs_11_0038__b135079261927">obs://bucket/src1/src2/test.txt</strong>, its absolute path is <strong id="obs_11_0038__b7507172618218">src1/src2/test.txt</strong>.</li><li id="obs_11_0038__li15234151014">This matching pattern applies only to objects whose names do not end with a slash (/).</li><li id="obs_11_0038__li193031540113413">Multiple <strong id="obs_11_0038__b1144183025920">include</strong> parameters can be specified, for example, <strong id="obs_11_0038__b1744253018591">-include=*.xxx -include=*.xxx</strong>.</li></ul>
</div></div> </div></div>
</td> </td>
</tr> </tr>
@ -164,7 +164,7 @@ Task id: a628d6da-c562-4a1f-b687-4fa125de0dc3</pre>
</td> </td>
<td class="cellrowborder" valign="top" width="55.00000000000001%" headers="mcps1.3.4.2.1.4.1.3 "><p id="obs_11_0038__p16963940134813">The time range matching pattern when downloading objects. Only objects whose latest modification time is within the configured time range are downloaded.</p> <td class="cellrowborder" valign="top" width="55.00000000000001%" headers="mcps1.3.4.2.1.4.1.3 "><p id="obs_11_0038__p16963940134813">The time range matching pattern when downloading objects. Only objects whose latest modification time is within the configured time range are downloaded.</p>
<p id="obs_11_0038__p15975633125310">This pattern has a lower priority than the object matching patterns (<strong id="obs_11_0038__b8524185317313">exclude</strong>/<strong id="obs_11_0038__b85251153539">include</strong>). That is, the time range matching pattern is executed after the configured object matching patterns.</p> <p id="obs_11_0038__p15975633125310">This pattern has a lower priority than the object matching patterns (<strong id="obs_11_0038__b8524185317313">exclude</strong>/<strong id="obs_11_0038__b85251153539">include</strong>). That is, the time range matching pattern is executed after the configured object matching patterns.</p>
<div class="note" id="obs_11_0038__note8766915165919"><span class="notetitle"> NOTE: </span><div class="notebody"><ul id="obs_11_0038__ul19272430145915"><li id="obs_11_0038__li12731730115918">The matching time range is represented in <em id="obs_11_0038__i1297864783014">time1</em><strong id="obs_11_0038__b997934713304">-</strong><em id="obs_11_0038__i298074703013">time2</em>, where <em id="obs_11_0038__i109803471301">time1</em> must be earlier than or the same as <em id="obs_11_0038__i29811847203013">time2</em>. The time format is <em id="obs_11_0038__i3982547153012">yyyyMMddHHmmss</em>.</li><li id="obs_11_0038__li32731530185916">Automatic formatting is supported. For example, yyyyMMdd is equivalent to yyyyMMdd000000, and yyyyMM is equivalent to yyyyMM01000000.</li><li id="obs_11_0038__li5185481610">If this parameter is set to <strong id="obs_11_0038__b5889165023014">*-</strong><em id="obs_11_0038__i2890650113017">time2</em>, all files whose latest modification time is earlier than <em id="obs_11_0038__i68911450133018">time2</em> are matched. If it is set to <em id="obs_11_0038__i489205019306">time1</em><strong id="obs_11_0038__b1089215093014">-*</strong>, all files whose latest modification time is later than <em id="obs_11_0038__i98935500303">time1</em> are matched.</li></ul> <div class="note" id="obs_11_0038__note8766915165919"><span class="notetitle"> NOTE: </span><div class="notebody"><ul id="obs_11_0038__ul19272430145915"><li id="obs_11_0038__li12731730115918">The matching time range is represented in <em id="obs_11_0038__i1297864783014">time1</em><strong id="obs_11_0038__b997934713304">-</strong><em id="obs_11_0038__i298074703013">time2</em>, where <em id="obs_11_0038__i109803471301">time1</em> must be earlier than or the same as <em id="obs_11_0038__i29811847203013">time2</em>. The time format is <em id="obs_11_0038__i3982547153012">yyyyMMddHHmmss</em>.</li><li id="obs_11_0038__li32731530185916">Automatic formatting is supported. For example, yyyyMMdd is equivalent to yyyyMMdd000000, and yyyyMM is equivalent to yyyyMM01000000.</li><li id="obs_11_0038__li5185481610">If this parameter is set to <strong id="obs_11_0038__b82921340125517">*-</strong><em id="obs_11_0038__i8292540165510">time2</em>, all files whose last modification time is earlier than <em id="obs_11_0038__i12292114017552">time2</em> are matched. If it is set to <em id="obs_11_0038__i529224025514">time1</em><strong id="obs_11_0038__b229284025514">-*</strong>, all files whose last modification time is later than <em id="obs_11_0038__i92921540145516">time1</em> are matched.</li></ul>
</div></div> </div></div>
<div class="notice" id="obs_11_0038__note1078981817591"><span class="noticetitle"> NOTICE: </span><div class="noticebody"><ul id="obs_11_0038__ul881073612597"><li id="obs_11_0038__li1740024105917">Time in the matching pattern is the UTC time.</li><li id="obs_11_0038__li58105368598">This matching pattern applies only to objects whose names do not end with a slash (/).</li></ul> <div class="notice" id="obs_11_0038__note1078981817591"><span class="noticetitle"> NOTICE: </span><div class="noticebody"><ul id="obs_11_0038__ul881073612597"><li id="obs_11_0038__li1740024105917">Time in the matching pattern is the UTC time.</li><li id="obs_11_0038__li58105368598">This matching pattern applies only to objects whose names do not end with a slash (/).</li></ul>
</div></div> </div></div>
@ -207,6 +207,8 @@ Task id: a628d6da-c562-4a1f-b687-4fa125de0dc3</pre>
<td class="cellrowborder" valign="top" width="27%" headers="mcps1.3.4.2.1.4.1.2 "><p id="obs_11_0038__p1266611611820">Optional (additional parameter)</p> <td class="cellrowborder" valign="top" width="27%" headers="mcps1.3.4.2.1.4.1.2 "><p id="obs_11_0038__p1266611611820">Optional (additional parameter)</p>
</td> </td>
<td class="cellrowborder" valign="top" width="55.00000000000001%" headers="mcps1.3.4.2.1.4.1.3 "><p id="obs_11_0038__p1166617619181">Specifies that requester pays is enabled.</p> <td class="cellrowborder" valign="top" width="55.00000000000001%" headers="mcps1.3.4.2.1.4.1.3 "><p id="obs_11_0038__p1166617619181">Specifies that requester pays is enabled.</p>
<p id="obs_11_0038__p13214143095512"><strong id="obs_11_0038__b153786262434559">Range</strong>:</p>
<p id="obs_11_0038__p13744112545515">requester</p>
</td> </td>
</tr> </tr>
</tbody> </tbody>

18
docs/obs/tool-obsutil/obs_11_0039.html
View File

@ -2,22 +2,22 @@
<h1 class="topictitle1">Using obsutil to Replicate Data Across Regions on the Client Side</h1> <h1 class="topictitle1">Using obsutil to Replicate Data Across Regions on the Client Side</h1>
<div id="body1608118480698"><p id="obs_11_0039__p8060118">obsutil client supports cross-region replication. You can directly replicate data from a source bucket to the destination bucket through data streams. The source bucket and destination bucket can be any two OBS buckets. Objects can be replicated between buckets in different regions under the same account or across accounts. The following procedure describes how to replicate data between buckets across accounts and regions:</p> <div id="body1608118480698"><p id="obs_11_0039__p8060118">obsutil client supports cross-region replication. You can directly replicate data from a source bucket to the destination bucket through data streams. The source bucket and destination bucket can be any two OBS buckets. Objects can be replicated between buckets in different regions under the same account or across accounts. The following procedure describes how to replicate data between buckets across accounts and regions:</p>
<ol id="obs_11_0039__ol12439123364517"><li id="obs_11_0039__li12439193315455"><span>Run the <strong id="obs_11_0039__b9292171813165">obsutil config</strong> command to configure the AK, SK, and endpoint of the source bucket account.</span><p><ul id="obs_11_0039__ul1129174841612"><li id="obs_11_0039__li62911148141616">In Windows<pre class="screen" id="obs_11_0039__screen134141504119"><span>obsutil config -interactive -crr</span></pre> <ol id="obs_11_0039__ol12439123364517"><li id="obs_11_0039__li12439193315455"><span>Run the <strong id="obs_11_0039__b9292171813165">obsutil config</strong> command to configure the AK, SK, and endpoint of the source bucket account.</span><p><ul id="obs_11_0039__ul1129174841612"><li id="obs_11_0039__li62911148141616">Windows<pre class="screen" id="obs_11_0039__screen134141504119"><span>obsutil config -interactive -crr</span></pre>
</li><li id="obs_11_0039__li2065885410165">In Linux<pre class="screen" id="obs_11_0039__screen20510125011145"><span>./obsutil config -interactive -crr</span></pre> </li><li id="obs_11_0039__li2065885410165">Linux<pre class="screen" id="obs_11_0039__screen20510125011145"><span>./obsutil config -interactive -crr</span></pre>
</li></ul> </li></ul>
</p></li><li id="obs_11_0039__li4731615194713"><span>Run the <strong id="obs_11_0039__b11200822102516">obsutil config</strong> command to configure the AK, SK, and endpoint of the destination bucket account.</span><p><ul id="obs_11_0039__ul1054741111178"><li id="obs_11_0039__li754713115173">In Windows<pre class="screen" id="obs_11_0039__screen162586401510"><span>obsutil config -interactive</span></pre> </p></li><li id="obs_11_0039__li4731615194713"><span>Run the <strong id="obs_11_0039__b11200822102516">obsutil config</strong> command to configure the AK, SK, and endpoint of the destination bucket account.</span><p><ul id="obs_11_0039__ul1054741111178"><li id="obs_11_0039__li754713115173">Windows<pre class="screen" id="obs_11_0039__screen162586401510"><span>obsutil config -interactive</span></pre>
</li><li id="obs_11_0039__li16535141311171">In Linux<pre class="screen" id="obs_11_0039__screen1325894101510"><span>./obsutil config -interactive</span></pre> </li><li id="obs_11_0039__li16535141311171">Linux<pre class="screen" id="obs_11_0039__screen1325894101510"><span>./obsutil config -interactive</span></pre>
</li></ul> </li></ul>
</p></li><li id="obs_11_0039__li1934120192169"><span>Check the connectivity to ensure that the destination bucket is correctly configured.</span><p><ul id="obs_11_0039__ul173105390185"><li id="obs_11_0039__li173101239121813">In Windows<pre class="screen" id="obs_11_0039__screen18391205165">obsutil ls -s</pre> </p></li><li id="obs_11_0039__li1934120192169"><span>Check the connectivity to ensure that the destination bucket is correctly configured.</span><p><ul id="obs_11_0039__ul173105390185"><li id="obs_11_0039__li173101239121813">Windows<pre class="screen" id="obs_11_0039__screen18391205165">obsutil ls -s</pre>
</li><li id="obs_11_0039__li681934171911">In Linux or macOS<pre class="screen" id="obs_11_0039__screen54471715121916">./obsutil ls -s</pre> </li><li id="obs_11_0039__li681934171911">macOS or Linux<pre class="screen" id="obs_11_0039__screen54471715121916">./obsutil ls -s</pre>
</li></ul> </li></ul>
<p id="obs_11_0039__p1452915815368">Check the command output:</p> <p id="obs_11_0039__p1452915815368">Check the command output:</p>
<ul id="obs_11_0039__ul157631931518"><li id="obs_11_0039__li376181991519">If it contains "Bucket number", the configuration is correct.</li><li id="obs_11_0039__li10711119141614">If it contains "Http status [403]", the access keys are wrong.</li><li id="obs_11_0039__li19649103911919">If it contains "A connection attempt failed", OBS cannot be connected. Then, check the network condition.</li><li id="obs_11_0039__li13706544314">If it contains "Error: cloud_url [url] is not in well format", the domain name to be accessed is incorrect. Check the domain name in the configuration file.</li></ul> <ul id="obs_11_0039__ul157631931518"><li id="obs_11_0039__li376181991519">If it contains "Bucket number", the configuration is correct.</li><li id="obs_11_0039__li10711119141614">If it contains "Http status [403]", the access keys may be incorrect.</li><li id="obs_11_0039__li19649103911919">If it contains "A connection attempt failed", OBS cannot be connected. Then, check the network condition.</li><li id="obs_11_0039__li13706544314">If it contains "Error: cloud_url [url] is not in well format", the domain name to be accessed is incorrect. Check the domain name in the configuration file.</li></ul>
<div class="note" id="obs_11_0039__note139810916178"><img src="public_sys-resources/note_3.0-en-us.png"><span class="notetitle"> </span><div class="notebody"><p id="obs_11_0039__p143981096179">If the command output contains "Http status [403]", you may not have the required permissions for obtaining the bucket list. A further analysis is required to identify the root cause.</p> <div class="note" id="obs_11_0039__note139810916178"><img src="public_sys-resources/note_3.0-en-us.png"><span class="notetitle"> </span><div class="notebody"><p id="obs_11_0039__p143981096179">If the command output contains "Http status [403]", you may not have the required permissions for obtaining the bucket list. A further analysis is required to identify the root cause.</p>
</div></div> </div></div>
</p></li><li id="obs_11_0039__li20602103564710"><span>Run the <strong id="obs_11_0039__b24466339255">cp</strong> command to specify that cross-region replication method is used to copy objects from the source bucket to the destination bucket.</span><p><ul id="obs_11_0039__ul9749112711720"><li id="obs_11_0039__li1474902741715">In Windows<pre class="screen" id="obs_11_0039__screen5420916185119"><span>obsutil cp obs://src-bucket obs://dst-bucket -f -r -crr</span></pre> </p></li><li id="obs_11_0039__li20602103564710"><span>Run the <strong id="obs_11_0039__b24466339255">cp</strong> command to specify that cross-region replication method is used to copy objects from the source bucket to the destination bucket.</span><p><ul id="obs_11_0039__ul9749112711720"><li id="obs_11_0039__li1474902741715">Windows<pre class="screen" id="obs_11_0039__screen5420916185119"><span>obsutil cp obs://src-bucket obs://dst-bucket -f -r -crr</span></pre>
</li></ul> </li></ul>
<ul id="obs_11_0039__ul175021299179"><li id="obs_11_0039__li185021129191719">In Linux<pre class="screen" id="obs_11_0039__screen1457461121612"><span>./obsutil cp obs://src-bucket obs://dst-bucket -f -r -crr</span></pre> <ul id="obs_11_0039__ul175021299179"><li id="obs_11_0039__li185021129191719">Linux<pre class="screen" id="obs_11_0039__screen1457461121612"><span>./obsutil cp obs://src-bucket obs://dst-bucket -f -r -crr</span></pre>
</li></ul> </li></ul>
</p></li></ol> </p></li></ol>
<div class="note" id="obs_11_0039__note1647002295216"><img src="public_sys-resources/note_3.0-en-us.png"><span class="notetitle"> </span><div class="notebody"><ul id="obs_11_0039__ul63975143532"><li id="obs_11_0039__li4132467561">To use the cross-region replication function, you need to specify the <strong id="obs_11_0039__b183703536508">-crr</strong> parameter. If this parameter is specified, update the configuration of the client-side cross-region replication in the configuration file. For details, see <a href="obs_11_0023.html">Updating a Configuration File</a>.</li><li id="obs_11_0039__li17823184795519">The configurations of the source bucket and destination bucket are respectively <strong id="obs_11_0039__b1028317394322">akCrr/skCrr/tokenCrr/endpointCrr</strong> and <strong id="obs_11_0039__b19283203973211">ak/sk/token/endpoint</strong> in the configuration file.</li><li id="obs_11_0039__li3320747105414">The preceding procedure is also applicable to the situation when the source and destination buckets belong to the same account.</li></ul> <div class="note" id="obs_11_0039__note1647002295216"><img src="public_sys-resources/note_3.0-en-us.png"><span class="notetitle"> </span><div class="notebody"><ul id="obs_11_0039__ul63975143532"><li id="obs_11_0039__li4132467561">To use the cross-region replication function, you need to specify the <strong id="obs_11_0039__b183703536508">-crr</strong> parameter. If this parameter is specified, update the configuration of the client-side cross-region replication in the configuration file. For details, see <a href="obs_11_0023.html">Updating a Configuration File</a>.</li><li id="obs_11_0039__li17823184795519">The configurations of the source bucket and destination bucket are respectively <strong id="obs_11_0039__b1028317394322">akCrr/skCrr/tokenCrr/endpointCrr</strong> and <strong id="obs_11_0039__b19283203973211">ak/sk/token/endpoint</strong> in the configuration file.</li><li id="obs_11_0039__li3320747105414">The preceding procedure is also applicable to the situation when the source and destination buckets belong to the same account.</li></ul>

12
docs/obs/tool-obsutil/obs_11_0040.html
View File

@ -3,11 +3,11 @@
<h1 class="topictitle1">Setting Bucket Properties</h1> <h1 class="topictitle1">Setting Bucket Properties</h1>
<div id="body1547106819231"><div class="section" id="obs_11_0040__section1479112110815"><h4 class="sectiontitle">Function</h4><p id="obs_11_0040__p11772825481">You can use this command to set the properties of a bucket, such as storage classes and access policies.</p> <div id="body1547106819231"><div class="section" id="obs_11_0040__section1479112110815"><h4 class="sectiontitle">Function</h4><p id="obs_11_0040__p11772825481">You can use this command to set the properties of a bucket, such as storage classes and access policies.</p>
</div> </div>
<div class="section" id="obs_11_0040__section1220752192216"><h4 class="sectiontitle">Command Line Structure</h4><ul id="obs_11_0040__ul832417119303"><li id="obs_11_0040__li19324181113010">In Windows<pre class="screen" id="obs_11_0040__screen69741218113010">obsutil chattri obs://bucket [-sc=xxx] [-acl=xxx] [-aclXml=xxx] [-config=xxx] </pre> <div class="section" id="obs_11_0040__section1220752192216"><h4 class="sectiontitle">Command Line Structure</h4><ul id="obs_11_0040__ul832417119303"><li id="obs_11_0040__li19324181113010">Windows<pre class="screen" id="obs_11_0040__screen69741218113010">obsutil chattri obs://bucket [-sc=xxx] [-acl=xxx] [-aclXml=xxx] [-config=xxx] </pre>
</li><li id="obs_11_0040__li1476086143015">In Linux or macOS<pre class="screen" id="obs_11_0040__screen82451326103012">./obsutil chattri obs://bucket [-sc=xxx] [-acl=xxx] [-aclXml=xxx] [-config=xxx] </pre> </li><li id="obs_11_0040__li1476086143015">macOS or Linux<pre class="screen" id="obs_11_0040__screen82451326103012">./obsutil chattri obs://bucket [-sc=xxx] [-acl=xxx] [-aclXml=xxx] [-config=xxx] </pre>
</li></ul> </li></ul>
</div> </div>
<div class="section" id="obs_11_0040__section1474510539439"><h4 class="sectiontitle">Examples</h4><ul id="obs_11_0040__ul18745155374311"><li id="obs_11_0040__li374555312435">Take the Windows OS as an example. Run the <strong id="obs_11_0040__b129741610194715">obsutil chattri obs://bucket-test -acl=private</strong> command to change the access control policy of the bucket to private read and write.<pre class="screen" id="obs_11_0040__screen15745953174312"><strong id="obs_11_0040__b117461553164317">obsutil chattri obs://bucket-test -acl=private</strong> <div class="section" id="obs_11_0040__section1474510539439"><h4 class="sectiontitle">Examples</h4><ul id="obs_11_0040__ul18745155374311"><li id="obs_11_0040__li374555312435">In Windows, run <strong id="obs_11_0040__b129741610194715">obsutil chattri obs://bucket-test -acl=private</strong> to change the bucket ACL to private read/write.<pre class="screen" id="obs_11_0040__screen15745953174312"><strong id="obs_11_0040__b117461553164317">obsutil chattri obs://bucket-test -acl=private</strong>
Start at 2024-09-29 07:58:46.0506904 +0000 UTC Start at 2024-09-29 07:58:46.0506904 +0000 UTC
@ -34,7 +34,7 @@ Set the acl of bucket [bucket-test] to [private] successfully, request id [04050
</td> </td>
<td class="cellrowborder" valign="top" width="25.742574257425744%" headers="mcps1.3.4.2.1.4.1.2 "><p id="obs_11_0040__p4533191944218">Optional (additional parameter)</p> <td class="cellrowborder" valign="top" width="25.742574257425744%" headers="mcps1.3.4.2.1.4.1.2 "><p id="obs_11_0040__p4533191944218">Optional (additional parameter)</p>
</td> </td>
<td class="cellrowborder" valign="top" width="56.43564356435643%" headers="mcps1.3.4.2.1.4.1.3 "><p id="obs_11_0040__p86547153813">The default storage class of the bucket. Possible values are:</p> <td class="cellrowborder" valign="top" width="56.43564356435643%" headers="mcps1.3.4.2.1.4.1.3 "><p id="obs_11_0040__p86547153813">The default storage class of the bucket. The value can be:</p>
<ul id="obs_11_0040__ul175651814214"><li id="obs_11_0040__li1256512172114"><strong id="obs_11_0040__b7961723191118">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_0040__li10565181142113"><strong id="obs_11_0040__b4475458112310">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_0040__li756616110216"><strong id="obs_11_0040__b457212172410">cold</strong>: Cold storage class. It provides secure, durable, and inexpensive storage for rarely-accessed (once a year) data.</li></ul> <ul id="obs_11_0040__ul175651814214"><li id="obs_11_0040__li1256512172114"><strong id="obs_11_0040__b7961723191118">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_0040__li10565181142113"><strong id="obs_11_0040__b4475458112310">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_0040__li756616110216"><strong id="obs_11_0040__b457212172410">cold</strong>: Cold storage class. It provides secure, durable, and inexpensive storage for rarely-accessed (once a year) data.</li></ul>
</td> </td>
</tr> </tr>
@ -42,7 +42,7 @@ Set the acl of bucket [bucket-test] to [private] successfully, request id [04050
</td> </td>
<td class="cellrowborder" valign="top" width="25.742574257425744%" headers="mcps1.3.4.2.1.4.1.2 "><p id="obs_11_0040__p82428286353">Optional (additional parameter)</p> <td class="cellrowborder" valign="top" width="25.742574257425744%" headers="mcps1.3.4.2.1.4.1.2 "><p id="obs_11_0040__p82428286353">Optional (additional parameter)</p>
</td> </td>
<td class="cellrowborder" valign="top" width="56.43564356435643%" headers="mcps1.3.4.2.1.4.1.3 "><p id="obs_11_0040__p16811512123619">The predefined access control policy of the bucket. Possible values are:</p> <td class="cellrowborder" valign="top" width="56.43564356435643%" headers="mcps1.3.4.2.1.4.1.3 "><p id="obs_11_0040__p16811512123619">The predefined access control policy of the bucket. The value can be:</p>
<ul id="obs_11_0040__ul1273864144412"><li id="obs_11_0040__li17738649445">private</li><li id="obs_11_0040__li1551213137447">public-read</li><li id="obs_11_0040__li1287691813449">public-read-write</li></ul> <ul id="obs_11_0040__ul1273864144412"><li id="obs_11_0040__li17738649445">private</li><li id="obs_11_0040__li1551213137447">public-read</li><li id="obs_11_0040__li1287691813449">public-read-write</li></ul>
<div class="note" id="obs_11_0040__note1790113183525"><span class="notetitle"> NOTE: </span><div class="notebody"><p id="obs_11_0040__p92982882916">The preceding three values indicate private read and write, public read, and public read and write.</p> <div class="note" id="obs_11_0040__note1790113183525"><span class="notetitle"> NOTE: </span><div class="notebody"><p id="obs_11_0040__p92982882916">The preceding three values indicate private read and write, public read, and public read and write.</p>
</div></div> </div></div>
@ -99,6 +99,8 @@ Set the acl of bucket [bucket-test] to [private] successfully, request id [04050
<td class="cellrowborder" valign="top" width="25.742574257425744%" headers="mcps1.3.4.2.1.4.1.2 "><p id="obs_11_0040__p1266611611820">Optional (additional parameter)</p> <td class="cellrowborder" valign="top" width="25.742574257425744%" headers="mcps1.3.4.2.1.4.1.2 "><p id="obs_11_0040__p1266611611820">Optional (additional parameter)</p>
</td> </td>
<td class="cellrowborder" valign="top" width="56.43564356435643%" headers="mcps1.3.4.2.1.4.1.3 "><p id="obs_11_0040__p1166617619181">Specifies that requester pays is enabled.</p> <td class="cellrowborder" valign="top" width="56.43564356435643%" headers="mcps1.3.4.2.1.4.1.3 "><p id="obs_11_0040__p1166617619181">Specifies that requester pays is enabled.</p>
<p id="obs_11_0040__p13214143095512"><strong id="obs_11_0040__b6749172234523">Range</strong>:</p>
<p id="obs_11_0040__p13744112545515">requester</p>
</td> </td>
</tr> </tr>
</tbody> </tbody>

16
docs/obs/tool-obsutil/obs_11_0041.html
View File

@ -5,20 +5,20 @@
<div class="note" id="obs_11_0041__note1443740153612"><img src="public_sys-resources/note_3.0-en-us.png"><span class="notetitle"> </span><div class="notebody"><p id="obs_11_0041__p9443134063613">You can set storage classes only for buckets whose version is 3.0.</p> <div class="note" id="obs_11_0041__note1443740153612"><img src="public_sys-resources/note_3.0-en-us.png"><span class="notetitle"> </span><div class="notebody"><p id="obs_11_0041__p9443134063613">You can set storage classes only for buckets whose version is 3.0.</p>
</div></div> </div></div>
</div> </div>
<div class="section" id="obs_11_0041__section1220752192216"><h4 class="sectiontitle">Command Line Structure</h4><ul id="obs_11_0041__ul4348115485212"><li id="obs_11_0041__li034819548529">In Windows<ul id="obs_11_0041__ul14371109125314"><li id="obs_11_0041__li645116618536">Setting properties of a single object<pre class="screen" id="obs_11_0041__screen2021764195319">obsutil chattri obs://bucket/key [-meta=aaa:bbb#ccc:ddd] [-sc=xxx] [-acl=xxx] [-aclXml=xxx] [-versionId=xxx] [-fr] [-o=xxx] [-config=xxx] </pre> <div class="section" id="obs_11_0041__section1220752192216"><h4 class="sectiontitle">Command Line Structure</h4><ul id="obs_11_0041__ul4348115485212"><li id="obs_11_0041__li034819548529">Windows<ul id="obs_11_0041__ul14371109125314"><li id="obs_11_0041__li645116618536">Setting properties of a single object<pre class="screen" id="obs_11_0041__screen2021764195319">obsutil chattri obs://bucket/key [-meta=aaa:bbb#ccc:ddd] [-sc=xxx] [-acl=xxx] [-aclXml=xxx] [-versionId=xxx] [-fr] [-o=xxx] [-config=xxx] </pre>
</li><li id="obs_11_0041__li18337131475317">Setting properties of objects in batches<pre class="screen" id="obs_11_0041__screen15467124815533">obsutil chattri obs://bucket[/key] -r [-f] [-v] [-meta=aaa:bbb#ccc:ddd] [-sc=xxx] [-acl=xxx] [-aclXml=xxx] [-o=xxx] [-j=1] [-config=xxx] </pre> </li><li id="obs_11_0041__li18337131475317">Setting properties of objects in batches<pre class="screen" id="obs_11_0041__screen15467124815533">obsutil chattri obs://bucket[/key] -r [-f] [-v] [-meta=aaa:bbb#ccc:ddd] [-sc=xxx] [-acl=xxx] [-aclXml=xxx] [-o=xxx] [-j=1] [-config=xxx] </pre>
</li></ul> </li></ul>
</li><li id="obs_11_0041__li4476145885216">In Linux or macOS<ul id="obs_11_0041__ul10651133045317"><li id="obs_11_0041__li252718313536">Setting properties of a single object<pre class="screen" id="obs_11_0041__screen970919582539">./obsutil chattri obs://bucket/key [-meta=aaa:bbb#ccc:ddd] [-sc=xxx] [-acl=xxx] [-aclXml=xxx] [-versionId=xxx] [-fr] [-o=xxx] [-config=xxx] </pre> </li><li id="obs_11_0041__li4476145885216">macOS or Linux<ul id="obs_11_0041__ul10651133045317"><li id="obs_11_0041__li252718313536">Setting properties of a single object<pre class="screen" id="obs_11_0041__screen970919582539">./obsutil chattri obs://bucket/key [-meta=aaa:bbb#ccc:ddd] [-sc=xxx] [-acl=xxx] [-aclXml=xxx] [-versionId=xxx] [-fr] [-o=xxx] [-config=xxx] </pre>
</li><li id="obs_11_0041__li952883111532">Setting properties of objects in batches<pre class="screen" id="obs_11_0041__screen2398117135418">./obsutil chattri obs://bucket[/key] -r [-f] [-v] [-meta=aaa:bbb#ccc:ddd] [-sc=xxx] [-acl=xxx] [-aclXml=xxx] [-o=xxx] [-j=1] [-config=xxx] </pre> </li><li id="obs_11_0041__li952883111532">Setting properties of objects in batches<pre class="screen" id="obs_11_0041__screen2398117135418">./obsutil chattri obs://bucket[/key] -r [-f] [-v] [-meta=aaa:bbb#ccc:ddd] [-sc=xxx] [-acl=xxx] [-aclXml=xxx] [-o=xxx] [-j=1] [-config=xxx] </pre>
</li></ul> </li></ul>
</li></ul> </li></ul>
</div> </div>
<div class="section" id="obs_11_0041__section15228678360"><h4 class="sectiontitle">Examples</h4><ul id="obs_11_0041__ul2022819714364"><li id="obs_11_0041__li122812720367">Take the Windows OS as an example, run the <strong id="obs_11_0041__b457411313143">obsutil chattri obs://bucket-test/key -acl=public-read</strong> command to set the access permission to an object to public read.<pre class="screen" id="obs_11_0041__screen13228378367"><strong id="obs_11_0041__b72280716367">obsutil chattri obs://bucket-test/key <strong id="obs_11_0041__b122281375367">-acl=public-read</strong></strong> <div class="section" id="obs_11_0041__section15228678360"><h4 class="sectiontitle">Examples</h4><ul id="obs_11_0041__ul2022819714364"><li id="obs_11_0041__li122812720367">In Windows, run <strong id="obs_11_0041__b457411313143">obsutil chattri obs://bucket-test/key -acl=public-read</strong> to set the object ACL to public read.<pre class="screen" id="obs_11_0041__screen13228378367"><strong id="obs_11_0041__b72280716367">obsutil chattri obs://bucket-test/key <strong id="obs_11_0041__b122281375367">-acl=public-read</strong></strong>
Start at 2024-09-30 08:17:15.5572914 +0000 UTC Start at 2024-09-30 08:17:15.5572914 +0000 UTC
Set the acl of object [key] in the bucket [bucket-test] to [public-read] successfully, request id [04050000016836DDFA73B2B5320E2651]</pre> Set the acl of object [key] in the bucket [bucket-test] to [public-read] successfully, request id [04050000016836DDFA73B2B5320E2651]</pre>
</li></ul> </li></ul>
<ul id="obs_11_0041__ul12280733611"><li id="obs_11_0041__li102286717364">Take the Windows OS as an example, run the <strong id="obs_11_0041__b153291461773">obsutil <strong id="obs_11_0041__b332923782619">chattri </strong>obs://bucket-test -r -f <strong id="obs_11_0041__b19438657192714">-acl=public-read</strong></strong> command to set the access permission to all objects in the bucket to public read.<pre class="screen" id="obs_11_0041__screen132294713611"><strong id="obs_11_0041__b1722977103611">obsutil <strong id="obs_11_0041__b142299718362">chattri </strong>obs://bucket-test -r -f</strong> <strong id="obs_11_0041__b922915773615">-acl=public-read</strong> <ul id="obs_11_0041__ul12280733611"><li id="obs_11_0041__li102286717364">In Windows, run <strong id="obs_11_0041__b153291461773">obsutil <strong id="obs_11_0041__b332923782619">chattri </strong>obs://bucket-test -r -f <strong id="obs_11_0041__b19438657192714">-acl=public-read</strong></strong> to set the ACL of all objects in the bucket to public read.<pre class="screen" id="obs_11_0041__screen132294713611"><strong id="obs_11_0041__b1722977103611">obsutil <strong id="obs_11_0041__b142299718362">chattri </strong>obs://bucket-test -r -f</strong> <strong id="obs_11_0041__b922915773615">-acl=public-read</strong>
Start at 2024-09-30 08:18:03.105373 +0000 UTC Start at 2024-09-30 08:18:03.105373 +0000 UTC
[------------------------------------------------] 100.00% tps:155.15 5/5 233ms [------------------------------------------------] 100.00% tps:155.15 5/5 233ms
@ -75,7 +75,7 @@ Task id: 9d7f73ff-f747-4fdd-9b2a-815ba2dc3b07</pre>
</td> </td>
<td class="cellrowborder" valign="top" width="24%" headers="mcps1.3.4.2.1.4.1.2 "><p id="obs_11_0041__p4533191944218">Optional (additional parameter)</p> <td class="cellrowborder" valign="top" width="24%" headers="mcps1.3.4.2.1.4.1.2 "><p id="obs_11_0041__p4533191944218">Optional (additional parameter)</p>
</td> </td>
<td class="cellrowborder" valign="top" width="60%" headers="mcps1.3.4.2.1.4.1.3 "><p id="obs_11_0041__p86547153813">The storage class of an object. Possible values are:</p> <td class="cellrowborder" valign="top" width="60%" headers="mcps1.3.4.2.1.4.1.3 "><p id="obs_11_0041__p86547153813">The storage class of an object. The value can be:</p>
<ul id="obs_11_0041__ul175651814214"><li id="obs_11_0041__li1256512172114"><strong id="obs_11_0041__b667231233317">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_0041__li10565181142113"><strong id="obs_11_0041__b56638104272">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_0041__li756616110216"><strong id="obs_11_0041__b15601913182718">cold</strong>: Cold storage class. It provides secure, durable, and inexpensive storage for rarely-accessed (once a year) data.</li></ul> <ul id="obs_11_0041__ul175651814214"><li id="obs_11_0041__li1256512172114"><strong id="obs_11_0041__b667231233317">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_0041__li10565181142113"><strong id="obs_11_0041__b56638104272">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_0041__li756616110216"><strong id="obs_11_0041__b15601913182718">cold</strong>: Cold storage class. It provides secure, durable, and inexpensive storage for rarely-accessed (once a year) data.</li></ul>
<p id="obs_11_0041__p8360846131113"><strong id="obs_11_0041__b842095581317">For an object whose storage class is cold, restore the object first and then specify its storage class.</strong> To restore an object, see <a href="obs_11_0016.html">Restoring Objects from the Cold Storage</a>.</p> <p id="obs_11_0041__p8360846131113"><strong id="obs_11_0041__b842095581317">For an object whose storage class is cold, restore the object first and then specify its storage class.</strong> To restore an object, see <a href="obs_11_0016.html">Restoring Objects from the Cold Storage</a>.</p>
</td> </td>
@ -84,7 +84,7 @@ Task id: 9d7f73ff-f747-4fdd-9b2a-815ba2dc3b07</pre>
</td> </td>
<td class="cellrowborder" valign="top" width="24%" headers="mcps1.3.4.2.1.4.1.2 "><p id="obs_11_0041__p82428286353">Optional (additional parameter)</p> <td class="cellrowborder" valign="top" width="24%" headers="mcps1.3.4.2.1.4.1.2 "><p id="obs_11_0041__p82428286353">Optional (additional parameter)</p>
</td> </td>
<td class="cellrowborder" valign="top" width="60%" headers="mcps1.3.4.2.1.4.1.3 "><p id="obs_11_0041__p16811512123619">The predefined access control policy of an object. Possible values are:</p> <td class="cellrowborder" valign="top" width="60%" headers="mcps1.3.4.2.1.4.1.3 "><p id="obs_11_0041__p16811512123619">The predefined access control policy of an object. The value can be:</p>
<ul id="obs_11_0041__ul1273864144412"><li id="obs_11_0041__li17738649445">private</li><li id="obs_11_0041__li1551213137447">public-read</li><li id="obs_11_0041__li1287691813449">public-read-write</li><li id="obs_11_0041__li52241559503">bucket-owner-full-control</li></ul> <ul id="obs_11_0041__ul1273864144412"><li id="obs_11_0041__li17738649445">private</li><li id="obs_11_0041__li1551213137447">public-read</li><li id="obs_11_0041__li1287691813449">public-read-write</li><li id="obs_11_0041__li52241559503">bucket-owner-full-control</li></ul>
</td> </td>
</tr> </tr>
@ -166,7 +166,7 @@ Task id: 9d7f73ff-f747-4fdd-9b2a-815ba2dc3b07</pre>
<td class="cellrowborder" valign="top" width="24%" headers="mcps1.3.4.2.1.4.1.2 "><p id="obs_11_0041__p19177173320483">Optional when setting properties of objects in batches (additional parameter)</p> <td class="cellrowborder" valign="top" width="24%" headers="mcps1.3.4.2.1.4.1.2 "><p id="obs_11_0041__p19177173320483">Optional when setting properties of objects in batches (additional parameter)</p>
</td> </td>
<td class="cellrowborder" valign="top" width="60%" headers="mcps1.3.4.2.1.4.1.3 "><p id="obs_11_0041__p2549177181312">The maximum number of concurrent tasks for setting object properties in batches. The default value is the value of <strong id="obs_11_0041__b1268754012466">defaultJobs</strong> in the configuration file.</p> <td class="cellrowborder" valign="top" width="60%" headers="mcps1.3.4.2.1.4.1.3 "><p id="obs_11_0041__p2549177181312">The maximum number of concurrent tasks for setting object properties in batches. The default value is the value of <strong id="obs_11_0041__b1268754012466">defaultJobs</strong> in the configuration file.</p>
<div class="note" id="obs_11_0041__note891964620819"><span class="notetitle"> NOTE: </span><div class="notebody"><p id="obs_11_0041__p1091964618820">The value is ensured to be greater than or equal to 1.</p> <div class="note" id="obs_11_0041__note891964620819"><span class="notetitle"> NOTE: </span><div class="notebody"><p id="obs_11_0041__p1091964618820">The tool ensures that this value is at least 1.</p>
</div></div> </div></div>
</td> </td>
</tr> </tr>
@ -191,6 +191,8 @@ Task id: 9d7f73ff-f747-4fdd-9b2a-815ba2dc3b07</pre>
<td class="cellrowborder" valign="top" width="24%" headers="mcps1.3.4.2.1.4.1.2 "><p id="obs_11_0041__p1266611611820">Optional (additional parameter)</p> <td class="cellrowborder" valign="top" width="24%" headers="mcps1.3.4.2.1.4.1.2 "><p id="obs_11_0041__p1266611611820">Optional (additional parameter)</p>
</td> </td>
<td class="cellrowborder" valign="top" width="60%" headers="mcps1.3.4.2.1.4.1.3 "><p id="obs_11_0041__p1166617619181">Specifies that requester pays is enabled.</p> <td class="cellrowborder" valign="top" width="60%" headers="mcps1.3.4.2.1.4.1.3 "><p id="obs_11_0041__p1166617619181">Specifies that requester pays is enabled.</p>
<p id="obs_11_0041__p13214143095512"><strong id="obs_11_0041__b17614343834544">Range</strong>:</p>
<p id="obs_11_0041__p13744112545515">requester</p>
</td> </td>
</tr> </tr>
</tbody> </tbody>

24
docs/obs/tool-obsutil/obs_11_0042.html
View File

@ -4,17 +4,17 @@
<div id="body1547713383688"><div class="section" id="obs_11_0042__section68797549353"><h4 class="sectiontitle">Function</h4><p id="obs_11_0042__p54301560815">You can use this command to synchronize all content in a local source path to the specified target OBS bucket to ensure data consistency. Incremental synchronization has the following meanings:</p> <div id="body1547713383688"><div class="section" id="obs_11_0042__section68797549353"><h4 class="sectiontitle">Function</h4><p id="obs_11_0042__p54301560815">You can use this command to synchronize all content in a local source path to the specified target OBS bucket to ensure data consistency. Incremental synchronization has the following meanings:</p>
<ol id="obs_11_0042__ol7389514788"><li id="obs_11_0042__li1138910141086">"Incremental" means that the local source files are compared with their counterparts in the target bucket and only those with content changes are uploaded.</li><li id="obs_11_0042__li89648205815">"Synchronization" means that after the command is executed, all source files in the local path have their counterparts in the target OBS bucket.</li></ol> <ol id="obs_11_0042__ol7389514788"><li id="obs_11_0042__li1138910141086">"Incremental" means that the local source files are compared with their counterparts in the target bucket and only those with content changes are uploaded.</li><li id="obs_11_0042__li89648205815">"Synchronization" means that after the command is executed, all source files in the local path have their counterparts in the target OBS bucket.</li></ol>
</div> </div>
<div class="notice" id="obs_11_0042__note15184181913594"><span class="noticetitle"><img src="public_sys-resources/notice_3.0-en-us.png"> </span><div class="noticebody"><ul id="obs_11_0042__ul1680042375018"><li id="obs_11_0042__li68001023115010">Do not change the local file or folder during synchronization. Otherwise, the synchronization may fail or data may be inconsistent.</li><li id="obs_11_0042__li18348152815501">Each file can be synchronously 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.</li></ul> <div class="notice" id="obs_11_0042__note15184181913594"><span class="noticetitle"><img src="public_sys-resources/notice_3.0-en-us.png"> </span><div class="noticebody"><ul id="obs_11_0042__ul1680042375018"><li id="obs_11_0042__li68001023115010">Do not change the local file or folder during synchronization. Otherwise, the synchronization may fail or data may be inconsistent.</li><li id="obs_11_0042__li18348152815501">During synchronous upload, each file is compared with the object at the corresponding path in the bucket. A file is uploaded only when the object does not exist, the object size differs from the file size, or the object was last modified earlier than the file.</li></ul>
</div></div> </div></div>
<div class="section" id="obs_11_0042__section1220752192216"><h4 class="sectiontitle">Command Line Structure</h4><ul id="obs_11_0042__ul2098662312412"><li id="obs_11_0042__li198632362414">In Windows<ul id="obs_11_0042__ul48751720253"><li id="obs_11_0042__li1012518598242">Uploading a file synchronously<pre class="screen" id="obs_11_0042__screen10125859132415">obsutil sync file_url obs://bucket[/key] [-arcDir=xxx] [-dryRun] [-link] [-vlength] [-vmd5] [-p=1] [-threshold=5248800] [-acl=xxx] [-sc=xxx] [-meta=aaa:bbb#ccc:ddd] [-ps=auto] [-o=xxx] [-cpd=xxx] [-fr] [-config=xxx] </pre> <div class="section" id="obs_11_0042__section1220752192216"><h4 class="sectiontitle">Command Line Structure</h4><ul id="obs_11_0042__ul2098662312412"><li id="obs_11_0042__li198632362414">Windows<ul id="obs_11_0042__ul48751720253"><li id="obs_11_0042__li1012518598242">Uploading a file synchronously<pre class="screen" id="obs_11_0042__screen10125859132415">obsutil sync file_url obs://bucket[/key] [-arcDir=xxx] [-dryRun] [-link] [-vlength] [-vmd5] [-p=1] [-threshold=5248800] [-acl=xxx] [-sc=xxx] [-meta=aaa:bbb#ccc:ddd] [-ps=auto] [-o=xxx] [-cpd=xxx] [-fr] [-config=xxx] </pre>
</li><li id="obs_11_0042__li162401213162513">Uploading a folder synchronously<pre class="screen" id="obs_11_0042__screen13477182952517">obsutil sync folder_url obs://bucket[/key] [-arcDir=xxx] [-dryRun] [-link] [-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_0042__li162401213162513">Uploading a folder synchronously<pre class="screen" id="obs_11_0042__screen13477182952517">obsutil sync folder_url obs://bucket[/key] [-arcDir=xxx] [-dryRun] [-link] [-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></ul> </li></ul>
</li><li id="obs_11_0042__li7461142911245">In Linux or macOS<ul id="obs_11_0042__ul19781832122716"><li id="obs_11_0042__li13282130132713">Uploading a file synchronously<pre class="screen" id="obs_11_0042__screen146603552810">./obsutil sync file_url obs://bucket[/key] [-arcDir=xxx] [-dryRun] [-link] [-vlength] [-vmd5] [-p=1] [-threshold=5248800] [-acl=xxx] [-sc=xxx] [-meta=aaa:bbb#ccc:ddd] [-ps=auto] [-o=xxx] [-cpd=xxx] [-fr] [-config=xxx] </pre> </li><li id="obs_11_0042__li7461142911245">macOS or Linux<ul id="obs_11_0042__ul19781832122716"><li id="obs_11_0042__li13282130132713">Uploading a file synchronously<pre class="screen" id="obs_11_0042__screen146603552810">./obsutil sync file_url obs://bucket[/key] [-arcDir=xxx] [-dryRun] [-link] [-vlength] [-vmd5] [-p=1] [-threshold=5248800] [-acl=xxx] [-sc=xxx] [-meta=aaa:bbb#ccc:ddd] [-ps=auto] [-o=xxx] [-cpd=xxx] [-fr] [-config=xxx] </pre>
</li><li id="obs_11_0042__li186411137132711">Uploading a folder synchronously<pre class="screen" id="obs_11_0042__screen13485493273">./obsutil sync folder_url obs://bucket[/key] [-arcDir=xxx] [-dryRun] [-link] [-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_0042__li186411137132711">Uploading a folder synchronously<pre class="screen" id="obs_11_0042__screen13485493273">./obsutil sync folder_url obs://bucket[/key] [-arcDir=xxx] [-dryRun] [-link] [-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></ul> </li></ul>
</li></ul> </li></ul>
</div> </div>
<div class="section" id="obs_11_0042__section53881308394"><h4 class="sectiontitle">Examples</h4><ul id="obs_11_0042__ul23882012398"><li id="obs_11_0042__li12388120153912">Take the Windows OS as an example. Run the <strong id="obs_11_0042__b457411313143">obsutil sync d:\temp\test.txt obs://bucket-test/key</strong> command to synchronously upload a file.<pre class="screen" id="obs_11_0042__screen1938810013397"><strong id="obs_11_0042__b53887013397">obsutil sync d:\temp\test.txt obs://bucket-test/key</strong> <div class="section" id="obs_11_0042__section53881308394"><h4 class="sectiontitle">Examples</h4><ul id="obs_11_0042__ul23882012398"><li id="obs_11_0042__li12388120153912">In Windows, run <strong id="obs_11_0042__b457411313143">obsutil sync d:\temp\test.txt obs://bucket-test/key</strong> to synchronously upload a file.<pre class="screen" id="obs_11_0042__screen1938810013397"><strong id="obs_11_0042__b53887013397">obsutil sync d:\temp\test.txt obs://bucket-test/key</strong>
Start at 2024-09-25 04:48:10.1147483 +0000 UTC Start at 2024-09-25 04:48:10.1147483 +0000 UTC
@ -26,7 +26,7 @@ CheckpointDir: C:\Users\Administrator\.obsutil_checkpoint
[====================================================] 100.00% 1.68 MB/s 8.46MB/8.46MB 5s [====================================================] 100.00% 1.68 MB/s 8.46MB/8.46MB 5s
Upload successfully, 8.46MB, d:\temp\test.txt --&gt; obs://bucket-test/key, cost [55], status [200], request id [00000192421F4E224012B8470C0CCCDC]</pre> Upload successfully, 8.46MB, d:\temp\test.txt --&gt; obs://bucket-test/key, cost [55], status [200], request id [00000192421F4E224012B8470C0CCCDC]</pre>
</li></ul> </li></ul>
<ul id="obs_11_0042__ul13897016394"><li id="obs_11_0042__li16389806391">Take the Windows OS as an example. Run the <strong id="obs_11_0042__b153291461773">obsutil sync d:\temp obs://bucket-test/temp</strong> command to synchronously upload a folder.<pre class="screen" id="obs_11_0042__screen7390110143917"><strong id="obs_11_0042__b239018013391">obsutil sync d:\temp obs://bucket-test/temp</strong> <ul id="obs_11_0042__ul13897016394"><li id="obs_11_0042__li16389806391">In Windows, run <strong id="obs_11_0042__b153291461773">obsutil sync d:\temp obs://bucket-test/temp</strong> to synchronously upload a folder.<pre class="screen" id="obs_11_0042__screen7390110143917"><strong id="obs_11_0042__b239018013391">obsutil sync d:\temp obs://bucket-test/temp</strong>
Start at 2024-09-25 04:48:10.1147483 +0000 UTC Start at 2024-09-25 04:48:10.1147483 +0000 UTC
@ -82,7 +82,7 @@ Task id: 104786c8-27c2-48fc-bc6a-5886596fb0ed</pre>
</td> </td>
<td class="cellrowborder" valign="top" width="65.03999999999999%" headers="mcps1.3.5.2.1.4.1.3 "><p id="obs_11_0042__p16965474526">The object name or object name prefix specified when uploading a file synchronously, or the object name prefix specified when uploading a folder synchronously</p> <td class="cellrowborder" valign="top" width="65.03999999999999%" headers="mcps1.3.5.2.1.4.1.3 "><p id="obs_11_0042__p16965474526">The object name or object name prefix specified when uploading a file synchronously, or the object name prefix specified when uploading a folder synchronously</p>
<p id="obs_11_0042__p060018221533">The rules are as follows:</p> <p id="obs_11_0042__p060018221533">The rules are as follows:</p>
<ul id="obs_11_0042__ul7190122515538"><li id="obs_11_0042__li15190225135311">If this parameter is left blank when synchronously uploading a file, the file is uploaded to the root directory of the bucket and the object name is the file name. If the value ends with a slash (/), the value is used as the object name prefix when the file is uploaded, and the object name is the value plus the file name. If the value does not end with a slash (/), the file is uploaded with the value as the object name.</li><li id="obs_11_0042__li161384914910">If this parameter is left blank when synchronously uploading a folder, all objects in the root directory of the bucket are the same as the files in the local folder. If this parameter is configured, objects whose name prefix is the configured value are the same as the files in the local folder.</li></ul> <ul id="obs_11_0042__ul7190122515538"><li id="obs_11_0042__li15190225135311">During a synchronous file upload, if this parameter is left blank, the file is uploaded to the bucket's root directory, and the object name is the same as the file name. If the value ends with a slash (/), it is used as the object name prefix during the upload, and the object name becomes the value plus the file name. If the value does not end with a slash (/), the file is uploaded using the value as the full object name.</li><li id="obs_11_0042__li161384914910">During a synchronous folder upload, if this parameter is left blank, all objects in the bucket's root directory are synchronized with the contents of the local folder. If this parameter is set, the objects whose name prefix is the specified parameter value are synchronized with the contents of the local folder.</li></ul>
<div class="note" id="obs_11_0042__note14528254193716"><span class="notetitle"> NOTE: </span><div class="notebody"><ul id="obs_11_0042__ul1791612918129"><li id="obs_11_0042__li56341131161211">If the value of this parameter does not end with a slash (/) when synchronously uploading a folder, the obsutil tool automatically adds a slash (/) at the end of the configured value as the object name prefix.</li><li id="obs_11_0042__li1891611294125">For details about how to use this parameter, see <a href="obs_11_0046.html">Synchronous Upload</a>.</li></ul> <div class="note" id="obs_11_0042__note14528254193716"><span class="notetitle"> NOTE: </span><div class="notebody"><ul id="obs_11_0042__ul1791612918129"><li id="obs_11_0042__li56341131161211">If the value of this parameter does not end with a slash (/) when synchronously uploading a folder, the obsutil tool automatically adds a slash (/) at the end of the configured value as the object name prefix.</li><li id="obs_11_0042__li1891611294125">For details about how to use this parameter, see <a href="obs_11_0046.html">Synchronous Upload</a>.</li></ul>
</div></div> </div></div>
</td> </td>
@ -155,7 +155,7 @@ Task id: 104786c8-27c2-48fc-bc6a-5886596fb0ed</pre>
</td> </td>
<td class="cellrowborder" valign="top" width="19.35%" headers="mcps1.3.5.2.1.4.1.2 "><p id="obs_11_0042__p82428286353">Optional (additional parameter)</p> <td class="cellrowborder" valign="top" width="19.35%" headers="mcps1.3.5.2.1.4.1.2 "><p id="obs_11_0042__p82428286353">Optional (additional parameter)</p>
</td> </td>
<td class="cellrowborder" valign="top" width="65.03999999999999%" headers="mcps1.3.5.2.1.4.1.3 "><p id="obs_11_0042__p16811512123619">The access control policies that can be specified when synchronously uploading files. Possible values are:</p> <td class="cellrowborder" valign="top" width="65.03999999999999%" headers="mcps1.3.5.2.1.4.1.3 "><p id="obs_11_0042__p16811512123619">The access control policies that can be specified when synchronously uploading files. The value can be:</p>
<ul id="obs_11_0042__ul1273864144412"><li id="obs_11_0042__li17738649445">private</li><li id="obs_11_0042__li1551213137447">public-read</li><li id="obs_11_0042__li1287691813449">public-read-write</li><li id="obs_11_0042__li370063135219">bucket-owner-full-control</li></ul> <ul id="obs_11_0042__ul1273864144412"><li id="obs_11_0042__li17738649445">private</li><li id="obs_11_0042__li1551213137447">public-read</li><li id="obs_11_0042__li1287691813449">public-read-write</li><li id="obs_11_0042__li370063135219">bucket-owner-full-control</li></ul>
<div class="note" id="obs_11_0042__note1790113183525"><span class="notetitle"> NOTE: </span><div class="notebody"><p id="obs_11_0042__p92982882916">The preceding four values indicate private read and write, public read, public read and write, and bucket owner full control.</p> <div class="note" id="obs_11_0042__note1790113183525"><span class="notetitle"> NOTE: </span><div class="notebody"><p id="obs_11_0042__p92982882916">The preceding four values indicate private read and write, public read, public read and write, and bucket owner full control.</p>
</div></div> </div></div>
@ -165,7 +165,7 @@ Task id: 104786c8-27c2-48fc-bc6a-5886596fb0ed</pre>
</td> </td>
<td class="cellrowborder" valign="top" width="19.35%" headers="mcps1.3.5.2.1.4.1.2 "><p id="obs_11_0042__p4533191944218">Optional (additional parameter)</p> <td class="cellrowborder" valign="top" width="19.35%" headers="mcps1.3.5.2.1.4.1.2 "><p id="obs_11_0042__p4533191944218">Optional (additional parameter)</p>
</td> </td>
<td class="cellrowborder" valign="top" width="65.03999999999999%" headers="mcps1.3.5.2.1.4.1.3 "><p id="obs_11_0042__p86547153813">The storage classes of objects that can be specified when synchronously uploading files. Possible values are:</p> <td class="cellrowborder" valign="top" width="65.03999999999999%" headers="mcps1.3.5.2.1.4.1.3 "><p id="obs_11_0042__p86547153813">The storage classes of objects that can be specified when synchronously uploading files. The value can be:</p>
<ul id="obs_11_0042__ul175651814214"><li id="obs_11_0042__li1256512172114"><strong id="obs_11_0042__b1854311482100">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_0042__li10565181142113"><strong id="obs_11_0042__b948925943410">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_0042__li756616110216"><strong id="obs_11_0042__b6734321352">cold</strong>: Cold storage class. It provides secure, durable, and inexpensive storage for rarely-accessed (once a year) data.</li></ul> <ul id="obs_11_0042__ul175651814214"><li id="obs_11_0042__li1256512172114"><strong id="obs_11_0042__b1854311482100">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_0042__li10565181142113"><strong id="obs_11_0042__b948925943410">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_0042__li756616110216"><strong id="obs_11_0042__b6734321352">cold</strong>: Cold storage class. It provides secure, durable, and inexpensive storage for rarely-accessed (once a year) data.</li></ul>
</td> </td>
</tr> </tr>
@ -173,7 +173,7 @@ Task id: 104786c8-27c2-48fc-bc6a-5886596fb0ed</pre>
</td> </td>
<td class="cellrowborder" valign="top" width="19.35%" headers="mcps1.3.5.2.1.4.1.2 "><p id="obs_11_0042__p3476173116357">Optional (additional parameter)</p> <td class="cellrowborder" valign="top" width="19.35%" headers="mcps1.3.5.2.1.4.1.2 "><p id="obs_11_0042__p3476173116357">Optional (additional parameter)</p>
</td> </td>
<td class="cellrowborder" valign="top" width="65.03999999999999%" headers="mcps1.3.5.2.1.4.1.3 "><p id="obs_11_0042__p1447673143520">The customized metadata that can be specified when uploading files. The format is <strong id="obs_11_0042__b18642117153113">key1:value1#key2:value2#key3:value3</strong>.</p> <td class="cellrowborder" valign="top" width="65.03999999999999%" headers="mcps1.3.5.2.1.4.1.3 "><p id="obs_11_0042__p1447673143520">The custom metadata that can be specified during file upload. The format is <strong id="obs_11_0042__b18642117153113">key1:value1#key2:value2#key3:value3</strong>.</p>
<div class="note" id="obs_11_0042__note2863162085514"><span class="notetitle"> NOTE: </span><div class="notebody"><p id="obs_11_0042__p686342013559">The preceding value indicates that the object in the bucket contains three groups of customized metadata after the file is uploaded: <strong id="obs_11_0042__b89423875116">key1:value1</strong>, <strong id="obs_11_0042__b5950387516">key2:value2</strong>, and <strong id="obs_11_0042__b179773875113">key3:value3</strong>.</p> <div class="note" id="obs_11_0042__note2863162085514"><span class="notetitle"> NOTE: </span><div class="notebody"><p id="obs_11_0042__p686342013559">The preceding value indicates that the object in the bucket contains three groups of customized metadata after the file is uploaded: <strong id="obs_11_0042__b89423875116">key1:value1</strong>, <strong id="obs_11_0042__b5950387516">key2:value2</strong>, and <strong id="obs_11_0042__b179773875113">key3:value3</strong>.</p>
</div></div> </div></div>
</td> </td>
@ -201,7 +201,7 @@ Task id: 104786c8-27c2-48fc-bc6a-5886596fb0ed</pre>
<td class="cellrowborder" valign="top" width="19.35%" headers="mcps1.3.5.2.1.4.1.2 "><p id="obs_11_0042__p989613496247">Optional for synchronously uploading a folder (additional parameter)</p> <td class="cellrowborder" valign="top" width="19.35%" headers="mcps1.3.5.2.1.4.1.2 "><p id="obs_11_0042__p989613496247">Optional for synchronously uploading a folder (additional parameter)</p>
</td> </td>
<td class="cellrowborder" valign="top" width="65.03999999999999%" headers="mcps1.3.5.2.1.4.1.3 "><p id="obs_11_0042__p112661531143816">The maximum number of concurrent tasks for uploading a folder synchronously. The default value is the value of <strong id="obs_11_0042__b13318131385">defaultJobs</strong> in the configuration file.</p> <td class="cellrowborder" valign="top" width="65.03999999999999%" headers="mcps1.3.5.2.1.4.1.3 "><p id="obs_11_0042__p112661531143816">The maximum number of concurrent tasks for uploading a folder synchronously. The default value is the value of <strong id="obs_11_0042__b13318131385">defaultJobs</strong> in the configuration file.</p>
<div class="note" id="obs_11_0042__note891964620819"><span class="notetitle"> NOTE: </span><div class="notebody"><p id="obs_11_0042__p1091964618820">The value is ensured to be greater than or equal to 1.</p> <div class="note" id="obs_11_0042__note891964620819"><span class="notetitle"> NOTE: </span><div class="notebody"><p id="obs_11_0042__p1091964618820">The tool ensures that this value is at least 1.</p>
</div></div> </div></div>
</td> </td>
</tr> </tr>
@ -221,7 +221,7 @@ Task id: 104786c8-27c2-48fc-bc6a-5886596fb0ed</pre>
<td class="cellrowborder" valign="top" width="19.35%" headers="mcps1.3.5.2.1.4.1.2 "><p id="obs_11_0042__p1856190112516">Optional for synchronously uploading a folder (additional parameter)</p> <td class="cellrowborder" valign="top" width="19.35%" headers="mcps1.3.5.2.1.4.1.2 "><p id="obs_11_0042__p1856190112516">Optional for synchronously uploading a folder (additional parameter)</p>
</td> </td>
<td class="cellrowborder" valign="top" width="65.03999999999999%" headers="mcps1.3.5.2.1.4.1.3 "><p id="obs_11_0042__p85831634179">The file matching patterns that are included, for example: <strong id="obs_11_0042__b1936152316275">*.jpg</strong></p> <td class="cellrowborder" valign="top" width="65.03999999999999%" headers="mcps1.3.5.2.1.4.1.3 "><p id="obs_11_0042__p85831634179">The file matching patterns that are included, for example: <strong id="obs_11_0042__b1936152316275">*.jpg</strong></p>
<div class="note" id="obs_11_0042__note6126191912710"><span class="notetitle"> NOTE: </span><div class="notebody"><ul id="obs_11_0042__ul144557173539"><li id="obs_11_0042__li104555174537">The asterisk (*) represents any group of characters, and the question mark (?) represents any single character.</li><li id="obs_11_0042__li83022046113412">You can use <strong id="obs_11_0042__b17420426142714">\*</strong> to represent <strong id="obs_11_0042__b8421122632715">*</strong> and <strong id="obs_11_0042__b16422202622719">\?</strong> to represent <strong id="obs_11_0042__b7423726122711">?</strong>.</li><li id="obs_11_0042__li442714198534">Only after identifying that the name of the file to be uploaded does not match the value of <strong id="obs_11_0042__b22581581369">exclude</strong>, the system checks whether the file name matches the value of this parameter. If yes, the file is uploaded. If not, the file is skipped.</li></ul> <div class="note" id="obs_11_0042__note6126191912710"><span class="notetitle"> NOTE: </span><div class="notebody"><ul id="obs_11_0042__ul144557173539"><li id="obs_11_0042__li104555174537">The asterisk (*) represents any group of characters, and the question mark (?) represents any single character.</li><li id="obs_11_0042__li83022046113412">You can use <strong id="obs_11_0042__b17420426142714">\*</strong> to represent <strong id="obs_11_0042__b8421122632715">*</strong> and <strong id="obs_11_0042__b16422202622719">\?</strong> to represent <strong id="obs_11_0042__b7423726122711">?</strong>.</li><li id="obs_11_0042__li442714198534">The <strong id="obs_11_0042__b154531231199">exclude</strong> rule is applied first. If the name of the file to be uploaded does not match the <strong id="obs_11_0042__b22581581369">exclude</strong> rule, the system then checks whether the file name matches this parameter. If it does, the file is uploaded. If it does not, the file is skipped.</li></ul>
</div></div> </div></div>
<div class="notice" id="obs_11_0042__note7627205718163"><span class="noticetitle"> NOTICE: </span><div class="noticebody"><ul id="obs_11_0042__ul1024816334581"><li id="obs_11_0042__li13248133155813">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_0042__li1797064820102">The matching pattern applies to the absolute file path (including the file name and file directory).</li><li id="obs_11_0042__li1022917497107">The matching pattern takes effect only for files in the folder.</li><li id="obs_11_0042__li1352381183210">Multiple <strong id="obs_11_0042__b1180819545549">include</strong> parameters can be specified, for example, <strong id="obs_11_0042__b10808654175410">-include=*.xxx -include=*.xxx</strong>.</li></ul> <div class="notice" id="obs_11_0042__note7627205718163"><span class="noticetitle"> NOTICE: </span><div class="noticebody"><ul id="obs_11_0042__ul1024816334581"><li id="obs_11_0042__li13248133155813">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_0042__li1797064820102">The matching pattern applies to the absolute file path (including the file name and file directory).</li><li id="obs_11_0042__li1022917497107">The matching pattern takes effect only for files in the folder.</li><li id="obs_11_0042__li1352381183210">Multiple <strong id="obs_11_0042__b1180819545549">include</strong> parameters can be specified, for example, <strong id="obs_11_0042__b10808654175410">-include=*.xxx -include=*.xxx</strong>.</li></ul>
</div></div> </div></div>
@ -249,7 +249,7 @@ Task id: 104786c8-27c2-48fc-bc6a-5886596fb0ed</pre>
</td> </td>
<td class="cellrowborder" valign="top" width="65.03999999999999%" headers="mcps1.3.5.2.1.4.1.3 "><p id="obs_11_0042__p16963940134813">The time range matching pattern when synchronously uploading files. Only files whose latest modification time is within the configured time range are uploaded.</p> <td class="cellrowborder" valign="top" width="65.03999999999999%" headers="mcps1.3.5.2.1.4.1.3 "><p id="obs_11_0042__p16963940134813">The time range matching pattern when synchronously uploading files. Only files whose latest modification time is within the configured time range are uploaded.</p>
<p id="obs_11_0042__p1467441919542">This pattern has a lower priority than the file matching patterns (<strong id="obs_11_0042__b154809501181">exclude</strong>/<strong id="obs_11_0042__b34822501581">include</strong>). That is, the time range matching pattern is executed after the configured file matching patterns.</p> <p id="obs_11_0042__p1467441919542">This pattern has a lower priority than the file matching patterns (<strong id="obs_11_0042__b154809501181">exclude</strong>/<strong id="obs_11_0042__b34822501581">include</strong>). That is, the time range matching pattern is executed after the configured file matching patterns.</p>
<div class="note" id="obs_11_0042__note8766915165919"><span class="notetitle"> NOTE: </span><div class="notebody"><ul id="obs_11_0042__ul19272430145915"><li id="obs_11_0042__li12731730115918">The matching time range is represented in <em id="obs_11_0042__i13561927173114">time1</em><strong id="obs_11_0042__b0357172733120">-</strong><em id="obs_11_0042__i03571276318">time2</em>, where <em id="obs_11_0042__i2035820277313">time1</em> must be earlier than or the same as <em id="obs_11_0042__i193593270311">time2</em>. The time format is <em id="obs_11_0042__i7359102715317">yyyyMMddHHmmss</em>.</li><li id="obs_11_0042__li32731530185916">Automatic formatting is supported. For example, yyyyMMdd is equivalent to yyyyMMdd000000, and yyyyMM is equivalent to yyyyMM01000000.</li><li id="obs_11_0042__li5185481610">If this parameter is set to <strong id="obs_11_0042__b697622914312">*-</strong><em id="obs_11_0042__i897611299316">time2</em>, all files whose latest modification time is earlier than <em id="obs_11_0042__i1097792943117">time2</em> are matched. If it is set to <em id="obs_11_0042__i199770297314">time1</em><strong id="obs_11_0042__b89783292318">-*</strong>, all files whose latest modification time is later than <em id="obs_11_0042__i1697822963118">time1</em> are matched.</li></ul> <div class="note" id="obs_11_0042__note8766915165919"><span class="notetitle"> NOTE: </span><div class="notebody"><ul id="obs_11_0042__ul19272430145915"><li id="obs_11_0042__li12731730115918">The matching time range is represented in <em id="obs_11_0042__i13561927173114">time1</em><strong id="obs_11_0042__b0357172733120">-</strong><em id="obs_11_0042__i03571276318">time2</em>, where <em id="obs_11_0042__i2035820277313">time1</em> must be earlier than or the same as <em id="obs_11_0042__i193593270311">time2</em>. The time format is <em id="obs_11_0042__i7359102715317">yyyyMMddHHmmss</em>.</li><li id="obs_11_0042__li32731530185916">Automatic formatting is supported. For example, yyyyMMdd is equivalent to yyyyMMdd000000, and yyyyMM is equivalent to yyyyMM01000000.</li><li id="obs_11_0042__li5185481610">If this parameter is set to <strong id="obs_11_0042__b2098314595512">*-</strong><em id="obs_11_0042__i89831154559">time2</em>, all files whose last modification time is earlier than <em id="obs_11_0042__i39831515510">time2</em> are matched. If it is set to <em id="obs_11_0042__i14984757559">time1</em><strong id="obs_11_0042__b1984550550">-*</strong>, all files whose last modification time is later than <em id="obs_11_0042__i698419519553">time1</em> are matched.</li></ul>
</div></div> </div></div>
<div class="notice" id="obs_11_0042__note1078981817591"><span class="noticetitle"> NOTICE: </span><div class="noticebody"><p id="obs_11_0042__p3426114111312">Time in the matching pattern is the UTC time.</p> <div class="notice" id="obs_11_0042__note1078981817591"><span class="noticetitle"> NOTICE: </span><div class="noticebody"><p id="obs_11_0042__p3426114111312">Time in the matching pattern is the UTC time.</p>
</div></div> </div></div>

16
docs/obs/tool-obsutil/obs_11_0043.html
View File

@ -6,11 +6,11 @@
<div class="notice" id="obs_11_0043__note780411406113"><span class="noticetitle"><img src="public_sys-resources/notice_3.0-en-us.png"> </span><div class="noticebody"><ul id="obs_11_0043__ul562142691216"><li id="obs_11_0043__li156218269126">Do not change the source objects in the OBS bucket when synchronously downloading objects. Otherwise, the synchronization may fail or data may be inconsistent.</li><li id="obs_11_0043__li13953133195915">Each object can be synchronously downloaded only when it does not exist in the local path, its size is different from the namesake one in the local path, or it has the latest modification time.</li><li id="obs_11_0043__li17204191655911">A single file cannot be downloaded synchronously. Only folders can be downloaded synchronously.</li></ul> <div class="notice" id="obs_11_0043__note780411406113"><span class="noticetitle"><img src="public_sys-resources/notice_3.0-en-us.png"> </span><div class="noticebody"><ul id="obs_11_0043__ul562142691216"><li id="obs_11_0043__li156218269126">Do not change the source objects in the OBS bucket when synchronously downloading objects. Otherwise, the synchronization may fail or data may be inconsistent.</li><li id="obs_11_0043__li13953133195915">Each object can be synchronously downloaded only when it does not exist in the local path, its size is different from the namesake one in the local path, or it has the latest modification time.</li><li id="obs_11_0043__li17204191655911">A single file cannot be downloaded synchronously. Only folders can be downloaded synchronously.</li></ul>
</div></div> </div></div>
</div> </div>
<div class="section" id="obs_11_0043__section19587175622519"><h4 class="sectiontitle">Command Line Structure</h4><ul id="obs_11_0043__ul4348115485212"><li id="obs_11_0043__li034819548529">In Windows<pre class="screen" id="obs_11_0043__screen15467124815533">obsutil sync obs://bucket[/key] folder_url [-tempFileDir=xxx] [-dryRun] [-vlength] [-vmd5] [-j=1] [-p=1] [-threshold=52428800] [-ps=auto] [-include=*.xxx] [-exclude=*.xxx] [-timeRange=time1-time2] [-mf] [-o=xxx] [-cpd=xxx] [-config=xxx] </pre> <div class="section" id="obs_11_0043__section19587175622519"><h4 class="sectiontitle">Command Line Structure</h4><ul id="obs_11_0043__ul4348115485212"><li id="obs_11_0043__li034819548529">Windows<pre class="screen" id="obs_11_0043__screen15467124815533">obsutil sync obs://bucket[/key] folder_url [-tempFileDir=xxx] [-dryRun] [-vlength] [-vmd5] [-j=1] [-p=1] [-threshold=52428800] [-ps=auto] [-include=*.xxx] [-exclude=*.xxx] [-timeRange=time1-time2] [-mf] [-o=xxx] [-cpd=xxx] [-config=xxx] </pre>
</li><li id="obs_11_0043__li4476145885216">In Linux or macOS<pre class="screen" id="obs_11_0043__screen2398117135418">./obsutil sync obs://bucket[/key] folder_url [-tempFileDir=xxx] [-dryRun] [-vlength] [-vmd5] [-j=1] [-p=1] [-threshold=52428800] [-ps=auto] [-include=*.xxx] [-exclude=*.xxx] [-timeRange=time1-time2] [-mf] [-o=xxx] [-cpd=xxx] [-config=xxx] </pre> </li><li id="obs_11_0043__li4476145885216">macOS or Linux<pre class="screen" id="obs_11_0043__screen2398117135418">./obsutil sync obs://bucket[/key] folder_url [-tempFileDir=xxx] [-dryRun] [-vlength] [-vmd5] [-j=1] [-p=1] [-threshold=52428800] [-ps=auto] [-include=*.xxx] [-exclude=*.xxx] [-timeRange=time1-time2] [-mf] [-o=xxx] [-cpd=xxx] [-config=xxx] </pre>
</li></ul> </li></ul>
</div> </div>
<div class="section" id="obs_11_0043__section81156464394"><h4 class="sectiontitle">Examples</h4><ul id="obs_11_0043__ul311612462399"><li id="obs_11_0043__li12116194633912">Take the Windows OS as an example. Run the <strong id="obs_11_0043__b1837091253712">obsutil sync obs://bucket-test/temp d:\ temp</strong> command to download objects synchronously.<pre class="screen" id="obs_11_0043__screen211611462398"><strong id="obs_11_0043__b3116114613390">obsutil sync obs://bucket-test/temp <strong id="obs_11_0043__b41161246123920">d:\temp</strong></strong> <div class="section" id="obs_11_0043__section81156464394"><h4 class="sectiontitle">Examples</h4><ul id="obs_11_0043__ul311612462399"><li id="obs_11_0043__li12116194633912">In Windows, run <strong id="obs_11_0043__b1837091253712">obsutil sync obs://bucket-test/temp d:\temp</strong> to download objects synchronously.<pre class="screen" id="obs_11_0043__screen211611462398"><strong id="obs_11_0043__b3116114613390">obsutil sync obs://bucket-test/temp <strong id="obs_11_0043__b41161246123920">d:\temp</strong></strong>
Start at 2024-09-30 08:53:22.327072 +0000 UTC Start at 2024-09-30 08:53:22.327072 +0000 UTC
Parallel: 5 Jobs: 5 Parallel: 5 Jobs: 5
@ -138,7 +138,7 @@ Task id: 3066a4b0-4d21-4929-bb84-4829c32cbd0f</pre>
<td class="cellrowborder" valign="top" width="27%" headers="mcps1.3.4.2.1.4.1.2 "><p id="obs_11_0043__p19305175612615">Optional for downloading objects in batches (additional parameter)</p> <td class="cellrowborder" valign="top" width="27%" headers="mcps1.3.4.2.1.4.1.2 "><p id="obs_11_0043__p19305175612615">Optional for downloading objects in batches (additional parameter)</p>
</td> </td>
<td class="cellrowborder" valign="top" width="55.00000000000001%" headers="mcps1.3.4.2.1.4.1.3 "><p id="obs_11_0043__p17665114555311">The maximum number of concurrent tasks for downloading objects synchronously. The default value is the value of <strong id="obs_11_0043__b115503229418">defaultJobs</strong> in the configuration file.</p> <td class="cellrowborder" valign="top" width="55.00000000000001%" headers="mcps1.3.4.2.1.4.1.3 "><p id="obs_11_0043__p17665114555311">The maximum number of concurrent tasks for downloading objects synchronously. The default value is the value of <strong id="obs_11_0043__b115503229418">defaultJobs</strong> in the configuration file.</p>
<div class="note" id="obs_11_0043__note891964620819"><span class="notetitle"> NOTE: </span><div class="notebody"><p id="obs_11_0043__p1091964618820">The value is ensured to be greater than or equal to 1.</p> <div class="note" id="obs_11_0043__note891964620819"><span class="notetitle"> NOTE: </span><div class="notebody"><p id="obs_11_0043__p1091964618820">The tool ensures that this value is at least 1.</p>
</div></div> </div></div>
</td> </td>
</tr> </tr>
@ -149,7 +149,7 @@ Task id: 3066a4b0-4d21-4929-bb84-4829c32cbd0f</pre>
<td class="cellrowborder" valign="top" width="55.00000000000001%" headers="mcps1.3.4.2.1.4.1.3 "><p id="obs_11_0043__p16666614131519">The matching patterns of source objects that are excluded, for example: <strong id="obs_11_0043__b03706457276">*.txt</strong></p> <td class="cellrowborder" valign="top" width="55.00000000000001%" headers="mcps1.3.4.2.1.4.1.3 "><p id="obs_11_0043__p16666614131519">The matching patterns of source objects that are excluded, for example: <strong id="obs_11_0043__b03706457276">*.txt</strong></p>
<div class="note" id="obs_11_0043__note145284716208"><span class="notetitle"> NOTE: </span><div class="notebody"><ul id="obs_11_0043__ul05604713204"><li id="obs_11_0043__li14580477208">The asterisk (*) represents any group of characters, and the question mark (?) represents any single character. For instance, <strong id="obs_11_0043__b19823146112712">abc*.txt</strong> indicates any file whose name starts with <strong id="obs_11_0043__b18825846182714">abc</strong> and ends with <strong id="obs_11_0043__b882720465272">.txt</strong>.</li><li id="obs_11_0043__li13574453123410">You can use <strong id="obs_11_0043__b12211248182714">\*</strong> to represent <strong id="obs_11_0043__b1322234832717">*</strong> and <strong id="obs_11_0043__b1122311486272">\?</strong> to represent <strong id="obs_11_0043__b122416488276">?</strong>.</li><li id="obs_11_0043__li20603473203">If the name of the object to be downloaded matches the value of this parameter, the object is skipped.</li></ul> <div class="note" id="obs_11_0043__note145284716208"><span class="notetitle"> NOTE: </span><div class="notebody"><ul id="obs_11_0043__ul05604713204"><li id="obs_11_0043__li14580477208">The asterisk (*) represents any group of characters, and the question mark (?) represents any single character. For instance, <strong id="obs_11_0043__b19823146112712">abc*.txt</strong> indicates any file whose name starts with <strong id="obs_11_0043__b18825846182714">abc</strong> and ends with <strong id="obs_11_0043__b882720465272">.txt</strong>.</li><li id="obs_11_0043__li13574453123410">You can use <strong id="obs_11_0043__b12211248182714">\*</strong> to represent <strong id="obs_11_0043__b1322234832717">*</strong> and <strong id="obs_11_0043__b1122311486272">\?</strong> to represent <strong id="obs_11_0043__b122416488276">?</strong>.</li><li id="obs_11_0043__li20603473203">If the name of the object to be downloaded matches the value of this parameter, the object is skipped.</li></ul>
</div></div> </div></div>
<div class="notice" id="obs_11_0043__note179117549207"><span class="noticetitle"> NOTICE: </span><div class="noticebody"><ul id="obs_11_0043__ul877892116516"><li id="obs_11_0043__li1517310321518">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_0043__li1680132141116">The matching pattern applies to the absolute path of an object, including the object name prefix and object name starting from the root directory. For example, if the path of an object in the bucket is <strong id="obs_11_0043__b1479674314319">obs://bucket/src1/src2/test.txt</strong>, then the absolute path of the object is <strong id="obs_11_0043__b9796443123114">src1/src2/test.txt</strong>.</li><li id="obs_11_0043__li1148165015513">This matching pattern applies only to objects whose names do not end with a slash (/).</li><li id="obs_11_0043__li1124111373312">Multiple <strong id="obs_11_0043__b4384121575515">exclude</strong> parameters can be specified, for example, <strong id="obs_11_0043__b1338913153553">-exclude=*.xxx -exclude=*.xxx</strong>.</li></ul> <div class="notice" id="obs_11_0043__note179117549207"><span class="noticetitle"> NOTICE: </span><div class="noticebody"><ul id="obs_11_0043__ul877892116516"><li id="obs_11_0043__li1517310321518">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_0043__li1680132141116">The matching pattern applies to the object's absolute path, which includes the object name prefix and the object name starting from the root directory. For example, if an object's path in the bucket is <strong id="obs_11_0043__b209533572111">obs://bucket/src1/src2/test.txt</strong>, its absolute path is <strong id="obs_11_0043__b12953175711118">src1/src2/test.txt</strong>.</li><li id="obs_11_0043__li1148165015513">This matching pattern applies only to objects whose names do not end with a slash (/).</li><li id="obs_11_0043__li1124111373312">Multiple <strong id="obs_11_0043__b4384121575515">exclude</strong> parameters can be specified, for example, <strong id="obs_11_0043__b1338913153553">-exclude=*.xxx -exclude=*.xxx</strong>.</li></ul>
</div></div> </div></div>
</td> </td>
</tr> </tr>
@ -158,9 +158,9 @@ Task id: 3066a4b0-4d21-4929-bb84-4829c32cbd0f</pre>
<td class="cellrowborder" valign="top" width="27%" headers="mcps1.3.4.2.1.4.1.2 "><p id="obs_11_0043__p966784516533">Optional for downloading objects in batches (additional parameter)</p> <td class="cellrowborder" valign="top" width="27%" headers="mcps1.3.4.2.1.4.1.2 "><p id="obs_11_0043__p966784516533">Optional for downloading objects in batches (additional parameter)</p>
</td> </td>
<td class="cellrowborder" valign="top" width="55.00000000000001%" headers="mcps1.3.4.2.1.4.1.3 "><p id="obs_11_0043__p37071730153119">The matching patterns of source objects that are included, for example: <strong id="obs_11_0043__b153581454102715">*.jpg</strong></p> <td class="cellrowborder" valign="top" width="55.00000000000001%" headers="mcps1.3.4.2.1.4.1.3 "><p id="obs_11_0043__p37071730153119">The matching patterns of source objects that are included, for example: <strong id="obs_11_0043__b153581454102715">*.jpg</strong></p>
<div class="note" id="obs_11_0043__note195168716220"><span class="notetitle"> NOTE: </span><div class="notebody"><ul id="obs_11_0043__ul752013715229"><li id="obs_11_0043__li135211772221">The asterisk (*) represents any group of characters, and the question mark (?) represents any single character.</li><li id="obs_11_0043__li1342845173416">You can use <strong id="obs_11_0043__b11288574273">\*</strong> to represent <strong id="obs_11_0043__b7129257182719">*</strong> and <strong id="obs_11_0043__b11130757112717">\?</strong> to represent <strong id="obs_11_0043__b11314574274">?</strong>.</li><li id="obs_11_0043__li201739642420">Only after identifying that the name of the file to be downloaded does not match the value of <strong id="obs_11_0043__b517175915272">exclude</strong>, the system checks whether the file name matches the value of this parameter. If yes, the file is downloaded. If not, the file is skipped.</li></ul> <div class="note" id="obs_11_0043__note195168716220"><span class="notetitle"> NOTE: </span><div class="notebody"><ul id="obs_11_0043__ul752013715229"><li id="obs_11_0043__li135211772221">The asterisk (*) represents any group of characters, and the question mark (?) represents any single character.</li><li id="obs_11_0043__li1342845173416">You can use <strong id="obs_11_0043__b11288574273">\*</strong> to represent <strong id="obs_11_0043__b7129257182719">*</strong> and <strong id="obs_11_0043__b11130757112717">\?</strong> to represent <strong id="obs_11_0043__b11314574274">?</strong>.</li><li id="obs_11_0043__li201739642420">The <strong id="obs_11_0043__b23926249393">exclude</strong> rule is applied first. If the name of the object to be downloaded does not match the <strong id="obs_11_0043__b517175915272">exclude</strong> rule, the system then checks whether the object name matches this parameter. If it does, the object is downloaded; if it does not, the object is skipped.</li></ul>
</div></div> </div></div>
<div class="notice" id="obs_11_0043__note9270217202212"><span class="noticetitle"> NOTICE: </span><div class="noticebody"><ul id="obs_11_0043__ul14807204120586"><li id="obs_11_0043__li10807104116585">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_0043__li528018614113">The matching pattern applies to the absolute path of an object, including the object name prefix and object name starting from the root directory. For example, if the path of an object in the bucket is <strong id="obs_11_0043__b6347174663115">obs://bucket/src1/src2/test.txt</strong>, then the absolute path of the object is <strong id="obs_11_0043__b1834884613314">src1/src2/test.txt</strong>.</li><li id="obs_11_0043__li473346191110">This matching pattern applies only to objects whose names do not end with a slash (/).</li><li id="obs_11_0043__li16426817334">Multiple <strong id="obs_11_0043__b1336421675516">include</strong> parameters can be specified, for example, <strong id="obs_11_0043__b8364101614557">-include=*.xxx -include=*.xxx</strong>.</li></ul> <div class="notice" id="obs_11_0043__note9270217202212"><span class="noticetitle"> NOTICE: </span><div class="noticebody"><ul id="obs_11_0043__ul14807204120586"><li id="obs_11_0043__li10807104116585">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_0043__li528018614113">The matching pattern applies to the object's absolute path, which includes the object name prefix and the object name starting from the root directory. For example, if an object's path in the bucket is <strong id="obs_11_0043__b6347174663115">obs://bucket/src1/src2/test.txt</strong>, its absolute path is <strong id="obs_11_0043__b1834884613314">src1/src2/test.txt</strong>.</li><li id="obs_11_0043__li473346191110">This matching pattern applies only to objects whose names do not end with a slash (/).</li><li id="obs_11_0043__li16426817334">Multiple <strong id="obs_11_0043__b1336421675516">include</strong> parameters can be specified, for example, <strong id="obs_11_0043__b8364101614557">-include=*.xxx -include=*.xxx</strong>.</li></ul>
</div></div> </div></div>
</td> </td>
</tr> </tr>
@ -170,7 +170,7 @@ Task id: 3066a4b0-4d21-4929-bb84-4829c32cbd0f</pre>
</td> </td>
<td class="cellrowborder" valign="top" width="55.00000000000001%" headers="mcps1.3.4.2.1.4.1.3 "><p id="obs_11_0043__p16963940134813">The time range matching pattern when synchronously downloading objects. Only objects whose latest modification time is within the configured time range are downloaded.</p> <td class="cellrowborder" valign="top" width="55.00000000000001%" headers="mcps1.3.4.2.1.4.1.3 "><p id="obs_11_0043__p16963940134813">The time range matching pattern when synchronously downloading objects. Only objects whose latest modification time is within the configured time range are downloaded.</p>
<p id="obs_11_0043__p1754153575414">This pattern has a lower priority than the object matching patterns (<strong id="obs_11_0043__b445318471394">exclude</strong>/<strong id="obs_11_0043__b1454174713911">include</strong>). That is, the time range matching pattern is executed after the configured object matching patterns.</p> <p id="obs_11_0043__p1754153575414">This pattern has a lower priority than the object matching patterns (<strong id="obs_11_0043__b445318471394">exclude</strong>/<strong id="obs_11_0043__b1454174713911">include</strong>). That is, the time range matching pattern is executed after the configured object matching patterns.</p>
<div class="note" id="obs_11_0043__note8766915165919"><span class="notetitle"> NOTE: </span><div class="notebody"><ul id="obs_11_0043__ul19272430145915"><li id="obs_11_0043__li12731730115918">The matching time range is represented in <em id="obs_11_0043__i15681115018316">time1</em><strong id="obs_11_0043__b9682450123118">-</strong><em id="obs_11_0043__i1868365011310">time2</em>, where <em id="obs_11_0043__i868365012316">time1</em> must be earlier than or the same as <em id="obs_11_0043__i1683125018315">time2</em>. The time format is <em id="obs_11_0043__i11684650103114">yyyyMMddHHmmss</em>.</li><li id="obs_11_0043__li32731530185916">Automatic formatting is supported. For example, yyyyMMdd is equivalent to yyyyMMdd000000, and yyyyMM is equivalent to yyyyMM01000000.</li><li id="obs_11_0043__li5185481610">If this parameter is set to <strong id="obs_11_0043__b18160175318312">*-</strong><em id="obs_11_0043__i1516195343118">time2</em>, all files whose latest modification time is earlier than <em id="obs_11_0043__i1162155315316">time2</em> are matched. If it is set to <em id="obs_11_0043__i61625530319">time1</em><strong id="obs_11_0043__b191638533315">-*</strong>, all files whose latest modification time is later than <em id="obs_11_0043__i19163553203113">time1</em> are matched.</li></ul> <div class="note" id="obs_11_0043__note8766915165919"><span class="notetitle"> NOTE: </span><div class="notebody"><ul id="obs_11_0043__ul19272430145915"><li id="obs_11_0043__li12731730115918">The matching time range is represented in <em id="obs_11_0043__i15681115018316">time1</em><strong id="obs_11_0043__b9682450123118">-</strong><em id="obs_11_0043__i1868365011310">time2</em>, where <em id="obs_11_0043__i868365012316">time1</em> must be earlier than or the same as <em id="obs_11_0043__i1683125018315">time2</em>. The time format is <em id="obs_11_0043__i11684650103114">yyyyMMddHHmmss</em>.</li><li id="obs_11_0043__li32731530185916">Automatic formatting is supported. For example, yyyyMMdd is equivalent to yyyyMMdd000000, and yyyyMM is equivalent to yyyyMM01000000.</li><li id="obs_11_0043__li5185481610">If this parameter is set to <strong id="obs_11_0043__b1417302735519">*-</strong><em id="obs_11_0043__i41731427125514">time2</em>, all files whose last modification time is earlier than <em id="obs_11_0043__i15173727165517">time2</em> are matched. If it is set to <em id="obs_11_0043__i11731027145518">time1</em><strong id="obs_11_0043__b6173172765517">-*</strong>, all files whose last modification time is later than <em id="obs_11_0043__i151739272550">time1</em> are matched.</li></ul>
</div></div> </div></div>
<div class="notice" id="obs_11_0043__note1078981817591"><span class="noticetitle"> NOTICE: </span><div class="noticebody"><ul id="obs_11_0043__ul881073612597"><li id="obs_11_0043__li1740024105917">Time in the matching pattern is the UTC time.</li><li id="obs_11_0043__li58105368598">This matching pattern applies only to objects whose names do not end with a slash (/).</li></ul> <div class="notice" id="obs_11_0043__note1078981817591"><span class="noticetitle"> NOTICE: </span><div class="noticebody"><ul id="obs_11_0043__ul881073612597"><li id="obs_11_0043__li1740024105917">Time in the matching pattern is the UTC time.</li><li id="obs_11_0043__li58105368598">This matching pattern applies only to objects whose names do not end with a slash (/).</li></ul>
</div></div> </div></div>

20
docs/obs/tool-obsutil/obs_11_0044.html
View File

@ -6,13 +6,13 @@
<div class="notice" id="obs_11_0044__note780411406113"><span class="noticetitle"><img src="public_sys-resources/notice_3.0-en-us.png"> </span><div class="noticebody"><ul id="obs_11_0044__ul151501843918"><li id="obs_11_0044__li14647135493">Do not change the source objects in the OBS bucket when synchronously copying objects. Otherwise, the synchronization may fail or data may be inconsistent.</li><li id="obs_11_0044__li15737104113143">To copy objects, you must have the read permission on the objects to be copied and the write permission on the destination bucket.</li><li id="obs_11_0044__li824417525518">If the client-side cross-region replication function is not enabled, ensure that the source bucket and destination bucket are in the same region.</li><li id="obs_11_0044__li139841802014">Each object can be synchronously copied only when it does not exist in the destination bucket, its size is different from the namesake one in the destination bucket, or it has the latest modification time.</li><li id="obs_11_0044__li1820583712910">If the source bucket is a parallel file system (supporting POSIX), the destination bucket cannot be an object storage bucket.</li></ul> <div class="notice" id="obs_11_0044__note780411406113"><span class="noticetitle"><img src="public_sys-resources/notice_3.0-en-us.png"> </span><div class="noticebody"><ul id="obs_11_0044__ul151501843918"><li id="obs_11_0044__li14647135493">Do not change the source objects in the OBS bucket when synchronously copying objects. Otherwise, the synchronization may fail or data may be inconsistent.</li><li id="obs_11_0044__li15737104113143">To copy objects, you must have the read permission on the objects to be copied and the write permission on the destination bucket.</li><li id="obs_11_0044__li824417525518">If the client-side cross-region replication function is not enabled, ensure that the source bucket and destination bucket are in the same region.</li><li id="obs_11_0044__li139841802014">Each object can be synchronously copied only when it does not exist in the destination bucket, its size is different from the namesake one in the destination bucket, or it has the latest modification time.</li><li id="obs_11_0044__li1820583712910">If the source bucket is a parallel file system (supporting POSIX), the destination bucket cannot be an object storage bucket.</li></ul>
</div></div> </div></div>
</div> </div>
<div class="section" id="obs_11_0044__section49408320267"><h4 class="sectiontitle">Command Line Structure</h4><ul id="obs_11_0044__ul9634193211493"><li id="obs_11_0044__li1763473234917">In Windows<pre class="screen" id="obs_11_0044__screen15740822175019">obsutil sync obs://srcbucket[/key] obs://dstbucket[/dest] [-dryRun] [-crr] [-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> <div class="section" id="obs_11_0044__section49408320267"><h4 class="sectiontitle">Command Line Structure</h4><ul id="obs_11_0044__ul9634193211493"><li id="obs_11_0044__li1763473234917">Windows<pre class="screen" id="obs_11_0044__screen15740822175019">obsutil sync obs://srcbucket[/key] obs://dstbucket[/dest] [-dryRun] [-crr] [-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_0044__li245683714917">In Linux or macOS<pre class="screen" id="obs_11_0044__screen161391565118">./obsutil sync obs://srcbucket[/key] obs://dstbucket[/dest] [-dryRun] [-crr] [-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_0044__li245683714917">macOS or Linux<pre class="screen" id="obs_11_0044__screen161391565118">./obsutil sync obs://srcbucket[/key] obs://dstbucket[/dest] [-dryRun] [-crr] [-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></ul> </li></ul>
</div> </div>
<div class="note" id="obs_11_0044__note38181439115018"><img src="public_sys-resources/note_3.0-en-us.png"><span class="notetitle"> </span><div class="notebody"><p id="obs_11_0044__p8777123720618">The source path and destination path cannot be the same or nested when synchronously copying objects.</p> <div class="note" id="obs_11_0044__note38181439115018"><img src="public_sys-resources/note_3.0-en-us.png"><span class="notetitle"> </span><div class="notebody"><p id="obs_11_0044__p8777123720618">The source path and destination path cannot be the same or nested when synchronously copying objects.</p>
</div></div> </div></div>
<div class="section" id="obs_11_0044__section178241322153911"><h4 class="sectiontitle">Examples</h4><ul id="obs_11_0044__ul78241122143917"><li id="obs_11_0044__li1824192283914">Take the Windows OS as an example. Run the <strong id="obs_11_0044__b350045510522">obsutil sync obs://bucket-test/temp/ obs://bucket-test2/temp/</strong> command to synchronously copy objects.<pre class="screen" id="obs_11_0044__screen682472213914"><strong id="obs_11_0044__b98241922193910">obsutil sync obs://bucket-test/temp/ obs://bucket-test2/temp </strong> <div class="section" id="obs_11_0044__section178241322153911"><h4 class="sectiontitle">Examples</h4><ul id="obs_11_0044__ul78241122143917"><li id="obs_11_0044__li1824192283914">In Windows, run <strong id="obs_11_0044__b350045510522">obsutil sync obs://bucket-test/temp/ obs://bucket-test2/temp/</strong> to synchronously copy objects.<pre class="screen" id="obs_11_0044__screen682472213914"><strong id="obs_11_0044__b98241922193910">obsutil sync obs://bucket-test/temp/ obs://bucket-test2/temp </strong>
Start at 2024-09-25 04:48:10.1147483 +0000 UTC Start at 2024-09-25 04:48:10.1147483 +0000 UTC
@ -135,7 +135,7 @@ Task id: 0476929d-9d23-4dc5-b2f8-0a0493f027c5</pre>
</td> </td>
<td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.5.2.1.4.1.2 "><p id="obs_11_0044__p17648193011318">Optional (additional parameter)</p> <td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.5.2.1.4.1.2 "><p id="obs_11_0044__p17648193011318">Optional (additional parameter)</p>
</td> </td>
<td class="cellrowborder" valign="top" width="56.99999999999999%" headers="mcps1.3.5.2.1.4.1.3 "><p id="obs_11_0044__p16650163083117">The access control policies for destination objects that can be specified when copying objects. Possible values are:</p> <td class="cellrowborder" valign="top" width="56.99999999999999%" headers="mcps1.3.5.2.1.4.1.3 "><p id="obs_11_0044__p16650163083117">The access control policies for destination objects that can be specified when copying objects. The value can be:</p>
<ul id="obs_11_0044__ul0651183053115"><li id="obs_11_0044__li13652230153113">private</li><li id="obs_11_0044__li1965516308318">public-read</li><li id="obs_11_0044__li1265633023119">public-read-write</li><li id="obs_11_0044__li121231651135216">bucket-owner-full-control</li></ul> <ul id="obs_11_0044__ul0651183053115"><li id="obs_11_0044__li13652230153113">private</li><li id="obs_11_0044__li1965516308318">public-read</li><li id="obs_11_0044__li1265633023119">public-read-write</li><li id="obs_11_0044__li121231651135216">bucket-owner-full-control</li></ul>
<div class="note" id="obs_11_0044__note1790113183525"><span class="notetitle"> NOTE: </span><div class="notebody"><p id="obs_11_0044__p92982882916">The preceding four values indicate private read and write, public read, public read and write, and bucket owner full control.</p> <div class="note" id="obs_11_0044__note1790113183525"><span class="notetitle"> NOTE: </span><div class="notebody"><p id="obs_11_0044__p92982882916">The preceding four values indicate private read and write, public read, public read and write, and bucket owner full control.</p>
</div></div> </div></div>
@ -145,7 +145,7 @@ Task id: 0476929d-9d23-4dc5-b2f8-0a0493f027c5</pre>
</td> </td>
<td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.5.2.1.4.1.2 "><p id="obs_11_0044__p134681525175117">Optional (additional parameter)</p> <td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.5.2.1.4.1.2 "><p id="obs_11_0044__p134681525175117">Optional (additional parameter)</p>
</td> </td>
<td class="cellrowborder" valign="top" width="56.99999999999999%" headers="mcps1.3.5.2.1.4.1.3 "><p id="obs_11_0044__p04731025135114">The storage classes of the destination objects that can be specified when copying objects. Possible values are:</p> <td class="cellrowborder" valign="top" width="56.99999999999999%" headers="mcps1.3.5.2.1.4.1.3 "><p id="obs_11_0044__p04731025135114">The storage classes of the destination objects that can be specified when copying objects. The value can be:</p>
<ul id="obs_11_0044__ul175651814214"><li id="obs_11_0044__li1256512172114"><strong id="obs_11_0044__b2436182181114">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_0044__li10565181142113"><strong id="obs_11_0044__b1620415920355">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_0044__li756616110216"><strong id="obs_11_0044__b11137181216356">cold</strong>: Cold storage class. It provides secure, durable, and inexpensive storage for rarely-accessed (once a year) data.</li></ul> <ul id="obs_11_0044__ul175651814214"><li id="obs_11_0044__li1256512172114"><strong id="obs_11_0044__b2436182181114">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_0044__li10565181142113"><strong id="obs_11_0044__b1620415920355">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_0044__li756616110216"><strong id="obs_11_0044__b11137181216356">cold</strong>: Cold storage class. It provides secure, durable, and inexpensive storage for rarely-accessed (once a year) data.</li></ul>
</td> </td>
</tr> </tr>
@ -183,7 +183,7 @@ Task id: 0476929d-9d23-4dc5-b2f8-0a0493f027c5</pre>
<td class="cellrowborder" valign="top" width="56.99999999999999%" headers="mcps1.3.5.2.1.4.1.3 "><p id="obs_11_0044__p4699130153112">The maximum number of concurrent tasks for copying objects synchronously. The default value is the value of <strong id="obs_11_0044__b115698204458">defaultJobs</strong> in the configuration file.</p> <td class="cellrowborder" valign="top" width="56.99999999999999%" headers="mcps1.3.5.2.1.4.1.3 "><p id="obs_11_0044__p4699130153112">The maximum number of concurrent tasks for copying objects synchronously. The default value is the value of <strong id="obs_11_0044__b115698204458">defaultJobs</strong> in the configuration file.</p>
<div class="caution" id="obs_11_0044__note793663513401"><span class="cautiontitle"> CAUTION: </span><div class="cautionbody"><p id="obs_11_0044__obs_11_0017_p1383211014413_1">For an inter-bucket replication task that does not include the <strong id="obs_11_0044__obs_11_0017_b4449164054017_1">crr</strong> parameter, the maximum allowable value for this parameter is 10,000.</p> <div class="caution" id="obs_11_0044__note793663513401"><span class="cautiontitle"> CAUTION: </span><div class="cautionbody"><p id="obs_11_0044__obs_11_0017_p1383211014413_1">For an inter-bucket replication task that does not include the <strong id="obs_11_0044__obs_11_0017_b4449164054017_1">crr</strong> parameter, the maximum allowable value for this parameter is 10,000.</p>
</div></div> </div></div>
<div class="note" id="obs_11_0044__note891964620819"><span class="notetitle"> NOTE: </span><div class="notebody"><p id="obs_11_0044__p1091964618820">The value is ensured to be greater than or equal to 1.</p> <div class="note" id="obs_11_0044__note891964620819"><span class="notetitle"> NOTE: </span><div class="notebody"><p id="obs_11_0044__p1091964618820">The tool ensures that this value is at least 1.</p>
</div></div> </div></div>
</td> </td>
</tr> </tr>
@ -194,7 +194,7 @@ Task id: 0476929d-9d23-4dc5-b2f8-0a0493f027c5</pre>
<td class="cellrowborder" valign="top" width="56.99999999999999%" headers="mcps1.3.5.2.1.4.1.3 "><p id="obs_11_0044__p16666614131519">The matching patterns of source objects that are excluded, for example, <strong id="obs_11_0044__b159651549158">*.txt</strong></p> <td class="cellrowborder" valign="top" width="56.99999999999999%" headers="mcps1.3.5.2.1.4.1.3 "><p id="obs_11_0044__p16666614131519">The matching patterns of source objects that are excluded, for example, <strong id="obs_11_0044__b159651549158">*.txt</strong></p>
<div class="note" id="obs_11_0044__note145284716208"><span class="notetitle"> NOTE: </span><div class="notebody"><ul id="obs_11_0044__ul05604713204"><li id="obs_11_0044__li14580477208">The asterisk (*) represents any group of characters, and the question mark (?) represents any single character. For instance, <strong id="obs_11_0044__b220217189286">abc*.txt</strong> indicates any file whose name starts with <strong id="obs_11_0044__b192030188286">abc</strong> and ends with <strong id="obs_11_0044__b19205318162818">.txt</strong>.</li><li id="obs_11_0044__li134314014354">You can use <strong id="obs_11_0044__b95182011288">\*</strong> to represent <strong id="obs_11_0044__b86520152817">*</strong> and <strong id="obs_11_0044__b147122092814">\?</strong> to represent <strong id="obs_11_0044__b168122032817">?</strong>.</li><li id="obs_11_0044__li20603473203">If the name of the object to be copied matches the value of this parameter, the object is skipped.</li></ul> <div class="note" id="obs_11_0044__note145284716208"><span class="notetitle"> NOTE: </span><div class="notebody"><ul id="obs_11_0044__ul05604713204"><li id="obs_11_0044__li14580477208">The asterisk (*) represents any group of characters, and the question mark (?) represents any single character. For instance, <strong id="obs_11_0044__b220217189286">abc*.txt</strong> indicates any file whose name starts with <strong id="obs_11_0044__b192030188286">abc</strong> and ends with <strong id="obs_11_0044__b19205318162818">.txt</strong>.</li><li id="obs_11_0044__li134314014354">You can use <strong id="obs_11_0044__b95182011288">\*</strong> to represent <strong id="obs_11_0044__b86520152817">*</strong> and <strong id="obs_11_0044__b147122092814">\?</strong> to represent <strong id="obs_11_0044__b168122032817">?</strong>.</li><li id="obs_11_0044__li20603473203">If the name of the object to be copied matches the value of this parameter, the object is skipped.</li></ul>
</div></div> </div></div>
<div class="notice" id="obs_11_0044__note179117549207"><span class="noticetitle"> NOTICE: </span><div class="noticebody"><ul id="obs_11_0044__ul877892116516"><li id="obs_11_0044__li1517310321518">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_0044__li15611821151118">The matching pattern applies to the absolute path of an object, including the object name prefix and object name starting from the root directory. For example, if the path of an object in the bucket is <strong id="obs_11_0044__b12122835326">obs://bucket/src1/src2/test.txt</strong>, then the absolute path of the object is <strong id="obs_11_0044__b6123739322">src1/src2/test.txt</strong>.</li><li id="obs_11_0044__li1148165015513">This matching pattern applies only to objects whose names do not end with a slash (/).</li><li id="obs_11_0044__li7368540203215">Multiple <strong id="obs_11_0044__b95159411551">exclude</strong> parameters can be specified, for example, <strong id="obs_11_0044__b1752034115513">-exclude=*.xxx -exclude=*.xxx</strong>.</li></ul> <div class="notice" id="obs_11_0044__note179117549207"><span class="noticetitle"> NOTICE: </span><div class="noticebody"><ul id="obs_11_0044__ul877892116516"><li id="obs_11_0044__li1517310321518">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_0044__li15611821151118">The matching pattern applies to the object's absolute path, which includes the object name prefix and the object name starting from the root directory. For example, if an object's path in the bucket is <strong id="obs_11_0044__b163561412121">obs://bucket/src1/src2/test.txt</strong>, its absolute path is <strong id="obs_11_0044__b16357312321">src1/src2/test.txt</strong>.</li><li id="obs_11_0044__li1148165015513">This matching pattern applies only to objects whose names do not end with a slash (/).</li><li id="obs_11_0044__li7368540203215">Multiple <strong id="obs_11_0044__b95159411551">exclude</strong> parameters can be specified, for example, <strong id="obs_11_0044__b1752034115513">-exclude=*.xxx -exclude=*.xxx</strong>.</li></ul>
</div></div> </div></div>
</td> </td>
</tr> </tr>
@ -203,9 +203,9 @@ Task id: 0476929d-9d23-4dc5-b2f8-0a0493f027c5</pre>
<td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.5.2.1.4.1.2 "><p id="obs_11_0044__p470523013527">Optional for copying objects in batches (additional parameter)</p> <td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.5.2.1.4.1.2 "><p id="obs_11_0044__p470523013527">Optional for copying objects in batches (additional parameter)</p>
</td> </td>
<td class="cellrowborder" valign="top" width="56.99999999999999%" headers="mcps1.3.5.2.1.4.1.3 "><p id="obs_11_0044__p37071730153119">The matching patterns of source objects that are included, for example: <strong id="obs_11_0044__b1215311571453">*.jpg</strong></p> <td class="cellrowborder" valign="top" width="56.99999999999999%" headers="mcps1.3.5.2.1.4.1.3 "><p id="obs_11_0044__p37071730153119">The matching patterns of source objects that are included, for example: <strong id="obs_11_0044__b1215311571453">*.jpg</strong></p>
<div class="note" id="obs_11_0044__note195168716220"><span class="notetitle"> NOTE: </span><div class="notebody"><ul id="obs_11_0044__ul752013715229"><li id="obs_11_0044__li135211772221">The asterisk (*) represents any group of characters, and the question mark (?) represents any single character.</li><li id="obs_11_0044__li123514283516">You can use <strong id="obs_11_0044__b1977422872810">\*</strong> to represent <strong id="obs_11_0044__b18775192812287">*</strong> and <strong id="obs_11_0044__b1277872813288">\?</strong> to represent <strong id="obs_11_0044__b977972862815">?</strong>.</li><li id="obs_11_0044__li16523871227">Only after identifying that the name of the file to be copied does not match the value of <strong id="obs_11_0044__b186317308287">exclude</strong>, the system checks whether the file name matches the value of this parameter. If yes, the file is copied. If not, the file is skipped.</li></ul> <div class="note" id="obs_11_0044__note195168716220"><span class="notetitle"> NOTE: </span><div class="notebody"><ul id="obs_11_0044__ul752013715229"><li id="obs_11_0044__li135211772221">The asterisk (*) represents any group of characters, and the question mark (?) represents any single character.</li><li id="obs_11_0044__li123514283516">You can use <strong id="obs_11_0044__b1977422872810">\*</strong> to represent <strong id="obs_11_0044__b18775192812287">*</strong> and <strong id="obs_11_0044__b1277872813288">\?</strong> to represent <strong id="obs_11_0044__b977972862815">?</strong>.</li><li id="obs_11_0044__li16523871227">The <strong id="obs_11_0044__b1841104119124">exclude</strong> rule is applied first. If the name of the object to be copied does not match the <strong id="obs_11_0044__b168416417123">exclude</strong> rule, the system then checks whether the object name matches this parameter. If it does, the object is copied. If it does not, the object is skipped.</li></ul>
</div></div> </div></div>
<div class="notice" id="obs_11_0044__note9270217202212"><span class="noticetitle"> NOTICE: </span><div class="noticebody"><ul id="obs_11_0044__ul9325145114588"><li id="obs_11_0044__li4325205125816">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_0044__li1047272541110">The matching pattern applies to the absolute path of an object, including the object name prefix and object name starting from the root directory. For example, if the path of an object in the bucket is <strong id="obs_11_0044__b17251611324">obs://bucket/src1/src2/test.txt</strong>, then the absolute path of the object is <strong id="obs_11_0044__b107268673215">src1/src2/test.txt</strong>.</li><li id="obs_11_0044__li4784268114">This matching pattern applies only to objects whose names do not end with a slash (/).</li><li id="obs_11_0044__li165858463328">Multiple <strong id="obs_11_0044__b250612515552">include</strong> parameters can be specified, for example, <strong id="obs_11_0044__b450611585517">-include=*.xxx -include=*.xxx</strong>.</li></ul> <div class="notice" id="obs_11_0044__note9270217202212"><span class="noticetitle"> NOTICE: </span><div class="noticebody"><ul id="obs_11_0044__ul9325145114588"><li id="obs_11_0044__li4325205125816">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_0044__li1047272541110">The matching pattern applies to the object's absolute path, which includes the object name prefix and the object name starting from the root directory. For example, if an object's path in the bucket is <strong id="obs_11_0044__b132374176211">obs://bucket/src1/src2/test.txt</strong>, its absolute path is <strong id="obs_11_0044__b142371178210">src1/src2/test.txt</strong>.</li><li id="obs_11_0044__li4784268114">This matching pattern applies only to objects whose names do not end with a slash (/).</li><li id="obs_11_0044__li165858463328">Multiple <strong id="obs_11_0044__b250612515552">include</strong> parameters can be specified, for example, <strong id="obs_11_0044__b450611585517">-include=*.xxx -include=*.xxx</strong>.</li></ul>
</div></div> </div></div>
</td> </td>
</tr> </tr>
@ -215,7 +215,7 @@ Task id: 0476929d-9d23-4dc5-b2f8-0a0493f027c5</pre>
</td> </td>
<td class="cellrowborder" valign="top" width="56.99999999999999%" headers="mcps1.3.5.2.1.4.1.3 "><p id="obs_11_0044__p16963940134813">The time range matching pattern when synchronously copying objects. Only objects whose latest modification time is within the configured time range are copied.</p> <td class="cellrowborder" valign="top" width="56.99999999999999%" headers="mcps1.3.5.2.1.4.1.3 "><p id="obs_11_0044__p16963940134813">The time range matching pattern when synchronously copying objects. Only objects whose latest modification time is within the configured time range are copied.</p>
<p id="obs_11_0044__p25091509569">This pattern has a lower priority than the object matching patterns (<strong id="obs_11_0044__b7671911151012">exclude</strong>/<strong id="obs_11_0044__b468411121013">include</strong>). That is, the time range matching pattern is executed after the configured object matching patterns.</p> <p id="obs_11_0044__p25091509569">This pattern has a lower priority than the object matching patterns (<strong id="obs_11_0044__b7671911151012">exclude</strong>/<strong id="obs_11_0044__b468411121013">include</strong>). That is, the time range matching pattern is executed after the configured object matching patterns.</p>
<div class="note" id="obs_11_0044__note8766915165919"><span class="notetitle"> NOTE: </span><div class="notebody"><ul id="obs_11_0044__ul19272430145915"><li id="obs_11_0044__li12731730115918">The matching time range is represented in <em id="obs_11_0044__i1365769183212">time1</em><strong id="obs_11_0044__b10657499328">-</strong><em id="obs_11_0044__i19658169163210">time2</em>, where <em id="obs_11_0044__i18659119103217">time1</em> must be earlier than or the same as <em id="obs_11_0044__i965919973214">time2</em>. The time format is <em id="obs_11_0044__i465920913326">yyyyMMddHHmmss</em>.</li><li id="obs_11_0044__li32731530185916">Automatic formatting is supported. For example, yyyyMMdd is equivalent to yyyyMMdd000000, and yyyyMM is equivalent to yyyyMM01000000.</li><li id="obs_11_0044__li5185481610">If this parameter is set to <strong id="obs_11_0044__b02567127325">*-</strong><em id="obs_11_0044__i72561112163215">time2</em>, all files whose latest modification time is earlier than <em id="obs_11_0044__i1925721243219">time2</em> are matched. If it is set to <em id="obs_11_0044__i8257151253218">time1</em><strong id="obs_11_0044__b6258312123215">-*</strong>, all files whose latest modification time is later than <em id="obs_11_0044__i2025821253216">time1</em> are matched.</li></ul> <div class="note" id="obs_11_0044__note8766915165919"><span class="notetitle"> NOTE: </span><div class="notebody"><ul id="obs_11_0044__ul19272430145915"><li id="obs_11_0044__li12731730115918">The matching time range is represented in <em id="obs_11_0044__i1365769183212">time1</em><strong id="obs_11_0044__b10657499328">-</strong><em id="obs_11_0044__i19658169163210">time2</em>, where <em id="obs_11_0044__i18659119103217">time1</em> must be earlier than or the same as <em id="obs_11_0044__i965919973214">time2</em>. The time format is <em id="obs_11_0044__i465920913326">yyyyMMddHHmmss</em>.</li><li id="obs_11_0044__li32731530185916">Automatic formatting is supported. For example, yyyyMMdd is equivalent to yyyyMMdd000000, and yyyyMM is equivalent to yyyyMM01000000.</li><li id="obs_11_0044__li5185481610">If this parameter is set to <strong id="obs_11_0044__b82593619555">*-</strong><em id="obs_11_0044__i12261236195516">time2</em>, all files whose last modification time is earlier than <em id="obs_11_0044__i182612361553">time2</em> are matched. If it is set to <em id="obs_11_0044__i16261936165514">time1</em><strong id="obs_11_0044__b726163616554">-*</strong>, all files whose last modification time is later than <em id="obs_11_0044__i1926203611554">time1</em> are matched.</li></ul>
</div></div> </div></div>
<div class="notice" id="obs_11_0044__note1078981817591"><span class="noticetitle"> NOTICE: </span><div class="noticebody"><ul id="obs_11_0044__ul881073612597"><li id="obs_11_0044__li1740024105917">Time in the matching pattern is the UTC time.</li><li id="obs_11_0044__li58105368598">This matching pattern applies only to objects whose names do not end with a slash (/).</li></ul> <div class="notice" id="obs_11_0044__note1078981817591"><span class="noticetitle"> NOTICE: </span><div class="noticebody"><ul id="obs_11_0044__ul881073612597"><li id="obs_11_0044__li1740024105917">Time in the matching pattern is the UTC time.</li><li id="obs_11_0044__li58105368598">This matching pattern applies only to objects whose names do not end with a slash (/).</li></ul>
</div></div> </div></div>

6
docs/obs/tool-obsutil/obs_11_0045.html
View File

@ -3,15 +3,15 @@
<h1 class="topictitle1">Archiving Log Files</h1> <h1 class="topictitle1">Archiving Log Files</h1>
<div id="body1547106819232"><div class="section" id="obs_11_0045__section1479112110815"><h4 class="sectiontitle">Function</h4><p id="obs_11_0045__p11772825481">You can use this command to archive log files to a local PC or to a specified bucket.</p> <div id="body1547106819232"><div class="section" id="obs_11_0045__section1479112110815"><h4 class="sectiontitle">Function</h4><p id="obs_11_0045__p11772825481">You can use this command to archive log files to a local PC or to a specified bucket.</p>
</div> </div>
<div class="section" id="obs_11_0045__section1220752192216"><h4 class="sectiontitle">Command Line Structure</h4><ul id="obs_11_0045__ul10922428121013"><li id="obs_11_0045__li79221528121010">In Windows<ul id="obs_11_0045__ul48751720253"><li id="obs_11_0045__li1012518598242">Archiving to a local PC<pre class="screen" id="obs_11_0045__screen10125859132415">obsutil archive [file_or_folder_url] [-config=xxx] </pre> <div class="section" id="obs_11_0045__section1220752192216"><h4 class="sectiontitle">Command Line Structure</h4><ul id="obs_11_0045__ul10922428121013"><li id="obs_11_0045__li79221528121010">Windows<ul id="obs_11_0045__ul48751720253"><li id="obs_11_0045__li1012518598242">Archiving to a local PC<pre class="screen" id="obs_11_0045__screen10125859132415">obsutil archive [file_or_folder_url] [-config=xxx] </pre>
</li><li id="obs_11_0045__li162401213162513">Archiving to a specified bucket<pre class="screen" id="obs_11_0045__screen13477182952517">obsutil archive obs://bucket[/key] [-config=xxx] </pre> </li><li id="obs_11_0045__li162401213162513">Archiving to a specified bucket<pre class="screen" id="obs_11_0045__screen13477182952517">obsutil archive obs://bucket[/key] [-config=xxx] </pre>
</li></ul> </li></ul>
</li><li id="obs_11_0045__li106087324101">In Linux or macOS<ul id="obs_11_0045__ul540412358913"><li id="obs_11_0045__li12404163514917">Archiving to a local PC<pre class="screen" id="obs_11_0045__screen204052351997">obsutil archive [file_or_folder_url] [-config=xxx] </pre> </li><li id="obs_11_0045__li106087324101">macOS or Linux<ul id="obs_11_0045__ul540412358913"><li id="obs_11_0045__li12404163514917">Archiving to a local PC<pre class="screen" id="obs_11_0045__screen204052351997">obsutil archive [file_or_folder_url] [-config=xxx] </pre>
</li><li id="obs_11_0045__li040683511913">Archiving to a specified bucket<pre class="screen" id="obs_11_0045__screen740612351992">obsutil archive obs://bucket[/key] [-config=xxx] </pre> </li><li id="obs_11_0045__li040683511913">Archiving to a specified bucket<pre class="screen" id="obs_11_0045__screen740612351992">obsutil archive obs://bucket[/key] [-config=xxx] </pre>
</li></ul> </li></ul>
</li></ul> </li></ul>
</div> </div>
<div class="section" id="obs_11_0045__section148621021184511"><h4 class="sectiontitle">Examples</h4><ul id="obs_11_0045__ul12862192116453"><li id="obs_11_0045__li886242124513">Take the Windows OS as an example. Run the <strong id="obs_11_0045__b369616289395">obsutil archive</strong> command to archive log files to the same directory where the tool is executed.<pre class="screen" id="obs_11_0045__screen9862132144515"><strong id="obs_11_0045__b6862142115450">obsutil <strong id="obs_11_0045__b78628212456">archive</strong></strong> <div class="section" id="obs_11_0045__section148621021184511"><h4 class="sectiontitle">Examples</h4><ul id="obs_11_0045__ul12862192116453"><li id="obs_11_0045__li886242124513">In Windows, run <strong id="obs_11_0045__b369616289395">obsutil archive</strong> to archive log files to the same directory where the tool is executed.<pre class="screen" id="obs_11_0045__screen9862132144515"><strong id="obs_11_0045__b6862142115450">obsutil <strong id="obs_11_0045__b78628212456">archive</strong></strong>
[----------------------------------------------------------] 100.00% 15/15 35ms [----------------------------------------------------------] 100.00% 15/15 35ms
Succeed to archive log files to [D:\obsutil\obsutil_log.zip]</pre> Succeed to archive log files to [D:\obsutil\obsutil_log.zip]</pre>

4
docs/obs/tool-obsutil/obs_11_0046.html
View File

@ -15,14 +15,14 @@ obs://bucket-test/src1/src2/
obs://bucket-test/src1/src2/test1.txt obs://bucket-test/src1/src2/test1.txt
obs://bucket-test/src1/src3/</pre> obs://bucket-test/src1/src3/</pre>
<p id="obs_11_0046__p515421611454">Based on the structure of the preceding local folder and objects in the bucket, different synchronous upload scenarios require different commands.</p> <p id="obs_11_0046__p515421611454">Based on the structure of the preceding local folder and objects in the bucket, different synchronous upload scenarios require different commands.</p>
<ul id="obs_11_0046__ul20301195665415"><li id="obs_11_0046__li1430185695420">To synchronize the <strong id="obs_11_0046__b3966315103415">test3.txt</strong> file in the local <strong id="obs_11_0046__b496651513345">src1</strong> folder to the root directory of bucket <strong id="obs_11_0046__b6967191523418">bucket-test</strong>, the command is as follows:<pre class="screen" id="obs_11_0046__screen27011879554">./obsutil sync /src1/test3.txt obs://bucket-test</pre> <ul id="obs_11_0046__ul20301195665415"><li id="obs_11_0046__li1430185695420">To synchronize the <strong id="obs_11_0046__b3966315103415">test3.txt</strong> file from the local <strong id="obs_11_0046__b496651513345">src1</strong> folder to the root directory of the <strong id="obs_11_0046__b6967191523418">bucket-test</strong> bucket, use the following command:<pre class="screen" id="obs_11_0046__screen27011879554">./obsutil sync /src1/test3.txt obs://bucket-test</pre>
<p id="obs_11_0046__p8859716195520">After the synchronization is successful, the <strong id="obs_11_0046__b18473175185612">test3.txt</strong> file is directly uploaded to the bucket because there is no <strong id="obs_11_0046__b13839164763610">test3.txt</strong> in bucket <strong id="obs_11_0046__b185541919165513">bucket-test</strong>. Then, objects in the bucket are as follows:</p> <p id="obs_11_0046__p8859716195520">After the synchronization is successful, the <strong id="obs_11_0046__b18473175185612">test3.txt</strong> file is directly uploaded to the bucket because there is no <strong id="obs_11_0046__b13839164763610">test3.txt</strong> in bucket <strong id="obs_11_0046__b185541919165513">bucket-test</strong>. Then, objects in the bucket are as follows:</p>
<pre class="screen" id="obs_11_0046__screen1677410173567">obs://bucket-test/test3.txt <pre class="screen" id="obs_11_0046__screen1677410173567">obs://bucket-test/test3.txt
obs://bucket-test/src1/ obs://bucket-test/src1/
obs://bucket-test/src1/src2/ obs://bucket-test/src1/src2/
obs://bucket-test/src1/src2/test1.txt obs://bucket-test/src1/src2/test1.txt
obs://bucket-test/src1/src3/</pre> obs://bucket-test/src1/src3/</pre>
</li><li id="obs_11_0046__li18460634165719">To synchronize all files and subfolders in the local <strong id="obs_11_0046__b951055515375">src1</strong> folder to the <strong id="obs_11_0046__b12511105512370">src1</strong> folder in bucket <strong id="obs_11_0046__b251215543718">bucket-test</strong>, the command is as follows:<pre class="screen" id="obs_11_0046__screen31021421101319">./obsutil sync /src1 obs://bucket-test/src1</pre> </li><li id="obs_11_0046__li18460634165719">To synchronize all files and subfolders from the local <strong id="obs_11_0046__b951055515375">src1</strong> folder to the <strong id="obs_11_0046__b12511105512370">src1</strong> folder in the <strong id="obs_11_0046__b251215543718">bucket-test</strong> bucket, use the following command:<pre class="screen" id="obs_11_0046__screen31021421101319">./obsutil sync /src1 obs://bucket-test/src1</pre>
<p id="obs_11_0046__p176731231101315">After the synchronization, the objects in the bucket are as follows:</p> <p id="obs_11_0046__p176731231101315">After the synchronization, the objects in the bucket are as follows:</p>
<pre class="screen" id="obs_11_0046__screen981772017300">obs://bucket-test/src1/ <pre class="screen" id="obs_11_0046__screen981772017300">obs://bucket-test/src1/
obs://bucket-test/src1/test3.txt obs://bucket-test/src1/test3.txt

2
docs/obs/tool-obsutil/obs_11_0047.html
View File

@ -13,7 +13,7 @@ obs://bucket-test/src1/src3/</pre>
<pre class="screen" id="obs_11_0047__screen1426863513468"><span style="color:#666600;">└──</span> src1 <pre class="screen" id="obs_11_0047__screen1426863513468"><span style="color:#666600;">└──</span> src1
<span style="color:#666600;">└──</span> test3.txt</pre> <span style="color:#666600;">└──</span> test3.txt</pre>
<p id="obs_11_0047__p72561242278">Based on the structure of the preceding local folder and objects in the bucket, different synchronous download scenarios require different commands.</p> <p id="obs_11_0047__p72561242278">Based on the structure of the preceding local folder and objects in the bucket, different synchronous download scenarios require different commands.</p>
<ul id="obs_11_0047__ul174731818476"><li id="obs_11_0047__li14521165111157">To synchronize all files and subfolders in the <strong id="obs_11_0047__b2043881188">src1</strong> folder in bucket <strong id="obs_11_0047__b172192017141115">bucket-test</strong> to the local <strong id="obs_11_0047__b129842841012">src1</strong> folder, the command is as follows:<pre class="screen" id="obs_11_0047__screen129934416261">./obsutil sync obs://bucket-test/src1 /src1</pre> <ul id="obs_11_0047__ul174731818476"><li id="obs_11_0047__li14521165111157">To synchronize all files and subfolders from the <strong id="obs_11_0047__b2043881188">src1</strong> folder in the <strong id="obs_11_0047__b172192017141115">bucket-test</strong> bucket to the local <strong id="obs_11_0047__b129842841012">src1</strong> folder, use the following command:<pre class="screen" id="obs_11_0047__screen129934416261">./obsutil sync obs://bucket-test/src1 /src1</pre>
<p id="obs_11_0047__p463863152617">After the synchronization is successful, the following files are generated in the local <strong id="obs_11_0047__b16868112017213">src1</strong> folder:</p> <p id="obs_11_0047__p463863152617">After the synchronization is successful, the following files are generated in the local <strong id="obs_11_0047__b16868112017213">src1</strong> folder:</p>
<pre class="screen" id="obs_11_0047__screen116391731192616"><span style="color:#666600;">└──</span> src1 <pre class="screen" id="obs_11_0047__screen116391731192616"><span style="color:#666600;">└──</span> src1
<span style="color:#666600;"> ├──</span> src2 <span style="color:#666600;"> ├──</span> src2

2
docs/obs/tool-obsutil/obs_11_0048.html
View File

@ -13,7 +13,7 @@ obs://bucket-src/src1/src3/</pre>
<pre class="screen" id="obs_11_0048__screen17712582343">obs://bucket-dest/src1/ <pre class="screen" id="obs_11_0048__screen17712582343">obs://bucket-dest/src1/
obs://bucket-dest/src1/test3.txt</pre> obs://bucket-dest/src1/test3.txt</pre>
<p id="obs_11_0048__p14551164724818">Based on the structure of objects in the bucket, different synchronous copy scenarios require different commands.</p> <p id="obs_11_0048__p14551164724818">Based on the structure of objects in the bucket, different synchronous copy scenarios require different commands.</p>
<ul id="obs_11_0048__ul174731818476"><li id="obs_11_0048__li1334253834912">To synchronize all files and subfolders in the <strong id="obs_11_0048__b14187936135210">src1</strong> folder in bucket <strong id="obs_11_0048__b55916925610">bucket-src</strong> to the <strong id="obs_11_0048__b3191173611521">src1</strong> folder in bucket <strong id="obs_11_0048__b141941436185213">bucket-dest</strong>, the command is as follows:<pre class="screen" id="obs_11_0048__screen1142954715014">./obsutil sync obs://bucket-src/src1 obs://bucket-dest/src1</pre> <ul id="obs_11_0048__ul174731818476"><li id="obs_11_0048__li1334253834912">To synchronize all files and subfolders from the <strong id="obs_11_0048__b14187936135210">src1</strong> folder in the <strong id="obs_11_0048__b55916925610">bucket-src</strong> bucket to the <strong id="obs_11_0048__b3191173611521">src1</strong> folder in the <strong id="obs_11_0048__b141941436185213">bucket-dest</strong> bucket, use the following command:<pre class="screen" id="obs_11_0048__screen1142954715014">./obsutil sync obs://bucket-src/src1 obs://bucket-dest/src1</pre>
<p id="obs_11_0048__p161831438155020">After the synchronous copy is complete, the objects in the destination bucket <strong id="obs_11_0048__b156251325115819">bucket-dest</strong> are as follows:</p> <p id="obs_11_0048__p161831438155020">After the synchronous copy is complete, the objects in the destination bucket <strong id="obs_11_0048__b156251325115819">bucket-dest</strong> are as follows:</p>
<pre class="screen" id="obs_11_0048__screen1918316382507">obs://bucket-dest/src1/ <pre class="screen" id="obs_11_0048__screen1918316382507">obs://bucket-dest/src1/
obs://bucket-dest/src1/test3.txt obs://bucket-dest/src1/test3.txt

8
docs/obs/tool-obsutil/obs_11_0049.html
View File

@ -17,21 +17,21 @@
</div></div> </div></div>
</p></li><li id="obs_11_0049__li57391361817"><span>Copy the obsutil tool to the directory created in step 1 and change its permission to <strong id="obs_11_0049__b96881334165113">711</strong>. Assume that the original path of the tool is <strong id="obs_11_0049__b16451471414">/home/test/obsutil</strong>. Run the following command:</span><p><pre class="screen" id="obs_11_0049__screen43656570210">cp /home/test/obsutil /obsutil </p></li><li id="obs_11_0049__li57391361817"><span>Copy the obsutil tool to the directory created in step 1 and change its permission to <strong id="obs_11_0049__b96881334165113">711</strong>. Assume that the original path of the tool is <strong id="obs_11_0049__b16451471414">/home/test/obsutil</strong>. Run the following command:</span><p><pre class="screen" id="obs_11_0049__screen43656570210">cp /home/test/obsutil /obsutil
chmod 711 /obsutil/obsutil</pre> chmod 711 /obsutil/obsutil</pre>
</p></li><li id="obs_11_0049__li1499171422317"><span>Run the <strong id="obs_11_0049__b134594446272">vi /etc/profile</strong> command, type <strong id="obs_11_0049__b1935783710216">i</strong> to enter the Insert mode to edit the file. Add <strong id="obs_11_0049__b1520019587301">export PATH=$PATH:/obsutil</strong> at the end of the file. Then press <strong id="obs_11_0049__b3361561141">ESC</strong> to exit the editing mode, and then type <strong id="obs_11_0049__b136181711173110">:wq!</strong> and press <strong id="obs_11_0049__b5949184119233">Enter</strong> to save the file and exit.</span><p><div class="note" id="obs_11_0049__note1422133312318"><img src="public_sys-resources/note_3.0-en-us.png"><span class="notetitle"> </span><div class="notebody"><p id="obs_11_0049__p187991326332">Skip this step if the new line already exists in the <strong id="obs_11_0049__b1923521101215">/etc/profile</strong> file.</p> </p></li><li id="obs_11_0049__li1499171422317"><span>Run the <strong id="obs_11_0049__b134594446272">vi /etc/profile</strong> command. Press <strong id="obs_11_0049__b1935783710216">i</strong> to enter the Insert mode and add <strong id="obs_11_0049__b1520019587301">export PATH=$PATH:/obsutil</strong> at the end of the file. Then press <strong id="obs_11_0049__b3361561141">Esc</strong> to exit the editing mode and type <strong id="obs_11_0049__b136181711173110">:wq!</strong> and press <strong id="obs_11_0049__b5949184119233">Enter</strong> to save the changes and exit.</span><p><div class="note" id="obs_11_0049__note1422133312318"><img src="public_sys-resources/note_3.0-en-us.png"><span class="notetitle"> </span><div class="notebody"><p id="obs_11_0049__p187991326332">Skip this step if the new line already exists in the <strong id="obs_11_0049__b1923521101215">/etc/profile</strong> file.</p>
</div></div> </div></div>
</p></li><li id="obs_11_0049__li996033762713"><span>Run the <strong id="obs_11_0049__b4237516164018">echo $PATH</strong> command to query the current environment variables. If <strong id="obs_11_0049__b142991144121319">:/obsutil</strong> in included in the query result, indicating that the <strong id="obs_11_0049__b11808140191513">/obsutil</strong> environment variable already exists, go to the next step. Otherwise, run the <strong id="obs_11_0049__b71226529408">source /etc/profile</strong> command.</span></li><li id="obs_11_0049__li186451918154515"><span>Check whether the configuration is successful: Run the <strong id="obs_11_0049__b108431010132110">obsutil help</strong> command in any directory. If the help information is displayed, the configuration is successful.</span></li></ol> </p></li><li id="obs_11_0049__li996033762713"><span>Run the <strong id="obs_11_0049__b4237516164018">echo $PATH</strong> command to query the current environment variables. If the query result includes <strong id="obs_11_0049__b142991144121319">:/obsutil</strong>, indicating that the <strong id="obs_11_0049__b11808140191513">/obsutil</strong> environment variable already exists, go to the next step. Otherwise, run the <strong id="obs_11_0049__b71226529408">source /etc/profile</strong> command.</span></li><li id="obs_11_0049__li186451918154515"><span>Check whether the configuration is successful: Run the <strong id="obs_11_0049__b108431010132110">obsutil help</strong> command in any directory. If the help information is displayed, the configuration is successful.</span></li></ol>
</div> </div>
<div class="section" id="obs_11_0049__section14418131348"><h4 class="sectiontitle">FAQs</h4><ol id="obs_11_0049__ol6575124113619"><li id="obs_11_0049__li357512414366">How do I locate the obsutil configuration file after setting obsutil commands to built-in commands?<p id="obs_11_0049__p11826162512363"><a name="obs_11_0049__li357512414366"></a><a name="li357512414366"></a>The <strong id="obs_11_0049__b209351652105319">.obsutilconfig</strong> file in the same directory where obsutil commands reside is the configuration file of the obsutil tool. You can also run the <strong id="obs_11_0049__b1252813075913">obsutil config</strong> command to obtain the configuration file path. An example is provided as follows:</p> <div class="section" id="obs_11_0049__section14418131348"><h4 class="sectiontitle">FAQs</h4><ol id="obs_11_0049__ol6575124113619"><li id="obs_11_0049__li357512414366">How do I locate the obsutil configuration file after setting obsutil commands to built-in commands?<p id="obs_11_0049__p11826162512363"><a name="obs_11_0049__li357512414366"></a><a name="li357512414366"></a>The <strong id="obs_11_0049__b209351652105319">.obsutilconfig</strong> file in the same directory where obsutil commands reside is the configuration file of the obsutil tool. You can also run the <strong id="obs_11_0049__b1252813075913">obsutil config</strong> command to obtain the configuration file path. An example is provided as follows:</p>
<pre class="screen" id="obs_11_0049__screen269584345916"><strong id="obs_11_0049__b969712559020">obsutil config</strong> <pre class="screen" id="obs_11_0049__screen269584345916"><strong id="obs_11_0049__b969712559020">obsutil config</strong>
Config file url: Config file url:
D:\tools\.obsutilconfig</pre> D:\tools\.obsutilconfig</pre>
</li><li id="obs_11_0049__li43932031161118">How do I delete obsutil commands after setting them as built-in commands?<ul id="obs_11_0049__ul18944114951218"><li id="obs_11_0049__li16945184916126">In Windows:<ol type="a" id="obs_11_0049__ol1848713541413"><li id="obs_11_0049__li048733551417">Run the <strong id="obs_11_0049__b18261536142212">where obsutil</strong> command to locate the path of obsutil commands.<pre class="screen" id="obs_11_0049__screen172418559207"><strong id="obs_11_0049__b1191364012216">where obsutil</strong> </li><li id="obs_11_0049__li43932031161118">How do I delete obsutil commands after setting them as built-in commands?<ul id="obs_11_0049__ul18944114951218"><li id="obs_11_0049__li16945184916126">Windows:<ol type="a" id="obs_11_0049__ol1848713541413"><li id="obs_11_0049__li048733551417">Run the <strong id="obs_11_0049__b18261536142212">where obsutil</strong> command to locate the path of obsutil commands.<pre class="screen" id="obs_11_0049__screen172418559207"><strong id="obs_11_0049__b1191364012216">where obsutil</strong>
E:\tools\bin\obsutil.exe</pre> E:\tools\bin\obsutil.exe</pre>
</li><li id="obs_11_0049__li1159219505202">Run the <strong id="obs_11_0049__b1728818598462">del </strong><em id="obs_11_0049__i107332224711">PATH</em> command to delete obsutil commands.<pre class="screen" id="obs_11_0049__screen64011134212"><strong id="obs_11_0049__b18636131312414">del E:\tools\bin\obsutil.exe</strong></pre> </li><li id="obs_11_0049__li1159219505202">Run the <strong id="obs_11_0049__b1728818598462">del </strong><em id="obs_11_0049__i107332224711">PATH</em> command to delete obsutil commands.<pre class="screen" id="obs_11_0049__screen64011134212"><strong id="obs_11_0049__b18636131312414">del E:\tools\bin\obsutil.exe</strong></pre>
<div class="note" id="obs_11_0049__note1072081102110"><img src="public_sys-resources/note_3.0-en-us.png"><span class="notetitle"> </span><div class="notebody"><p id="obs_11_0049__p97211182110">Replace <em id="obs_11_0049__i18421324174710">PATH</em> with the path of obsutil commands. <strong id="obs_11_0049__b10979848114718">E:\tools\bin\obsutil.exe</strong> is used in the preceding example.</p> <div class="note" id="obs_11_0049__note1072081102110"><img src="public_sys-resources/note_3.0-en-us.png"><span class="notetitle"> </span><div class="notebody"><p id="obs_11_0049__p97211182110">Replace <em id="obs_11_0049__i18421324174710">PATH</em> with the path of obsutil commands. <strong id="obs_11_0049__b10979848114718">E:\tools\bin\obsutil.exe</strong> is used in the preceding example.</p>
</div></div> </div></div>
</li></ol> </li></ol>
</li><li id="obs_11_0049__li468014305133">In Linux or macOS:<ol type="a" id="obs_11_0049__ol3418141516156"><li id="obs_11_0049__li9418151519155">Run the <strong id="obs_11_0049__b13246144018491">which obsutil</strong> command to locate the path of obsutil commands.<pre class="screen" id="obs_11_0049__screen161578414152"><strong id="obs_11_0049__b7574135751514">which obsutil</strong> </li><li id="obs_11_0049__li468014305133">macOS or Linux<ol type="a" id="obs_11_0049__ol3418141516156"><li id="obs_11_0049__li9418151519155">Run the <strong id="obs_11_0049__b13246144018491">which obsutil</strong> command to locate the path of obsutil commands.<pre class="screen" id="obs_11_0049__screen161578414152"><strong id="obs_11_0049__b7574135751514">which obsutil</strong>
/obsutil/obsutil</pre> /obsutil/obsutil</pre>
</li><li id="obs_11_0049__li1317745394714">Run the <strong id="obs_11_0049__b15173496497">rm -rf </strong><em id="obs_11_0049__i95190492499">PATH</em> command to delete obsutil commands.<pre class="screen" id="obs_11_0049__screen161779537478"><strong id="obs_11_0049__b16177115312476">rm -rf /obsutil/obsutil</strong></pre> </li><li id="obs_11_0049__li1317745394714">Run the <strong id="obs_11_0049__b15173496497">rm -rf </strong><em id="obs_11_0049__i95190492499">PATH</em> command to delete obsutil commands.<pre class="screen" id="obs_11_0049__screen161779537478"><strong id="obs_11_0049__b16177115312476">rm -rf /obsutil/obsutil</strong></pre>
<div class="note" id="obs_11_0049__note0177553144716"><img src="public_sys-resources/note_3.0-en-us.png"><span class="notetitle"> </span><div class="notebody"><p id="obs_11_0049__p1617885324713">Replace <em id="obs_11_0049__i5780144575017">PATH</em> with the path of obsutil commands. <strong id="obs_11_0049__b37809453508">/obsutil/obsutil</strong> is used in the preceding example.</p> <div class="note" id="obs_11_0049__note0177553144716"><img src="public_sys-resources/note_3.0-en-us.png"><span class="notetitle"> </span><div class="notebody"><p id="obs_11_0049__p1617885324713">Replace <em id="obs_11_0049__i5780144575017">PATH</em> with the path of obsutil commands. <strong id="obs_11_0049__b37809453508">/obsutil/obsutil</strong> is used in the preceding example.</p>

8
docs/obs/tool-obsutil/obs_11_0050.html
View File

@ -5,15 +5,15 @@
</div> </div>
<div class="notice" id="obs_11_0050__note15184181913594"><span class="noticetitle"><img src="public_sys-resources/notice_3.0-en-us.png"> </span><div class="noticebody"><p id="obs_11_0050__p8240134902215">No error is returned if a folder with the same name as an existing one is created, and the content of the existing folder remains unchanged.</p> <div class="notice" id="obs_11_0050__note15184181913594"><span class="noticetitle"><img src="public_sys-resources/notice_3.0-en-us.png"> </span><div class="noticebody"><p id="obs_11_0050__p8240134902215">No error is returned if a folder with the same name as an existing one is created, and the content of the existing folder remains unchanged.</p>
</div></div> </div></div>
<div class="section" id="obs_11_0050__section1220752192216"><h4 class="sectiontitle">Command Line Structure</h4><ul id="obs_11_0050__ul832417119303"><li id="obs_11_0050__li19324181113010">In Windows<ul id="obs_11_0050__ul14371109125314"><li id="obs_11_0050__li645116618536">Creating a folder in a specified bucket<pre class="screen" id="obs_11_0050__screen2021764195319">obsutil mkdir obs://bucket/folder[/subfolder1/subfolder2] [-config=xxx] </pre> <div class="section" id="obs_11_0050__section1220752192216"><h4 class="sectiontitle">Command Line Structure</h4><ul id="obs_11_0050__ul832417119303"><li id="obs_11_0050__li19324181113010">Windows<ul id="obs_11_0050__ul14371109125314"><li id="obs_11_0050__li645116618536">Creating a folder in a specified bucket<pre class="screen" id="obs_11_0050__screen2021764195319">obsutil mkdir obs://bucket/folder[/subfolder1/subfolder2] [-config=xxx] </pre>
</li><li id="obs_11_0050__li18337131475317">Creating a folder in the local file system<pre class="screen" id="obs_11_0050__screen15467124815533">obsutil mkdir folder_url [-config=xxx] </pre> </li><li id="obs_11_0050__li18337131475317">Creating a folder in the local file system<pre class="screen" id="obs_11_0050__screen15467124815533">obsutil mkdir folder_url [-config=xxx] </pre>
</li></ul> </li></ul>
</li><li id="obs_11_0050__li1476086143015">In Linux or macOS<ul id="obs_11_0050__ul102477258222"><li id="obs_11_0050__li6786202119227">Creating a folder in a specified bucket<pre class="screen" id="obs_11_0050__screen878692142210">./obsutil mkdir obs://bucket/folder[/subfolder1/subfolder2] [-config=xxx] </pre> </li><li id="obs_11_0050__li1476086143015">macOS or Linux<ul id="obs_11_0050__ul102477258222"><li id="obs_11_0050__li6786202119227">Creating a folder in a specified bucket<pre class="screen" id="obs_11_0050__screen878692142210">./obsutil mkdir obs://bucket/folder[/subfolder1/subfolder2] [-config=xxx] </pre>
</li><li id="obs_11_0050__li1978614214227">Creating a folder in the local file system<pre class="screen" id="obs_11_0050__screen178620215229">./obsutil mkdir folder_url [-config=xxx] </pre> </li><li id="obs_11_0050__li1978614214227">Creating a folder in the local file system<pre class="screen" id="obs_11_0050__screen178620215229">./obsutil mkdir folder_url [-config=xxx] </pre>
</li></ul> </li></ul>
</li></ul> </li></ul>
</div> </div>
<div class="section" id="obs_11_0050__section17814953162816"><h4 class="sectiontitle">Examples</h4><ul id="obs_11_0050__ul581405315283"><li id="obs_11_0050__li8814653202816">Take the Windows OS as an example. Run the <strong id="obs_11_0050__b129741610194715">obsutil mkdir obs://bucket-test/folder1/folder2</strong> command to create a folder in a bucket.<pre class="screen" id="obs_11_0050__screen88147535282"><strong id="obs_11_0050__b6815155316285">obsutil mkdir obs://bucket-test/folder1/folder2</strong> <div class="section" id="obs_11_0050__section17814953162816"><h4 class="sectiontitle">Examples</h4><ul id="obs_11_0050__ul581405315283"><li id="obs_11_0050__li8814653202816">In Windows, run <strong id="obs_11_0050__b129741610194715">obsutil mkdir obs://bucket-test/folder1/folder2</strong> to create a folder in the bucket.<pre class="screen" id="obs_11_0050__screen88147535282"><strong id="obs_11_0050__b6815155316285">obsutil mkdir obs://bucket-test/folder1/folder2</strong>
The bucket [bucket-test] does not support POSIX, create folder(s) step by step The bucket [bucket-test] does not support POSIX, create folder(s) step by step
Create folder [obs://bucket-test/folder1/] successfully, request id [0000016979E1D23C860BB3D8E4577C5E] Create folder [obs://bucket-test/folder1/] successfully, request id [0000016979E1D23C860BB3D8E4577C5E]
@ -71,6 +71,8 @@ Create folder [obs://bucket-test/folder1/folder2] successfully, request id [0000
<td class="cellrowborder" valign="top" width="18%" headers="mcps1.3.5.2.1.4.1.2 "><p id="obs_11_0050__p1266611611820">Optional (additional parameter)</p> <td class="cellrowborder" valign="top" width="18%" headers="mcps1.3.5.2.1.4.1.2 "><p id="obs_11_0050__p1266611611820">Optional (additional parameter)</p>
</td> </td>
<td class="cellrowborder" valign="top" width="69%" headers="mcps1.3.5.2.1.4.1.3 "><p id="obs_11_0050__p1166617619181">Specifies that requester pays is enabled.</p> <td class="cellrowborder" valign="top" width="69%" headers="mcps1.3.5.2.1.4.1.3 "><p id="obs_11_0050__p1166617619181">Specifies that requester pays is enabled.</p>
<p id="obs_11_0050__p13214143095512"><strong id="obs_11_0050__b76173330134540">Range</strong>:</p>
<p id="obs_11_0050__p13744112545515">requester</p>
</td> </td>
</tr> </tr>
</tbody> </tbody>

14
docs/obs/tool-obsutil/obs_11_0051.html
View File

@ -3,10 +3,10 @@
<h1 class="topictitle1">Generating the Download Link of an Object</h1> <h1 class="topictitle1">Generating the Download Link of an Object</h1>
<div id="body1552529750621"><div class="section" id="obs_11_0051__section1479112110815"><h4 class="sectiontitle">Function</h4><p id="obs_11_0051__p11772825481">You can use this command to generate the download link of a specified object in a bucket or generate the download links of objects in a bucket in batches by object name prefix.</p> <div id="body1552529750621"><div class="section" id="obs_11_0051__section1479112110815"><h4 class="sectiontitle">Function</h4><p id="obs_11_0051__p11772825481">You can use this command to generate the download link of a specified object in a bucket or generate the download links of objects in a bucket in batches by object name prefix.</p>
</div> </div>
<div class="section" id="obs_11_0051__section1220752192216"><h4 class="sectiontitle">Command Line Structure</h4><ul id="obs_11_0051__ul832417119303"><li id="obs_11_0051__li19324181113010">In Windows<ul id="obs_11_0051__ul14371109125314"><li id="obs_11_0051__li645116618536">Generating the download link of a single object<pre class="screen" id="obs_11_0051__screen2021764195319">obsutil sign obs://bucket/key [-e=300] [-config=xxx] </pre> <div class="section" id="obs_11_0051__section1220752192216"><h4 class="sectiontitle">Command Line Structure</h4><ul id="obs_11_0051__ul832417119303"><li id="obs_11_0051__li19324181113010">Windows<ul id="obs_11_0051__ul14371109125314"><li id="obs_11_0051__li645116618536">Generating the download link of a single object<pre class="screen" id="obs_11_0051__screen2021764195319">obsutil sign obs://bucket/key [-e=300] [-config=xxx] </pre>
</li><li id="obs_11_0051__li18337131475317">Generating the download links of objects in batches by object name prefix<pre class="screen" id="obs_11_0051__screen15467124815533">obsutil sign obs://bucket[/key] -r [-e=300] [-timeRange=time1-time2] [-include=*.xxx] [-exclude=*.xxx] [-o=xxx] [-config=xxx] </pre> </li><li id="obs_11_0051__li18337131475317">Generating the download links of objects in batches by object name prefix<pre class="screen" id="obs_11_0051__screen15467124815533">obsutil sign obs://bucket[/key] -r [-e=300] [-timeRange=time1-time2] [-include=*.xxx] [-exclude=*.xxx] [-o=xxx] [-config=xxx] </pre>
</li></ul> </li></ul>
</li><li id="obs_11_0051__li1476086143015">In Linux or macOS<ul id="obs_11_0051__ul102477258222"><li id="obs_11_0051__li6786202119227">Generating the download link of a single object<pre class="screen" id="obs_11_0051__screen878692142210">./obsutil sign obs://bucket/key [-e=300] [-config=xxx] </pre> </li><li id="obs_11_0051__li1476086143015">macOS or Linux<ul id="obs_11_0051__ul102477258222"><li id="obs_11_0051__li6786202119227">Generating the download link of a single object<pre class="screen" id="obs_11_0051__screen878692142210">./obsutil sign obs://bucket/key [-e=300] [-config=xxx] </pre>
</li><li id="obs_11_0051__li1978614214227">Generating the download links of objects in batches by object name prefix<pre class="screen" id="obs_11_0051__screen178620215229">./obsutil sign obs://bucket[/key] -r [-e=300] [-timeRange=time1-time2] [-include=*.xxx] [-exclude=*.xxx] [-o=xxx] [-config=xxx] </pre> </li><li id="obs_11_0051__li1978614214227">Generating the download links of objects in batches by object name prefix<pre class="screen" id="obs_11_0051__screen178620215229">./obsutil sign obs://bucket[/key] -r [-e=300] [-timeRange=time1-time2] [-include=*.xxx] [-exclude=*.xxx] [-o=xxx] [-config=xxx] </pre>
</li></ul> </li></ul>
</li></ul> </li></ul>
@ -69,7 +69,7 @@ Task id: af4dc692-6a88-4541-8156-ff1a889d2288</pre>
<td class="cellrowborder" valign="top" width="69%" headers="mcps1.3.4.2.1.4.1.3 "><p id="obs_11_0051__p16666614131519">The matching patterns of objects that are excluded, for example: <strong id="obs_11_0051__b141934383516">*.txt</strong></p> <td class="cellrowborder" valign="top" width="69%" headers="mcps1.3.4.2.1.4.1.3 "><p id="obs_11_0051__p16666614131519">The matching patterns of objects that are excluded, for example: <strong id="obs_11_0051__b141934383516">*.txt</strong></p>
<div class="note" id="obs_11_0051__note145284716208"><span class="notetitle"> NOTE: </span><div class="notebody"><ul id="obs_11_0051__ul05604713204"><li id="obs_11_0051__li14580477208">The asterisk (*) represents any group of characters, and the question mark (?) represents any single character. For instance, <strong id="obs_11_0051__b960954194116">abc*.txt</strong> indicates any file whose name starts with <strong id="obs_11_0051__b196913548413">abc</strong> and ends with <strong id="obs_11_0051__b1070185411417">.txt</strong>.</li><li id="obs_11_0051__li10293181913349">You can use <strong id="obs_11_0051__b34091756134117">\*</strong> to represent <strong id="obs_11_0051__b19410165616411">*</strong> and <strong id="obs_11_0051__b154111456204116">\?</strong> to represent <strong id="obs_11_0051__b241265644119">?</strong>.</li><li id="obs_11_0051__li20603473203">If the name of the object to be downloaded matches the value of this parameter, the object is skipped.</li></ul> <div class="note" id="obs_11_0051__note145284716208"><span class="notetitle"> NOTE: </span><div class="notebody"><ul id="obs_11_0051__ul05604713204"><li id="obs_11_0051__li14580477208">The asterisk (*) represents any group of characters, and the question mark (?) represents any single character. For instance, <strong id="obs_11_0051__b960954194116">abc*.txt</strong> indicates any file whose name starts with <strong id="obs_11_0051__b196913548413">abc</strong> and ends with <strong id="obs_11_0051__b1070185411417">.txt</strong>.</li><li id="obs_11_0051__li10293181913349">You can use <strong id="obs_11_0051__b34091756134117">\*</strong> to represent <strong id="obs_11_0051__b19410165616411">*</strong> and <strong id="obs_11_0051__b154111456204116">\?</strong> to represent <strong id="obs_11_0051__b241265644119">?</strong>.</li><li id="obs_11_0051__li20603473203">If the name of the object to be downloaded matches the value of this parameter, the object is skipped.</li></ul>
</div></div> </div></div>
<div class="notice" id="obs_11_0051__note179117549207"><span class="noticetitle"> NOTICE: </span><div class="noticebody"><ul id="obs_11_0051__ul877892116516"><li id="obs_11_0051__li1517310321518">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_0051__li7566721111012">The matching pattern applies to the absolute path of an object, including the object name prefix and object name starting from the root directory. For example, if the path of an object in the bucket is <strong id="obs_11_0051__b639119353111">obs://bucket/src1/src2/test.txt</strong>, then the absolute path of the object is <strong id="obs_11_0051__b123921738315">src1/src2/test.txt</strong>.</li><li id="obs_11_0051__li10874112101017">This matching pattern applies only to objects whose names do not end with a slash (/).</li><li id="obs_11_0051__li1518953734020">Multiple <strong id="obs_11_0051__b12649043185412">exclude</strong> parameters can be specified, for example, <strong id="obs_11_0051__b6650174355411">-exclude=*.xxx -exclude=*.xxx</strong>.</li></ul> <div class="notice" id="obs_11_0051__note179117549207"><span class="noticetitle"> NOTICE: </span><div class="noticebody"><ul id="obs_11_0051__ul877892116516"><li id="obs_11_0051__li1517310321518">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_0051__li7566721111012">The matching pattern applies to the object's absolute path, which includes the object name prefix and the object name starting from the root directory. For example, if an object's path in the bucket is <strong id="obs_11_0051__b177442254112">obs://bucket/src1/src2/test.txt</strong>, its absolute path is <strong id="obs_11_0051__b57443251713">src1/src2/test.txt</strong>.</li><li id="obs_11_0051__li10874112101017">This matching pattern applies only to objects whose names do not end with a slash (/).</li><li id="obs_11_0051__li1518953734020">Multiple <strong id="obs_11_0051__b12649043185412">exclude</strong> parameters can be specified, for example, <strong id="obs_11_0051__b6650174355411">-exclude=*.xxx -exclude=*.xxx</strong>.</li></ul>
</div></div> </div></div>
</td> </td>
</tr> </tr>
@ -78,9 +78,9 @@ Task id: af4dc692-6a88-4541-8156-ff1a889d2288</pre>
<td class="cellrowborder" valign="top" width="18%" headers="mcps1.3.4.2.1.4.1.2 "><p id="obs_11_0051__p966784516533">Optional when generating download links of objects in batches (additional parameter)</p> <td class="cellrowborder" valign="top" width="18%" headers="mcps1.3.4.2.1.4.1.2 "><p id="obs_11_0051__p966784516533">Optional when generating download links of objects in batches (additional parameter)</p>
</td> </td>
<td class="cellrowborder" valign="top" width="69%" headers="mcps1.3.4.2.1.4.1.3 "><p id="obs_11_0051__p37071730153119">The matching patterns of objects that are included, for example: <strong id="obs_11_0051__b16049125112">*.jpg</strong></p> <td class="cellrowborder" valign="top" width="69%" headers="mcps1.3.4.2.1.4.1.3 "><p id="obs_11_0051__p37071730153119">The matching patterns of objects that are included, for example: <strong id="obs_11_0051__b16049125112">*.jpg</strong></p>
<div class="note" id="obs_11_0051__note195168716220"><span class="notetitle"> NOTE: </span><div class="notebody"><ul id="obs_11_0051__ul752013715229"><li id="obs_11_0051__li135211772221">The asterisk (*) represents any group of characters, and the question mark (?) represents any single character.</li><li id="obs_11_0051__li151801324163419">You can use <strong id="obs_11_0051__b987530144318">\*</strong> to represent <strong id="obs_11_0051__b18877180184311">*</strong> and <strong id="obs_11_0051__b1287813084316">\?</strong> to represent <strong id="obs_11_0051__b287910134320">?</strong>.</li><li id="obs_11_0051__li201739642420">Only after identifying that the name of the file to be downloaded does not match the value of <strong id="obs_11_0051__b613133154313">exclude</strong>, the system checks whether the file name matches the value of this parameter. If yes, the file is downloaded. If not, the file is skipped.</li></ul> <div class="note" id="obs_11_0051__note195168716220"><span class="notetitle"> NOTE: </span><div class="notebody"><ul id="obs_11_0051__ul752013715229"><li id="obs_11_0051__li135211772221">The asterisk (*) represents any group of characters, and the question mark (?) represents any single character.</li><li id="obs_11_0051__li151801324163419">You can use <strong id="obs_11_0051__b987530144318">\*</strong> to represent <strong id="obs_11_0051__b18877180184311">*</strong> and <strong id="obs_11_0051__b1287813084316">\?</strong> to represent <strong id="obs_11_0051__b287910134320">?</strong>.</li><li id="obs_11_0051__li201739642420">The <strong id="obs_11_0051__b1747417718819">exclude</strong> rule is applied first. If the name of the object to be downloaded does not match the <strong id="obs_11_0051__b17474074811">exclude</strong> rule, the system then checks whether the object name matches this parameter. If it does, the object is downloaded; if it does not, the object is skipped.</li></ul>
</div></div> </div></div>
<div class="notice" id="obs_11_0051__note9270217202212"><span class="noticetitle"> NOTICE: </span><div class="noticebody"><ul id="obs_11_0051__ul1329413124584"><li id="obs_11_0051__li14294512115812">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_0051__li12968216131016">The matching pattern applies to the absolute path of an object, including the object name prefix and object name starting from the root directory. For example, if the path of an object in the bucket is <strong id="obs_11_0051__b81280613316">obs://bucket/src1/src2/test.txt</strong>, then the absolute path of the object is <strong id="obs_11_0051__b6129365319">src1/src2/test.txt</strong>.</li><li id="obs_11_0051__li1148165015513">This matching pattern applies only to objects whose names do not end with a slash (/).</li><li id="obs_11_0051__li1346454318403">Multiple <strong id="obs_11_0051__b01277461549">include</strong> parameters can be specified, for example, <strong id="obs_11_0051__b11279461544">-include=*.xxx -include=*.xxx</strong>.</li></ul> <div class="notice" id="obs_11_0051__note9270217202212"><span class="noticetitle"> NOTICE: </span><div class="noticebody"><ul id="obs_11_0051__ul1329413124584"><li id="obs_11_0051__li14294512115812">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_0051__li12968216131016">The matching pattern applies to the object's absolute path, which includes the object name prefix and the object name starting from the root directory. For example, if an object's path in the bucket is <strong id="obs_11_0051__b15381135210110">obs://bucket/src1/src2/test.txt</strong>, its absolute path is <strong id="obs_11_0051__b193811521711">src1/src2/test.txt</strong>.</li><li id="obs_11_0051__li1148165015513">This matching pattern applies only to objects whose names do not end with a slash (/).</li><li id="obs_11_0051__li1346454318403">Multiple <strong id="obs_11_0051__b01277461549">include</strong> parameters can be specified, for example, <strong id="obs_11_0051__b11279461544">-include=*.xxx -include=*.xxx</strong>.</li></ul>
</div></div> </div></div>
</td> </td>
</tr> </tr>
@ -90,7 +90,7 @@ Task id: af4dc692-6a88-4541-8156-ff1a889d2288</pre>
</td> </td>
<td class="cellrowborder" valign="top" width="69%" headers="mcps1.3.4.2.1.4.1.3 "><p id="obs_11_0051__p16963940134813">The time range matching pattern when generating download links of objects. Only the download links of objects whose latest modification time is within the configured time range are generated.</p> <td class="cellrowborder" valign="top" width="69%" headers="mcps1.3.4.2.1.4.1.3 "><p id="obs_11_0051__p16963940134813">The time range matching pattern when generating download links of objects. Only the download links of objects whose latest modification time is within the configured time range are generated.</p>
<p id="obs_11_0051__p2816559125317">This pattern has a lower priority than the object matching patterns (<strong id="obs_11_0051__b51820100612">exclude</strong>/<strong id="obs_11_0051__b132018108614">include</strong>). That is, the time range matching pattern is executed after the configured object matching patterns.</p> <p id="obs_11_0051__p2816559125317">This pattern has a lower priority than the object matching patterns (<strong id="obs_11_0051__b51820100612">exclude</strong>/<strong id="obs_11_0051__b132018108614">include</strong>). That is, the time range matching pattern is executed after the configured object matching patterns.</p>
<div class="note" id="obs_11_0051__note8766915165919"><span class="notetitle"> NOTE: </span><div class="notebody"><ul id="obs_11_0051__ul19272430145915"><li id="obs_11_0051__li17393154423217">Time in the matching pattern is the UTC time.</li><li id="obs_11_0051__li737595663220">This matching pattern applies only to objects whose names do not end with a slash (/).</li><li id="obs_11_0051__li12731730115918">The matching time range is represented in <em id="obs_11_0051__i12915187173118">time1</em><strong id="obs_11_0051__b169157716311">-</strong><em id="obs_11_0051__i189161733112">time2</em>, where <em id="obs_11_0051__i8917774312">time1</em> must be earlier than or the same as <em id="obs_11_0051__i11917375311">time2</em>. The time format is <em id="obs_11_0051__i5918579310">yyyyMMddHHmmss</em>.</li><li id="obs_11_0051__li32731530185916">Automatic formatting is supported. For example, yyyyMMdd is equivalent to yyyyMMdd000000, and yyyyMM is equivalent to yyyyMM01000000.</li><li id="obs_11_0051__li5185481610">If this parameter is set to <strong id="obs_11_0051__b179177993112">*-</strong><em id="obs_11_0051__i7918398313">time2</em>, all files whose latest modification time is earlier than <em id="obs_11_0051__i15918159123117">time2</em> are matched. If it is set to <em id="obs_11_0051__i109195963111">time1</em><strong id="obs_11_0051__b1391999143115">-*</strong>, all files whose latest modification time is later than <em id="obs_11_0051__i1792019173116">time1</em> are matched.</li></ul> <div class="note" id="obs_11_0051__note8766915165919"><span class="notetitle"> NOTE: </span><div class="notebody"><ul id="obs_11_0051__ul19272430145915"><li id="obs_11_0051__li17393154423217">Time in the matching pattern is the UTC time.</li><li id="obs_11_0051__li737595663220">This matching pattern applies only to objects whose names do not end with a slash (/).</li><li id="obs_11_0051__li12731730115918">The matching time range is represented in <em id="obs_11_0051__i12915187173118">time1</em><strong id="obs_11_0051__b169157716311">-</strong><em id="obs_11_0051__i189161733112">time2</em>, where <em id="obs_11_0051__i8917774312">time1</em> must be earlier than or the same as <em id="obs_11_0051__i11917375311">time2</em>. The time format is <em id="obs_11_0051__i5918579310">yyyyMMddHHmmss</em>.</li><li id="obs_11_0051__li32731530185916">Automatic formatting is supported. For example, yyyyMMdd is equivalent to yyyyMMdd000000, and yyyyMM is equivalent to yyyyMM01000000.</li><li id="obs_11_0051__li5185481610">If this parameter is set to <strong id="obs_11_0051__b45922016115516">*-</strong><em id="obs_11_0051__i1759214161556">time2</em>, all files whose last modification time is earlier than <em id="obs_11_0051__i16592111605514">time2</em> are matched. If it is set to <em id="obs_11_0051__i20592216195514">time1</em><strong id="obs_11_0051__b13592716135517">-*</strong>, all files whose last modification time is later than <em id="obs_11_0051__i19592131625517">time1</em> are matched.</li></ul>
</div></div> </div></div>
</td> </td>
</tr> </tr>
@ -116,6 +116,8 @@ Task id: af4dc692-6a88-4541-8156-ff1a889d2288</pre>
<td class="cellrowborder" valign="top" width="18%" headers="mcps1.3.4.2.1.4.1.2 "><p id="obs_11_0051__p1266611611820">Optional (additional parameter)</p> <td class="cellrowborder" valign="top" width="18%" headers="mcps1.3.4.2.1.4.1.2 "><p id="obs_11_0051__p1266611611820">Optional (additional parameter)</p>
</td> </td>
<td class="cellrowborder" valign="top" width="69%" headers="mcps1.3.4.2.1.4.1.3 "><p id="obs_11_0051__p1166617619181">Specifies that requester pays is enabled.</p> <td class="cellrowborder" valign="top" width="69%" headers="mcps1.3.4.2.1.4.1.3 "><p id="obs_11_0051__p1166617619181">Specifies that requester pays is enabled.</p>
<p id="obs_11_0051__p13214143095512"><strong id="obs_11_0051__b125407726834552">Range</strong>:</p>
<p id="obs_11_0051__p13744112545515">requester</p>
</td> </td>
</tr> </tr>
</tbody> </tbody>

2
docs/obs/tool-obsutil/obs_11_0052.html
View File

@ -33,7 +33,7 @@
<p id="obs_11_0052__p151523105511">Adjust the number of concurrent tasks in the multipart mode according to the following formula:</p> <p id="obs_11_0052__p151523105511">Adjust the number of concurrent tasks in the multipart mode according to the following formula:</p>
<p id="obs_11_0052__p1476315299439"><strong id="obs_11_0052__b202655312186">defaultParallels = Min(Number of CPUs x 2, Object size/defaultPartSize x 1.5)</strong></p> <p id="obs_11_0052__p1476315299439"><strong id="obs_11_0052__b202655312186">defaultParallels = Min(Number of CPUs x 2, Object size/defaultPartSize x 1.5)</strong></p>
<p id="obs_11_0052__p132201415513"></p> <p id="obs_11_0052__p132201415513"></p>
<p id="obs_11_0052__p5450192314325">In the upload, download, and copy commands, parameters <strong id="obs_11_0052__b735714121314">-p</strong> and <strong id="obs_11_0052__b1657311573114">-ps</strong> are used to modify the number of concurrent tasks in the multipart mode and part size respectively, and then deliver the multipart task based on the parameter values configured in the command. The default values in the configuration file are used if you do not set them in a command.</p> <p id="obs_11_0052__p5450192314325">For the upload, download, and copy commands, obsutil provides the <strong id="obs_11_0052__b735714121314">-p</strong> and <strong id="obs_11_0052__b1657311573114">-ps</strong> parameters to control the number of concurrent tasks and part size, respectively. obsutil then executes the tasks according to the values you specified. The default values in the configuration file are used if you do not set them in a command.</p>
<p id="obs_11_0052__p72841972565">Adjust the number of concurrent tasks in the multipart mode according to the following formula:</p> <p id="obs_11_0052__p72841972565">Adjust the number of concurrent tasks in the multipart mode according to the following formula:</p>
<p id="obs_11_0052__p1010243633111"><strong id="obs_11_0052__b1647413491491">p = Min(Number of CPUs x 2, Object size/ps x 1.5)</strong></p> <p id="obs_11_0052__p1010243633111"><strong id="obs_11_0052__b1647413491491">p = Min(Number of CPUs x 2, Object size/ps x 1.5)</strong></p>
<p id="obs_11_0052__p15924110112019"></p> <p id="obs_11_0052__p15924110112019"></p>

28
docs/obs/tool-obsutil/obs_11_0053.html
View File

@ -5,17 +5,17 @@
<div class="notice" id="obs_11_0053__note780411406113"><span class="noticetitle"><img src="public_sys-resources/notice_3.0-en-us.png"> </span><div class="noticebody"><ul id="obs_11_0053__ul562142691216"><li id="obs_11_0053__li156218269126">Do not change the source objects in the OBS bucket when moving objects. Otherwise, the operation may fail or data may be inconsistent.</li><li id="obs_11_0053__li16529194022218">The source objects are deleted after the move operation succeeds.</li><li id="obs_11_0053__li2073805924513">If an object move (<strong id="obs_11_0053__b1877318543340">mv</strong>) task is manually canceled or interrupted unexpectedly, obsutil cannot automatically resume or continue the task. In such cases, the move task may fail to be completely executed (for example, the source object is copied but not deleted), which may cause the source and target objects to coexist.</li><li id="obs_11_0053__li164742023913">If the source bucket is a parallel file system (supporting POSIX), the destination bucket cannot be an object storage bucket.</li></ul> <div class="notice" id="obs_11_0053__note780411406113"><span class="noticetitle"><img src="public_sys-resources/notice_3.0-en-us.png"> </span><div class="noticebody"><ul id="obs_11_0053__ul562142691216"><li id="obs_11_0053__li156218269126">Do not change the source objects in the OBS bucket when moving objects. Otherwise, the operation may fail or data may be inconsistent.</li><li id="obs_11_0053__li16529194022218">The source objects are deleted after the move operation succeeds.</li><li id="obs_11_0053__li2073805924513">If an object move (<strong id="obs_11_0053__b1877318543340">mv</strong>) task is manually canceled or interrupted unexpectedly, obsutil cannot automatically resume or continue the task. In such cases, the move task may fail to be completely executed (for example, the source object is copied but not deleted), which may cause the source and target objects to coexist.</li><li id="obs_11_0053__li164742023913">If the source bucket is a parallel file system (supporting POSIX), the destination bucket cannot be an object storage bucket.</li></ul>
</div></div> </div></div>
</div> </div>
<div class="section" id="obs_11_0053__section23858124111"><a name="obs_11_0053__section23858124111"></a><a name="section23858124111"></a><h4 class="sectiontitle">Command Line Structure</h4><ul id="obs_11_0053__ul9634193211493"><li id="obs_11_0053__li1763473234917">In Windows<ul id="obs_11_0053__ul10693164464919"><li id="obs_11_0053__li9351943114915">Moving a single object<pre class="screen" id="obs_11_0053__screen17782164918497">obsutil mv obs://srcbucket/key obs://dstbucket/[dest] [-dryRun] [-u] [-p=1] [-threshold=52428800] [-versionId=xxx] [-acl=xxx] [-sc=xxx] [-meta=aaa:bbb#ccc:ddd] [-ps=auto] [-cpd=xxx] [-fr] [-o=xxx] [-config=xxx] </pre> <div class="section" id="obs_11_0053__section23858124111"><a name="obs_11_0053__section23858124111"></a><a name="section23858124111"></a><h4 class="sectiontitle">Command Line Structure</h4><ul id="obs_11_0053__ul9634193211493"><li id="obs_11_0053__li1763473234917">Windows<ul id="obs_11_0053__ul10693164464919"><li id="obs_11_0053__li9351943114915">Moving a single object<pre class="screen" id="obs_11_0053__screen17782164918497">obsutil mv obs://srcbucket/key obs://dstbucket/[dest] [-dryRun] [-u] [-p=1] [-threshold=52428800] [-versionId=xxx] [-acl=xxx] [-sc=xxx] [-meta=aaa:bbb#ccc:ddd] [-ps=auto] [-cpd=xxx] [-fr] [-o=xxx] [-config=xxx] </pre>
</li><li id="obs_11_0053__li4878129135017">Moving objects in batches<pre class="screen" id="obs_11_0053__screen15740822175019">obsutil mv obs://srcbucket[/key] obs://dstbucket[/dest] -r [-dryRun] [-f] [-flat] [-u] [-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_0053__li4878129135017">Moving objects in batches<pre class="screen" id="obs_11_0053__screen15740822175019">obsutil mv obs://srcbucket[/key] obs://dstbucket[/dest] -r [-dryRun] [-f] [-flat] [-u] [-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></ul> </li></ul>
</li><li id="obs_11_0053__li245683714917">In Linux or macOS<ul id="obs_11_0053__ul20620193216509"><li id="obs_11_0053__li896314506">Moving a single object<pre class="screen" id="obs_11_0053__screen18891658135018">./obsutil mv obs://srcbucket/key obs://dstbucket/[dest] [-dryRun] [-u] [-p=1] [-threshold=52428800] [-versionId=xxx] [-acl=xxx] [-sc=xxx] [-meta=aaa:bbb#ccc:ddd] [-ps=auto] [-cpd=xxx] [-fr] [-o=xxx] [-config=xxx] </pre> </li><li id="obs_11_0053__li245683714917">macOS or Linux<ul id="obs_11_0053__ul20620193216509"><li id="obs_11_0053__li896314506">Moving a single object<pre class="screen" id="obs_11_0053__screen18891658135018">./obsutil mv obs://srcbucket/key obs://dstbucket/[dest] [-dryRun] [-u] [-p=1] [-threshold=52428800] [-versionId=xxx] [-acl=xxx] [-sc=xxx] [-meta=aaa:bbb#ccc:ddd] [-ps=auto] [-cpd=xxx] [-fr] [-o=xxx] [-config=xxx] </pre>
</li><li id="obs_11_0053__li1964513913507">Moving objects in batches<pre class="screen" id="obs_11_0053__screen161391565118">./obsutil mv obs://srcbucket[/key] obs://dstbucket[/dest] -r [-dryRun] [-f] [-flat] [-u] [-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_0053__li1964513913507">Moving objects in batches<pre class="screen" id="obs_11_0053__screen161391565118">./obsutil mv obs://srcbucket[/key] obs://dstbucket[/dest] -r [-dryRun] [-f] [-flat] [-u] [-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></ul> </li></ul>
</li></ul> </li></ul>
<div class="note" id="obs_11_0053__note38181439115018"><img src="public_sys-resources/note_3.0-en-us.png"><span class="notetitle"> </span><div class="notebody"><ul id="obs_11_0053__ul18347716517"><li id="obs_11_0053__li1583410755112">The source path and destination path cannot be the same.</li><li id="obs_11_0053__li283411717519">The source and destination paths cannot be nested when moving objects in batches.</li><li id="obs_11_0053__li202932177144">Batch object move is not available for parallel file systems.</li></ul> <div class="note" id="obs_11_0053__note38181439115018"><img src="public_sys-resources/note_3.0-en-us.png"><span class="notetitle"> </span><div class="notebody"><ul id="obs_11_0053__ul18347716517"><li id="obs_11_0053__li1583410755112">The source and destination paths cannot be the same.</li><li id="obs_11_0053__li283411717519">The source and destination paths cannot be nested during batch moves.</li><li id="obs_11_0053__li202932177144">Batch object moves are not supported for parallel file systems.</li></ul>
</div></div> </div></div>
</div> </div>
<div class="section" id="obs_11_0053__section185216375373"><h4 class="sectiontitle">Examples</h4><ul id="obs_11_0053__ul252283733718"><li id="obs_11_0053__li65228376375">Take the Windows OS as an example. Run the <strong id="obs_11_0053__b12977813142111">obsutil mv obs://bucket-test/key obs://bucket-test2</strong> command to move a single object.<pre class="screen" id="obs_11_0053__screen8522133753719"><strong id="obs_11_0053__b1852293713718">obsutil mv obs://bucket-test/key obs://bucket-test2</strong> <div class="section" id="obs_11_0053__section185216375373"><h4 class="sectiontitle">Examples</h4><ul id="obs_11_0053__ul252283733718"><li id="obs_11_0053__li65228376375">In Windows, run <strong id="obs_11_0053__b12977813142111">obsutil mv obs://bucket-test/key obs://bucket-test2</strong> to move a single object.<pre class="screen" id="obs_11_0053__screen8522133753719"><strong id="obs_11_0053__b1852293713718">obsutil mv obs://bucket-test/key obs://bucket-test2</strong>
Start at 2024-09-30 08:36:01.3934921 +0000 UTC Start at 2024-09-30 08:36:01.3934921 +0000 UTC
Parallel: 5 Jobs: 5 Parallel: 5 Jobs: 5
@ -27,7 +27,7 @@ Waiting for the copied key to be completed on server side.
Move successfully, 19B, obs://bucket-test/key --&gt; obs://bucket-test2/key, cost [1815], status [200], request id [00000192421282AC401423183A8B83A1]</pre> Move successfully, 19B, obs://bucket-test/key --&gt; obs://bucket-test2/key, cost [1815], status [200], request id [00000192421282AC401423183A8B83A1]</pre>
</li></ul> </li></ul>
<ul id="obs_11_0053__ul25221037133720"><li id="obs_11_0053__li352233763714">Take the Windows OS as an example. Run the <strong id="obs_11_0053__b149781813172117">obsutil mv obs://bucket-test/temp/ obs://bucket-test2 -f -r</strong> command to move objects in batches.<pre class="screen" id="obs_11_0053__screen11523437183713"><strong id="obs_11_0053__b752320376379">obsutil mv obs://bucket-test/temp/ obs://bucket-test2 -f -r</strong> <ul id="obs_11_0053__ul25221037133720"><li id="obs_11_0053__li352233763714">In Windows, run <strong id="obs_11_0053__b149781813172117">obsutil mv obs://bucket-test/temp/ obs://bucket-test2 -f -r</strong> to move objects in batches.<pre class="screen" id="obs_11_0053__screen11523437183713"><strong id="obs_11_0053__b752320376379">obsutil mv obs://bucket-test/temp/ obs://bucket-test2 -f -r</strong>
Start at 2024-09-30 08:37:32.2454905 +0000 UTC Start at 2024-09-30 08:37:32.2454905 +0000 UTC
Parallel: 5 Jobs: 5 Parallel: 5 Jobs: 5
@ -144,7 +144,7 @@ Task id: 0476929d-9d23-4dc5-b2f8-0a0493f027c5</pre>
</td> </td>
<td class="cellrowborder" valign="top" width="18.529999999999998%" headers="mcps1.3.4.2.1.4.1.2 "><p id="obs_11_0053__p17648193011318">Optional (additional parameter)</p> <td class="cellrowborder" valign="top" width="18.529999999999998%" headers="mcps1.3.4.2.1.4.1.2 "><p id="obs_11_0053__p17648193011318">Optional (additional parameter)</p>
</td> </td>
<td class="cellrowborder" valign="top" width="63.9%" headers="mcps1.3.4.2.1.4.1.3 "><p id="obs_11_0053__p16650163083117">The access control policies for destination objects that can be specified when moving objects. Possible values are:</p> <td class="cellrowborder" valign="top" width="63.9%" headers="mcps1.3.4.2.1.4.1.3 "><p id="obs_11_0053__p16650163083117">The access control policies for destination objects that can be specified when moving objects. The value can be:</p>
<ul id="obs_11_0053__ul0651183053115"><li id="obs_11_0053__li13652230153113">private</li><li id="obs_11_0053__li1965516308318">public-read</li><li id="obs_11_0053__li1265633023119">public-read-write</li><li id="obs_11_0053__li193894267536">bucket-owner-full-control</li></ul> <ul id="obs_11_0053__ul0651183053115"><li id="obs_11_0053__li13652230153113">private</li><li id="obs_11_0053__li1965516308318">public-read</li><li id="obs_11_0053__li1265633023119">public-read-write</li><li id="obs_11_0053__li193894267536">bucket-owner-full-control</li></ul>
<div class="note" id="obs_11_0053__note1790113183525"><span class="notetitle"> NOTE: </span><div class="notebody"><p id="obs_11_0053__p92982882916">The preceding four values indicate private read and write, public read, public read and write, and bucket owner full control.</p> <div class="note" id="obs_11_0053__note1790113183525"><span class="notetitle"> NOTE: </span><div class="notebody"><p id="obs_11_0053__p92982882916">The preceding four values indicate private read and write, public read, public read and write, and bucket owner full control.</p>
</div></div> </div></div>
@ -154,7 +154,7 @@ Task id: 0476929d-9d23-4dc5-b2f8-0a0493f027c5</pre>
</td> </td>
<td class="cellrowborder" valign="top" width="18.529999999999998%" headers="mcps1.3.4.2.1.4.1.2 "><p id="obs_11_0053__p134681525175117">Optional (additional parameter)</p> <td class="cellrowborder" valign="top" width="18.529999999999998%" headers="mcps1.3.4.2.1.4.1.2 "><p id="obs_11_0053__p134681525175117">Optional (additional parameter)</p>
</td> </td>
<td class="cellrowborder" valign="top" width="63.9%" headers="mcps1.3.4.2.1.4.1.3 "><p id="obs_11_0053__p04731025135114">The storage classes of the destination objects that can be specified when moving objects. Possible values are:</p> <td class="cellrowborder" valign="top" width="63.9%" headers="mcps1.3.4.2.1.4.1.3 "><p id="obs_11_0053__p04731025135114">The storage classes of the destination objects that can be specified when moving objects. The value can be:</p>
<ul id="obs_11_0053__ul175651814214"><li id="obs_11_0053__li1256512172114"><strong id="obs_11_0053__b2884043121012">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_0053__li10565181142113"><strong id="obs_11_0053__b1134343533220">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_0053__li756616110216"><strong id="obs_11_0053__b1711919389325">cold</strong>: Cold storage class. It provides secure, durable, and inexpensive storage for rarely-accessed (once a year) data.</li></ul> <ul id="obs_11_0053__ul175651814214"><li id="obs_11_0053__li1256512172114"><strong id="obs_11_0053__b2884043121012">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_0053__li10565181142113"><strong id="obs_11_0053__b1134343533220">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_0053__li756616110216"><strong id="obs_11_0053__b1711919389325">cold</strong>: Cold storage class. It provides secure, durable, and inexpensive storage for rarely-accessed (once a year) data.</li></ul>
</td> </td>
</tr> </tr>
@ -163,7 +163,7 @@ Task id: 0476929d-9d23-4dc5-b2f8-0a0493f027c5</pre>
<td class="cellrowborder" valign="top" width="18.529999999999998%" headers="mcps1.3.4.2.1.4.1.2 "><p id="obs_11_0053__p26631230193118">Optional (additional parameter)</p> <td class="cellrowborder" valign="top" width="18.529999999999998%" headers="mcps1.3.4.2.1.4.1.2 "><p id="obs_11_0053__p26631230193118">Optional (additional parameter)</p>
</td> </td>
<td class="cellrowborder" valign="top" width="63.9%" headers="mcps1.3.4.2.1.4.1.3 "><p id="obs_11_0053__p17941525135111">The metadata of destination objects that can be specified when moving objects. The format is <em id="obs_11_0053__i183948142313">key1</em><strong id="obs_11_0053__b839719147310">:</strong><em id="obs_11_0053__i143970148316">value1</em><strong id="obs_11_0053__b639819141631">#</strong><em id="obs_11_0053__i2039812142317">key2</em><strong id="obs_11_0053__b63995141316">:</strong><em id="obs_11_0053__i173991141735">value2</em><strong id="obs_11_0053__b940011141031">#</strong><em id="obs_11_0053__i34011314436">key3</em><strong id="obs_11_0053__b1340119143316">:</strong><em id="obs_11_0053__i1940212141535">value3</em>.</p> <td class="cellrowborder" valign="top" width="63.9%" headers="mcps1.3.4.2.1.4.1.3 "><p id="obs_11_0053__p17941525135111">The metadata of destination objects that can be specified when moving objects. The format is <em id="obs_11_0053__i183948142313">key1</em><strong id="obs_11_0053__b839719147310">:</strong><em id="obs_11_0053__i143970148316">value1</em><strong id="obs_11_0053__b639819141631">#</strong><em id="obs_11_0053__i2039812142317">key2</em><strong id="obs_11_0053__b63995141316">:</strong><em id="obs_11_0053__i173991141735">value2</em><strong id="obs_11_0053__b940011141031">#</strong><em id="obs_11_0053__i34011314436">key3</em><strong id="obs_11_0053__b1340119143316">:</strong><em id="obs_11_0053__i1940212141535">value3</em>.</p>
<div class="note" id="obs_11_0053__note1606229165119"><span class="notetitle"> NOTE: </span><div class="notebody"><p id="obs_11_0053__p686342013559">The preceding value indicates that the destination objects in the bucket contain three groups of customized metadata after objects are moved: <strong id="obs_11_0053__b17135731716">key1:value1</strong>, <strong id="obs_11_0053__b613177161713">key2:value2</strong>, and <strong id="obs_11_0053__b013167111711">key3:value3</strong>.</p> <div class="note" id="obs_11_0053__note1606229165119"><span class="notetitle"> NOTE: </span><div class="notebody"><p id="obs_11_0053__p686342013559">The format example above indicates that the destination objects contain three groups of custom metadata: <em id="obs_11_0053__i16254142105218">key1:value1</em>, <em id="obs_11_0053__i825494255219">key2:value2</em>, and <em id="obs_11_0053__i18254134285211">key3:value3</em>.</p>
</div></div> </div></div>
</td> </td>
</tr> </tr>
@ -204,7 +204,7 @@ Task id: 0476929d-9d23-4dc5-b2f8-0a0493f027c5</pre>
<td class="cellrowborder" valign="top" width="18.529999999999998%" headers="mcps1.3.4.2.1.4.1.2 "><p id="obs_11_0053__p170013055218">Optional for moving objects in batches (additional parameter)</p> <td class="cellrowborder" valign="top" width="18.529999999999998%" headers="mcps1.3.4.2.1.4.1.2 "><p id="obs_11_0053__p170013055218">Optional for moving objects in batches (additional parameter)</p>
</td> </td>
<td class="cellrowborder" valign="top" width="63.9%" headers="mcps1.3.4.2.1.4.1.3 "><p id="obs_11_0053__p4699130153112">The maximum number of concurrent tasks for moving objects in batches. The default value is the value of <strong id="obs_11_0053__b6802155075017">defaultJobs</strong> in the configuration file.</p> <td class="cellrowborder" valign="top" width="63.9%" headers="mcps1.3.4.2.1.4.1.3 "><p id="obs_11_0053__p4699130153112">The maximum number of concurrent tasks for moving objects in batches. The default value is the value of <strong id="obs_11_0053__b6802155075017">defaultJobs</strong> in the configuration file.</p>
<div class="note" id="obs_11_0053__note891964620819"><span class="notetitle"> NOTE: </span><div class="notebody"><p id="obs_11_0053__p1091964618820">The value is ensured to be greater than or equal to 1.</p> <div class="note" id="obs_11_0053__note891964620819"><span class="notetitle"> NOTE: </span><div class="notebody"><p id="obs_11_0053__p1091964618820">The tool ensures that this value is at least 1.</p>
</div></div> </div></div>
</td> </td>
</tr> </tr>
@ -215,7 +215,7 @@ Task id: 0476929d-9d23-4dc5-b2f8-0a0493f027c5</pre>
<td class="cellrowborder" valign="top" width="63.9%" headers="mcps1.3.4.2.1.4.1.3 "><p id="obs_11_0053__p16666614131519">The matching patterns of source objects that are excluded, for example: <strong id="obs_11_0053__b98036164282">*.txt</strong></p> <td class="cellrowborder" valign="top" width="63.9%" headers="mcps1.3.4.2.1.4.1.3 "><p id="obs_11_0053__p16666614131519">The matching patterns of source objects that are excluded, for example: <strong id="obs_11_0053__b98036164282">*.txt</strong></p>
<div class="note" id="obs_11_0053__note145284716208"><span class="notetitle"> NOTE: </span><div class="notebody"><ul id="obs_11_0053__ul05604713204"><li id="obs_11_0053__li14580477208">The asterisk (*) represents any group of characters, and the question mark (?) represents any single character. For instance, <strong id="obs_11_0053__b220217189286">abc*.txt</strong> indicates any file whose name starts with <strong id="obs_11_0053__b192030188286">abc</strong> and ends with <strong id="obs_11_0053__b19205318162818">.txt</strong>.</li><li id="obs_11_0053__li485725816339">You can use <strong id="obs_11_0053__b95182011288">\*</strong> to represent <strong id="obs_11_0053__b86520152817">*</strong> and <strong id="obs_11_0053__b147122092814">\?</strong> to represent <strong id="obs_11_0053__b168122032817">?</strong>.</li><li id="obs_11_0053__li20603473203">If the name of the object to be moved matches the value of this parameter, the object is skipped.</li></ul> <div class="note" id="obs_11_0053__note145284716208"><span class="notetitle"> NOTE: </span><div class="notebody"><ul id="obs_11_0053__ul05604713204"><li id="obs_11_0053__li14580477208">The asterisk (*) represents any group of characters, and the question mark (?) represents any single character. For instance, <strong id="obs_11_0053__b220217189286">abc*.txt</strong> indicates any file whose name starts with <strong id="obs_11_0053__b192030188286">abc</strong> and ends with <strong id="obs_11_0053__b19205318162818">.txt</strong>.</li><li id="obs_11_0053__li485725816339">You can use <strong id="obs_11_0053__b95182011288">\*</strong> to represent <strong id="obs_11_0053__b86520152817">*</strong> and <strong id="obs_11_0053__b147122092814">\?</strong> to represent <strong id="obs_11_0053__b168122032817">?</strong>.</li><li id="obs_11_0053__li20603473203">If the name of the object to be moved matches the value of this parameter, the object is skipped.</li></ul>
</div></div> </div></div>
<div class="notice" id="obs_11_0053__note179117549207"><span class="noticetitle"> NOTICE: </span><div class="noticebody"><ul id="obs_11_0053__ul877892116516"><li id="obs_11_0053__li1517310321518">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_0053__li022165913813">The matching pattern applies to the absolute path of an object, including the object name prefix and object name starting from the root directory. For example, if the path of an object in the bucket is <strong id="obs_11_0053__b17743109155712">obs://bucket/src1/src2/test.txt</strong>, then the absolute path of the object is <strong id="obs_11_0053__b0744995574">src1/src2/test.txt</strong>.</li><li id="obs_11_0053__li1148165015513">This matching pattern applies only to objects whose names do not end with a slash (/).</li><li id="obs_11_0053__li772248194117">Multiple <strong id="obs_11_0053__b1379172005220">exclude</strong> parameters can be specified, for example, <strong id="obs_11_0053__b17951342514">-exclude=*.xxx -exclude=*.xxx</strong>.</li></ul> <div class="notice" id="obs_11_0053__note179117549207"><span class="noticetitle"> NOTICE: </span><div class="noticebody"><ul id="obs_11_0053__ul877892116516"><li id="obs_11_0053__li1517310321518">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_0053__li022165913813">The matching pattern applies to the object's absolute path, which includes the object name prefix and the object name starting from the root directory. For example, if an object's path in the bucket is <strong id="obs_11_0053__b58154494596">obs://bucket/src1/src2/test.txt</strong>, its absolute path is <strong id="obs_11_0053__b58151949175916">src1/src2/test.txt</strong>.</li><li id="obs_11_0053__li1148165015513">This matching pattern applies only to objects whose names do not end with a slash (/).</li><li id="obs_11_0053__li772248194117">Multiple <strong id="obs_11_0053__b1379172005220">exclude</strong> parameters can be specified, for example, <strong id="obs_11_0053__b17951342514">-exclude=*.xxx -exclude=*.xxx</strong>.</li></ul>
</div></div> </div></div>
</td> </td>
</tr> </tr>
@ -224,9 +224,9 @@ Task id: 0476929d-9d23-4dc5-b2f8-0a0493f027c5</pre>
<td class="cellrowborder" valign="top" width="18.529999999999998%" headers="mcps1.3.4.2.1.4.1.2 "><p id="obs_11_0053__p470523013527">Optional for moving objects in batches (additional parameter)</p> <td class="cellrowborder" valign="top" width="18.529999999999998%" headers="mcps1.3.4.2.1.4.1.2 "><p id="obs_11_0053__p470523013527">Optional for moving objects in batches (additional parameter)</p>
</td> </td>
<td class="cellrowborder" valign="top" width="63.9%" headers="mcps1.3.4.2.1.4.1.3 "><p id="obs_11_0053__p37071730153119">The matching patterns of source objects that are included, for example: <strong id="obs_11_0053__b17984162514281">*.jpg</strong></p> <td class="cellrowborder" valign="top" width="63.9%" headers="mcps1.3.4.2.1.4.1.3 "><p id="obs_11_0053__p37071730153119">The matching patterns of source objects that are included, for example: <strong id="obs_11_0053__b17984162514281">*.jpg</strong></p>
<div class="note" id="obs_11_0053__note195168716220"><span class="notetitle"> NOTE: </span><div class="notebody"><ul id="obs_11_0053__ul752013715229"><li id="obs_11_0053__li135211772221">The asterisk (*) represents any group of characters, and the question mark (?) represents any single character.</li><li id="obs_11_0053__li095322123418">You can use <strong id="obs_11_0053__b144924521579">\*</strong> to represent <strong id="obs_11_0053__b1349314526578">*</strong> and <strong id="obs_11_0053__b649414527570">\?</strong> to represent <strong id="obs_11_0053__b184951752155711">?</strong>.</li><li id="obs_11_0053__li16523871227">Only after identifying that the name of the file to be moved does not match the value of <strong id="obs_11_0053__b186317308287">exclude</strong>, the system checks whether the file name matches the value of this parameter. If yes, the file is moved. If not, the file is skipped.</li></ul> <div class="note" id="obs_11_0053__note195168716220"><span class="notetitle"> NOTE: </span><div class="notebody"><ul id="obs_11_0053__ul752013715229"><li id="obs_11_0053__li135211772221">The asterisk (*) represents any group of characters, and the question mark (?) represents any single character.</li><li id="obs_11_0053__li095322123418">You can use <strong id="obs_11_0053__b144924521579">\*</strong> to represent <strong id="obs_11_0053__b1349314526578">*</strong> and <strong id="obs_11_0053__b649414527570">\?</strong> to represent <strong id="obs_11_0053__b184951752155711">?</strong>.</li><li id="obs_11_0053__li16523871227">The <strong id="obs_11_0053__b124211857725">exclude</strong> rule is applied first. If the name of the object to be moved does not match the <strong id="obs_11_0053__b186317308287">exclude</strong> rule, the system then checks whether the object name matches this parameter. If it does, the object is moved. If it does not, the object is skipped.</li></ul>
</div></div> </div></div>
<div class="notice" id="obs_11_0053__note9270217202212"><span class="noticetitle"> NOTICE: </span><div class="noticebody"><ul id="obs_11_0053__ul11495105419578"><li id="obs_11_0053__li449635411576">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_0053__li31631544919">The matching pattern applies to the absolute path of an object, including the object name prefix and object name starting from the root directory. For example, if the path of an object in the bucket is <strong id="obs_11_0053__b19761653185911">obs://bucket/src1/src2/test.txt</strong>, then the absolute path of the object is <strong id="obs_11_0053__b1697635319597">src1/src2/test.txt</strong>.</li><li id="obs_11_0053__li156078420919">This matching pattern applies only to objects whose names do not end with a slash (/).</li><li id="obs_11_0053__li195101514412">Multiple <strong id="obs_11_0053__b943563218526">include</strong> parameters can be specified, for example, <strong id="obs_11_0053__b19285101511518">-include=*.xxx -include=*.xxx</strong>.</li></ul> <div class="notice" id="obs_11_0053__note9270217202212"><span class="noticetitle"> NOTICE: </span><div class="noticebody"><ul id="obs_11_0053__ul11495105419578"><li id="obs_11_0053__li449635411576">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_0053__li31631544919">The matching pattern applies to the object's absolute path, which includes the object name prefix and the object name starting from the root directory. For example, if an object's path in the bucket is <strong id="obs_11_0053__b114975565916">obs://bucket/src1/src2/test.txt</strong>, its absolute path is <strong id="obs_11_0053__b12149855175919">src1/src2/test.txt</strong>.</li><li id="obs_11_0053__li156078420919">This matching pattern applies only to objects whose names do not end with a slash (/).</li><li id="obs_11_0053__li195101514412">Multiple <strong id="obs_11_0053__b943563218526">include</strong> parameters can be specified, for example, <strong id="obs_11_0053__b19285101511518">-include=*.xxx -include=*.xxx</strong>.</li></ul>
</div></div> </div></div>
</td> </td>
</tr> </tr>
@ -236,7 +236,7 @@ Task id: 0476929d-9d23-4dc5-b2f8-0a0493f027c5</pre>
</td> </td>
<td class="cellrowborder" valign="top" width="63.9%" headers="mcps1.3.4.2.1.4.1.3 "><p id="obs_11_0053__p16963940134813">The time range matching pattern when moving objects. Only objects whose latest modification time is within the configured time range are moved.</p> <td class="cellrowborder" valign="top" width="63.9%" headers="mcps1.3.4.2.1.4.1.3 "><p id="obs_11_0053__p16963940134813">The time range matching pattern when moving objects. Only objects whose latest modification time is within the configured time range are moved.</p>
<p id="obs_11_0053__p1565821819529">This pattern has a lower priority than the object matching patterns (<strong id="obs_11_0053__b798717286019">exclude</strong>/<strong id="obs_11_0053__b898918288012">include</strong>). That is, the time range matching pattern is executed after the configured object matching patterns.</p> <p id="obs_11_0053__p1565821819529">This pattern has a lower priority than the object matching patterns (<strong id="obs_11_0053__b798717286019">exclude</strong>/<strong id="obs_11_0053__b898918288012">include</strong>). That is, the time range matching pattern is executed after the configured object matching patterns.</p>
<div class="note" id="obs_11_0053__note8766915165919"><span class="notetitle"> NOTE: </span><div class="notebody"><ul id="obs_11_0053__ul19272430145915"><li id="obs_11_0053__li12731730115918">The matching time range is represented in <em id="obs_11_0053__i166591939609">time1</em><strong id="obs_11_0053__b146611839208">-</strong><em id="obs_11_0053__i196626391809">time2</em>, where <em id="obs_11_0053__i2663739401">time1</em> must be earlier than or the same as <em id="obs_11_0053__i866513913015">time2</em>. The time format is <em id="obs_11_0053__i3666639806">yyyyMMddHHmmss</em>.</li><li id="obs_11_0053__li32731530185916">Automatic formatting is supported. For example, yyyyMMdd is equivalent to yyyyMMdd000000, and yyyyMM is equivalent to yyyyMM01000000.</li><li id="obs_11_0053__li5185481610">If this parameter is set to <strong id="obs_11_0053__b139130461105">*-</strong><em id="obs_11_0053__i18914846808">time2</em>, all files whose latest modification time is earlier than <em id="obs_11_0053__i491514461408">time2</em> are matched. If it is set to <em id="obs_11_0053__i189172463010">time1</em><strong id="obs_11_0053__b291810461016">-*</strong>, all files whose latest modification time is later than <em id="obs_11_0053__i17919104617014">time1</em> are matched.</li></ul> <div class="note" id="obs_11_0053__note8766915165919"><span class="notetitle"> NOTE: </span><div class="notebody"><ul id="obs_11_0053__ul19272430145915"><li id="obs_11_0053__li12731730115918">The matching time range is represented in <em id="obs_11_0053__i166591939609">time1</em><strong id="obs_11_0053__b146611839208">-</strong><em id="obs_11_0053__i196626391809">time2</em>, where <em id="obs_11_0053__i2663739401">time1</em> must be earlier than or the same as <em id="obs_11_0053__i866513913015">time2</em>. The time format is <em id="obs_11_0053__i3666639806">yyyyMMddHHmmss</em>.</li><li id="obs_11_0053__li32731530185916">Automatic formatting is supported. For example, yyyyMMdd is equivalent to yyyyMMdd000000, and yyyyMM is equivalent to yyyyMM01000000.</li><li id="obs_11_0053__li5185481610">If this parameter is set to <strong id="obs_11_0053__b0232113595418">*-</strong><em id="obs_11_0053__i202321735135413">time2</em>, all files whose last modification time is earlier than <em id="obs_11_0053__i202325352547">time2</em> are matched. If it is set to <em id="obs_11_0053__i1023212356549">time1</em><strong id="obs_11_0053__b4232103518549">-*</strong>, all files whose last modification time is later than <em id="obs_11_0053__i12232135185419">time1</em> are matched.</li></ul>
</div></div> </div></div>
<div class="notice" id="obs_11_0053__note1078981817591"><span class="noticetitle"> NOTICE: </span><div class="noticebody"><ul id="obs_11_0053__ul881073612597"><li id="obs_11_0053__li1740024105917">Time in the matching pattern is the UTC time.</li><li id="obs_11_0053__li58105368598">This matching pattern applies only to objects whose names do not end with a slash (/).</li></ul> <div class="notice" id="obs_11_0053__note1078981817591"><span class="noticetitle"> NOTICE: </span><div class="noticebody"><ul id="obs_11_0053__ul881073612597"><li id="obs_11_0053__li1740024105917">Time in the matching pattern is the UTC time.</li><li id="obs_11_0053__li58105368598">This matching pattern applies only to objects whose names do not end with a slash (/).</li></ul>
</div></div> </div></div>
@ -280,6 +280,8 @@ Task id: 0476929d-9d23-4dc5-b2f8-0a0493f027c5</pre>
<td class="cellrowborder" valign="top" width="18.529999999999998%" headers="mcps1.3.4.2.1.4.1.2 "><p id="obs_11_0053__p1266611611820">Optional (additional parameter)</p> <td class="cellrowborder" valign="top" width="18.529999999999998%" headers="mcps1.3.4.2.1.4.1.2 "><p id="obs_11_0053__p1266611611820">Optional (additional parameter)</p>
</td> </td>
<td class="cellrowborder" valign="top" width="63.9%" headers="mcps1.3.4.2.1.4.1.3 "><p id="obs_11_0053__p1166617619181">Specifies that requester pays is enabled.</p> <td class="cellrowborder" valign="top" width="63.9%" headers="mcps1.3.4.2.1.4.1.3 "><p id="obs_11_0053__p1166617619181">Specifies that requester pays is enabled.</p>
<p id="obs_11_0053__p13214143095512"><strong id="obs_11_0053__b132669349234549">Range</strong>:</p>
<p id="obs_11_0053__p13744112545515">requester</p>
</td> </td>
</tr> </tr>
</tbody> </tbody>

2
docs/obs/tool-obsutil/obs_11_0055.html
View File

@ -11,7 +11,7 @@
</thead> </thead>
<tbody><tr id="obs_11_0055__row16392217305"><td class="cellrowborder" valign="top" width="25.230000000000004%" headers="mcps1.3.2.2.3.1.1 "><p id="obs_11_0055__p173921917103"><a href="obs_11_0056.html">Log Files</a></p> <tbody><tr id="obs_11_0055__row16392217305"><td class="cellrowborder" valign="top" width="25.230000000000004%" headers="mcps1.3.2.2.3.1.1 "><p id="obs_11_0055__p173921917103"><a href="obs_11_0056.html">Log Files</a></p>
</td> </td>
<td class="cellrowborder" valign="top" width="74.77000000000001%" headers="mcps1.3.2.2.3.1.2 "><p id="obs_11_0055__p03921017002">obsutil log files include tool logs and SDK logs. The tool logs record the success information and exceptions generated during obsutil running. The SDK logs record the success information and exceptions generated during requesting for OBS.</p> <td class="cellrowborder" valign="top" width="74.77000000000001%" headers="mcps1.3.2.2.3.1.2 "><p id="obs_11_0055__p03921017002">obsutil log files include both tool logs and SDK logs. The tool logs record success and exception information while obsutil is running. The SDK logs record success and exception information when obsutil sends requests to OBS.</p>
</td> </td>
</tr> </tr>
<tr id="obs_11_0055__row173928171205"><td class="cellrowborder" valign="top" width="25.230000000000004%" headers="mcps1.3.2.2.3.1.1 "><p id="obs_11_0055__p183921217907"><a href="obs_11_0057.html">Result Lists</a></p> <tr id="obs_11_0055__row173928171205"><td class="cellrowborder" valign="top" width="25.230000000000004%" headers="mcps1.3.2.2.3.1.1 "><p id="obs_11_0055__p183921217907"><a href="obs_11_0057.html">Result Lists</a></p>

4
docs/obs/tool-obsutil/obs_11_0058.html
View File

@ -1,7 +1,7 @@
<a name="obs_11_0058"></a><a name="obs_11_0058"></a> <a name="obs_11_0058"></a><a name="obs_11_0058"></a>
<h1 class="topictitle1">Return Codes</h1> <h1 class="topictitle1">Return Codes</h1>
<div id="body1554982511704"><p id="obs_11_0058__p169772010175615">If obsutil is invoked by processes, the command output cannot be viewed in real time. obsutil generates different return codes based on different execution results. <a href="#obs_11_0058__table936012247195">Table 1</a> describes the return codes. You can use either the following methods to obtain the return code of the latest execution result and then analyze and rectify the fault based on it:</p> <div id="body1554982511704"><p id="obs_11_0058__p169772010175615">If obsutil is invoked by processes, the command output cannot be viewed in real time. obsutil generates different return codes based on different execution results. <a href="#obs_11_0058__table936012247195">Table 1</a> describes the return codes. You can use the following methods to obtain the return code of the latest execution result and then analyze and rectify the fault based on it:</p>
<ul id="obs_11_0058__ul19665189168"><li id="obs_11_0058__li947510322463">In the macOS or Linux OS, run the following command to obtain the return code of the latest execution result:<pre class="screen" id="obs_11_0058__screen1867183413014">echo $?</pre> <ul id="obs_11_0058__ul19665189168"><li id="obs_11_0058__li947510322463">In the macOS or Linux OS, run the following command to obtain the return code of the latest execution result:<pre class="screen" id="obs_11_0058__screen1867183413014">echo $?</pre>
</li><li id="obs_11_0058__li74741440134613">In the Windows OS, run the following command to obtain the return code of the latest execution result:<pre class="screen" id="obs_11_0058__screen147271755153020">echo %errorlevel%</pre> </li><li id="obs_11_0058__li74741440134613">In the Windows OS, run the following command to obtain the return code of the latest execution result:<pre class="screen" id="obs_11_0058__screen147271755153020">echo %errorlevel%</pre>
</li></ul> </li></ul>
@ -69,7 +69,7 @@
</td> </td>
<td class="cellrowborder" valign="top" width="26.82268226822682%" headers="mcps1.3.3.2.4.1.2 "><p id="obs_11_0058__p96937416915">The operation is not supported.</p> <td class="cellrowborder" valign="top" width="26.82268226822682%" headers="mcps1.3.3.2.4.1.2 "><p id="obs_11_0058__p96937416915">The operation is not supported.</p>
</td> </td>
<td class="cellrowborder" valign="top" width="55.08550855085508%" headers="mcps1.3.3.2.4.1.3 "><p id="obs_11_0058__p1369318417915">Running the <strong id="obs_11_0058__b724204311317">chattri</strong> command to change object properties.</p> <td class="cellrowborder" valign="top" width="55.08550855085508%" headers="mcps1.3.3.2.4.1.3 "><p id="obs_11_0058__p1369318417915">Running the <strong id="obs_11_0058__b1280215375310">chattri</strong> command to change object properties is not supported.</p>
</td> </td>
</tr> </tr>
<tr id="obs_11_0058__row449544513101"><td class="cellrowborder" valign="top" width="18.09180918091809%" headers="mcps1.3.3.2.4.1.1 "><p id="obs_11_0058__p749564519103">8</p> <tr id="obs_11_0058__row449544513101"><td class="cellrowborder" valign="top" width="18.09180918091809%" headers="mcps1.3.3.2.4.1.1 "><p id="obs_11_0058__p749564519103">8</p>

Some files were not shown because too many files have changed in this diff Show More