doc-exports/docs/sfs/api-ref/sfs_02_0030.html
zhangyue 5d0d5cb580 SFS API DOC
Reviewed-by: Muller, Martin <martin.muller@t-systems.com>
Co-authored-by: zhangyue <zhangyue164@huawei.com>
Co-committed-by: zhangyue <zhangyue164@huawei.com>
2023-05-01 07:32:40 +00:00

193 lines
16 KiB
HTML

<a name="sfs_02_0030"></a><a name="sfs_02_0030"></a>
<h1 class="topictitle1">Deleting a File System Access Rule</h1>
<div id="body8662426"><div class="section" id="sfs_02_0030__s1a5be1c634fa405ba06c19e1af9f3d40"><h4 class="sectiontitle">Function</h4><p id="sfs_02_0030__a71a63667cf554a9886b5085738e1bea2">This API is used to delete a file system access rule.</p>
<div class="note" id="sfs_02_0030__n5f42e3d158dd41e697b8978c2c8a31f2"><img src="public_sys-resources/note_3.0-en-us.png"><span class="notetitle"> </span><div class="notebody"><p id="sfs_02_0030__en-us_topic_0064390799_p3563913211">This API is an asynchronous API. If the returned status code is <strong id="sfs_02_0030__b15184114473010">202</strong>, the API request is successfully delivered and received. Later, you can refer to <a href="sfs_02_0031.html">Querying File System Access Rules</a> to identify whether the access rule is deleted successfully.</p>
</div></div>
</div>
<div class="section" id="sfs_02_0030__sd0a208cfe579473ebd8103fe98120524"><h4 class="sectiontitle">URI</h4><ul id="sfs_02_0030__en-us_topic_0064390799_ul5300362"><li id="sfs_02_0030__en-us_topic_0064390799_li47703261">POST /v2/{project_id}/shares/{share_id}/action</li><li id="sfs_02_0030__en-us_topic_0064390799_li26676172">Parameter description
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="sfs_02_0030__en-us_topic_0064390799_table38758958" frame="border" border="1" rules="all"><thead align="left"><tr id="sfs_02_0030__en-us_topic_0064390799_row40742509"><th align="left" class="cellrowborder" valign="top" width="20.16%" id="mcps1.3.2.2.2.1.1.5.1.1"><p id="sfs_02_0030__p17124101410431">Parameter</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="12.83%" id="mcps1.3.2.2.2.1.1.5.1.2"><p id="sfs_02_0030__p1612415146430">Mandatory</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="18.279999999999998%" id="mcps1.3.2.2.2.1.1.5.1.3"><p id="sfs_02_0030__p312416148432">Type</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="48.730000000000004%" id="mcps1.3.2.2.2.1.1.5.1.4"><p id="sfs_02_0030__p3124181464318">Description</p>
</th>
</tr>
</thead>
<tbody><tr id="sfs_02_0030__en-us_topic_0064390799_row63404869"><td class="cellrowborder" valign="top" width="20.16%" headers="mcps1.3.2.2.2.1.1.5.1.1 "><p id="sfs_02_0030__a9ab33272c5414630949ff32c58bf1590">share_id</p>
</td>
<td class="cellrowborder" valign="top" width="12.83%" headers="mcps1.3.2.2.2.1.1.5.1.2 "><p id="sfs_02_0030__ad364fbce5fdc48189bce7a175ee8e94b">Yes</p>
</td>
<td class="cellrowborder" valign="top" width="18.279999999999998%" headers="mcps1.3.2.2.2.1.1.5.1.3 "><p id="sfs_02_0030__a8a6d2a4cc8d244f2b4b374571a243128">String</p>
</td>
<td class="cellrowborder" valign="top" width="48.730000000000004%" headers="mcps1.3.2.2.2.1.1.5.1.4 "><p id="sfs_02_0030__a4fb7cc60bee246c9a28baa9a19a42260">Specifies the ID of the shared file system.</p>
</td>
</tr>
<tr id="sfs_02_0030__en-us_topic_0064390799_row43163346"><td class="cellrowborder" valign="top" width="20.16%" headers="mcps1.3.2.2.2.1.1.5.1.1 "><p id="sfs_02_0030__a59173d5ae3334777871059512bb67a7a">project_id</p>
</td>
<td class="cellrowborder" valign="top" width="12.83%" headers="mcps1.3.2.2.2.1.1.5.1.2 "><p id="sfs_02_0030__en-us_topic_0064390799_p856561217407">Yes</p>
</td>
<td class="cellrowborder" valign="top" width="18.279999999999998%" headers="mcps1.3.2.2.2.1.1.5.1.3 "><p id="sfs_02_0030__a23e80aa107554437b2a2cc9d93ced01a">String</p>
</td>
<td class="cellrowborder" valign="top" width="48.730000000000004%" headers="mcps1.3.2.2.2.1.1.5.1.4 "><p id="sfs_02_0030__a7f2f8b0f2c4a484499c65c3e2a6cb2e6">Specifies the project ID of the operator.</p>
</td>
</tr>
</tbody>
</table>
</div>
</li></ul>
</div>
<div class="section" id="sfs_02_0030__s840db22bfac0425eb0cf3366f68629ef"><h4 class="sectiontitle">Request</h4><ul id="sfs_02_0030__en-us_topic_0064390799_ul25229732"><li id="sfs_02_0030__en-us_topic_0064390799_li4646565">Parameter description
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="sfs_02_0030__en-us_topic_0064390799_table42069424" frame="border" border="1" rules="all"><thead align="left"><tr id="sfs_02_0030__en-us_topic_0064390799_row20618333"><th align="left" class="cellrowborder" valign="top" width="19.791979197919794%" id="mcps1.3.3.2.1.1.1.5.1.1"><p id="sfs_02_0030__p1783914071518">Parameter</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="13.52135213521352%" id="mcps1.3.3.2.1.1.1.5.1.2"><p id="sfs_02_0030__p10839134015152">Mandatory</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="18.801880188018806%" id="mcps1.3.3.2.1.1.1.5.1.3"><p id="sfs_02_0030__p11839940121513">Type</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="47.88478847884789%" id="mcps1.3.3.2.1.1.1.5.1.4"><p id="sfs_02_0030__p883994019154">Description</p>
</th>
</tr>
</thead>
<tbody><tr id="sfs_02_0030__en-us_topic_0064390799_row35228531"><td class="cellrowborder" valign="top" width="19.791979197919794%" headers="mcps1.3.3.2.1.1.1.5.1.1 "><p id="sfs_02_0030__en-us_topic_0064390799_p34938791">os-deny_access</p>
</td>
<td class="cellrowborder" valign="top" width="13.52135213521352%" headers="mcps1.3.3.2.1.1.1.5.1.2 "><p id="sfs_02_0030__abe11d32a4d2143b19ccb091cc19ec0d4">Yes</p>
</td>
<td class="cellrowborder" valign="top" width="18.801880188018806%" headers="mcps1.3.3.2.1.1.1.5.1.3 "><p id="sfs_02_0030__ac6f7260e19d24659ae13f28c9bb97c00">Object</p>
</td>
<td class="cellrowborder" valign="top" width="47.88478847884789%" headers="mcps1.3.3.2.1.1.1.5.1.4 "><p id="sfs_02_0030__en-us_topic_0064390799_p18961705">Specifies the <strong id="sfs_02_0030__afc657c67057642c8b9ab5fbcb404fd03">os-deny_access</strong> object.</p>
</td>
</tr>
</tbody>
</table>
</div>
<div class="note" id="sfs_02_0030__note204513266015"><img src="public_sys-resources/note_3.0-en-us.png"><span class="notetitle"> </span><div class="notebody"><p id="sfs_02_0030__p164572619015">If the API version ranges from 1.0 to 2.6, the top-layer parameters of the request body in the JSON format use prefix <strong id="sfs_02_0030__b64801053131416">os-</strong>. If the API version is later than 2.6, prefix <strong id="sfs_02_0030__b343016557144">os-</strong> must be removed.</p>
</div></div>
</li><li class="litext" id="sfs_02_0030__li175514508261">Description of field <strong id="sfs_02_0030__aa99a8e3119954ce2ad227dfd7797a96b">os-deny_access</strong>
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="sfs_02_0030__table555150142610" frame="border" border="1" rules="all"><thead align="left"><tr id="sfs_02_0030__row655175018260"><th align="left" class="cellrowborder" valign="top" width="19.55%" id="mcps1.3.3.2.2.2.1.5.1.1"><p id="sfs_02_0030__p15515017263">Parameter</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="14.26%" id="mcps1.3.3.2.2.2.1.5.1.2"><p id="sfs_02_0030__p855125092614">Mandatory</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="18.32%" id="mcps1.3.3.2.2.2.1.5.1.3"><p id="sfs_02_0030__p655850112611">Type</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="47.870000000000005%" id="mcps1.3.3.2.2.2.1.5.1.4"><p id="sfs_02_0030__p75525022619">Description</p>
</th>
</tr>
</thead>
<tbody><tr id="sfs_02_0030__row7551050132618"><td class="cellrowborder" valign="top" width="19.55%" headers="mcps1.3.3.2.2.2.1.5.1.1 "><p id="sfs_02_0030__p1855165082620">access_id</p>
</td>
<td class="cellrowborder" valign="top" width="14.26%" headers="mcps1.3.3.2.2.2.1.5.1.2 "><p id="sfs_02_0030__p15551550192613">Yes</p>
</td>
<td class="cellrowborder" valign="top" width="18.32%" headers="mcps1.3.3.2.2.2.1.5.1.3 "><p id="sfs_02_0030__p125585032619">String</p>
</td>
<td class="cellrowborder" valign="top" width="47.870000000000005%" headers="mcps1.3.3.2.2.2.1.5.1.4 "><p id="sfs_02_0030__p255350192610">Specifies the ID of the access rule of the shared file system. The value contains 1 to 36 characters.</p>
</td>
</tr>
</tbody>
</table>
</div>
</li></ul>
<ul id="sfs_02_0030__uba0932b38c6b46ac9d78172bd3e913ba"><li id="sfs_02_0030__l348d3e7515f648d49ec99af0e721d826">Example request<pre class="screen" id="sfs_02_0030__sbb52b69998c045cbaaf1818ea9e65582">{
"os-deny_access": {
"access_id": "418e3cf4-08c3-4ed2-a29a-ceffa346b3b8"
}
}</pre>
</li></ul>
</div>
<div class="section" id="sfs_02_0030__s21a46342638f4cacb04ad589d49cf060"><h4 class="sectiontitle">Response</h4><ul id="sfs_02_0030__en-us_topic_0064390799_ul31903028"><li id="sfs_02_0030__en-us_topic_0064390799_li18691797">Parameter description</li></ul>
<p class="litext" id="sfs_02_0030__en-us_topic_0064390799_p32825243">None</p>
<ul id="sfs_02_0030__en-us_topic_0064390799_ul896237"><li id="sfs_02_0030__laed9ab0784794563ab047c98996eb7b7">Example response<p id="sfs_02_0030__af792514495384491aeb563c6e14f1fbd"><a name="sfs_02_0030__laed9ab0784794563ab047c98996eb7b7"></a><a name="laed9ab0784794563ab047c98996eb7b7"></a>None</p>
</li></ul>
</div>
<div class="section" id="sfs_02_0030__sa0baa7bed4bd4ba08b6422614b2d2a8c"><h4 class="sectiontitle">Status Codes</h4><ul id="sfs_02_0030__en-us_topic_0064390799_ul25580392"><li id="sfs_02_0030__en-us_topic_0064390799_li28896937">Normal<p id="sfs_02_0030__en-us_topic_0064390799_p58745844"><a name="sfs_02_0030__en-us_topic_0064390799_li28896937"></a><a name="en-us_topic_0064390799_li28896937"></a>202</p>
</li><li id="sfs_02_0030__en-us_topic_0064390799_li58950555">Abnormal
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="sfs_02_0030__en-us_topic_0064390799_table60792949" frame="border" border="1" rules="all"><thead align="left"><tr id="sfs_02_0030__en-us_topic_0064390799_row42658596"><th align="left" class="cellrowborder" valign="top" width="43.43%" id="mcps1.3.5.2.2.1.1.3.1.1"><p id="sfs_02_0030__en-us_topic_0064390799_p32794215">Status Code</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="56.57%" id="mcps1.3.5.2.2.1.1.3.1.2"><p id="sfs_02_0030__en-us_topic_0064390799_p39085796">Description</p>
</th>
</tr>
</thead>
<tbody><tr id="sfs_02_0030__en-us_topic_0064390799_row11832897"><td class="cellrowborder" valign="top" width="43.43%" headers="mcps1.3.5.2.2.1.1.3.1.1 "><p id="sfs_02_0030__en-us_topic_0064390799_p18940582">400 Bad Request</p>
</td>
<td class="cellrowborder" valign="top" width="56.57%" headers="mcps1.3.5.2.2.1.1.3.1.2 "><p id="sfs_02_0030__en-us_topic_0064390799_p57792188">The server failed to process the request.</p>
</td>
</tr>
<tr id="sfs_02_0030__en-us_topic_0064390799_row50367649"><td class="cellrowborder" valign="top" width="43.43%" headers="mcps1.3.5.2.2.1.1.3.1.1 "><p id="sfs_02_0030__en-us_topic_0064390799_p53247746">401 Unauthorized</p>
</td>
<td class="cellrowborder" valign="top" width="56.57%" headers="mcps1.3.5.2.2.1.1.3.1.2 "><p id="sfs_02_0030__en-us_topic_0064390799_p18100201">You must enter a username and the password to access the requested page.</p>
</td>
</tr>
<tr id="sfs_02_0030__en-us_topic_0064390799_row28684081"><td class="cellrowborder" valign="top" width="43.43%" headers="mcps1.3.5.2.2.1.1.3.1.1 "><p id="sfs_02_0030__en-us_topic_0064390799_p41709209">403 Forbidden</p>
</td>
<td class="cellrowborder" valign="top" width="56.57%" headers="mcps1.3.5.2.2.1.1.3.1.2 "><p id="sfs_02_0030__en-us_topic_0064390799_p23002745">Access to the requested page is forbidden.</p>
</td>
</tr>
<tr id="sfs_02_0030__en-us_topic_0064390799_row5698118"><td class="cellrowborder" valign="top" width="43.43%" headers="mcps1.3.5.2.2.1.1.3.1.1 "><p id="sfs_02_0030__en-us_topic_0064390799_p58894414">404 Not Found</p>
</td>
<td class="cellrowborder" valign="top" width="56.57%" headers="mcps1.3.5.2.2.1.1.3.1.2 "><p id="sfs_02_0030__en-us_topic_0064390799_p5718243">The requested page was not found.</p>
</td>
</tr>
<tr id="sfs_02_0030__en-us_topic_0064390799_row51464189"><td class="cellrowborder" valign="top" width="43.43%" headers="mcps1.3.5.2.2.1.1.3.1.1 "><p id="sfs_02_0030__en-us_topic_0064390799_p7849808">405 Method Not Allowed</p>
</td>
<td class="cellrowborder" valign="top" width="56.57%" headers="mcps1.3.5.2.2.1.1.3.1.2 "><p id="sfs_02_0030__en-us_topic_0064390799_p31854691">You are not allowed to use the method specified in the request.</p>
</td>
</tr>
<tr id="sfs_02_0030__en-us_topic_0064390799_row18256764"><td class="cellrowborder" valign="top" width="43.43%" headers="mcps1.3.5.2.2.1.1.3.1.1 "><p id="sfs_02_0030__en-us_topic_0064390799_p2402898">406 Not Acceptable</p>
</td>
<td class="cellrowborder" valign="top" width="56.57%" headers="mcps1.3.5.2.2.1.1.3.1.2 "><p id="sfs_02_0030__en-us_topic_0064390799_p60417086">The response generated by the server could not be accepted by the client.</p>
</td>
</tr>
<tr id="sfs_02_0030__en-us_topic_0064390799_row6882862"><td class="cellrowborder" valign="top" width="43.43%" headers="mcps1.3.5.2.2.1.1.3.1.1 "><p id="sfs_02_0030__en-us_topic_0064390799_p20640979">407 Proxy Authentication Required</p>
</td>
<td class="cellrowborder" valign="top" width="56.57%" headers="mcps1.3.5.2.2.1.1.3.1.2 "><p id="sfs_02_0030__en-us_topic_0064390799_p61306625">You must use the proxy server for authentication. Then the request can be processed.</p>
</td>
</tr>
<tr id="sfs_02_0030__en-us_topic_0064390799_row14888714"><td class="cellrowborder" valign="top" width="43.43%" headers="mcps1.3.5.2.2.1.1.3.1.1 "><p id="sfs_02_0030__en-us_topic_0064390799_p65135191">408 Request Timeout</p>
</td>
<td class="cellrowborder" valign="top" width="56.57%" headers="mcps1.3.5.2.2.1.1.3.1.2 "><p id="sfs_02_0030__en-us_topic_0064390799_p41459137">The request timed out.</p>
</td>
</tr>
<tr id="sfs_02_0030__en-us_topic_0064390799_row37587916"><td class="cellrowborder" valign="top" width="43.43%" headers="mcps1.3.5.2.2.1.1.3.1.1 "><p id="sfs_02_0030__en-us_topic_0064390799_p24722347">409 Conflict</p>
</td>
<td class="cellrowborder" valign="top" width="56.57%" headers="mcps1.3.5.2.2.1.1.3.1.2 "><p id="sfs_02_0030__en-us_topic_0064390799_p56353115">The request could not be processed due to a conflict.</p>
</td>
</tr>
<tr id="sfs_02_0030__en-us_topic_0064390799_row37415993"><td class="cellrowborder" valign="top" width="43.43%" headers="mcps1.3.5.2.2.1.1.3.1.1 "><p id="sfs_02_0030__en-us_topic_0064390799_p10796581">500 Internal Server Error</p>
</td>
<td class="cellrowborder" valign="top" width="56.57%" headers="mcps1.3.5.2.2.1.1.3.1.2 "><p id="sfs_02_0030__en-us_topic_0064390799_p2107829">Failed to complete the request because of an internal service error.</p>
</td>
</tr>
<tr id="sfs_02_0030__en-us_topic_0064390799_row18970462"><td class="cellrowborder" valign="top" width="43.43%" headers="mcps1.3.5.2.2.1.1.3.1.1 "><p id="sfs_02_0030__en-us_topic_0064390799_p60212448">501 Not Implemented</p>
</td>
<td class="cellrowborder" valign="top" width="56.57%" headers="mcps1.3.5.2.2.1.1.3.1.2 "><p id="sfs_02_0030__en-us_topic_0064390799_p45370106">Failed to complete the request because the server does not support the requested function.</p>
</td>
</tr>
<tr id="sfs_02_0030__en-us_topic_0064390799_row5677776"><td class="cellrowborder" valign="top" width="43.43%" headers="mcps1.3.5.2.2.1.1.3.1.1 "><p id="sfs_02_0030__en-us_topic_0064390799_p57246722">502 Bad Gateway</p>
</td>
<td class="cellrowborder" valign="top" width="56.57%" headers="mcps1.3.5.2.2.1.1.3.1.2 "><p id="sfs_02_0030__en-us_topic_0064390799_p6472929">Failed to complete the request because the request is invalid.</p>
</td>
</tr>
<tr id="sfs_02_0030__en-us_topic_0064390799_row58256364"><td class="cellrowborder" valign="top" width="43.43%" headers="mcps1.3.5.2.2.1.1.3.1.1 "><p id="sfs_02_0030__en-us_topic_0064390799_p21145081">503 Service Unavailable</p>
</td>
<td class="cellrowborder" valign="top" width="56.57%" headers="mcps1.3.5.2.2.1.1.3.1.2 "><p id="sfs_02_0030__en-us_topic_0064390799_p35029990">Failed to complete the request because the service is unavailable.</p>
</td>
</tr>
<tr id="sfs_02_0030__en-us_topic_0064390799_row46834456"><td class="cellrowborder" valign="top" width="43.43%" headers="mcps1.3.5.2.2.1.1.3.1.1 "><p id="sfs_02_0030__en-us_topic_0064390799_p35494585">504 Gateway Timeout</p>
</td>
<td class="cellrowborder" valign="top" width="56.57%" headers="mcps1.3.5.2.2.1.1.3.1.2 "><p id="sfs_02_0030__en-us_topic_0064390799_p56489102">A gateway timeout error occurred.</p>
</td>
</tr>
</tbody>
</table>
</div>
</li></ul>
</div>
</div>
<div>
<div class="familylinks">
<div class="parentlink"><strong>Parent topic:</strong> <a href="sfs_02_0028.html">File System Access Rules</a></div>
</div>
</div>