doc-exports/docs/evs/api-ref/evs_04_2014.html
zhangyue ccbf63b495 EVS API DOC
Reviewed-by: Muller, Martin <martin.muller@t-systems.com>
Reviewed-by: Sabelnikov, Dmitriy <dmitriy.sabelnikov@t-systems.com>
Co-authored-by: zhangyue <zhangyue164@huawei.com>
Co-committed-by: zhangyue <zhangyue164@huawei.com>
2024-05-16 09:08:21 +00:00

174 lines
13 KiB
HTML

<a name="evs_04_2014"></a><a name="evs_04_2014"></a>
<h1 class="topictitle1">Expanding Capacity of an EVS Disk</h1>
<div id="body53130720"><div class="section" id="evs_04_2014__section4445458"><h4 class="sectiontitle">Function</h4><p id="evs_04_2014__p17530718191518">This API is used to expand the capacity of an EVS disk. <span id="evs_04_2014__text1864821170194726"></span></p>
</div>
<ul id="evs_04_2014__ul1931366164211"><li id="evs_04_2014__li31392702164213">If the status of the to-be-expanded disk is <strong id="evs_04_2014__b1612977365174554">available</strong>, there are no restrictions.</li><li id="evs_04_2014__li60094846164251">If the status of the to-be-expanded disk is <strong id="evs_04_2014__b1026642936">in-use</strong>, the restrictions are as follows:<ul id="evs_04_2014__ul580664716433"><li id="evs_04_2014__li2791020816439">A shared disk cannot be expanded, that is, the value of parameter <strong id="evs_04_2014__b842352706174734">multiattach</strong> must be <strong id="evs_04_2014__b842352706174753">false</strong>.</li><li id="evs_04_2014__li24297666164211">The status of the server to which the disk attached must be <strong id="evs_04_2014__b842352706174849">ACTIVE</strong>, <strong id="evs_04_2014__b842352706174852">PAUSED</strong>, <strong id="evs_04_2014__b842352706174854">SUSPENDED</strong>, or <strong id="evs_04_2014__b842352706174859">SHUTOFF</strong>.</li></ul>
</li></ul>
<div class="notice" id="evs_04_2014__note6325143016124"><span class="noticetitle"><img src="public_sys-resources/notice_3.0-en-us.png"> </span><div class="noticebody"><p id="evs_04_2014__p3239196016124">This API call exists for compatibility reasons only and is not meant to be used. </p>
</div></div>
<div class="section" id="evs_04_2014__section40009126"><h4 class="sectiontitle">URI</h4><ul id="evs_04_2014__ul27217289"><li id="evs_04_2014__li43629015">URI format<p id="evs_04_2014__p44289360"><a name="evs_04_2014__li43629015"></a><a name="li43629015"></a>POST /v2/{project_id}/cloudvolumes/{volume_id}/action</p>
</li><li id="evs_04_2014__li63059925">Parameter description
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="evs_04_2014__table30668413" frame="border" border="1" rules="all"><thead align="left"><tr id="evs_04_2014__row58200784"><th align="left" class="cellrowborder" valign="top" width="24%" id="mcps1.3.4.2.2.1.1.4.1.1"><p id="evs_04_2014__p16643039">Parameter</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="22%" id="mcps1.3.4.2.2.1.1.4.1.2"><p id="evs_04_2014__p5908907">Mandatory</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="54%" id="mcps1.3.4.2.2.1.1.4.1.3"><p id="evs_04_2014__p8859419">Description</p>
</th>
</tr>
</thead>
<tbody><tr id="evs_04_2014__row46524311"><td class="cellrowborder" valign="top" width="24%" headers="mcps1.3.4.2.2.1.1.4.1.1 "><p id="evs_04_2014__p10372872">project_id</p>
</td>
<td class="cellrowborder" valign="top" width="22%" headers="mcps1.3.4.2.2.1.1.4.1.2 "><p id="evs_04_2014__p34896342">Yes</p>
</td>
<td class="cellrowborder" valign="top" width="54%" headers="mcps1.3.4.2.2.1.1.4.1.3 "><p id="evs_04_2014__p8031464">The project ID.</p>
</td>
</tr>
<tr id="evs_04_2014__row5174319"><td class="cellrowborder" valign="top" width="24%" headers="mcps1.3.4.2.2.1.1.4.1.1 "><p id="evs_04_2014__p16466658">volume_id</p>
</td>
<td class="cellrowborder" valign="top" width="22%" headers="mcps1.3.4.2.2.1.1.4.1.2 "><p id="evs_04_2014__p58730959">Yes</p>
</td>
<td class="cellrowborder" valign="top" width="54%" headers="mcps1.3.4.2.2.1.1.4.1.3 "><p id="evs_04_2014__p59587228">The ID of a disk.</p>
</td>
</tr>
</tbody>
</table>
</div>
</li></ul>
</div>
<div class="section" id="evs_04_2014__section24537816"><h4 class="sectiontitle">Request</h4><ul id="evs_04_2014__ul61836145"><li id="evs_04_2014__li19654399">Request parameters
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="evs_04_2014__table42671863" frame="border" border="1" rules="all"><thead align="left"><tr id="evs_04_2014__row12592542"><th align="left" class="cellrowborder" valign="top" width="18%" id="mcps1.3.5.2.1.1.1.5.1.1"><p id="evs_04_2014__p13362997">Parameter</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="18%" id="mcps1.3.5.2.1.1.1.5.1.2"><p id="evs_04_2014__p8661001">Type</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="16%" id="mcps1.3.5.2.1.1.1.5.1.3"><p id="evs_04_2014__p30452481">Mandatory</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="48%" id="mcps1.3.5.2.1.1.1.5.1.4"><p id="evs_04_2014__p50731910">Description</p>
</th>
</tr>
</thead>
<tbody><tr id="evs_04_2014__row5187493615377"><td class="cellrowborder" valign="top" width="18%" headers="mcps1.3.5.2.1.1.1.5.1.1 "><p id="evs_04_2014__p4112025815377">os-extend</p>
</td>
<td class="cellrowborder" valign="top" width="18%" headers="mcps1.3.5.2.1.1.1.5.1.2 "><p id="evs_04_2014__p4240658415377">Object</p>
</td>
<td class="cellrowborder" valign="top" width="16%" headers="mcps1.3.5.2.1.1.1.5.1.3 "><p id="evs_04_2014__p1238131615377">Yes</p>
</td>
<td class="cellrowborder" valign="top" width="48%" headers="mcps1.3.5.2.1.1.1.5.1.4 "><p id="evs_04_2014__p6336250715377">The disk expansion marker. For details, see <a href="#evs_04_2014__li19185119124117">Parameter in the os-extend field</a>.</p>
</td>
</tr>
</tbody>
</table>
</div>
</li><li id="evs_04_2014__li19185119124117"><a name="evs_04_2014__li19185119124117"></a><a name="li19185119124117"></a>Parameter in the <strong id="evs_04_2014__b842352706145625">os-extend</strong> field
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="evs_04_2014__table15186149194112" frame="border" border="1" rules="all"><thead align="left"><tr id="evs_04_2014__row418613904115"><th align="left" class="cellrowborder" valign="top" width="18%" id="mcps1.3.5.2.2.2.1.5.1.1"><p id="evs_04_2014__p91861591418">Parameter</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="18%" id="mcps1.3.5.2.2.2.1.5.1.2"><p id="evs_04_2014__p218699134116">Type</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="16%" id="mcps1.3.5.2.2.2.1.5.1.3"><p id="evs_04_2014__p141867974119">Mandatory</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="48%" id="mcps1.3.5.2.2.2.1.5.1.4"><p id="evs_04_2014__p161874916417">Description</p>
</th>
</tr>
</thead>
<tbody><tr id="evs_04_2014__row118711964115"><td class="cellrowborder" valign="top" width="18%" headers="mcps1.3.5.2.2.2.1.5.1.1 "><p id="evs_04_2014__p101872944115">new_size</p>
</td>
<td class="cellrowborder" valign="top" width="18%" headers="mcps1.3.5.2.2.2.1.5.1.2 "><p id="evs_04_2014__p3187992411">Integer</p>
</td>
<td class="cellrowborder" valign="top" width="16%" headers="mcps1.3.5.2.2.2.1.5.1.3 "><p id="evs_04_2014__p118719914117">Yes</p>
</td>
<td class="cellrowborder" valign="top" width="48%" headers="mcps1.3.5.2.2.2.1.5.1.4 "><p id="evs_04_2014__p8187199204115">The new disk size, in GB.</p>
<p id="evs_04_2014__p1187179134115">The new size ranges from the original size to the maximum size (<strong id="evs_04_2014__b842352706154149">32768</strong> for a data disk and <strong id="evs_04_2014__b7981161735114">1024</strong> for a system disk).</p>
<div class="note" id="evs_04_2014__note518718914412"><span class="notetitle"> NOTE: </span><div class="notebody"><p id="evs_04_2014__evs_04_2013_p5070492815911">If the specified value is a decimal, the number part of the value will be used.</p>
</div></div>
</td>
</tr>
</tbody>
</table>
</div>
</li><li id="evs_04_2014__li52840473">Example request<pre class="screen" id="evs_04_2014__screen572756695828">{
"os-extend": {
"new_size": 200
}
}</pre>
</li></ul>
</div>
<div class="section" id="evs_04_2014__section19513753"><h4 class="sectiontitle">Response</h4><ul id="evs_04_2014__ul5123368020846"><li id="evs_04_2014__li10896102464312">Response parameters
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="evs_04_2014__evs_04_2013_table735313581437" frame="border" border="1" rules="all"><thead align="left"><tr id="evs_04_2014__evs_04_2013_row153536585313"><th align="left" class="cellrowborder" valign="top" width="21.157884211578843%" id="mcps1.3.6.2.1.1.1.4.1.1"><p id="evs_04_2014__evs_04_2013_p123541158732">Parameter</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="21.197880211978802%" id="mcps1.3.6.2.1.1.1.4.1.2"><p id="evs_04_2014__evs_04_2013_p1435411581320">Type</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="57.64423557644236%" id="mcps1.3.6.2.1.1.1.4.1.3"><p id="evs_04_2014__evs_04_2013_p13541058036">Description</p>
</th>
</tr>
</thead>
<tbody><tr id="evs_04_2014__evs_04_2013_row1135495819312"><td class="cellrowborder" valign="top" width="21.157884211578843%" headers="mcps1.3.6.2.1.1.1.4.1.1 "><p id="evs_04_2014__evs_04_2013_p33545583319">job_id</p>
</td>
<td class="cellrowborder" valign="top" width="21.197880211978802%" headers="mcps1.3.6.2.1.1.1.4.1.2 "><p id="evs_04_2014__evs_04_2013_p19354165810317">String</p>
</td>
<td class="cellrowborder" valign="top" width="57.64423557644236%" headers="mcps1.3.6.2.1.1.1.4.1.3 "><p id="evs_04_2014__evs_04_2013_p435416581936">The task ID.</p>
<div class="note" id="evs_04_2014__evs_04_2013_note335410589314"><span class="notetitle"> NOTE: </span><div class="notebody"><p id="evs_04_2014__evs_04_2013_p1435514588312">For details about how to query the task status, see <a href="evs_04_0054.html">Querying Task Status</a>.</p>
</div></div>
</td>
</tr>
<tr id="evs_04_2014__evs_04_2013_row195162113414"><td class="cellrowborder" valign="top" width="21.157884211578843%" headers="mcps1.3.6.2.1.1.1.4.1.1 "><p id="evs_04_2014__evs_04_2013_p129522216412">error</p>
</td>
<td class="cellrowborder" valign="top" width="21.197880211978802%" headers="mcps1.3.6.2.1.1.1.4.1.2 "><p id="evs_04_2014__evs_04_2013_p1595262111415">Object</p>
</td>
<td class="cellrowborder" valign="top" width="57.64423557644236%" headers="mcps1.3.6.2.1.1.1.4.1.3 "><p id="evs_04_2014__evs_04_2013_p109527215417">The error message returned if an error occurs. For details, see <a href="#evs_04_2014__li24688256">Parameters in the error field</a>.</p>
</td>
</tr>
</tbody>
</table>
</div>
</li><li id="evs_04_2014__li24688256"><a name="evs_04_2014__li24688256"></a><a name="li24688256"></a>Parameters in the <strong id="evs_04_2014__b1498512710717">error</strong> field
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="evs_04_2014__table15441099103019" frame="border" border="1" rules="all"><thead align="left"><tr id="evs_04_2014__row54094047103019"><th align="left" class="cellrowborder" valign="top" width="21.17788221177882%" id="mcps1.3.6.2.2.2.1.4.1.1"><p id="evs_04_2014__p19541716103019">Parameter</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="21.17788221177882%" id="mcps1.3.6.2.2.2.1.4.1.2"><p id="evs_04_2014__p39375186103019">Type</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="57.64423557644236%" id="mcps1.3.6.2.2.2.1.4.1.3"><p id="evs_04_2014__p38578950103019">Description</p>
</th>
</tr>
</thead>
<tbody><tr id="evs_04_2014__row59401790103019"><td class="cellrowborder" valign="top" width="21.17788221177882%" headers="mcps1.3.6.2.2.2.1.4.1.1 "><p id="evs_04_2014__p46815658103019">message</p>
</td>
<td class="cellrowborder" valign="top" width="21.17788221177882%" headers="mcps1.3.6.2.2.2.1.4.1.2 "><p id="evs_04_2014__p33971979103019">String</p>
</td>
<td class="cellrowborder" valign="top" width="57.64423557644236%" headers="mcps1.3.6.2.2.2.1.4.1.3 "><p id="evs_04_2014__p21623243103019">The error message returned if an error occurs.</p>
</td>
</tr>
<tr id="evs_04_2014__row60391466103019"><td class="cellrowborder" valign="top" width="21.17788221177882%" headers="mcps1.3.6.2.2.2.1.4.1.1 "><p id="evs_04_2014__p59870541103019">code</p>
</td>
<td class="cellrowborder" valign="top" width="21.17788221177882%" headers="mcps1.3.6.2.2.2.1.4.1.2 "><p id="evs_04_2014__p17675690103019">String</p>
</td>
<td class="cellrowborder" valign="top" width="57.64423557644236%" headers="mcps1.3.6.2.2.2.1.4.1.3 "><p id="evs_04_2014__p6087468103019">The error code returned if an error occurs.</p>
<p id="evs_04_2014__p54787218103019">For details about the error code, see <a href="evs_04_0038.html">Error Codes</a>.</p>
</td>
</tr>
</tbody>
</table>
</div>
</li><li id="evs_04_2014__li462803520846">Example response<pre class="screen" id="evs_04_2014__screen6021682695918">{
"job_id": "70a599e0-31e7-49b7-b260-868f441e862b"
}</pre>
<p id="evs_04_2014__p3932656120846">or</p>
<pre class="screen" id="evs_04_2014__screen1817795695925">{
"error": {
"message": "XXXX",
"code": "XXX"
}
}</pre>
</li></ul>
</div>
<div class="section" id="evs_04_2014__section41406050"><h4 class="sectiontitle">Status Codes</h4><ul id="evs_04_2014__ul51464189"><li id="evs_04_2014__li60524524">Normal<p id="evs_04_2014__p7849808"><a name="evs_04_2014__li60524524"></a><a name="li60524524"></a>200</p>
</li></ul>
</div>
<div class="section" id="evs_04_2014__section431317151242"><h4 class="sectiontitle">Error Codes</h4><p id="evs_04_2014__evs_04_2013_p783819215242">For details, see <a href="evs_04_0038.html">Error Codes</a>.</p>
</div>
</div>
<div>
<div class="familylinks">
<div class="parentlink"><strong>Parent topic:</strong> <a href="evs_04_2002.html">Disk Management</a></div>
</div>
</div>