forked from docs/doc-exports
Reviewed-by: gtema <artem.goncharov@gmail.com> Co-authored-by: Wei, Hongmin <weihongmin1@huawei.com> Co-committed-by: Wei, Hongmin <weihongmin1@huawei.com>
201 lines
17 KiB
HTML
201 lines
17 KiB
HTML
<a name="sfs_02_0034"></a><a name="sfs_02_0034"></a>
|
|
|
|
<h1 class="topictitle1">Expanding a Shared File System</h1>
|
|
<div id="body8662426"><div class="section" id="sfs_02_0034__s4f6c8c4d908b42c684eb84e837062288"><h4 class="sectiontitle">Function</h4><p id="sfs_02_0034__a88a5e892201043caa11f5eb61e5b27f2">This API is used to expand the capacity of a shared file system.</p>
|
|
<div class="note" id="sfs_02_0034__n68423a05d21943ffaa3b063db1f0f5dd"><img src="public_sys-resources/note_3.0-en-us.png"><span class="notetitle"> </span><div class="notebody"><p id="sfs_02_0034__en-us_topic_0076901182_p3563913211">This API is an asynchronous API. If the returned status code is <strong id="sfs_02_0034__b193774217327">202</strong>, the API request is successfully delivered and received. Later, you can refer to <a href="sfs_02_0024.html">Querying Details About a Shared File System</a> to identify whether the shared file system is expanded successfully.</p>
|
|
</div></div>
|
|
</div>
|
|
<div class="section" id="sfs_02_0034__sd7de213608b64be19fc069d3ed492035"><h4 class="sectiontitle">URI</h4><ul id="sfs_02_0034__en-us_topic_0076901182_ul29185940"><li id="sfs_02_0034__en-us_topic_0076901182_li61346876">POST /v2/{project_id}/shares/{share_id}/action</li><li id="sfs_02_0034__en-us_topic_0076901182_li27369819">Parameter description
|
|
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="sfs_02_0034__en-us_topic_0076901182_table45001781" frame="border" border="1" rules="all"><thead align="left"><tr id="sfs_02_0034__en-us_topic_0076901182_row42052973"><th align="left" class="cellrowborder" valign="top" width="18.96%" id="mcps1.3.2.2.2.1.1.5.1.1"><p id="sfs_02_0034__p17124101410431">Parameter</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="13.489999999999998%" id="mcps1.3.2.2.2.1.1.5.1.2"><p id="sfs_02_0034__p1612415146430">Mandatory</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="21.93%" id="mcps1.3.2.2.2.1.1.5.1.3"><p id="sfs_02_0034__p312416148432">Type</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="45.62%" id="mcps1.3.2.2.2.1.1.5.1.4"><p id="sfs_02_0034__p3124181464318">Description</p>
|
|
</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody><tr id="sfs_02_0034__en-us_topic_0076901182_row33631540"><td class="cellrowborder" valign="top" width="18.96%" headers="mcps1.3.2.2.2.1.1.5.1.1 "><p id="sfs_02_0034__aedfbfdb579c44e8999a6b19f0c120f21">share_id</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="13.489999999999998%" headers="mcps1.3.2.2.2.1.1.5.1.2 "><p id="sfs_02_0034__a3121e3e565c84c5c9a278230940473b8">Yes</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="21.93%" headers="mcps1.3.2.2.2.1.1.5.1.3 "><p id="sfs_02_0034__ab2a72bed03004193a29602dddc423715">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="45.62%" headers="mcps1.3.2.2.2.1.1.5.1.4 "><p id="sfs_02_0034__a4dc199fc384e446b91b4c696aba10de2">Specifies the ID of the shared file system.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="sfs_02_0034__en-us_topic_0076901182_row52334961"><td class="cellrowborder" valign="top" width="18.96%" headers="mcps1.3.2.2.2.1.1.5.1.1 "><p id="sfs_02_0034__a13d92d0f99b64184bf787c5aaaf08e68">project_id</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="13.489999999999998%" headers="mcps1.3.2.2.2.1.1.5.1.2 "><p id="sfs_02_0034__addb93471cf8f4e28868bab4ff0e872c1">Yes</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="21.93%" headers="mcps1.3.2.2.2.1.1.5.1.3 "><p id="sfs_02_0034__a582ca5c66a514507a75aca16841d8b47">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="45.62%" headers="mcps1.3.2.2.2.1.1.5.1.4 "><p id="sfs_02_0034__abfe5b79c46fc49e8a0a9562a7a4ee510">Specifies the project ID of the operator.</p>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
</li></ul>
|
|
</div>
|
|
<div class="section" id="sfs_02_0034__s3a7db8387fb7411d8cd846a82e921b21"><h4 class="sectiontitle">Request</h4><ul id="sfs_02_0034__en-us_topic_0076901182_ul51488348"><li id="sfs_02_0034__en-us_topic_0076901182_li60741955">Parameter description
|
|
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="sfs_02_0034__td1edbbef558c45dc93c04a19b4d19c95" frame="border" border="1" rules="all"><thead align="left"><tr id="sfs_02_0034__r6316f3ede17f448b8d59d8f206e4cb2d"><th align="left" class="cellrowborder" valign="top" width="19.041904190419043%" id="mcps1.3.3.2.1.1.1.5.1.1"><p id="sfs_02_0034__p131881436162417">Parameter</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="13.491349134913492%" id="mcps1.3.3.2.1.1.1.5.1.2"><p id="sfs_02_0034__p191881736142411">Mandatory</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="21.992199219921993%" id="mcps1.3.3.2.1.1.1.5.1.3"><p id="sfs_02_0034__p720210367248">Type</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="45.474547454745476%" id="mcps1.3.3.2.1.1.1.5.1.4"><p id="sfs_02_0034__p520212367242">Description</p>
|
|
</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody><tr id="sfs_02_0034__r66d0739dd8074f8fb9f374eb544d4975"><td class="cellrowborder" valign="top" width="19.041904190419043%" headers="mcps1.3.3.2.1.1.1.5.1.1 "><p id="sfs_02_0034__en-us_topic_0076901182_p558669416566">os-extend</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="13.491349134913492%" headers="mcps1.3.3.2.1.1.1.5.1.2 "><p id="sfs_02_0034__aa732e4db77d047edb2a11e0c9849eef9">Yes</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="21.992199219921993%" headers="mcps1.3.3.2.1.1.1.5.1.3 "><p id="sfs_02_0034__a98e384c67a554123a24dda987cef6c10">Object</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="45.474547454745476%" headers="mcps1.3.3.2.1.1.1.5.1.4 "><p id="sfs_02_0034__a58584a8208054f19b1d8b19d5d1d998a">Specifies the <strong id="sfs_02_0034__a830cecef16ad4e0aaccf32b92495055d">os-extend</strong> object.</p>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
</li><li class="litext" id="sfs_02_0034__li02731039192716">Description of field <strong id="sfs_02_0034__a99b8525fc22a40dcae6632397a300b79">os-extend</strong>
|
|
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="sfs_02_0034__t5f52f8ee95e042c999e4c980a32639ca" frame="border" border="1" rules="all"><thead align="left"><tr id="sfs_02_0034__r927230140bfd4f158c1e71fdd1175ac8"><th align="left" class="cellrowborder" valign="top" width="19.09190919091909%" id="mcps1.3.3.2.2.2.1.5.1.1"><p id="sfs_02_0034__p471810438242">Parameter</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="13.611361136113612%" id="mcps1.3.3.2.2.2.1.5.1.2"><p id="sfs_02_0034__p1971864317241">Mandatory</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="21.802180218021803%" id="mcps1.3.3.2.2.2.1.5.1.3"><p id="sfs_02_0034__p13718114314248">Type</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="45.4945494549455%" id="mcps1.3.3.2.2.2.1.5.1.4"><p id="sfs_02_0034__p1971810432247">Description</p>
|
|
</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody><tr id="sfs_02_0034__rc028b30fffb54c19a3beb3b6076a1c22"><td class="cellrowborder" valign="top" width="19.09190919091909%" headers="mcps1.3.3.2.2.2.1.5.1.1 "><p id="sfs_02_0034__en-us_topic_0076901182_p175453116566">new_size</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="13.611361136113612%" headers="mcps1.3.3.2.2.2.1.5.1.2 "><p id="sfs_02_0034__a21f0e930a19543bbbf58337ee63c2b51">Yes</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="21.802180218021803%" headers="mcps1.3.3.2.2.2.1.5.1.3 "><p id="sfs_02_0034__ac05b15b7a921463a8b6bb53b8a087420">Integer</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="45.4945494549455%" headers="mcps1.3.3.2.2.2.1.5.1.4 "><p id="sfs_02_0034__a08a732f87cea4d28b8931eb0b3621bc9">Specifies the post-expansion capacity (GB) of the shared file system.</p>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
</li></ul>
|
|
<ul id="sfs_02_0034__u434deb31f4cf492a8cb7b55513fa65f2"><li id="sfs_02_0034__en-us_topic_0076901182_li21151286">Example request<pre class="screen" id="sfs_02_0034__se4447b9628bd41c9bfa67c3a8dfe3238">{
|
|
"os-extend": {
|
|
"new_size": 2
|
|
}
|
|
}</pre>
|
|
</li></ul>
|
|
</div>
|
|
<div class="section" id="sfs_02_0034__s8703d904c5b7413188ce12352326a73e"><h4 class="sectiontitle">Response</h4><ul id="sfs_02_0034__en-us_topic_0076901182_ul51358334"><li id="sfs_02_0034__en-us_topic_0076901182_li59571824">Parameter description<p id="sfs_02_0034__af40a8a72fa024e808a84943a44c493cf"><a name="sfs_02_0034__en-us_topic_0076901182_li59571824"></a><a name="en-us_topic_0076901182_li59571824"></a>None</p>
|
|
</li></ul>
|
|
<ul id="sfs_02_0034__en-us_topic_0076901182_ul16836485"><li id="sfs_02_0034__en-us_topic_0076901182_li17310640">Example response<p id="sfs_02_0034__ac7bebbd8a6534dc6abb4d9031daf09ed"><a name="sfs_02_0034__en-us_topic_0076901182_li17310640"></a><a name="en-us_topic_0076901182_li17310640"></a>None</p>
|
|
</li></ul>
|
|
</div>
|
|
<div class="section" id="sfs_02_0034__s7194f469973442a09f40e4760eb0a747"><h4 class="sectiontitle">Status Codes</h4><ul id="sfs_02_0034__en-us_topic_0076901182_ul2990516"><li id="sfs_02_0034__en-us_topic_0076901182_li26914650">Normal<p id="sfs_02_0034__en-us_topic_0076901182_p40905261"><a name="sfs_02_0034__en-us_topic_0076901182_li26914650"></a><a name="en-us_topic_0076901182_li26914650"></a>202</p>
|
|
</li><li id="sfs_02_0034__en-us_topic_0076901182_li32603030">Abnormal
|
|
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="sfs_02_0034__en-us_topic_0076901182_table24991814" frame="border" border="1" rules="all"><thead align="left"><tr id="sfs_02_0034__en-us_topic_0076901182_row17706563"><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_0034__en-us_topic_0076901182_p24945537">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_0034__en-us_topic_0076901182_p7322627">Description</p>
|
|
</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody><tr id="sfs_02_0034__en-us_topic_0076901182_row56261938"><td class="cellrowborder" valign="top" width="43.43%" headers="mcps1.3.5.2.2.1.1.3.1.1 "><p id="sfs_02_0034__en-us_topic_0076901182_p60923125">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_0034__en-us_topic_0076901182_p35826101">The server failed to process the request.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="sfs_02_0034__r6a88088baf7c4c158aa8a4c6bccf7c34"><td class="cellrowborder" valign="top" width="43.43%" headers="mcps1.3.5.2.2.1.1.3.1.1 "><p id="sfs_02_0034__en-us_topic_0076901182_p534990621322">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_0034__a831eaa0025e24bd6884fed2bb2a5df4f">Invalid input: The post-deduction capacity must be larger than 0 and smaller than the current capacity. (Current capacity: <em id="sfs_02_0034__i1442372620142837">XX</em>; post-deduction capacity: <em id="sfs_02_0034__i1852505181142837">XX</em>)</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="sfs_02_0034__r4bc3f27fc2384de9ade4c5976682e08d"><td class="cellrowborder" valign="top" width="43.43%" headers="mcps1.3.5.2.2.1.1.3.1.1 "><p id="sfs_02_0034__a59b5a7ea71554a679c1147c64cbbf34a">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_0034__ae6d27ab5da85456aa12088fd4e2afe71">Invalid input: The post-expansion capacity must be larger than the current capacity. (Current capacity: <em id="sfs_02_0034__i167922714514297">XX</em>; post-expansion capacity: <em id="sfs_02_0034__i66903648114297">XX</em>)</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="sfs_02_0034__en-us_topic_0076901182_row53999455"><td class="cellrowborder" valign="top" width="43.43%" headers="mcps1.3.5.2.2.1.1.3.1.1 "><p id="sfs_02_0034__en-us_topic_0076901182_p11879716">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_0034__en-us_topic_0076901182_p22732954">You must enter a username and the password to access the requested page.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="sfs_02_0034__en-us_topic_0076901182_row3269999"><td class="cellrowborder" valign="top" width="43.43%" headers="mcps1.3.5.2.2.1.1.3.1.1 "><p id="sfs_02_0034__en-us_topic_0076901182_p63543344">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_0034__en-us_topic_0076901182_p46737271">Access to the requested page is forbidden.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="sfs_02_0034__en-us_topic_0076901182_row17982255"><td class="cellrowborder" valign="top" width="43.43%" headers="mcps1.3.5.2.2.1.1.3.1.1 "><p id="sfs_02_0034__en-us_topic_0076901182_p47276535">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_0034__en-us_topic_0076901182_p4194103">The requested page was not found.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="sfs_02_0034__en-us_topic_0076901182_row37746932"><td class="cellrowborder" valign="top" width="43.43%" headers="mcps1.3.5.2.2.1.1.3.1.1 "><p id="sfs_02_0034__en-us_topic_0076901182_p37602652">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_0034__en-us_topic_0076901182_p25915985">You are not allowed to use the method specified in the request.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="sfs_02_0034__en-us_topic_0076901182_row31917275"><td class="cellrowborder" valign="top" width="43.43%" headers="mcps1.3.5.2.2.1.1.3.1.1 "><p id="sfs_02_0034__en-us_topic_0076901182_p35162510">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_0034__en-us_topic_0076901182_p29591041">The response generated by the server could not be accepted by the client.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="sfs_02_0034__en-us_topic_0076901182_row64992778"><td class="cellrowborder" valign="top" width="43.43%" headers="mcps1.3.5.2.2.1.1.3.1.1 "><p id="sfs_02_0034__en-us_topic_0076901182_p29923648">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_0034__en-us_topic_0076901182_p7896460">You must use the proxy server for authentication. Then the request can be processed.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="sfs_02_0034__en-us_topic_0076901182_row3959276"><td class="cellrowborder" valign="top" width="43.43%" headers="mcps1.3.5.2.2.1.1.3.1.1 "><p id="sfs_02_0034__en-us_topic_0076901182_p52265969">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_0034__en-us_topic_0076901182_p5685119">The request timed out.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="sfs_02_0034__en-us_topic_0076901182_row51166072"><td class="cellrowborder" valign="top" width="43.43%" headers="mcps1.3.5.2.2.1.1.3.1.1 "><p id="sfs_02_0034__en-us_topic_0076901182_p50811173">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_0034__en-us_topic_0076901182_p22064367">The request could not be processed due to a conflict.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="sfs_02_0034__en-us_topic_0076901182_row64361578"><td class="cellrowborder" valign="top" width="43.43%" headers="mcps1.3.5.2.2.1.1.3.1.1 "><p id="sfs_02_0034__en-us_topic_0076901182_p45905321">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_0034__en-us_topic_0076901182_p27343545">Failed to complete the request because of an internal service error.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="sfs_02_0034__en-us_topic_0076901182_row44765319"><td class="cellrowborder" valign="top" width="43.43%" headers="mcps1.3.5.2.2.1.1.3.1.1 "><p id="sfs_02_0034__en-us_topic_0076901182_p2112211">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_0034__en-us_topic_0076901182_p36871363">Failed to complete the request because the server does not support the requested function.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="sfs_02_0034__en-us_topic_0076901182_row63406812"><td class="cellrowborder" valign="top" width="43.43%" headers="mcps1.3.5.2.2.1.1.3.1.1 "><p id="sfs_02_0034__en-us_topic_0076901182_p35678142">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_0034__en-us_topic_0076901182_p4248376">Failed to complete the request because the request is invalid.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="sfs_02_0034__en-us_topic_0076901182_row38235390"><td class="cellrowborder" valign="top" width="43.43%" headers="mcps1.3.5.2.2.1.1.3.1.1 "><p id="sfs_02_0034__en-us_topic_0076901182_p10058896">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_0034__en-us_topic_0076901182_p9464271">Failed to complete the request because the service is unavailable.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="sfs_02_0034__en-us_topic_0076901182_row18069578"><td class="cellrowborder" valign="top" width="43.43%" headers="mcps1.3.5.2.2.1.1.3.1.1 "><p id="sfs_02_0034__en-us_topic_0076901182_p54349751">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_0034__en-us_topic_0076901182_p40253700">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_0033.html">Expansion and Shrinking</a></div>
|
|
</div>
|
|
</div>
|
|
|