yexinru/doc-exports
1
0
Fork 0
forked from docs/doc-exports
Code Pull Requests Activity
Files
de9f8a7cc5b4e61816cbd4e52cc108c5f9fc3b4c
doc-exports/docs/sfs/api-ref/ExpandShare.html
zhangyue e0d0a83c1f 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>
2025-04-14 12:20:07 +00:00

192 lines
13 KiB
HTML
Raw Blame History

<a name="ExpandShare"></a><a name="ExpandShare"></a>
<h1 class="topictitle1">Expanding the Capacity of a File System</h1>
<div id="body1708331107508"><div class="section" id="ExpandShare__section111645333423"><h4 class="sectiontitle">Function</h4><p id="ExpandShare__p1316483354217">This API is used to expand the capacity of a file system.</p>
</div>
<div class="section" id="ExpandShare__section13164153316428"><h4 class="sectiontitle">URI</h4><p id="ExpandShare__p10164833164220">POST /v1/{project_id}/sfs-turbo/shares/{share_id}/action</p>
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="ExpandShare__table2016543315424" frame="border" border="1" rules="all"><caption><b>Table 1 </b>Path Parameters</caption><thead align="left"><tr id="ExpandShare__row17164173316425"><th align="left" class="cellrowborder" valign="top" width="20%" id="mcps1.3.2.3.2.5.1.1"><p id="ExpandShare__p171657333425">Parameter</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="20%" id="mcps1.3.2.3.2.5.1.2"><p id="ExpandShare__p15165133104212">Mandatory</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="20%" id="mcps1.3.2.3.2.5.1.3"><p id="ExpandShare__p17165733134213">Type</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="40%" id="mcps1.3.2.3.2.5.1.4"><p id="ExpandShare__p131655331427">Description</p>
</th>
</tr>
</thead>
<tbody><tr id="ExpandShare__row101641033184216"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.2.3.2.5.1.1 "><p id="ExpandShare__p916553374216">project_id</p>
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.2.3.2.5.1.2 "><p id="ExpandShare__p1516523316422">Yes</p>
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.2.3.2.5.1.3 "><p id="ExpandShare__p15165173315421">String</p>
</td>
<td class="cellrowborder" valign="top" width="40%" headers="mcps1.3.2.3.2.5.1.4 "><p id="ExpandShare__p91665338429">Project ID</p>
</td>
</tr>
<tr id="ExpandShare__row5164173316429"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.2.3.2.5.1.1 "><p id="ExpandShare__p1016663315422">share_id</p>
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.2.3.2.5.1.2 "><p id="ExpandShare__p616617336429">Yes</p>
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.2.3.2.5.1.3 "><p id="ExpandShare__p2016613318428">String</p>
</td>
<td class="cellrowborder" valign="top" width="40%" headers="mcps1.3.2.3.2.5.1.4 "><p id="ExpandShare__p61661633204212">File system ID</p>
</td>
</tr>
</tbody>
</table>
</div>
</div>
<div class="section" id="ExpandShare__section1316603317422"><h4 class="sectiontitle">Request Parameters</h4>
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="ExpandShare__HeaderParameter" frame="border" border="1" rules="all"><caption><b>Table 2 </b>Request header parameters</caption><thead align="left"><tr id="ExpandShare__row1916633319427"><th align="left" class="cellrowborder" valign="top" width="20%" id="mcps1.3.3.2.2.5.1.1"><p id="ExpandShare__p6167153319423">Parameter</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="20%" id="mcps1.3.3.2.2.5.1.2"><p id="ExpandShare__p121671233114217">Mandatory</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="20%" id="mcps1.3.3.2.2.5.1.3"><p id="ExpandShare__p116763318426">Type</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="40%" id="mcps1.3.3.2.2.5.1.4"><p id="ExpandShare__p1216713317423">Description</p>
</th>
</tr>
</thead>
<tbody><tr id="ExpandShare__row17166143314212"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.2.2.5.1.1 "><p id="ExpandShare__p3167123310426">X-Auth-Token</p>
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.2.2.5.1.2 "><p id="ExpandShare__p1216743344214">Yes</p>
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.2.2.5.1.3 "><p id="ExpandShare__p9167933124218">String</p>
</td>
<td class="cellrowborder" valign="top" width="40%" headers="mcps1.3.3.2.2.5.1.4 "><p id="ExpandShare__p1616763315425">Account token</p>
</td>
</tr>
<tr id="ExpandShare__row1916613310429"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.2.2.5.1.1 "><p id="ExpandShare__p181671933124214">Content-Type</p>
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.2.2.5.1.2 "><p id="ExpandShare__p1716763364216">Yes</p>
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.2.2.5.1.3 "><p id="ExpandShare__p11680338425">String</p>
</td>
<td class="cellrowborder" valign="top" width="40%" headers="mcps1.3.3.2.2.5.1.4 "><p id="ExpandShare__p12168733194219">MIME type</p>
</td>
</tr>
</tbody>
</table>
</div>
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="ExpandShare__request_ExpandShareRequestBody" frame="border" border="1" rules="all"><caption><b>Table 3 </b>Request body parameters</caption><thead align="left"><tr id="ExpandShare__row116813384218"><th align="left" class="cellrowborder" valign="top" width="20%" id="mcps1.3.3.3.2.5.1.1"><p id="ExpandShare__p016812331429">Parameter</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="20%" id="mcps1.3.3.3.2.5.1.2"><p id="ExpandShare__p1616843354210">Mandatory</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="20%" id="mcps1.3.3.3.2.5.1.3"><p id="ExpandShare__p1816817332428">Type</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="40%" id="mcps1.3.3.3.2.5.1.4"><p id="ExpandShare__p1316803364219">Description</p>
</th>
</tr>
</thead>
<tbody><tr id="ExpandShare__row2168153313429"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.3.2.5.1.1 "><p id="ExpandShare__p61688330426">extend</p>
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.3.2.5.1.2 "><p id="ExpandShare__p4169123384219">Yes</p>
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.3.2.5.1.3 "><p id="ExpandShare__p18169833154216"><a href="#ExpandShare__request_Extend">Extend</a> object</p>
</td>
<td class="cellrowborder" valign="top" width="40%" headers="mcps1.3.3.3.2.5.1.4 "><p id="ExpandShare__p1916993364214">Object of <strong id="ExpandShare__b181691233164217">extend</strong></p>
</td>
</tr>
</tbody>
</table>
</div>
<div class="tablenoborder"><a name="ExpandShare__request_Extend"></a><a name="request_Extend"></a><table cellpadding="4" cellspacing="0" summary="" id="ExpandShare__request_Extend" frame="border" border="1" rules="all"><caption><b>Table 4 </b>Extend</caption><thead align="left"><tr id="ExpandShare__row716933310424"><th align="left" class="cellrowborder" valign="top" width="20%" id="mcps1.3.3.4.2.5.1.1"><p id="ExpandShare__p181701433134218">Parameter</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="20%" id="mcps1.3.3.4.2.5.1.2"><p id="ExpandShare__p1917015335424">Mandatory</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="20%" id="mcps1.3.3.4.2.5.1.3"><p id="ExpandShare__p101701233134212">Type</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="40%" id="mcps1.3.3.4.2.5.1.4"><p id="ExpandShare__p5170143313425">Description</p>
</th>
</tr>
</thead>
<tbody><tr id="ExpandShare__row21697334423"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.4.2.5.1.1 "><p id="ExpandShare__p17170183315427">new_size</p>
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.4.2.5.1.2 "><p id="ExpandShare__p17170153314428">Yes</p>
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.4.2.5.1.3 "><p id="ExpandShare__p20170143334214">Integer</p>
</td>
<td class="cellrowborder" valign="top" width="40%" headers="mcps1.3.3.4.2.5.1.4 "><p id="ExpandShare__p9170173324218">New capacity of the file system after expansion, in GiB.</p>
<p id="ExpandShare__p1317016332422">The value ranges from 500 GiB to 32768 GiB, and the capacity expansion step is greater than or equal to 100 GiB.</p>
<p id="ExpandShare__p18170133124212">Specifications of the previous-generation SFS Turbo file system: Standard Enhanced and Performance Enhanced. The capacity ranges from 10240 GiB to 327680 GiB. The capacity expansion step is greater than or equal to 100 GiB.</p>
<p id="ExpandShare__p617063313427">20 MB/s/TiB. The capacity ranges from 3686 GiB to 1048576 GiB. The capacity must be a multiple of 1.2 TiB, and the capacity expansion step must be greater than or equal to 1.2 TiB. The target capacity must be converted to GiB and then rounded down. For example, 4.8 TiB-&gt;4915 GiB, 8.4 TiB-&gt;8601 GiB.</p>
<p id="ExpandShare__p51701033144210">40 MB/s/TiB. The capacity ranges from 1228 GiB to 1048576 GiB. The capacity must be a multiple of 1.2 TiB, and the capacity expansion step must be greater than or equal to 1.2 TiB. The target capacity must be converted to GiB and then rounded down. For example, 4.8 TiB-&gt;4915 GiB, 8.4 TiB-&gt;8601 GiB.</p>
<p id="ExpandShare__p15170143344211">125 MB/s/TiB, 250 MB/s/TiB and 40 MB/s/TiB, the expansion steps are the same.</p>
<p id="ExpandShare__p18171113304213"></p>
</td>
</tr>
</tbody>
</table>
</div>
</div>
<div class="section" id="ExpandShare__section10172933164212"><h4 class="sectiontitle">Response Parameters</h4><p id="ExpandShare__p1317303318428"><strong id="ExpandShare__b1817363304218">Status code: 202</strong></p>
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="ExpandShare__response_ExpandShareResponseBody" frame="border" border="1" rules="all"><caption><b>Table 5 </b>Response body parameters</caption><thead align="left"><tr id="ExpandShare__row12173233164213"><th align="left" class="cellrowborder" valign="top" width="25%" id="mcps1.3.4.3.2.4.1.1"><p id="ExpandShare__p15173833154220">Parameter</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="25%" id="mcps1.3.4.3.2.4.1.2"><p id="ExpandShare__p20173183384211">Type</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="50%" id="mcps1.3.4.3.2.4.1.3"><p id="ExpandShare__p71733331424">Description</p>
</th>
</tr>
</thead>
<tbody><tr id="ExpandShare__row141731733174212"><td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.4.3.2.4.1.1 "><p id="ExpandShare__p217343311427">id</p>
</td>
<td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.4.3.2.4.1.2 "><p id="ExpandShare__p517483316428">String</p>
</td>
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.4.3.2.4.1.3 "><p id="ExpandShare__p12174033114215">ID of the SFS Turbo file system</p>
</td>
</tr>
<tr id="ExpandShare__row111733339420"><td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.4.3.2.4.1.1 "><p id="ExpandShare__p1117473314422">name</p>
</td>
<td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.4.3.2.4.1.2 "><p id="ExpandShare__p817433310429">String</p>
</td>
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.4.3.2.4.1.3 "><p id="ExpandShare__p3174123324220">Name of the SFS Turbo file system</p>
</td>
</tr>
</tbody>
</table>
</div>
</div>
<div class="section" id="ExpandShare__section41741033114220"><h4 class="sectiontitle">Example Requests</h4><p id="ExpandShare__p1174193314212">Expanding the capacity of a file system to 1,000 GB</p>
<pre class="screen" id="ExpandShare__screen1417493324211">{
"extend" : {
"new_size" : 1000
}
}</pre>
</div>
<div class="section" id="ExpandShare__section1174183317422"><h4 class="sectiontitle">Example Responses</h4><p id="ExpandShare__p217514337424"><strong id="ExpandShare__b1717510339427">Status code: 202</strong></p>
<p id="ExpandShare__p121754331424">Response body for expanding the capacity of a file system</p>
<pre class="screen" id="ExpandShare__screen517563314426">{
"id" : "67d4bd5e-7b2f-4c24-9a0b-c0038940c6f8",
"name" : "sfs-turbo-test"
}</pre>
</div>
<div class="section" id="ExpandShare__section10175103312422"><h4 class="sectiontitle">Status Codes</h4>
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="ExpandShare__status_code" frame="border" border="1" rules="all"><thead align="left"><tr id="ExpandShare__row151751433194216"><th align="left" class="cellrowborder" valign="top" width="15%" id="mcps1.3.7.2.1.3.1.1"><p id="ExpandShare__p617516332422">Status Code</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="85%" id="mcps1.3.7.2.1.3.1.2"><p id="ExpandShare__p617683304219">Description</p>
</th>
</tr>
</thead>
<tbody><tr id="ExpandShare__row517593311428"><td class="cellrowborder" valign="top" width="15%" headers="mcps1.3.7.2.1.3.1.1 "><p id="ExpandShare__p13176113334218">202</p>
</td>
<td class="cellrowborder" valign="top" width="85%" headers="mcps1.3.7.2.1.3.1.2 "><p id="ExpandShare__p171762033194214">Response body for expanding the capacity of a file system</p>
</td>
</tr>
</tbody>
</table>
</div>
</div>
<div class="section" id="ExpandShare__section017633315425"><h4 class="sectiontitle">Error Codes</h4><p id="ExpandShare__p91768336425">See <a href="ErrorCode.html">Error Codes</a>.</p>
</div>
</div>
<div>
<div class="familylinks">
<div class="parentlink"><strong>Parent topic:</strong> <a href="topic_300000000.html">Lifecycle Management</a></div>
</div>
</div>
View Git Blame Copy Permalink