doc-exports/docs/rds/api-ref/en-us_topic_0056890049.html
Wang , Deng Ke 5208dcae7b RDS API 20221104 version
Reviewed-by: Hasko, Vladimir <vladimir.hasko@t-systems.com>
Co-authored-by: Wang , Deng Ke <wangdengke2@huawei.com>
Co-committed-by: Wang , Deng Ke <wangdengke2@huawei.com>
2022-11-10 09:55:48 +00:00

117 lines
10 KiB
HTML

<a name="en-us_topic_0056890049"></a><a name="en-us_topic_0056890049"></a>
<h1 class="topictitle1">Changing DB Instance Volume</h1>
<div id="body1492603082525"><div class="section" id="en-us_topic_0056890049__section39107512101854"><h4 class="sectiontitle">Function</h4><p id="en-us_topic_0056890049__p13591938101854">This API is used to change the DB instance volume.</p>
</div>
<div class="section" id="en-us_topic_0056890049__section55218585101854"><h4 class="sectiontitle">URI</h4><ul id="en-us_topic_0056890049__ul43520399101854"><li id="en-us_topic_0056890049__li56139272101854">URI format<p id="en-us_topic_0056890049__p35491401101854"><a name="en-us_topic_0056890049__li56139272101854"></a><a name="li56139272101854"></a>PATH: /v1.0/{project_id}/instances/{instanceId}/action</p>
<p id="en-us_topic_0056890049__p50987155101854">Method: POST</p>
</li><li id="en-us_topic_0056890049__li56231215101854">Parameter description
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="en-us_topic_0056890049__table36318895101854" frame="border" border="1" rules="all"><caption><b>Table 1 </b>Parameter description</caption><thead align="left"><tr id="en-us_topic_0056890049__row51305511101854"><th align="left" class="cellrowborder" valign="top" width="21.07%" id="mcps1.3.2.2.2.1.2.4.1.1"><p id="en-us_topic_0056890049__p62105732101854"><strong id="en-us_topic_0056890049__b84235270691445_1">Name</strong></p>
</th>
<th align="left" class="cellrowborder" valign="top" width="29.25%" id="mcps1.3.2.2.2.1.2.4.1.2"><p id="en-us_topic_0056890049__p64508414101854"><strong id="en-us_topic_0056890049__b842352706102346_1">Mandatory</strong></p>
</th>
<th align="left" class="cellrowborder" valign="top" width="49.68%" id="mcps1.3.2.2.2.1.2.4.1.3"><p id="en-us_topic_0056890049__p57799036101854"><strong id="en-us_topic_0056890049__b842352706163417_1">Description</strong></p>
</th>
</tr>
</thead>
<tbody><tr id="en-us_topic_0056890049__row51210343101854"><td class="cellrowborder" valign="top" width="21.07%" headers="mcps1.3.2.2.2.1.2.4.1.1 "><p id="en-us_topic_0056890049__p54397094101854">project_id</p>
</td>
<td class="cellrowborder" valign="top" width="29.25%" headers="mcps1.3.2.2.2.1.2.4.1.2 "><p id="en-us_topic_0056890049__p44088482101854">Yes</p>
</td>
<td class="cellrowborder" valign="top" width="49.68%" headers="mcps1.3.2.2.2.1.2.4.1.3 "><p id="en-us_topic_0056890049__p14397250101854">Specifies the project ID of a tenant in a region.</p>
</td>
</tr>
<tr id="en-us_topic_0056890049__row62466387101854"><td class="cellrowborder" valign="top" width="21.07%" headers="mcps1.3.2.2.2.1.2.4.1.1 "><p id="en-us_topic_0056890049__p26612581101854">instanceId</p>
</td>
<td class="cellrowborder" valign="top" width="29.25%" headers="mcps1.3.2.2.2.1.2.4.1.2 "><p id="en-us_topic_0056890049__p8135439101854">Yes</p>
</td>
<td class="cellrowborder" valign="top" width="49.68%" headers="mcps1.3.2.2.2.1.2.4.1.3 "><p id="en-us_topic_0056890049__p54990842101854">Specifies the DB instance ID.</p>
</td>
</tr>
</tbody>
</table>
</div>
</li></ul>
<ul id="en-us_topic_0056890049__ul59875915101854"><li id="en-us_topic_0056890049__li2012331101854">Restrictions<ol id="en-us_topic_0056890049__ol18110980101854"><li id="en-us_topic_0056890049__li28781097101854">The adjusted volume size must be greater than the original one and the desired volume size must be a multiple of 10.</li><li id="en-us_topic_0056890049__li57703281101854">The sizes of the primary and standby DB instances are the same. When you scale the primary DB instance, its standby DB instance is also scaled.</li><li id="en-us_topic_0056890049__li43454203101854">The DB instances can be scaled when they are in the <strong id="en-us_topic_0056890049__b8423527068536">Available</strong> state.</li><li id="en-us_topic_0056890049__li55543510101854">Currently, only the DB engines MySQL and PostgreSQL are supported by the API.</li></ol>
</li></ul>
</div>
<div class="section" id="en-us_topic_0056890049__section30129545101854"><h4 class="sectiontitle">Request</h4><ul id="en-us_topic_0056890049__ul24574084101854"><li id="en-us_topic_0056890049__li19840165101854">Parameter description
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="en-us_topic_0056890049__table44343763101854" frame="border" border="1" rules="all"><caption><b>Table 2 </b>Parameter description</caption><thead align="left"><tr id="en-us_topic_0056890049__row32217258101854"><th align="left" class="cellrowborder" valign="top" width="24.242424242424242%" id="mcps1.3.3.2.1.1.2.4.1.1"><p id="en-us_topic_0056890049__p59461092101854"><strong id="en-us_topic_0056890049__b84235270691445_5">Name</strong></p>
</th>
<th align="left" class="cellrowborder" valign="top" width="42.42424242424242%" id="mcps1.3.3.2.1.1.2.4.1.2"><p id="en-us_topic_0056890049__p51619167101854"><strong id="en-us_topic_0056890049__b842352706164541_1">Type</strong></p>
</th>
<th align="left" class="cellrowborder" valign="top" width="33.33333333333333%" id="mcps1.3.3.2.1.1.2.4.1.3"><p id="en-us_topic_0056890049__p20403011101854"><strong id="en-us_topic_0056890049__b842352706163417_5">Description</strong></p>
</th>
</tr>
</thead>
<tbody><tr id="en-us_topic_0056890049__row42031158101854"><td class="cellrowborder" valign="top" width="24.242424242424242%" headers="mcps1.3.3.2.1.1.2.4.1.1 "><p id="en-us_topic_0056890049__p49080675101854">resize</p>
</td>
<td class="cellrowborder" valign="top" width="42.42424242424242%" headers="mcps1.3.3.2.1.1.2.4.1.2 "><p id="en-us_topic_0056890049__p16111728101854">Dictionary data structure. For details, see <a href="#en-us_topic_0056890049__table46186408101854">Table 3</a>.</p>
</td>
<td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.3.2.1.1.2.4.1.3 "><p id="en-us_topic_0056890049__p1398707101854">Specifies the information about the returned parameter <strong id="en-us_topic_0056890049__b842352706113940_1">volume</strong>.</p>
</td>
</tr>
</tbody>
</table>
</div>
<div class="tablenoborder"><a name="en-us_topic_0056890049__table46186408101854"></a><a name="table46186408101854"></a><table cellpadding="4" cellspacing="0" summary="" id="en-us_topic_0056890049__table46186408101854" frame="border" border="1" rules="all"><caption><b>Table 3 </b>resize field data structure description</caption><thead align="left"><tr id="en-us_topic_0056890049__row5532136101854"><th align="left" class="cellrowborder" valign="top" width="23.47%" id="mcps1.3.3.2.1.2.2.4.1.1"><p id="en-us_topic_0056890049__p45449848101854"><strong id="en-us_topic_0056890049__b84235270691445_7">Name</strong></p>
</th>
<th align="left" class="cellrowborder" valign="top" width="42.86%" id="mcps1.3.3.2.1.2.2.4.1.2"><p id="en-us_topic_0056890049__p57559081101854"><strong id="en-us_topic_0056890049__b842352706164541_3">Type</strong></p>
</th>
<th align="left" class="cellrowborder" valign="top" width="33.67%" id="mcps1.3.3.2.1.2.2.4.1.3"><p id="en-us_topic_0056890049__p31773986101854"><strong id="en-us_topic_0056890049__b842352706163417_7">Description</strong></p>
</th>
</tr>
</thead>
<tbody><tr id="en-us_topic_0056890049__row23556108101854"><td class="cellrowborder" valign="top" width="23.47%" headers="mcps1.3.3.2.1.2.2.4.1.1 "><p id="en-us_topic_0056890049__p28996623101854">volume</p>
</td>
<td class="cellrowborder" valign="top" width="42.86%" headers="mcps1.3.3.2.1.2.2.4.1.2 "><p id="en-us_topic_0056890049__p67025106101854">Dictionary data structure. For details, see <a href="#en-us_topic_0056890049__table20238213101854">Table 4</a>.</p>
</td>
<td class="cellrowborder" valign="top" width="33.67%" headers="mcps1.3.3.2.1.2.2.4.1.3 "><p id="en-us_topic_0056890049__p6049385101854">Specifies the information about the returned parameter <strong id="en-us_topic_0056890049__b842352706113940_3">size</strong>.</p>
</td>
</tr>
</tbody>
</table>
</div>
<div class="tablenoborder"><a name="en-us_topic_0056890049__table20238213101854"></a><a name="table20238213101854"></a><table cellpadding="4" cellspacing="0" summary="" id="en-us_topic_0056890049__table20238213101854" frame="border" border="1" rules="all"><caption><b>Table 4 </b>volume field data structure description</caption><thead align="left"><tr id="en-us_topic_0056890049__row48003310101854"><th align="left" class="cellrowborder" valign="top" width="23.369999999999997%" id="mcps1.3.3.2.1.3.2.4.1.1"><p id="en-us_topic_0056890049__p63062868101854"><strong id="en-us_topic_0056890049__b84235270691445_9">Name</strong></p>
</th>
<th align="left" class="cellrowborder" valign="top" width="43.3%" id="mcps1.3.3.2.1.3.2.4.1.2"><p id="en-us_topic_0056890049__p7818683101854"><strong id="en-us_topic_0056890049__b842352706164541_5">Type</strong></p>
</th>
<th align="left" class="cellrowborder" valign="top" width="33.33%" id="mcps1.3.3.2.1.3.2.4.1.3"><p id="en-us_topic_0056890049__p29333578101854"><strong id="en-us_topic_0056890049__b842352706163417_9">Description</strong></p>
</th>
</tr>
</thead>
<tbody><tr id="en-us_topic_0056890049__row27209642101854"><td class="cellrowborder" valign="top" width="23.369999999999997%" headers="mcps1.3.3.2.1.3.2.4.1.1 "><p id="en-us_topic_0056890049__p56497411101854">size</p>
</td>
<td class="cellrowborder" valign="top" width="43.3%" headers="mcps1.3.3.2.1.3.2.4.1.2 "><p id="en-us_topic_0056890049__p12887548101854">Int</p>
</td>
<td class="cellrowborder" valign="top" width="33.33%" headers="mcps1.3.3.2.1.3.2.4.1.3 "><p id="en-us_topic_0056890049__p37258429101854">Specifies the volume size after scaling up. The value must a multiple of 10.</p>
<p id="en-us_topic_0056890049__p66890408101854">Its value range is from 50 GB to 4000 GB.</p>
</td>
</tr>
</tbody>
</table>
</div>
</li></ul>
<ul id="en-us_topic_0056890049__ul49413993101854"><li id="en-us_topic_0056890049__li42072761101854">Request example<pre class="codeblock" id="en-us_topic_0056890049__codeblock43260305101910">{
"resize": {
"volume": {
"size": 400
}
}
}</pre>
</li></ul>
</div>
<div class="section" id="en-us_topic_0056890049__section52450500101854"><h4 class="sectiontitle">Normal Response</h4><p id="en-us_topic_0056890049__p65029181182214">None</p>
</div>
<div class="section" id="en-us_topic_0056890049__section60588987101854"><h4 class="sectiontitle">Abnormal Response</h4><p id="en-us_topic_0056890049__p8760952101854">For details, see <a href="en-us_topic_0032488197.html">Abnormal Request Results</a>.</p>
</div>
</div>
<div>
<div class="familylinks">
<div class="parentlink"><strong>Parent topic:</strong> <a href="rds_06_0021.html">DB Instance Management</a></div>
</div>
</div>