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

330 lines
46 KiB
HTML
Raw Blame History

<a name="obs_11_0017"></a><a name="obs_11_0017"></a>
<h1 class="topictitle1">Copying an Object</h1>
<div id="body1543219320305"><div class="section" id="obs_11_0017__section1479112110815"><h4 class="sectiontitle">Function</h4><p id="obs_11_0017__p11634386239">You can use this command to copy a single object or copy objects in batches by a specified object name prefix.</p>
<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 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>
</li></ul>
</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>
</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><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__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>
</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>
Start at 2024-09-30 08:30:09.0815415 +0000 UTC
Parallel: 3 Jobs: 3
Threshold: 50.00MB PartSize: auto
CheckpointDir: xxxx
[=====================================================] 100.00% 6/s 0s
Waiting for the copied key to be completed on server side.
Copy successfully, 19B, obs://bucket-test/key --&gt; obs://bucket-test2/key
ext.txt, cost [1708], status [200], request id [00000192420D227E4017336A12F1DC22]</pre>
</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>
Start at 2024-09-30 08:34:02.7819703 +0000 UTC
Parallel: 5 Jobs: 5
Threshold: 50.00MB PartSize: auto
CheckpointDir: xxxx
Task id: 0476929d-9d23-4dc5-b2f8-0a0493f027c5
OutputDir: xxxx
[=============================================================] 100.00% 10/s 0s
Succeed count: 5 Failed count: 0
Metrics [max cost:298 ms, min cost:192 ms, average cost:238.00 ms, average tps:9.71, transferred size: 7.20MB]
Task id: 0476929d-9d23-4dc5-b2f8-0a0493f027c5</pre>
</li></ul>
<ul id="obs_11_0017__ul798111463719"><li id="obs_11_0017__li59817413377">For more examples, see <a href="obs_11_0027.html">Common Examples</a>.</li></ul>
</div>
<div class="section" id="obs_11_0017__section3940203142610"><h4 class="sectiontitle">Parameter Description</h4>
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="obs_11_0017__table125609307312" frame="border" border="1" rules="all"><thead align="left"><tr id="obs_11_0017__row456603043117"><th align="left" class="cellrowborder" valign="top" width="17.57%" id="mcps1.3.5.2.1.4.1.1"><p id="obs_11_0017__p85680303316">Parameter</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="18.529999999999998%" id="mcps1.3.5.2.1.4.1.2"><p id="obs_11_0017__p14572130153112">Optional or Mandatory</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="63.9%" id="mcps1.3.5.2.1.4.1.3"><p id="obs_11_0017__p15751930133118">Description</p>
</th>
</tr>
</thead>
<tbody><tr id="obs_11_0017__row20577630203112"><td class="cellrowborder" valign="top" width="17.57%" headers="mcps1.3.5.2.1.4.1.1 "><p id="obs_11_0017__p18579630143115">srcbucket</p>
</td>
<td class="cellrowborder" valign="top" width="18.529999999999998%" headers="mcps1.3.5.2.1.4.1.2 "><p id="obs_11_0017__p458314302313">Mandatory</p>
</td>
<td class="cellrowborder" valign="top" width="63.9%" headers="mcps1.3.5.2.1.4.1.3 "><p id="obs_11_0017__p34544306544">The source bucket name</p>
</td>
</tr>
<tr id="obs_11_0017__row1059316307314"><td class="cellrowborder" valign="top" width="17.57%" headers="mcps1.3.5.2.1.4.1.1 "><p id="obs_11_0017__p159616306318">dstbucket</p>
</td>
<td class="cellrowborder" valign="top" width="18.529999999999998%" headers="mcps1.3.5.2.1.4.1.2 "><p id="obs_11_0017__p1559933073119">Mandatory</p>
</td>
<td class="cellrowborder" valign="top" width="63.9%" headers="mcps1.3.5.2.1.4.1.3 "><p id="obs_11_0017__p95994308315">The destination bucket name</p>
</td>
</tr>
<tr id="obs_11_0017__row169347719447"><td class="cellrowborder" valign="top" width="17.57%" headers="mcps1.3.5.2.1.4.1.1 "><p id="obs_11_0017__p1811911004419">dest</p>
</td>
<td class="cellrowborder" valign="top" width="18.529999999999998%" headers="mcps1.3.5.2.1.4.1.2 "><p id="obs_11_0017__p9123510204415">Optional</p>
</td>
<td class="cellrowborder" valign="top" width="63.9%" headers="mcps1.3.5.2.1.4.1.3 "><p id="obs_11_0017__p1839313263477">The destination object name when copying an object, or the name prefix of destination objects when copying objects in batches</p>
</td>
</tr>
<tr id="obs_11_0017__row106007303311"><td class="cellrowborder" valign="top" width="17.57%" headers="mcps1.3.5.2.1.4.1.1 "><p id="obs_11_0017__p1060363010318">key</p>
</td>
<td class="cellrowborder" valign="top" width="18.529999999999998%" headers="mcps1.3.5.2.1.4.1.2 "><p id="obs_11_0017__p8535551165513">Mandatory for copying an object.</p>
<p id="obs_11_0017__p7265911561">Optional for copying objects in batches.</p>
</td>
<td class="cellrowborder" valign="top" width="63.9%" headers="mcps1.3.5.2.1.4.1.3 "><p id="obs_11_0017__p176052030183114">The source object name when copying an object, or the name prefix of source objects when copying objects in batches</p>
<p id="obs_11_0017__p36061309319">The rules are as follows:</p>
<ul id="obs_11_0017__ul1560743053116"><li id="obs_11_0017__li11753135514237">This parameter cannot be left blank when copying an object.<ul id="obs_11_0017__ul361161052419"><li id="obs_11_0017__li2801132513244">If <strong id="obs_11_0017__b181611291">dest</strong> is left blank, the source object is copied to the root directory of the destination bucket.</li><li id="obs_11_0017__li16111710142419">If the value of <strong id="obs_11_0017__b186801226172916">dest</strong> ends with a slash (/), the destination object name is the value of <strong id="obs_11_0017__b15115194318293">dest</strong> plus the source object name. Otherwise, the destination object name is the value of <strong id="obs_11_0017__b1179195182914">dest</strong>.</li></ul>
</li><li id="obs_11_0017__li18729884611">If this parameter is left blank when copying objects in batches, all objects in the source bucket are copied. If not, objects whose name prefix is the set value in the source bucket are copied. The rules for confirming the name of the destination object are as follows:<ul id="obs_11_0017__ul101911711114619"><li id="obs_11_0017__li854312210453">If the value of <strong id="obs_11_0017__b175610418258">dest</strong> ends with a slash (/), the destination object name is the value of <strong id="obs_11_0017__b1756312281499">dest</strong> plus the source object name.</li><li id="obs_11_0017__li10217143020463">If the value of <strong id="obs_11_0017__b198673121165">dest</strong> does not end with a slash (/), the destination object name is <em id="obs_11_0017__i1144918511760">the value of </em><em id="obs_11_0017__i651522503618"><strong id="obs_11_0017__b92851281163">dest</strong></em><strong id="obs_11_0017__b10281031178">/</strong><em id="obs_11_0017__i563313811717">source object name</em>.</li></ul>
</li><li id="obs_11_0017__li14388510181714">If this parameter is configured but the <strong id="obs_11_0017__b37483487329">flat</strong> parameter is not when copying objects in batches, the name of the source object contains the name prefix of the parent object. If <strong id="obs_11_0017__b1974812485329">flat</strong> is configured, then the name of the source object does not contain the name prefix of the parent object.</li></ul>
<div class="note" id="obs_11_0017__note14528254193716"><span class="notetitle"> NOTE: </span><div class="notebody"><p id="obs_11_0017__p690613504191">For details about how to use this parameter, see <a href="obs_11_0030.html">Copy</a>.</p>
</div></div>
</td>
</tr>
<tr id="obs_11_0017__row64161323113"><td class="cellrowborder" valign="top" width="17.57%" headers="mcps1.3.5.2.1.4.1.1 "><p id="obs_11_0017__p123051451513">fr</p>
</td>
<td class="cellrowborder" valign="top" width="18.529999999999998%" headers="mcps1.3.5.2.1.4.1.2 "><p id="obs_11_0017__p113071451811">Optional for copying an object (additional parameter)</p>
</td>
<td class="cellrowborder" valign="top" width="63.9%" headers="mcps1.3.5.2.1.4.1.3 "><p id="obs_11_0017__p73101351816">Generates an operation result file when copying an object.</p>
</td>
</tr>
<tr id="obs_11_0017__row19803114816115"><td class="cellrowborder" valign="top" width="17.57%" headers="mcps1.3.5.2.1.4.1.1 "><p id="obs_11_0017__p13236151151117">flat</p>
</td>
<td class="cellrowborder" valign="top" width="18.529999999999998%" headers="mcps1.3.5.2.1.4.1.2 "><p id="obs_11_0017__p142391351111116">Optional for copying objects in batches (additional parameter)</p>
</td>
<td class="cellrowborder" valign="top" width="63.9%" headers="mcps1.3.5.2.1.4.1.3 "><p id="obs_11_0017__p624025171110">The name prefix of the parent object is excluded when copying objects in batches.</p>
</td>
</tr>
<tr id="obs_11_0017__row1513173918563"><td class="cellrowborder" valign="top" width="17.57%" headers="mcps1.3.5.2.1.4.1.1 "><p id="obs_11_0017__p1537517155414">dryRun</p>
</td>
<td class="cellrowborder" valign="top" width="18.529999999999998%" headers="mcps1.3.5.2.1.4.1.2 "><p id="obs_11_0017__p13376216548">Optional (additional parameter)</p>
</td>
<td class="cellrowborder" valign="top" width="63.9%" headers="mcps1.3.5.2.1.4.1.3 "><p id="obs_11_0017__p1137981175411">Conducts a dry run.</p>
</td>
</tr>
<tr id="obs_11_0017__row4959122013591"><td class="cellrowborder" valign="top" width="17.57%" headers="mcps1.3.5.2.1.4.1.1 "><p id="obs_11_0017__p19960122065918">crr</p>
</td>
<td class="cellrowborder" valign="top" width="18.529999999999998%" headers="mcps1.3.5.2.1.4.1.2 "><p id="obs_11_0017__p696012075919">Optional (additional parameter)</p>
</td>
<td class="cellrowborder" valign="top" width="63.9%" headers="mcps1.3.5.2.1.4.1.3 "><p id="obs_11_0017__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>
<ul id="obs_11_0017__ul488142913207"><li id="obs_11_0017__li088111298200">If this parameter is configured, the configuration of client-side cross-region replication must be updated in the configuration file. For details, see <a href="obs_11_0023.html">Updating a Configuration File</a>.</li><li id="obs_11_0017__li1122919717215">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.</li></ul>
<div class="note" id="obs_11_0017__note4424164104813"><span class="notetitle"> NOTE: </span><div class="notebody"><p id="obs_11_0017__p1823524415214">The configurations of the source bucket and destination bucket are respectively <strong id="obs_11_0017__b18758453123912">akCrr/skCrr/tokenCrr/endpointCrr</strong> and <strong id="obs_11_0017__b1475811533398">ak/sk/token/endpoint</strong> in the configuration file.</p>
</div></div>
</td>
</tr>
<tr id="obs_11_0017__row145913418207"><td class="cellrowborder" valign="top" width="17.57%" headers="mcps1.3.5.2.1.4.1.1 "><p id="obs_11_0017__p1605745105311">vlength</p>
</td>
<td class="cellrowborder" valign="top" width="18.529999999999998%" headers="mcps1.3.5.2.1.4.1.2 "><p id="obs_11_0017__p12605114512534">Optional (additional parameter)</p>
</td>
<td class="cellrowborder" valign="top" width="63.9%" headers="mcps1.3.5.2.1.4.1.3 "><p id="obs_11_0017__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>
<p id="obs_11_0017__p1140513952214"><strong id="obs_11_0017__b12100250112320">This parameter must be used together with crr.</strong></p>
</td>
</tr>
<tr id="obs_11_0017__row16347124510200"><td class="cellrowborder" valign="top" width="17.57%" headers="mcps1.3.5.2.1.4.1.1 "><p id="obs_11_0017__p136091945105315">vmd5</p>
</td>
<td class="cellrowborder" valign="top" width="18.529999999999998%" headers="mcps1.3.5.2.1.4.1.2 "><p id="obs_11_0017__p461011452539">Optional (additional parameter)</p>
</td>
<td class="cellrowborder" valign="top" width="63.9%" headers="mcps1.3.5.2.1.4.1.3 "><p id="obs_11_0017__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>
<ul id="obs_11_0017__ul66321615251"><li id="obs_11_0017__li14631816162519"><strong id="obs_11_0017__b0469105614236">This parameter must be used together with crr.</strong></li><li id="obs_11_0017__li1423618183256"><strong id="obs_11_0017__b147357347436">Objects in the source bucket must contain metadata x-obs-meta-md5chksum, or MD5 verification will be skipped.</strong> After the MD5 verification is successful, this parameter value is used for metadata <strong id="obs_11_0017__b14794104594512">x-obs-meta-md5chksum</strong> of the destination object, for later MD5 verification during download or replication.</li><li id="obs_11_0017__li37959201258"><strong id="obs_11_0017__b1345124413479">If your object needs encryption, do not use this parameter.</strong></li></ul>
</td>
</tr>
<tr id="obs_11_0017__row17612113018317"><td class="cellrowborder" valign="top" width="17.57%" headers="mcps1.3.5.2.1.4.1.1 "><p id="obs_11_0017__p1461418302318">u</p>
</td>
<td class="cellrowborder" valign="top" width="18.529999999999998%" headers="mcps1.3.5.2.1.4.1.2 "><p id="obs_11_0017__p1615183013110">Optional (additional parameter)</p>
</td>
<td class="cellrowborder" valign="top" width="63.9%" headers="mcps1.3.5.2.1.4.1.3 "><p id="obs_11_0017__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_0017__row3632193093117"><td class="cellrowborder" valign="top" width="17.57%" headers="mcps1.3.5.2.1.4.1.1 "><p id="obs_11_0017__p26341030163117">p</p>
</td>
<td class="cellrowborder" valign="top" width="18.529999999999998%" headers="mcps1.3.5.2.1.4.1.2 "><p id="obs_11_0017__p9636183093120">Optional (additional parameter)</p>
</td>
<td class="cellrowborder" valign="top" width="63.9%" headers="mcps1.3.5.2.1.4.1.3 "><p id="obs_11_0017__p7638163013112">The maximum number of concurrent multipart copy tasks when copying an object. The default value is the value of <strong id="obs_11_0017__b625031412158">defaultParallels</strong> in the configuration file.</p>
<div class="caution" id="obs_11_0017__note1983260174111"><span class="cautiontitle"> CAUTION: </span><div class="cautionbody"><p id="obs_11_0017__p1383211014413">For an inter-bucket replication task that does not include the <strong id="obs_11_0017__b4449164054017">crr</strong> parameter, the maximum allowable value for this parameter is 10,000.</p>
</div></div>
</td>
</tr>
<tr id="obs_11_0017__row363913014313"><td class="cellrowborder" valign="top" width="17.57%" headers="mcps1.3.5.2.1.4.1.1 "><p id="obs_11_0017__p116401030183113">threshold</p>
</td>
<td class="cellrowborder" valign="top" width="18.529999999999998%" headers="mcps1.3.5.2.1.4.1.2 "><p id="obs_11_0017__p176431304319">Optional (additional parameter)</p>
</td>
<td class="cellrowborder" valign="top" width="63.9%" headers="mcps1.3.5.2.1.4.1.3 "><p id="obs_11_0017__p169636862610">The threshold for enabling multipart copy. 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.</p>
<p id="obs_11_0017__p10441558182618">The default value is the value of <strong id="obs_11_0017__b78602445505">defaultBigfileThreshold</strong> in the configuration file.</p>
<p id="obs_11_0017__p694345118263">Unit: byte</p>
<p id="obs_11_0017__p787653182616">This parameter value can contain a unit, for example, <strong id="obs_11_0017__b79836945118">1MB</strong> (indicating 1,048,576 bytes).</p>
<div class="note" id="obs_11_0017__note1382352674913"><span class="notetitle"> NOTE: </span><div class="notebody"><p id="obs_11_0017__p9309618162915">If you copy an object directly, no part record is generated, and resumable transmission is not supported.</p>
</div></div>
</td>
</tr>
<tr id="obs_11_0017__row145994924514"><td class="cellrowborder" valign="top" width="17.57%" headers="mcps1.3.5.2.1.4.1.1 "><p id="obs_11_0017__p95911457154514">versionId</p>
</td>
<td class="cellrowborder" valign="top" width="18.529999999999998%" headers="mcps1.3.5.2.1.4.1.2 "><p id="obs_11_0017__p0594135774510">Optional for copying an object (additional parameter)</p>
</td>
<td class="cellrowborder" valign="top" width="63.9%" headers="mcps1.3.5.2.1.4.1.3 "><p id="obs_11_0017__p1859655744514">The source object version ID that can be specified when copying an object</p>
</td>
</tr>
<tr id="obs_11_0017__row264453012315"><td class="cellrowborder" valign="top" width="17.57%" headers="mcps1.3.5.2.1.4.1.1 "><p id="obs_11_0017__p964614304315">acl</p>
</td>
<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 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>
<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>
</tr>
<tr id="obs_11_0017__row62441623105116"><td class="cellrowborder" valign="top" width="17.57%" headers="mcps1.3.5.2.1.4.1.1 "><p id="obs_11_0017__p13466172515511">sc</p>
</td>
<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 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>
<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>
</tr>
<tr id="obs_11_0017__row8659203023112"><td class="cellrowborder" valign="top" width="17.57%" headers="mcps1.3.5.2.1.4.1.1 "><p id="obs_11_0017__p1366223093111">meta</p>
</td>
<td class="cellrowborder" valign="top" width="18.529999999999998%" headers="mcps1.3.5.2.1.4.1.2 "><p id="obs_11_0017__p26631230193118">Optional (additional parameter)</p>
</td>
<td class="cellrowborder" valign="top" width="63.9%" headers="mcps1.3.5.2.1.4.1.3 "><p id="obs_11_0017__obs_11_0013_p1989915710016">The standard or user-defined metadata that can be specified during object replication.</p>
<ul id="obs_11_0017__obs_11_0013_ul01131372111"><li id="obs_11_0017__obs_11_0013_li11132372016">Standard metadata includes <strong id="obs_11_0017__b1376271516215">Content-Type</strong>, <strong id="obs_11_0017__b16762181517215">Content-Encoding</strong>, <strong id="obs_11_0017__b187629159213">Cache-Control</strong>, <strong id="obs_11_0017__b1976212159213">Content-Disposition</strong>, <strong id="obs_11_0017__b1676315155214">Content-Language</strong> and <strong id="obs_11_0017__b476316155213">Expires</strong>.</li><li id="obs_11_0017__obs_11_0013_li878422619215">User-defined metadata must be in the format of <em id="obs_11_0017__i86269537477">key:value</em>. Multiple user-defined metadata items are separated by number signs (#), for example, <em id="obs_11_0017__i18525145618477">key1:value1</em><strong id="obs_11_0017__b13525105614717">#</strong><em id="obs_11_0017__i3525956104715">key2:value2</em><strong id="obs_11_0017__b452545624711">#</strong><em id="obs_11_0017__i8526105610474">key3:value3</em>, which indicates that the object copy in the destination bucket contains three groups of user-defined metadata: <em id="obs_11_0017__i95263565470">key1:value1</em>, <em id="obs_11_0017__i1252635614719">key2:value2</em>, and <em id="obs_11_0017__i552625613475">key3:value3</em>.</li></ul>
</td>
</tr>
<tr id="obs_11_0017__row466716303317"><td class="cellrowborder" valign="top" width="17.57%" headers="mcps1.3.5.2.1.4.1.1 "><p id="obs_11_0017__p1366917307314">ps</p>
</td>
<td class="cellrowborder" valign="top" width="18.529999999999998%" headers="mcps1.3.5.2.1.4.1.2 "><p id="obs_11_0017__p267203023115">Optional (additional parameter)</p>
</td>
<td class="cellrowborder" valign="top" width="63.9%" headers="mcps1.3.5.2.1.4.1.3 "><p id="obs_11_0017__p161953211218">The size of each part in a multipart copy task</p>
<ul id="obs_11_0017__ul1595728151510"><li id="obs_11_0017__li568441015155">The default value is the value of <strong id="obs_11_0017__b43118359517">defaultPartSize</strong> in the configuration file. The parameter can be set to <strong id="obs_11_0017__b1631112359512">auto</strong>. In this case, obsutil automatically configures the part size for each multipart task based on the source file size.</li><li id="obs_11_0017__li42601437111518">Range: <strong id="obs_11_0017__b8366182103710">100KB</strong> to <strong id="obs_11_0017__b936618213371">5GB</strong></li><li id="obs_11_0017__li1976515611152">Unit: byte. This parameter value can contain a unit, for example, <strong id="obs_11_0017__b19014311810">1MB</strong> (indicating 1,048,576 bytes).</li></ul>
</td>
</tr>
<tr id="obs_11_0017__row1367463093119"><td class="cellrowborder" valign="top" width="17.57%" headers="mcps1.3.5.2.1.4.1.1 "><p id="obs_11_0017__p1967612305318">cpd</p>
</td>
<td class="cellrowborder" valign="top" width="18.529999999999998%" headers="mcps1.3.5.2.1.4.1.2 "><p id="obs_11_0017__p1367810308316">Optional (additional parameter)</p>
</td>
<td class="cellrowborder" valign="top" width="63.9%" headers="mcps1.3.5.2.1.4.1.3 "><p id="obs_11_0017__obs_11_0013_p730944183517">The folder where the part records reside. The default value is <strong id="obs_11_0017__b1475814261694">.obsutil_checkpoint</strong>, the subfolder in the home directory of the user who executes obsutil commands.</p>
<p id="obs_11_0017__obs_11_0013_p942205114266">A part record is generated during a multipart copy and saved to the <strong id="obs_11_0017__b84343465307">upload</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>
</td>
</tr>
<tr id="obs_11_0017__row12681173043113"><td class="cellrowborder" valign="top" width="17.57%" headers="mcps1.3.5.2.1.4.1.1 "><p id="obs_11_0017__p1683230123111">r</p>
</td>
<td class="cellrowborder" valign="top" width="18.529999999999998%" headers="mcps1.3.5.2.1.4.1.2 "><p id="obs_11_0017__p1368433083110">Mandatory for copying objects in batches (additional parameter)</p>
</td>
<td class="cellrowborder" valign="top" width="63.9%" headers="mcps1.3.5.2.1.4.1.3 "><p id="obs_11_0017__p12686930183119">Copies objects in batches based on a specified name prefix of objects in the source bucket.</p>
</td>
</tr>
<tr id="obs_11_0017__row1568763019310"><td class="cellrowborder" valign="top" width="17.57%" headers="mcps1.3.5.2.1.4.1.1 "><p id="obs_11_0017__p2688183018315">f</p>
</td>
<td class="cellrowborder" valign="top" width="18.529999999999998%" headers="mcps1.3.5.2.1.4.1.2 "><p id="obs_11_0017__p1691193012317">Optional for copying objects in batches (additional parameter)</p>
</td>
<td class="cellrowborder" valign="top" width="63.9%" headers="mcps1.3.5.2.1.4.1.3 "><p id="obs_11_0017__p1269315302318">Runs in force mode.</p>
</td>
</tr>
<tr id="obs_11_0017__row20694163013111"><td class="cellrowborder" valign="top" width="17.57%" headers="mcps1.3.5.2.1.4.1.1 "><p id="obs_11_0017__p269613053110">j</p>
</td>
<td class="cellrowborder" valign="top" width="18.529999999999998%" headers="mcps1.3.5.2.1.4.1.2 "><p id="obs_11_0017__p170013055218">Optional for copying objects in batches (additional parameter)</p>
</td>
<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></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></div>
</td>
</tr>
<tr id="obs_11_0017__row8334161131517"><td class="cellrowborder" valign="top" width="17.57%" headers="mcps1.3.5.2.1.4.1.1 "><p id="obs_11_0017__p7660121421518">exclude</p>
</td>
<td class="cellrowborder" valign="top" width="18.529999999999998%" headers="mcps1.3.5.2.1.4.1.2 "><p id="obs_11_0017__p176621714131512">Optional for copying objects in batches (additional parameter)</p>
</td>
<td class="cellrowborder" valign="top" width="63.9%" headers="mcps1.3.5.2.1.4.1.3 "><p id="obs_11_0017__obs_11_0013_p63147571114">The matching patterns of source objects that are excluded. After this parameter is specified, if the name of the object to be copied matches the value of this parameter, the object is skipped. For example, if this parameter is set to <strong id="obs_11_0017__b99771017143713">*.txt</strong>, all files whose names end with <strong id="obs_11_0017__b129771817193714">.txt</strong> are skipped and not copied.</p>
<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_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></div>
</td>
</tr>
<tr id="obs_11_0017__row207003306314"><td class="cellrowborder" valign="top" width="17.57%" headers="mcps1.3.5.2.1.4.1.1 "><p id="obs_11_0017__p11703123012317">include</p>
</td>
<td class="cellrowborder" valign="top" width="18.529999999999998%" headers="mcps1.3.5.2.1.4.1.2 "><p id="obs_11_0017__p470523013527">Optional for copying objects in batches (additional parameter)</p>
</td>
<td class="cellrowborder" valign="top" width="63.9%" headers="mcps1.3.5.2.1.4.1.3 "><p id="obs_11_0017__obs_11_0013_p85831634179">The included matching patterns of source objects. After this parameter is specified, if the name of the object to be copied matches the value of this parameter, the object is copied. For example, if this parameter is set to <strong id="obs_11_0017__b0519154794415">*.txt</strong>, all objects whose names end with <strong id="obs_11_0017__b8519104714449">.txt</strong> are copied.</p>
<ul id="obs_11_0017__obs_11_0013_ul169281816194618"><li id="obs_11_0017__obs_11_0013_li1992814168465">An asterisk (*) matches any number of characters. For instance, <strong id="obs_11_0017__b103413476375">abc*.txt</strong> matches all files whose names start with <strong id="obs_11_0017__b19341144713377">abc</strong>, contain any number of characters in the middle, and end with <strong id="obs_11_0017__b334184716377">.txt</strong>.</li><li id="obs_11_0017__obs_11_0013_li1592891618462">A question mark (?) matches any single character. For instance, <strong id="obs_11_0017__b2468154973711">abc?.txt</strong> matches all files whose names start with <strong id="obs_11_0017__b19468349143714">abc</strong>, contain any single character in the middle, and end with <strong id="obs_11_0017__b20468549183710">.txt</strong>.</li><li id="obs_11_0017__obs_11_0013_li18928111611466">You can use <strong id="obs_11_0017__b152191146133816">\*</strong> to represent <strong id="obs_11_0017__b13219144623813">*</strong> and <strong id="obs_11_0017__b8219134620389">\?</strong> to represent <strong id="obs_11_0017__b1821994643815">?</strong>.</li><li id="obs_11_0017__obs_11_0013_li1892861615466">Multiple <strong id="obs_11_0017__b10421353124018">include</strong> parameters can be specified, for example, <strong id="obs_11_0017__b242155317406">-include=*.xxx -include=*.xxx</strong>.</li></ul>
<p id="obs_11_0017__obs_11_0013_p2094855175020"><strong id="obs_11_0017__b79139216404">Restrictions</strong>:</p>
<ul id="obs_11_0017__obs_11_0013_ul19542137205019"><li id="obs_11_0017__obs_11_0013_li1654213718504">This matching pattern applies only to objects whose names do not end with a slash (/).</li><li id="obs_11_0017__obs_11_0013_li12852141815019">If both the <strong id="obs_11_0017__b19934133417487">exclude</strong> and <strong id="obs_11_0017__b893417341486">include</strong> parameters are configured, the <strong id="obs_11_0017__b7934133494810">exclude</strong> rules are applied first. If the name of an object to be copied does not match <strong id="obs_11_0017__b17934193424819">exclude</strong>, OBS checks whether the object name matches the value of <strong id="obs_11_0017__b2934113454814">include</strong>. If yes, the object is copied. If no, the object is skipped.</li></ul>
<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>
<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></div>
</td>
</tr>
<tr id="obs_11_0017__row881016184213"><td class="cellrowborder" valign="top" width="17.57%" headers="mcps1.3.5.2.1.4.1.1 "><p id="obs_11_0017__p496314014481">timeRange</p>
</td>
<td class="cellrowborder" valign="top" width="18.529999999999998%" headers="mcps1.3.5.2.1.4.1.2 "><p id="obs_11_0017__p1664510223494">Optional for copying objects in batches (additional parameter)</p>
</td>
<td class="cellrowborder" valign="top" width="63.9%" headers="mcps1.3.5.2.1.4.1.3 "><p id="obs_11_0017__p447514276391">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_0017__p138074294535">This pattern has a lower priority than the file matching patterns (<strong id="obs_11_0017__b729212935714">exclude</strong>/<strong id="obs_11_0017__b929292910578">include</strong>). That is, the time range matching pattern is executed after the configured file matching patterns.</p>
<ul id="obs_11_0017__ul14334173714218"><li id="obs_11_0017__li03341237427">Time in the matching pattern is the UTC time.</li><li id="obs_11_0017__li525317516314">The matching time range is represented in <em id="obs_11_0017__i18466181415585">time1</em><strong id="obs_11_0017__b7466114175810">-</strong><em id="obs_11_0017__i1646611418588">time2</em>, where <em id="obs_11_0017__i19466414155812">time1</em> must be earlier than or the same as <em id="obs_11_0017__i946691417585">time2</em>. The time format is <em id="obs_11_0017__i9466181455815">yyyyMMddHHmmss</em>.</li><li id="obs_11_0017__li15253251631">Automatic formatting is supported. For example, <em id="obs_11_0017__i6282535125818">yyyyMMdd</em> is equivalent to <em id="obs_11_0017__i192822035175811">yyyyMMdd</em><strong id="obs_11_0017__b17282143575815">000000</strong>, and <em id="obs_11_0017__i92821935175810">yyyyMM</em> is equivalent to <em id="obs_11_0017__i028263520585">yyyyMM</em><strong id="obs_11_0017__b928243535810">01000000</strong>.</li><li id="obs_11_0017__li14253185339">If this parameter is set to <strong id="obs_11_0017__b11626154735810">*-</strong><em id="obs_11_0017__i15626194745816">time2</em>, all files whose last modification time is earlier than <em id="obs_11_0017__i1626747155815">time2</em> are matched. If it is set to <em id="obs_11_0017__i262618472584">time1</em><strong id="obs_11_0017__b7626147165816">-*</strong>, all files whose last modification time is later than <em id="obs_11_0017__i1162724715816">time1</em> are matched.</li></ul>
<p id="obs_11_0017__p16179103374810"><strong id="obs_11_0017__b166161810125912">This matching pattern applies only to objects whose names do not end with a slash (/).</strong></p>
</td>
</tr>
<tr id="obs_11_0017__row3161559962"><td class="cellrowborder" valign="top" width="17.57%" headers="mcps1.3.5.2.1.4.1.1 "><p id="obs_11_0017__p10122175516">mf</p>
</td>
<td class="cellrowborder" valign="top" width="18.529999999999998%" headers="mcps1.3.5.2.1.4.1.2 "><p id="obs_11_0017__p1562018121550">Optional (additional parameter)</p>
</td>
<td class="cellrowborder" valign="top" width="63.9%" headers="mcps1.3.5.2.1.4.1.3 "><p id="obs_11_0017__p31226718512">Indicates that the name matching pattern (<strong id="obs_11_0017__b173026515416">include</strong> or <strong id="obs_11_0017__b16219544416">exclude</strong>) and the time matching pattern (<strong id="obs_11_0017__b678117911422">timeRange</strong>) also take effect on objects whose names end with a slash (/).</p>
</td>
</tr>
<tr id="obs_11_0017__row9725193023119"><td class="cellrowborder" valign="top" width="17.57%" headers="mcps1.3.5.2.1.4.1.1 "><p id="obs_11_0017__p1672753013119">o</p>
</td>
<td class="cellrowborder" valign="top" width="18.529999999999998%" headers="mcps1.3.5.2.1.4.1.2 "><p id="obs_11_0017__p871493095216">Optional (additional parameter)</p>
</td>
<td class="cellrowborder" valign="top" width="63.9%" headers="mcps1.3.5.2.1.4.1.3 "><p id="obs_11_0017__obs_11_0013_p136841674517">The folder that stores the result files. After the command is executed, result files (possibly success, failure, and warning files) will be created in the specified folder.</p>
<p id="obs_11_0017__obs_11_0013_p139151442123019">The default value is <strong id="obs_11_0017__b13207219111412">.obsutil_output</strong>, a subfolder in the user's home directory where obsutil commands are executed.</p>
<ul id="obs_11_0017__obs_11_0013_ul1938211254515"><li id="obs_11_0017__obs_11_0013_li2092115541966">A result file should be named as follows: <strong id="obs_11_0017__b18634132116148">cp_{succeed | failed | warning}_report_</strong><em id="obs_11_0017__i1063514216146">time</em><strong id="obs_11_0017__b19635162161413">_</strong><em id="obs_11_0017__i163592116144">TaskId</em><strong id="obs_11_0017__b1963522111414">.txt</strong>.</li><li id="obs_11_0017__obs_11_0013_li1742813102712">By default, the maximum size of a single result file is 30 MB. You can set the maximum size by configuring <strong id="obs_11_0017__b988892431418">recordMaxLogSize</strong> in the configuration file.</li><li id="obs_11_0017__obs_11_0013_li1738317251851">By default, the maximum number of result files that can be retained is 1,024. You can set the maximum number by configuring <strong id="obs_11_0017__b966282717144">recordBackups</strong> in the configuration file.</li><li id="obs_11_0017__obs_11_0013_li133831325958">If there are multiple folders and files and you need to confirm the details of a failed task, refer to the failure result file <strong id="obs_11_0017__obs_11_0013_b5396121718320">cp_failed_report_</strong><em id="obs_11_0017__obs_11_0013_i1639621714325">time</em><strong id="obs_11_0017__obs_11_0013_b1739631753215">_</strong><em id="obs_11_0017__obs_11_0013_i203979172328">TaskId</em><strong id="obs_11_0017__obs_11_0013_b1639718176326">.txt</strong> in the result folder and the <a href="obs_11_0056.html">log files</a> in the log path.</li></ul>
</td>
</tr>
<tr id="obs_11_0017__row373961716182"><td class="cellrowborder" valign="top" width="17.57%" headers="mcps1.3.5.2.1.4.1.1 "><p id="obs_11_0017__p114391014518">bucket-cname</p>
</td>
<td class="cellrowborder" valign="top" width="18.529999999999998%" headers="mcps1.3.5.2.1.4.1.2 "><p id="obs_11_0017__p4143210950">Optional (additional parameter)</p>
</td>
<td class="cellrowborder" valign="top" width="63.9%" headers="mcps1.3.5.2.1.4.1.3 "><p id="obs_11_0017__p16143610251">The user-defined domain name bound to the bucket</p>
<div class="note" id="obs_11_0017__note16256574591"><span class="notetitle"> NOTE: </span><div class="notebody"><p id="obs_11_0017__p172595719595">This parameter is only supported by obsutil 5.7.9 and later.</p>
</div></div>
</td>
</tr>
<tr id="obs_11_0017__row1248115553510"><td class="cellrowborder" valign="top" width="17.57%" headers="mcps1.3.5.2.1.4.1.1 "><p id="obs_11_0017__p153951131317">config</p>
</td>
<td class="cellrowborder" valign="top" width="18.529999999999998%" headers="mcps1.3.5.2.1.4.1.2 "><p id="obs_11_0017__p12395135316">Optional (additional parameter)</p>
</td>
<td class="cellrowborder" valign="top" width="63.9%" headers="mcps1.3.5.2.1.4.1.3 "><p id="obs_11_0017__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_0017__row1033516962214"><td class="cellrowborder" valign="top" width="17.57%" headers="mcps1.3.5.2.1.4.1.1 "><p id="obs_11_0017__p1966666191820">payer</p>
</td>
<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 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>
</tr>
</tbody>
</table>
</div>
</div>
<div class="section" id="obs_11_0017__section6926520122416"><h4 class="sectiontitle">Response</h4><p id="obs_11_0017__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>
View Git Blame Copy Permalink