Files
doc-exports/docs/obs/tool-obsutil/obs_11_0041.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

211 lines
23 KiB
HTML

<a name="obs_11_0041"></a><a name="obs_11_0041"></a>
<h1 class="topictitle1">Setting Object Properties</h1>
<div id="body1547106819231"><div class="section" id="obs_11_0041__section1479112110815"><h4 class="sectiontitle">Function</h4><p id="obs_11_0041__p11772825481">You can use this command to set properties of an object or set properties of objects in batches by a specified object name prefix.</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 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>
</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><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__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>
</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>
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>
</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>
Start at 2024-09-30 08:18:03.105373 +0000 UTC
[------------------------------------------------] 100.00% tps:155.15 5/5 233ms
Succeed count: 5 Failed count: 0
Metrics [max cost:177 ms, min cost:53 ms, average cost:102.40 ms, average tps:20.41]
Task id: 9d7f73ff-f747-4fdd-9b2a-815ba2dc3b07</pre>
</li></ul>
</div>
<div class="section" id="obs_11_0041__section6559191102418"><h4 class="sectiontitle">Parameter Description</h4>
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="obs_11_0041__table10831182114445" frame="border" border="1" rules="all"><thead align="left"><tr id="obs_11_0041__row683212154419"><th align="left" class="cellrowborder" valign="top" width="16%" id="mcps1.3.4.2.1.4.1.1"><p id="obs_11_0041__p118329219446">Parameter</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="24%" id="mcps1.3.4.2.1.4.1.2"><p id="obs_11_0041__p15137125919108">Optional or Mandatory</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="60%" id="mcps1.3.4.2.1.4.1.3"><p id="obs_11_0041__p12832121184414">Description</p>
</th>
</tr>
</thead>
<tbody><tr id="obs_11_0041__row108328217449"><td class="cellrowborder" valign="top" width="16%" headers="mcps1.3.4.2.1.4.1.1 "><p id="obs_11_0041__p64495172515">bucket</p>
</td>
<td class="cellrowborder" valign="top" width="24%" headers="mcps1.3.4.2.1.4.1.2 "><p id="obs_11_0041__p154316502519">Mandatory</p>
</td>
<td class="cellrowborder" valign="top" width="60%" headers="mcps1.3.4.2.1.4.1.3 "><p id="obs_11_0041__p17425512259">The name of the bucket to which an object belongs</p>
</td>
</tr>
<tr id="obs_11_0041__row16373619121810"><td class="cellrowborder" valign="top" width="16%" headers="mcps1.3.4.2.1.4.1.1 "><p id="obs_11_0041__p737411911186">key</p>
</td>
<td class="cellrowborder" valign="top" width="24%" headers="mcps1.3.4.2.1.4.1.2 "><p id="obs_11_0041__p8166018195614">Mandatory when setting properties of an object.</p>
<p id="obs_11_0041__p741812412475">Optional when setting properties of objects in batches.</p>
</td>
<td class="cellrowborder" valign="top" width="60%" headers="mcps1.3.4.2.1.4.1.3 "><p id="obs_11_0041__p1864718233461">The name of the object whose properties are to be set, or the name prefix of objects whose properties are to be set in batches</p>
<p id="obs_11_0041__p141171313817">If this parameter is left blank during batch operation, properties of all objects in the bucket are set.</p>
</td>
</tr>
<tr id="obs_11_0041__row6439831174716"><td class="cellrowborder" valign="top" width="16%" headers="mcps1.3.4.2.1.4.1.1 "><p id="obs_11_0041__p1366223093111">meta</p>
</td>
<td class="cellrowborder" valign="top" width="24%" headers="mcps1.3.4.2.1.4.1.2 "><p id="obs_11_0041__p26631230193118">Optional (additional parameter)</p>
</td>
<td class="cellrowborder" valign="top" width="60%" headers="mcps1.3.4.2.1.4.1.3 "><p id="obs_11_0041__p3377181615919">The standard or user-defined metadata that can be specified for an object when setting properties of the object</p>
<ul id="obs_11_0041__ul01131372111"><li id="obs_11_0041__li11132372016">Standard metadata includes <strong id="obs_11_0041__b1622295613412">Content-Type</strong>, <strong id="obs_11_0041__b102228561640">Content-Encoding</strong>, <strong id="obs_11_0041__b9222135610411">Cache-Control</strong>, <strong id="obs_11_0041__b18222145610411">Content-Disposition</strong>, <strong id="obs_11_0041__b152229561145">Content-Language</strong> and <strong id="obs_11_0041__b422235619411">Expires</strong>.</li><li id="obs_11_0041__li878422619215">User-defined metadata must be in the format of <em id="obs_11_0041__i895416353211">key:value</em>. Multiple user-defined metadata items are separated by number signs (#), for example, <em id="obs_11_0041__i13533151913218">key1:value1</em><strong id="obs_11_0041__b253471943218">#</strong><em id="obs_11_0041__i1953416191329">key2:value2</em><strong id="obs_11_0041__b13534219143215">#</strong><em id="obs_11_0041__i8534181903216">key3:value3</em>, which indicates that the object whose properties are set contains three groups of user-defined metadata: <em id="obs_11_0041__i19534181912328">key1:value1</em>, <em id="obs_11_0041__i45341919153215">key2:value2</em>, and <em id="obs_11_0041__i4534141916323">key3:value3</em>.</li></ul>
<p id="obs_11_0041__p17941525135111"><strong id="obs_11_0041__b147917121896">This parameter must be used together with direct.</strong></p>
</td>
</tr>
<tr id="obs_11_0041__row1797105321314"><td class="cellrowborder" valign="top" width="16%" headers="mcps1.3.4.2.1.4.1.1 "><p id="obs_11_0041__p1298135317139">direct</p>
</td>
<td class="cellrowborder" valign="top" width="24%" headers="mcps1.3.4.2.1.4.1.2 "><p id="obs_11_0041__p1027810150140">Optional (additional parameter)</p>
</td>
<td class="cellrowborder" valign="top" width="60%" headers="mcps1.3.4.2.1.4.1.3 "><p id="obs_11_0041__p6557105518155">The metadata operation indicator</p>
<p id="obs_11_0041__p20557155517150">The value can be:</p>
<ul id="obs_11_0041__ul1694131918108"><li id="obs_11_0041__li16941171910105"><strong id="obs_11_0041__b4895354192617">REPLACE_NEW</strong>: The existing metadata value is replaced with a new one, the metadata lacking a value is assigned one, and the metadata not specified keeps unchanged.</li><li id="obs_11_0041__li1010172516109"><strong id="obs_11_0041__b327012110272">REPLACE</strong>: The metadata is replaced with the header included in the current request and the metadata not specified is deleted.</li></ul>
<p id="obs_11_0041__p10171654191017"><strong id="obs_11_0041__b1871734151717">This parameter must be used together with meta.</strong></p>
</td>
</tr>
<tr id="obs_11_0041__row8533319194211"><td class="cellrowborder" valign="top" width="16%" headers="mcps1.3.4.2.1.4.1.1 "><p id="obs_11_0041__p19533119154211">sc</p>
</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>
<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>
<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>
</td>
</tr>
<tr id="obs_11_0041__row490772910240"><td class="cellrowborder" valign="top" width="16%" headers="mcps1.3.4.2.1.4.1.1 "><p id="obs_11_0041__p990817298248">acl</p>
</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>
<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>
<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>
</tr>
<tr id="obs_11_0041__row32753484186"><td class="cellrowborder" valign="top" width="16%" headers="mcps1.3.4.2.1.4.1.1 "><p id="obs_11_0041__p1258123413176">aclXml</p>
</td>
<td class="cellrowborder" valign="top" width="24%" headers="mcps1.3.4.2.1.4.1.2 "><p id="obs_11_0041__p75818346179">Optional (additional parameter)</p>
</td>
<td class="cellrowborder" valign="top" width="60%" headers="mcps1.3.4.2.1.4.1.3 "><p id="obs_11_0041__p2058173418170">The bucket's access control policy, in XML format. The format is as follows:</p>
<pre class="screen" id="obs_11_0041__screen78378416219">&lt;AccessControlPolicy&gt;
&lt;Owner&gt;
&lt;ID&gt;<em id="obs_11_0041__i131811237783">ownerid</em>&lt;/ID&gt;
&lt;/Owner&gt;
&lt;AccessControlList&gt;
&lt;Grant&gt;
&lt;Grantee&gt;
&lt;ID&gt;<em id="obs_11_0041__i20604651896">userid</em>&lt;/ID&gt;
&lt;/Grantee&gt;
&lt;Permission&gt;<em id="obs_11_0041__i786413238102">[WRITE|WRITE_ACP|READ|READ_ACP|FULL_CONTROL]</em>&lt;/Permission&gt;
&lt;/Grant&gt;
&lt;Grant&gt;
&lt;Grantee&gt;
&lt;Canned&gt;Everyone&lt;/Canned&gt;
&lt;/Grantee&gt;
&lt;Permission&gt;<em id="obs_11_0041__i287517813170">[WRITE|WRITE_ACP|READ|READ_ACP|FULL_CONTROL]</em>&lt;/Permission&gt;
&lt;/Grant&gt;
&lt;/AccessControlList&gt;
&lt;/AccessControlPolicy&gt;</pre>
<ul id="obs_11_0041__ul11591446103319"><li id="obs_11_0041__li478395773216"><strong id="obs_11_0041__b538215791411">Owner</strong>: Optional. Specify the object owner's ID.</li><li id="obs_11_0041__li1867895491914">In <strong id="obs_11_0041__b10739131191420">AccessControlList</strong>, the <strong id="obs_11_0041__b1774018116148">Grant</strong> field contains the authorized users. <strong id="obs_11_0041__b1741201121410">Grantee</strong> specifies the IDs of authorized users. <strong id="obs_11_0041__b674151161414">Canned</strong> specifies the authorized user group (currently, only <strong id="obs_11_0041__b0742211121415">Everyone</strong> is supported).</li><li id="obs_11_0041__li878944832211">The following permissions can be granted:<ul id="obs_11_0041__ul14912151102218"><li id="obs_11_0041__li195575592220"><strong id="obs_11_0041__b1668214343385">WRITE</strong>: the write permission</li><li id="obs_11_0041__li103585932213"><strong id="obs_11_0041__b7847184713384">WRITE_ACP</strong>: the write permission for the ACL</li><li id="obs_11_0041__li790716238"><strong id="obs_11_0041__b15157146163910">READ</strong>: the read permission</li><li id="obs_11_0041__li979518412313"><strong id="obs_11_0041__b13342320113912">READ_ACP</strong>: the read permission for the ACL</li><li id="obs_11_0041__li59122051142217"><strong id="obs_11_0041__b07767328395">FULL_CONTROL</strong>: the full control permission</li></ul>
</li></ul>
<p id="obs_11_0041__p1790263110204"><strong id="obs_11_0041__b12584333204114">Because angle brackets (&lt;) and (&gt;) are unavoidably included in the parameter value, you must use quotation marks to enclose them for escaping when running the command.</strong> Use single quotation marks for Linux or macOS and double quotation marks for Windows.</p>
</td>
</tr>
<tr id="obs_11_0041__row1141710101913"><td class="cellrowborder" valign="top" width="16%" headers="mcps1.3.4.2.1.4.1.1 "><p id="obs_11_0041__p174267194117">versionId</p>
</td>
<td class="cellrowborder" valign="top" width="24%" headers="mcps1.3.4.2.1.4.1.2 "><p id="obs_11_0041__p774216710415">Optional when setting properties of an object (additional parameter)</p>
</td>
<td class="cellrowborder" valign="top" width="60%" headers="mcps1.3.4.2.1.4.1.3 "><p id="obs_11_0041__p874257164113">The version ID of the object whose properties are to be set</p>
</td>
</tr>
<tr id="obs_11_0041__row12415113193"><td class="cellrowborder" valign="top" width="16%" headers="mcps1.3.4.2.1.4.1.1 "><p id="obs_11_0041__p8517143114816">fr</p>
</td>
<td class="cellrowborder" valign="top" width="24%" headers="mcps1.3.4.2.1.4.1.2 "><p id="obs_11_0041__p1965455113483">Optional when setting properties of an object (additional parameter)</p>
</td>
<td class="cellrowborder" valign="top" width="60%" headers="mcps1.3.4.2.1.4.1.3 "><p id="obs_11_0041__p1951718433487">Generates an operation result file when setting properties of an object.</p>
</td>
</tr>
<tr id="obs_11_0041__row18415121181916"><td class="cellrowborder" valign="top" width="16%" headers="mcps1.3.4.2.1.4.1.1 "><p id="obs_11_0041__p9369940145311">f</p>
</td>
<td class="cellrowborder" valign="top" width="24%" headers="mcps1.3.4.2.1.4.1.2 "><p id="obs_11_0041__p19278143834816">Optional when setting properties of objects in batches (additional parameter)</p>
</td>
<td class="cellrowborder" valign="top" width="60%" headers="mcps1.3.4.2.1.4.1.3 "><p id="obs_11_0041__p972417362487">Runs in force mode.</p>
</td>
</tr>
<tr id="obs_11_0041__row1441461141918"><td class="cellrowborder" valign="top" width="16%" headers="mcps1.3.4.2.1.4.1.1 "><p id="obs_11_0041__p71594425537">r</p>
</td>
<td class="cellrowborder" valign="top" width="24%" headers="mcps1.3.4.2.1.4.1.2 "><p id="obs_11_0041__p1273555018488">Mandatory when setting properties of objects in batches (additional parameter)</p>
</td>
<td class="cellrowborder" valign="top" width="60%" headers="mcps1.3.4.2.1.4.1.3 "><p id="obs_11_0041__p1173519509481">Sets properties of objects in batches based on a specified object name prefix.</p>
</td>
</tr>
<tr id="obs_11_0041__row12414181121915"><td class="cellrowborder" valign="top" width="16%" headers="mcps1.3.4.2.1.4.1.1 "><p id="obs_11_0041__p373223134117">v</p>
</td>
<td class="cellrowborder" valign="top" width="24%" headers="mcps1.3.4.2.1.4.1.2 "><p id="obs_11_0041__p101701338485">Optional when setting properties of objects in batches (additional parameter)</p>
</td>
<td class="cellrowborder" valign="top" width="60%" headers="mcps1.3.4.2.1.4.1.3 "><p id="obs_11_0041__p1073202316412">Sets properties of versions of objects in batches based on a specified object name prefix.</p>
</td>
</tr>
<tr id="obs_11_0041__row1241412161915"><td class="cellrowborder" valign="top" width="16%" headers="mcps1.3.4.2.1.4.1.1 "><p id="obs_11_0041__p138574472533">o</p>
</td>
<td class="cellrowborder" valign="top" width="24%" headers="mcps1.3.4.2.1.4.1.2 "><p id="obs_11_0041__p817213354812">Optional (additional parameter)</p>
</td>
<td class="cellrowborder" valign="top" width="60%" headers="mcps1.3.4.2.1.4.1.3 "><p id="obs_11_0041__p1549382992620">The folder that stores the result files. After the command is executed, result files (including success and failure files) will be created in the specified folder.</p>
<p id="obs_11_0041__p4924117181112">The default value is <strong id="obs_11_0041__b62664464113">.obsutil_output</strong>, a subfolder in the user's home directory where obsutil commands are executed.</p>
<ul id="obs_11_0041__ul1938211254515"><li id="obs_11_0041__li2092115541966">A result file should be named as follows: <strong id="obs_11_0041__b740725218113">cp_{succeed | failed | warning}_report_</strong><em id="obs_11_0041__i16408205281111">time</em><strong id="obs_11_0041__b11408752121110">_</strong><em id="obs_11_0041__i15408175216115">TaskId</em><strong id="obs_11_0041__b7408135216118">.txt</strong>.</li><li id="obs_11_0041__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_0041__b1817115631112">recordMaxLogSize</strong> in the configuration file.</li><li id="obs_11_0041__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_0041__b2488195810112">recordBackups</strong> in the configuration file.</li><li id="obs_11_0041__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_0041__obs_11_0013_b5396121718320">cp_failed_report_</strong><em id="obs_11_0041__obs_11_0013_i1639621714325">time</em><strong id="obs_11_0041__obs_11_0013_b1739631753215">_</strong><em id="obs_11_0041__obs_11_0013_i203979172328">TaskId</em><strong id="obs_11_0041__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_0041__row541431131917"><td class="cellrowborder" valign="top" width="16%" headers="mcps1.3.4.2.1.4.1.1 "><p id="obs_11_0041__p87050508534">j</p>
</td>
<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 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></div>
</td>
</tr>
<tr id="obs_11_0041__row12440154817175"><td class="cellrowborder" valign="top" width="16%" headers="mcps1.3.4.2.1.4.1.1 "><p id="obs_11_0041__p114391014518">bucket-cname</p>
</td>
<td class="cellrowborder" valign="top" width="24%" headers="mcps1.3.4.2.1.4.1.2 "><p id="obs_11_0041__p4143210950">Optional (additional parameter)</p>
</td>
<td class="cellrowborder" valign="top" width="60%" headers="mcps1.3.4.2.1.4.1.3 "><p id="obs_11_0041__p16143610251">The user-defined domain name bound to the bucket</p>
<div class="note" id="obs_11_0041__note16256574591"><span class="notetitle"> NOTE: </span><div class="notebody"><p id="obs_11_0041__p172595719595">This parameter is only supported by obsutil 5.7.9 and later.</p>
</div></div>
</td>
</tr>
<tr id="obs_11_0041__row440921733714"><td class="cellrowborder" valign="top" width="16%" headers="mcps1.3.4.2.1.4.1.1 "><p id="obs_11_0041__p153951131317">config</p>
</td>
<td class="cellrowborder" valign="top" width="24%" headers="mcps1.3.4.2.1.4.1.2 "><p id="obs_11_0041__p12395135316">Optional (additional parameter)</p>
</td>
<td class="cellrowborder" valign="top" width="60%" headers="mcps1.3.4.2.1.4.1.3 "><p id="obs_11_0041__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_0041__row11631183917533"><td class="cellrowborder" valign="top" width="16%" headers="mcps1.3.4.2.1.4.1.1 "><p id="obs_11_0041__p1966666191820">payer</p>
</td>
<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 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>
</tr>
</tbody>
</table>
</div>
<div class="note" id="obs_11_0041__note917895681819"><img src="public_sys-resources/note_3.0-en-us.png"><span class="notetitle"> </span><div class="notebody"><p id="obs_11_0041__p1717911569181">Only one from <strong id="obs_11_0041__b116261337164217">acl</strong>, <strong id="obs_11_0041__b11104031134216">sc</strong>, or <strong id="obs_11_0041__b13502194254211">aclXml</strong> can be set for each command.</p>
</div></div>
</div>
<div class="section" id="obs_11_0041__section6926520122416"><h4 class="sectiontitle">Response</h4><p id="obs_11_0041__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>