forked from docs/doc-exports
weihongmin1
c4291b1dd5
Reviewed-by: Sabelnikov, Dmitriy <dmitriy.sabelnikov@t-systems.com> Co-authored-by: weihongmin1 <weihongmin1@huawei.com> Co-committed-by: weihongmin1 <weihongmin1@huawei.com>
260 lines
33 KiB
HTML
260 lines
33 KiB
HTML
<a name="obs_11_0037"></a><a name="obs_11_0037"></a>
|
|
|
|
<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>
|
|
<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">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>
|
|
</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">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
|
|
|
|
Start at 2024-10-08 01:10:07.3809685 +0000 UTC
|
|
|
|
Parallel: 5 Jobs: 5
|
|
Threshold: 50.00MB PartSize: auto
|
|
VerifyLength: false VerifyMd5: false
|
|
CheckpointDir: xxxx
|
|
|
|
Task id: a628d6da-c562-4a1f-b687-4fa125de0dc3
|
|
OutputDir: xxxx
|
|
TempFileDir: xxxx
|
|
|
|
[========================================================] 100.00% tps:35.71 2.02 KB/s 7.20MB/7.20MB 0s
|
|
Succeed count: 1 Failed count: 0
|
|
Succeed bytes: xxx
|
|
Metrics [max cost:90 ms, min cost:45 ms, average cost:63.80 ms, average tps:35.71, transferred size:70B]
|
|
|
|
Task id: a628d6da-c562-4a1f-b687-4fa125de0dc3</pre>
|
|
</li></ul>
|
|
</div>
|
|
<div class="section" id="obs_11_0037__section3940203142610"><h4 class="sectiontitle">Parameter Description</h4>
|
|
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="obs_11_0037__table125609307312" frame="border" border="1" rules="all"><thead align="left"><tr id="obs_11_0037__row456603043117"><th align="left" class="cellrowborder" valign="top" width="18%" id="mcps1.3.4.2.1.4.1.1"><p id="obs_11_0037__p85680303316">Parameter</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="27%" id="mcps1.3.4.2.1.4.1.2"><p id="obs_11_0037__p14572130153112">Optional or Mandatory</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="55.00000000000001%" id="mcps1.3.4.2.1.4.1.3"><p id="obs_11_0037__p15751930133118">Description</p>
|
|
</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody><tr id="obs_11_0037__row10984414202"><td class="cellrowborder" valign="top" width="18%" headers="mcps1.3.4.2.1.4.1.1 "><p id="obs_11_0037__p28307351476">recover</p>
|
|
</td>
|
|
<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 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. 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>
|
|
</td>
|
|
</tr>
|
|
<tr id="obs_11_0037__row1335717441023"><td class="cellrowborder" valign="top" width="18%" headers="mcps1.3.4.2.1.4.1.1 "><p id="obs_11_0037__p156631810914">dryRun</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="27%" headers="mcps1.3.4.2.1.4.1.2 "><p id="obs_11_0037__p10663610617">Optional (additional parameter)</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="55.00000000000001%" headers="mcps1.3.4.2.1.4.1.3 "><p id="obs_11_0037__p76630101412">Conducts a dry run.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="obs_11_0037__row12398958133217"><td class="cellrowborder" valign="top" width="18%" headers="mcps1.3.4.2.1.4.1.1 "><p id="obs_11_0037__p19960122065918">crr</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="27%" headers="mcps1.3.4.2.1.4.1.2 "><p id="obs_11_0037__p696012075919">Optional (additional parameter)</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="55.00000000000001%" headers="mcps1.3.4.2.1.4.1.3 "><p id="obs_11_0037__p1296062012595">Enables the client-side cross-region replication function. In this mode, data is directly copied to the destination bucket from the source bucket through data stream. The buckets can be any two OBS buckets.</p>
|
|
<div class="note" id="obs_11_0037__note4424164104813"><span class="notetitle"> NOTE: </span><div class="notebody"><ul id="obs_11_0037__ul743879115112"><li id="obs_11_0037__li34388965110">If this parameter is configured, ensure that the configuration of client-side cross-region replication is updated in the configuration file. For details, see <a href="obs_11_0023.html">Updating a Configuration File</a>.</li><li id="obs_11_0037__li1283061135112">The configurations of the source bucket and destination bucket are respectively <strong id="obs_11_0037__b1028317394322">akCrr/skCrr/tokenCrr/endpointCrr</strong> and <strong id="obs_11_0037__b19283203973211">ak/sk/token/endpoint</strong> in the configuration file.</li></ul>
|
|
</div></div>
|
|
<div class="notice" id="obs_11_0037__note19922116154811"><span class="noticetitle"> NOTICE: </span><div class="noticebody"><p id="obs_11_0037__p145215458113">When cross-region replication is enabled, the upload/download bandwidth, CPU, and memory resources of the host where commands are executed will be occupied, which may deteriorate the host performance.</p>
|
|
</div></div>
|
|
</td>
|
|
</tr>
|
|
<tr id="obs_11_0037__row69712557325"><td class="cellrowborder" valign="top" width="18%" headers="mcps1.3.4.2.1.4.1.1 "><p id="obs_11_0037__p1605745105311">vlength</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="27%" headers="mcps1.3.4.2.1.4.1.2 "><p id="obs_11_0037__p12605114512534">Optional (additional parameter)</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="55.00000000000001%" headers="mcps1.3.4.2.1.4.1.3 "><p id="obs_11_0037__p1660724595316">Verifies whether the object size in the destination bucket is the same as that in the source bucket after the copy task completes.</p>
|
|
<div class="note" id="obs_11_0037__note57671113172915"><span class="notetitle"> NOTE: </span><div class="notebody"><p id="obs_11_0037__p1768313182910">This parameter must be used together with <strong id="obs_11_0037__b122200479322">crr</strong>.</p>
|
|
</div></div>
|
|
</td>
|
|
</tr>
|
|
<tr id="obs_11_0037__row1360005310322"><td class="cellrowborder" valign="top" width="18%" headers="mcps1.3.4.2.1.4.1.1 "><p id="obs_11_0037__p136091945105315">vmd5</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="27%" headers="mcps1.3.4.2.1.4.1.2 "><p id="obs_11_0037__p461011452539">Optional (additional parameter)</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="55.00000000000001%" headers="mcps1.3.4.2.1.4.1.3 "><p id="obs_11_0037__p19611745185310">Verifies whether the MD5 value of the destination bucket is the same as that of the source bucket after the copy task completes.</p>
|
|
<div class="note" id="obs_11_0037__note13542169102916"><span class="notetitle"> NOTE: </span><div class="notebody"><ul id="obs_11_0037__ul114913379291"><li id="obs_11_0037__li1814913377295">This parameter must be used together with <strong id="obs_11_0037__b18530115119329">crr</strong>.</li><li id="obs_11_0037__li101491137162913">Objects in the source bucket must contain metadata <strong id="obs_11_0037__b39201852143215">x-obs-meta-md5chksum</strong>, or MD5 verification will be skipped.<p id="obs_11_0037__p1765649132314">After the MD5 verification is successful, this parameter value is used for metadata <strong id="obs_11_0037__b134111813616">x-obs-meta-md5chksum</strong> of the destination object, for later MD5 verification during download or copy.</p>
|
|
</li></ul>
|
|
</div></div>
|
|
<div class="caution" id="obs_11_0037__note183475244419"><span class="cautiontitle"> CAUTION: </span><div class="cautionbody"><p id="obs_11_0037__p98341052114418">If your object needs encryption, do not use this parameter.</p>
|
|
</div></div>
|
|
</td>
|
|
</tr>
|
|
<tr id="obs_11_0037__row17612113018317"><td class="cellrowborder" valign="top" width="18%" headers="mcps1.3.4.2.1.4.1.1 "><p id="obs_11_0037__p1461418302318">u</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="27%" headers="mcps1.3.4.2.1.4.1.2 "><p id="obs_11_0037__p1615183013110">Optional (additional parameter)</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="55.00000000000001%" headers="mcps1.3.4.2.1.4.1.3 "><p id="obs_11_0037__p361753019315">Indicates incremental copy. If this parameter is set, each object can be 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.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="obs_11_0037__row3632193093117"><td class="cellrowborder" valign="top" width="18%" headers="mcps1.3.4.2.1.4.1.1 "><p id="obs_11_0037__p26341030163117">p</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="27%" headers="mcps1.3.4.2.1.4.1.2 "><p id="obs_11_0037__p9636183093120">Optional (additional parameter)</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="55.00000000000001%" headers="mcps1.3.4.2.1.4.1.3 "><p id="obs_11_0037__p7638163013112">The maximum number of concurrent multipart copy tasks when copying an object. The default value is the value of <strong id="obs_11_0037__b253885916212">defaultParallels</strong> in the configuration file.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="obs_11_0037__row363913014313"><td class="cellrowborder" valign="top" width="18%" headers="mcps1.3.4.2.1.4.1.1 "><p id="obs_11_0037__p116401030183113">threshold</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="27%" headers="mcps1.3.4.2.1.4.1.2 "><p id="obs_11_0037__p176431304319">Optional (additional parameter)</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="55.00000000000001%" headers="mcps1.3.4.2.1.4.1.3 "><p id="obs_11_0037__p16441830113114">The threshold for enabling multipart copy, in bytes. The default value is the value of <strong id="obs_11_0037__b454131013441">defaultBigfileThreshold</strong> in the configuration file.</p>
|
|
<div class="note" id="obs_11_0037__note1382352674913"><span class="notetitle"> NOTE: </span><div class="notebody"><ul id="obs_11_0037__ul182059695115"><li id="obs_11_0037__li1320515655118">If the size of the object to be copied is smaller than the threshold, copy the object directly. If not, a multipart copy is required.</li><li id="obs_11_0037__li1651511123516">If you copy an object directly, no part record is generated, and resumable transmission is not supported.</li><li id="obs_11_0037__li1184794414422">This parameter value can contain a unit, for example, <strong id="obs_11_0037__b1510723215019">1MB</strong> (indicating 1,048,576 bytes).</li></ul>
|
|
</div></div>
|
|
</td>
|
|
</tr>
|
|
<tr id="obs_11_0037__row264453012315"><td class="cellrowborder" valign="top" width="18%" headers="mcps1.3.4.2.1.4.1.1 "><p id="obs_11_0037__p964614304315">acl</p>
|
|
</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>
|
|
<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>
|
|
<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>
|
|
</td>
|
|
</tr>
|
|
<tr id="obs_11_0037__row62441623105116"><td class="cellrowborder" valign="top" width="18%" headers="mcps1.3.4.2.1.4.1.1 "><p id="obs_11_0037__p13466172515511">sc</p>
|
|
</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>
|
|
<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>
|
|
</td>
|
|
</tr>
|
|
<tr id="obs_11_0037__row8659203023112"><td class="cellrowborder" valign="top" width="18%" headers="mcps1.3.4.2.1.4.1.1 "><p id="obs_11_0037__p1366223093111">meta</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="27%" headers="mcps1.3.4.2.1.4.1.2 "><p id="obs_11_0037__p26631230193118">Optional (additional parameter)</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="55.00000000000001%" headers="mcps1.3.4.2.1.4.1.3 "><p id="obs_11_0037__p17941525135111">The metadata of destination objects that can be specified when copying objects. This parameter should be configured in the following format: <em id="obs_11_0037__i18942181716223">key1</em><strong id="obs_11_0037__b19429176221">:</strong><em id="obs_11_0037__i39424179221">value1</em><strong id="obs_11_0037__b5942191732215">#</strong><em id="obs_11_0037__i794314175222">key2</em><strong id="obs_11_0037__b194371716223">:</strong><em id="obs_11_0037__i1894312174222">value2</em><strong id="obs_11_0037__b2943121762215">#</strong><em id="obs_11_0037__i16943201722214">key3</em><strong id="obs_11_0037__b1894314179225">:</strong><em id="obs_11_0037__i14943117112211">value3</em>.</p>
|
|
<div class="note" id="obs_11_0037__note1606229165119"><span class="notetitle"> NOTE: </span><div class="notebody"><p id="obs_11_0037__p686342013559">The format example above indicates that the destination objects contain three groups of custom metadata: <em id="obs_11_0037__i135891138122219">key1:value1</em>, <em id="obs_11_0037__i10590143819224">key2:value2</em>, and <em id="obs_11_0037__i1959043815225">key3:value3</em>.</p>
|
|
</div></div>
|
|
</td>
|
|
</tr>
|
|
<tr id="obs_11_0037__row466716303317"><td class="cellrowborder" valign="top" width="18%" headers="mcps1.3.4.2.1.4.1.1 "><p id="obs_11_0037__p1366917307314">ps</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="27%" headers="mcps1.3.4.2.1.4.1.2 "><p id="obs_11_0037__p267203023115">Optional (additional parameter)</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="55.00000000000001%" headers="mcps1.3.4.2.1.4.1.3 "><p id="obs_11_0037__p1167313023117">The size of each part in a multipart copy task, in bytes. The value ranges from <strong id="obs_11_0037__b1315618388449">100KB</strong> to <strong id="obs_11_0037__b615663814416">5GB</strong>. The default value is the value of <strong id="obs_11_0037__b13156123864412">defaultPartSize</strong> in the configuration file.</p>
|
|
<div class="note" id="obs_11_0037__note19227113864316"><span class="notetitle"> NOTE: </span><div class="notebody"><ul id="obs_11_0037__ul11281315134615"><li id="obs_11_0037__li11281215174619">This parameter value can contain a unit, for example, <strong id="obs_11_0037__b1240417283505">1MB</strong> (indicating 1,048,576 bytes).</li><li id="obs_11_0037__li1573310168464">The parameter can be set to <strong id="obs_11_0037__b144601040105219">auto</strong>. In this case, obsutil automatically sets the part size for each multipart task based on the source object size.</li></ul>
|
|
</div></div>
|
|
</td>
|
|
</tr>
|
|
<tr id="obs_11_0037__row1367463093119"><td class="cellrowborder" valign="top" width="18%" headers="mcps1.3.4.2.1.4.1.1 "><p id="obs_11_0037__p1967612305318">cpd</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="27%" headers="mcps1.3.4.2.1.4.1.2 "><p id="obs_11_0037__p1367810308316">Optional (additional parameter)</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="55.00000000000001%" headers="mcps1.3.4.2.1.4.1.3 "><p id="obs_11_0037__p46792307316">The folder where the part records reside. The default value is <strong id="obs_11_0037__b15871124304419">.obsutil_checkpoint</strong>, the subfolder in the home directory of the user who executes obsutil commands.</p>
|
|
<div class="note" id="obs_11_0037__note22601842192718"><span class="notetitle"> NOTE: </span><div class="notebody"><p id="obs_11_0037__p118866577266">A part record is generated during a multipart copy and saved to the <strong id="obs_11_0037__b2029618267491">copy</strong> subfolder. After the copy succeeds, its part record is deleted automatically. If the copy fails or is suspended, the system attempts to resume the task according to its part record when you perform the copy the next time.</p>
|
|
</div></div>
|
|
</td>
|
|
</tr>
|
|
<tr id="obs_11_0037__row1568763019310"><td class="cellrowborder" valign="top" width="18%" headers="mcps1.3.4.2.1.4.1.1 "><p id="obs_11_0037__p2688183018315">f</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="27%" headers="mcps1.3.4.2.1.4.1.2 "><p id="obs_11_0037__p1748156161912">Optional (additional parameter)</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="55.00000000000001%" headers="mcps1.3.4.2.1.4.1.3 "><p id="obs_11_0037__p1269315302318">Runs in force mode.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="obs_11_0037__row20694163013111"><td class="cellrowborder" valign="top" width="18%" headers="mcps1.3.4.2.1.4.1.1 "><p id="obs_11_0037__p269613053110">j</p>
|
|
</td>
|
|
<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 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 tool ensures that this value is at least 1.</p>
|
|
</div></div>
|
|
</td>
|
|
</tr>
|
|
<tr id="obs_11_0037__row8334161131517"><td class="cellrowborder" valign="top" width="18%" headers="mcps1.3.4.2.1.4.1.1 "><p id="obs_11_0037__p7660121421518">exclude</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="27%" headers="mcps1.3.4.2.1.4.1.2 "><p id="obs_11_0037__p207547618193">Optional (additional parameter)</p>
|
|
</td>
|
|
<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></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 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>
|
|
</td>
|
|
</tr>
|
|
<tr id="obs_11_0037__row207003306314"><td class="cellrowborder" valign="top" width="18%" headers="mcps1.3.4.2.1.4.1.1 "><p id="obs_11_0037__p11703123012317">include</p>
|
|
</td>
|
|
<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 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">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 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>
|
|
</td>
|
|
</tr>
|
|
<tr id="obs_11_0037__row450632218429"><td class="cellrowborder" valign="top" width="18%" headers="mcps1.3.4.2.1.4.1.1 "><p id="obs_11_0037__p496314014481">timeRange</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="27%" headers="mcps1.3.4.2.1.4.1.2 "><p id="obs_11_0037__p1664510223494">Optional (additional parameter)</p>
|
|
</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>
|
|
<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__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 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>
|
|
</td>
|
|
</tr>
|
|
<tr id="obs_11_0037__row2100330397"><td class="cellrowborder" valign="top" width="18%" headers="mcps1.3.4.2.1.4.1.1 "><p id="obs_11_0037__p10122175516">mf</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="27%" headers="mcps1.3.4.2.1.4.1.2 "><p id="obs_11_0037__p1562018121550">Optional (additional parameter)</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="55.00000000000001%" headers="mcps1.3.4.2.1.4.1.3 "><p id="obs_11_0037__p31226718512">Indicates that the name matching pattern (<strong id="obs_11_0037__b17339350857">include</strong> or <strong id="obs_11_0037__b1834017508517">exclude</strong>) and the time matching pattern (<strong id="obs_11_0037__b5341145012515">timeRange</strong>) also take effect on objects whose names end with a slash (/).</p>
|
|
<p id="obs_11_0037__p15797105118514"></p>
|
|
</td>
|
|
</tr>
|
|
<tr id="obs_11_0037__row9725193023119"><td class="cellrowborder" valign="top" width="18%" headers="mcps1.3.4.2.1.4.1.1 "><p id="obs_11_0037__p1672753013119">o</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="27%" headers="mcps1.3.4.2.1.4.1.2 "><p id="obs_11_0037__p17760136151914">Optional (additional parameter)</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="55.00000000000001%" headers="mcps1.3.4.2.1.4.1.3 "><p id="obs_11_0037__p137321030143112">The folder that stores the result files. After the command is executed, result files (possibly success, failure, and warning files) will be created in the specified folder. The default value is <strong id="obs_11_0037__b989318541212">.obsutil_output</strong>, a subfolder in the user's home directory where obsutil commands are executed.</p>
|
|
<div class="note" id="obs_11_0037__note289083220249"><span class="notetitle"> NOTE: </span><div class="notebody"><ul id="obs_11_0037__ul101190347408"><li id="obs_11_0037__li111993418408">A result file should be named as follows: <strong id="obs_11_0037__b0803034193116">cp_{succeed | failed | warning}_report_</strong><em id="obs_11_0037__i19804143418318">time</em><strong id="obs_11_0037__b158041134133113">_</strong><em id="obs_11_0037__i280413423115">TaskId</em><strong id="obs_11_0037__b15804103411316">.txt</strong>.<p id="obs_11_0037__li412103664016p0">By default, the maximum size of a single result file is 30 MB and the maximum number of result files that can be retained is 1,024. You can set the maximum size and number by configuring <strong id="obs_11_0037__b1660275124311">recordMaxLogSize</strong> and <strong id="obs_11_0037__b1260320514311">recordBackups</strong> in the configuration file.</p>
|
|
</li><li id="obs_11_0037__li69951552734">If there are multiple folders and files and you need to confirm the details of a failed task, refer to the failure result file <strong id="obs_11_0037__obs_11_0013_b5396121718320">cp_failed_report_</strong><em id="obs_11_0037__obs_11_0013_i1639621714325">time</em><strong id="obs_11_0037__obs_11_0013_b1739631753215">_</strong><em id="obs_11_0037__obs_11_0013_i203979172328">TaskId</em><strong id="obs_11_0037__obs_11_0013_b1639718176326">.txt</strong> in the result folder and the <a href="obs_11_0056.html">log files</a> in the log path.</li></ul>
|
|
</div></div>
|
|
</td>
|
|
</tr>
|
|
<tr id="obs_11_0037__row1367084045314"><td class="cellrowborder" valign="top" width="18%" headers="mcps1.3.4.2.1.4.1.1 "><p id="obs_11_0037__p1214331787">clear</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="27%" headers="mcps1.3.4.2.1.4.1.2 "><p id="obs_11_0037__p112145311787">Optional (additional parameter)</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="55.00000000000001%" headers="mcps1.3.4.2.1.4.1.3 "><p id="obs_11_0037__p18214731083">Deletes the failure result files after the copy task is resumed.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="obs_11_0037__row923556133614"><td class="cellrowborder" valign="top" width="18%" headers="mcps1.3.4.2.1.4.1.1 "><p id="obs_11_0037__p153951131317">config</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="27%" headers="mcps1.3.4.2.1.4.1.2 "><p id="obs_11_0037__p12395135316">Optional (additional parameter)</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="55.00000000000001%" headers="mcps1.3.4.2.1.4.1.3 "><p id="obs_11_0037__obs_11_0008_p1750111452317">The user-defined configuration file for executing the current command. For details about parameters that can be configured, see <a href="obs_11_0035.html">Configuration Parameters</a>.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="obs_11_0037__row1621221120239"><td class="cellrowborder" valign="top" width="18%" headers="mcps1.3.4.2.1.4.1.1 "><p id="obs_11_0037__p1966666191820">payer</p>
|
|
</td>
|
|
<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 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>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
</div>
|
|
<div class="section" id="obs_11_0037__section6926520122416"><h4 class="sectiontitle">Response</h4><p id="obs_11_0037__p21251255183018">Refer to <a href="obs_11_0013.html#obs_11_0013__section6926520122416">Response</a> for uploading an object.</p>
|
|
</div>
|
|
</div>
|
|
<div>
|
|
<div class="familylinks">
|
|
<div class="parentlink"><strong>Parent topic:</strong> <a href="obs_11_0012.html">Object Commands</a></div>
|
|
</div>
|
|
</div>
|
|
|