forked from docs/doc-exports
zhangyue
e0d0a83c1f
Reviewed-by: Muller, Martin <martin.muller@t-systems.com> Co-authored-by: zhangyue <zhangyue164@huawei.com> Co-committed-by: zhangyue <zhangyue164@huawei.com>
235 lines
16 KiB
HTML
235 lines
16 KiB
HTML
<a name="sfs_02_0116"></a><a name="sfs_02_0116"></a>
|
|
|
|
<h1 class="topictitle1">Configuring a File System ACL</h1>
|
|
<div id="body0000001389475177"><div class="section" id="sfs_02_0116__section7636107125210"><h4 class="sectiontitle">Function</h4><p id="sfs_02_0116__p116378716526">This API is used to configure a file system ACL.</p>
|
|
<div class="note" id="sfs_02_0116__note43094431654"><img src="public_sys-resources/note_3.0-en-us.png"><span class="notetitle"> </span><div class="notebody"><p id="sfs_02_0116__p93101243358">After the ACL is configured, the configuration takes about 30 second to take effect.</p>
|
|
</div></div>
|
|
</div>
|
|
<div class="section" id="sfs_02_0116__section1563787145210"><h4 class="sectiontitle">URI</h4><p id="sfs_02_0116__p9638375521">PUT /</p>
|
|
|
|
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="sfs_02_0116__table1463913735220" frame="border" border="1" rules="all"><caption><b>Table 1 </b>Query parameter</caption><thead align="left"><tr id="sfs_02_0116__row156386715216"><th align="left" class="cellrowborder" valign="top" width="20%" id="mcps1.3.2.3.2.5.1.1"><p id="sfs_02_0116__p1763917765214">Parameter</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="20%" id="mcps1.3.2.3.2.5.1.2"><p id="sfs_02_0116__p16406735210">Mandatory</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="20%" id="mcps1.3.2.3.2.5.1.3"><p id="sfs_02_0116__p36412735212">Type</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="40%" id="mcps1.3.2.3.2.5.1.4"><p id="sfs_02_0116__p1964118715217">Description</p>
|
|
</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody><tr id="sfs_02_0116__row1863812735218"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.2.3.2.5.1.1 "><p id="sfs_02_0116__p1364213711522">sfsacl</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.2.3.2.5.1.2 "><p id="sfs_02_0116__p196421073524">Yes</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.2.3.2.5.1.3 "><p id="sfs_02_0116__p16434725210">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="40%" headers="mcps1.3.2.3.2.5.1.4 "><p id="sfs_02_0116__p1364315719527">/</p>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
</div>
|
|
<div class="section" id="sfs_02_0116__section0644971520"><h4 class="sectiontitle">Request Parameters</h4>
|
|
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="sfs_02_0116__en-us_topic_0000001310871229_en-us_topic_0000001311039645_HeaderParameter" frame="border" border="1" rules="all"><caption><b>Table 2 </b>Request header parameters</caption><thead align="left"><tr id="sfs_02_0116__row064515712520"><th align="left" class="cellrowborder" valign="top" width="20%" id="mcps1.3.3.2.2.5.1.1"><p id="sfs_02_0116__p864620715219">Parameter</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="20%" id="mcps1.3.3.2.2.5.1.2"><p id="sfs_02_0116__p156478785211">Mandatory</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="20%" id="mcps1.3.3.2.2.5.1.3"><p id="sfs_02_0116__p26471715211">Type</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="40%" id="mcps1.3.3.2.2.5.1.4"><p id="sfs_02_0116__p1564767105216">Description</p>
|
|
</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody><tr id="sfs_02_0116__row764518735213"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.2.2.5.1.1 "><p id="sfs_02_0116__p1864819715525">Date</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.2.2.5.1.2 "><p id="sfs_02_0116__p964897205217">Yes</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.2.2.5.1.3 "><p id="sfs_02_0116__p6650147185210">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="40%" headers="mcps1.3.3.2.2.5.1.4 "><p id="sfs_02_0116__p14651178522">The request time.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="sfs_02_0116__row2645877526"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.2.2.5.1.1 "><p id="sfs_02_0116__p18651578522">Authorization</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.2.2.5.1.2 "><p id="sfs_02_0116__p065215755216">Yes</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.2.2.5.1.3 "><p id="sfs_02_0116__p1565314775213">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="40%" headers="mcps1.3.3.2.2.5.1.4 "><p id="sfs_02_0116__p365377195215">The signature information.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="sfs_02_0116__row176451795219"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.2.2.5.1.1 "><p id="sfs_02_0116__p265419714520">Host</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.2.2.5.1.2 "><p id="sfs_02_0116__p1265412775213">Yes</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.2.2.5.1.3 "><p id="sfs_02_0116__p36541785218">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="40%" headers="mcps1.3.3.2.2.5.1.4 "><p id="sfs_02_0116__p11655977527">The host address.</p>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
|
|
<div class="tablenoborder"><a name="sfs_02_0116__en-us_topic_0000001310871229_en-us_topic_0000001311039645_request_Statement"></a><a name="en-us_topic_0000001310871229_en-us_topic_0000001311039645_request_Statement"></a><table cellpadding="4" cellspacing="0" summary="" id="sfs_02_0116__en-us_topic_0000001310871229_en-us_topic_0000001311039645_request_Statement" frame="border" border="1" rules="all"><caption><b>Table 3 </b>Request body parameter</caption><thead align="left"><tr id="sfs_02_0116__row16550713523"><th align="left" class="cellrowborder" valign="top" width="20%" id="mcps1.3.3.3.2.5.1.1"><p id="sfs_02_0116__p1465607205213">Parameter</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="20%" id="mcps1.3.3.3.2.5.1.2"><p id="sfs_02_0116__p186576713522">Mandatory</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="20%" id="mcps1.3.3.3.2.5.1.3"><p id="sfs_02_0116__p36576712522">Type</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="40%" id="mcps1.3.3.3.2.5.1.4"><p id="sfs_02_0116__p96581576521">Description</p>
|
|
</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody><tr id="sfs_02_0116__row106561078521"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.3.2.5.1.1 "><p id="sfs_02_0116__p146581277522">Statement</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.3.2.5.1.2 "><p id="sfs_02_0116__p26589755216">No</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.3.2.5.1.3 "><p id="sfs_02_0116__p865920719523">Array of <a href="#sfs_02_0116__en-us_topic_0000001310871229_en-us_topic_0000001311039645_request_Statement">Statement</a> objects</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="40%" headers="mcps1.3.3.3.2.5.1.4 "><p id="sfs_02_0116__p11659207195211">Unique identification</p>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
|
|
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="sfs_02_0116__table366019785218" frame="border" border="1" rules="all"><caption><b>Table 4 </b>Statement</caption><thead align="left"><tr id="sfs_02_0116__row1666015714523"><th align="left" class="cellrowborder" valign="top" width="20%" id="mcps1.3.3.4.2.5.1.1"><p id="sfs_02_0116__p16661207145215">Parameter</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="20%" id="mcps1.3.3.4.2.5.1.2"><p id="sfs_02_0116__p13662207165217">Mandatory</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="20%" id="mcps1.3.3.4.2.5.1.3"><p id="sfs_02_0116__p156622711521">Type</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="40%" id="mcps1.3.3.4.2.5.1.4"><p id="sfs_02_0116__p1066315719528">Description</p>
|
|
</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody><tr id="sfs_02_0116__row166010785214"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.4.2.5.1.1 "><p id="sfs_02_0116__p10663127175217">Sid</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.4.2.5.1.2 "><p id="sfs_02_0116__p06641714521">No</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.4.2.5.1.3 "><p id="sfs_02_0116__p366418717526">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="40%" headers="mcps1.3.3.4.2.5.1.4 "><p id="sfs_02_0116__p1666414765212">The statement ID.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="sfs_02_0116__row14660167125214"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.4.2.5.1.1 "><p id="sfs_02_0116__p96653765216">Action</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.4.2.5.1.2 "><p id="sfs_02_0116__p866615716529">Yes</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.4.2.5.1.3 "><p id="sfs_02_0116__p1966717195217">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="40%" headers="mcps1.3.3.4.2.5.1.4 "><p id="sfs_02_0116__p66676785211">The allowed statement action.</p>
|
|
<p id="sfs_02_0116__p1666718795210">Enumerated values:</p>
|
|
<ul id="sfs_02_0116__ul1466817785213"><li id="sfs_02_0116__li166814725210"><strong id="sfs_02_0116__b66861266996">FullControl</strong>: read/write</li><li id="sfs_02_0116__li96681773522"><strong id="sfs_02_0116__b115300244196">Read</strong>: read-only</li></ul>
|
|
</td>
|
|
</tr>
|
|
<tr id="sfs_02_0116__row366011775215"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.4.2.5.1.1 "><p id="sfs_02_0116__p4669187125211">Effect</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.4.2.5.1.2 "><p id="sfs_02_0116__p666947165214">Yes</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.4.2.5.1.3 "><p id="sfs_02_0116__p1767018725210">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="40%" headers="mcps1.3.3.4.2.5.1.4 "><p id="sfs_02_0116__p1267016765211">The effect specifying that the statement permission is <strong id="sfs_02_0116__b3810420101817">Allow</strong>.</p>
|
|
<p id="sfs_02_0116__p1267015745210">Enumerated value:</p>
|
|
<ul id="sfs_02_0116__ul1167117735218"><li id="sfs_02_0116__li1767167195211"><strong id="sfs_02_0116__b15671117155218">Allow</strong></li></ul>
|
|
</td>
|
|
</tr>
|
|
<tr id="sfs_02_0116__row15661675529"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.4.2.5.1.1 "><p id="sfs_02_0116__p86718712527">Condition</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.4.2.5.1.2 "><p id="sfs_02_0116__p667257115211">Yes</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.4.2.5.1.3 "><p id="sfs_02_0116__p1067212712523"><a href="#sfs_02_0116__en-us_topic_0000001310871229_en-us_topic_0000001311039645_request_Condition">Condition</a> object</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="40%" headers="mcps1.3.3.4.2.5.1.4 "><p id="sfs_02_0116__p146735725218">The conditions for a statement to take effect.</p>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
|
|
<div class="tablenoborder"><a name="sfs_02_0116__en-us_topic_0000001310871229_en-us_topic_0000001311039645_request_Condition"></a><a name="en-us_topic_0000001310871229_en-us_topic_0000001311039645_request_Condition"></a><table cellpadding="4" cellspacing="0" summary="" id="sfs_02_0116__en-us_topic_0000001310871229_en-us_topic_0000001311039645_request_Condition" frame="border" border="1" rules="all"><caption><b>Table 5 </b>Condition</caption><thead align="left"><tr id="sfs_02_0116__row46736718525"><th align="left" class="cellrowborder" valign="top" width="20%" id="mcps1.3.3.5.2.5.1.1"><p id="sfs_02_0116__p136751770528">Parameter</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="20%" id="mcps1.3.3.5.2.5.1.2"><p id="sfs_02_0116__p14675117125219">Mandatory</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="20%" id="mcps1.3.3.5.2.5.1.3"><p id="sfs_02_0116__p15675679522">Type</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="40%" id="mcps1.3.3.5.2.5.1.4"><p id="sfs_02_0116__p16763712524">Description</p>
|
|
</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody><tr id="sfs_02_0116__row16746775220"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.5.2.5.1.1 "><p id="sfs_02_0116__p86761379522">SourceVpc</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.5.2.5.1.2 "><p id="sfs_02_0116__p17677978524">Yes</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.5.2.5.1.3 "><p id="sfs_02_0116__p166772716520">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="40%" headers="mcps1.3.3.5.2.5.1.4 "><p id="sfs_02_0116__p166784795211">A specified VPC ID.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="sfs_02_0116__row96743725214"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.5.2.5.1.1 "><p id="sfs_02_0116__p467811718525">VpcSourceIp</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.5.2.5.1.2 "><p id="sfs_02_0116__p116786755214">No</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.5.2.5.1.3 "><p id="sfs_02_0116__p867937165216">Array of strings</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="40%" headers="mcps1.3.3.5.2.5.1.4 "><p id="sfs_02_0116__p106792710526">A specified IP address or IP address range. This parameter is currently not supported.</p>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
</div>
|
|
<div class="section" id="sfs_02_0116__section16791871522"><h4 class="sectiontitle">Response Parameters</h4><p id="sfs_02_0116__p11680178529">This response uses common headers. For details, see <a href="sfs_02_0106.html#sfs_02_0106__en-us_topic_0000001263068826_d0e686">Table 1</a>.</p>
|
|
</div>
|
|
<div class="section" id="sfs_02_0116__section176807717520"><h4 class="sectiontitle">Example Request</h4><p id="sfs_02_0116__p8794583376">Configuring a file system ACL (granting the read/write permissions for IP addresses <strong id="sfs_02_0116__b9449142612397">127.0.0.1/24</strong> and <strong id="sfs_02_0116__b10226829113919">192.168.1.85/24</strong> in VPC <strong id="sfs_02_0116__b182361732103911">241dbf6b-dc5d-41b2-9108-ca5e56b48386</strong>):</p>
|
|
<pre class="screen" id="sfs_02_0116__screen4683678524">PUT /?sfsacl HTTP/1.1
|
|
Host: examplefilesystem.sfs3.example.region.com
|
|
Date: WED, 01 Jul 2015 02:32:25 GMT
|
|
Authorization: OBS H4IPJX0TQTHTHEBQQCEC:jZiAT8Vx4azWEvPRMWi0X5BpJMA=
|
|
|
|
{
|
|
"Statement": [{
|
|
"Sid": "Stmt1375240018061",
|
|
"Action": "FullControl",
|
|
"Effect": "Allow",
|
|
"Condition": {
|
|
"SourceVpc": "241dbf6b-dc5d-41b2-9108-ca5e56b48386",
|
|
"VpcSourceIp": ["127.0.0.1/24", "192.168.1.85/24"]
|
|
}
|
|
}]
|
|
}</pre>
|
|
</div>
|
|
<div class="section" id="sfs_02_0116__section168947105215"><h4 class="sectiontitle">Example Response</h4><pre class="screen" id="sfs_02_0116__screen20862123142015">HTTP/1.1 204 OK
|
|
Server: OBS
|
|
X-Obs-Request-Id: 0000018893B8073AC04721AA7EE3408B
|
|
X-Obs-Id-2: 32AAAQAAEAABSAAgAAEAABAAAQAAEAABCS5QDe0QLbFNz6FXoKuXHzD2wS0eJQaj
|
|
Date: Wed, 07 Jun 2023 02:38:11 GMT</pre>
|
|
</div>
|
|
<div class="section" id="sfs_02_0116__section186901078526"><h4 class="sectiontitle">Status Codes</h4>
|
|
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="sfs_02_0116__en-us_topic_0000001310871229_en-us_topic_0000001311039645_status_code" frame="border" border="1" rules="all"><thead align="left"><tr id="sfs_02_0116__row269112714521"><th align="left" class="cellrowborder" valign="top" width="15%" id="mcps1.3.7.2.1.3.1.1"><p id="sfs_02_0116__p66921375522">Status Code</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="85%" id="mcps1.3.7.2.1.3.1.2"><p id="sfs_02_0116__p1869313775214">Description</p>
|
|
</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody><tr id="sfs_02_0116__row166927745213"><td class="cellrowborder" valign="top" width="15%" headers="mcps1.3.7.2.1.3.1.1 "><p id="sfs_02_0116__p46932765218">204</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="85%" headers="mcps1.3.7.2.1.3.1.2 "><p id="sfs_02_0116__p669410785220">The file system ACL is configured.</p>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
</div>
|
|
<div class="section" id="sfs_02_0116__section969477135214"><h4 class="sectiontitle">Error Codes</h4><p id="sfs_02_0116__p126948713524">See <a href="sfs_02_0119.html">General Purpose File System Error Codes</a>.</p>
|
|
</div>
|
|
</div>
|
|
<div>
|
|
<div class="familylinks">
|
|
<div class="parentlink"><strong>Parent topic:</strong> <a href="sfs_02_0115.html">File System Access Rules</a></div>
|
|
</div>
|
|
</div>
|
|
|