doc-exports/docs/rds/api-ref/en-us_topic_0056890050.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

97 lines
8.8 KiB
HTML

<a name="en-us_topic_0056890050"></a><a name="en-us_topic_0056890050"></a>
<h1 class="topictitle1">Changing DB Instance Specifications</h1>
<div id="body1492603082525"><div class="section" id="en-us_topic_0056890050__section31046129101956"><h4 class="sectiontitle">Function</h4><p id="en-us_topic_0056890050__p31708517101956">This API is used to change DB instance specifications.</p>
</div>
<div class="notice" id="en-us_topic_0056890050__note111721638157"><span class="noticetitle"><img src="public_sys-resources/notice_3.0-en-us.png"> </span><div class="noticebody"><p id="en-us_topic_0056890050__p16172433155">Services will be interrupted for 5 to 10 minutes when you change DB instance specifications. Exercise caution when performing this operation.</p>
</div></div>
<div class="section" id="en-us_topic_0056890050__section16941204101956"><h4 class="sectiontitle">URI</h4><ul id="en-us_topic_0056890050__ul30060304101956"><li id="en-us_topic_0056890050__li2107288101956">URI format<p id="en-us_topic_0056890050__p18965593101956"><a name="en-us_topic_0056890050__li2107288101956"></a><a name="li2107288101956"></a>PATH: /v1.0/{project_id}/instances/{instanceId}/action</p>
<p id="en-us_topic_0056890050__p36472614101956">Method: POST</p>
</li><li id="en-us_topic_0056890050__li59818070101956">Parameter description
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="en-us_topic_0056890050__table1491724101956" frame="border" border="1" rules="all"><caption><b>Table 1 </b>Parameter description</caption><thead align="left"><tr id="en-us_topic_0056890050__row58880760101956"><th align="left" class="cellrowborder" valign="top" width="21.61%" id="mcps1.3.3.2.2.1.2.4.1.1"><p id="en-us_topic_0056890050__p4612244101956"><strong id="en-us_topic_0056890050__b84235270691445_1">Name</strong></p>
</th>
<th align="left" class="cellrowborder" valign="top" width="28.01%" id="mcps1.3.3.2.2.1.2.4.1.2"><p id="en-us_topic_0056890050__p38047444101956"><strong id="en-us_topic_0056890050__b842352706102346_1">Mandatory</strong></p>
</th>
<th align="left" class="cellrowborder" valign="top" width="50.38%" id="mcps1.3.3.2.2.1.2.4.1.3"><p id="en-us_topic_0056890050__p61944096101956"><strong id="en-us_topic_0056890050__b842352706163417_1">Description</strong></p>
</th>
</tr>
</thead>
<tbody><tr id="en-us_topic_0056890050__row51415905101956"><td class="cellrowborder" valign="top" width="21.61%" headers="mcps1.3.3.2.2.1.2.4.1.1 "><p id="en-us_topic_0056890050__p3938815101956">project_id</p>
</td>
<td class="cellrowborder" valign="top" width="28.01%" headers="mcps1.3.3.2.2.1.2.4.1.2 "><p id="en-us_topic_0056890050__p50608609101956">Yes</p>
</td>
<td class="cellrowborder" valign="top" width="50.38%" headers="mcps1.3.3.2.2.1.2.4.1.3 "><p id="en-us_topic_0056890050__p5656688101956">Specifies the project ID of a tenant in a region.</p>
</td>
</tr>
<tr id="en-us_topic_0056890050__row50910195101956"><td class="cellrowborder" valign="top" width="21.61%" headers="mcps1.3.3.2.2.1.2.4.1.1 "><p id="en-us_topic_0056890050__p30085168101956">instanceId</p>
</td>
<td class="cellrowborder" valign="top" width="28.01%" headers="mcps1.3.3.2.2.1.2.4.1.2 "><p id="en-us_topic_0056890050__p20979533101956">Yes</p>
</td>
<td class="cellrowborder" valign="top" width="50.38%" headers="mcps1.3.3.2.2.1.2.4.1.3 "><p id="en-us_topic_0056890050__p21620594101956">Specifies the DB instance ID.</p>
</td>
</tr>
</tbody>
</table>
</div>
</li></ul>
<ul id="en-us_topic_0056890050__ul63070006101956"><li id="en-us_topic_0056890050__li30759143101956">Restrictions<ol id="en-us_topic_0056890050__ol8396837101956"><li id="en-us_topic_0056890050__li8462672101956">The new specifications cannot be the same as the original specifications.</li><li id="en-us_topic_0056890050__li9055185101956">The instance class can be modified only for DB instances whose status is <strong id="en-us_topic_0056890050__b842352706978">Available</strong>.</li><li id="en-us_topic_0056890050__li24561194101956">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_0056890050__section19724157101956"><h4 class="sectiontitle">Request</h4><ul id="en-us_topic_0056890050__ul54152910101956"><li id="en-us_topic_0056890050__li17614150101956">Parameter description
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="en-us_topic_0056890050__table24309628101956" frame="border" border="1" rules="all"><caption><b>Table 2 </b>Parameter description</caption><thead align="left"><tr id="en-us_topic_0056890050__row53446469101956"><th align="left" class="cellrowborder" valign="top" width="24.242424242424242%" id="mcps1.3.4.2.1.1.2.4.1.1"><p id="en-us_topic_0056890050__p34196722101956"><strong id="en-us_topic_0056890050__b84235270691445_5">Name</strong></p>
</th>
<th align="left" class="cellrowborder" valign="top" width="42.42424242424242%" id="mcps1.3.4.2.1.1.2.4.1.2"><p id="en-us_topic_0056890050__p18471079101956"><strong id="en-us_topic_0056890050__b842352706164541_1">Type</strong></p>
</th>
<th align="left" class="cellrowborder" valign="top" width="33.33333333333333%" id="mcps1.3.4.2.1.1.2.4.1.3"><p id="en-us_topic_0056890050__p19762445101956"><strong id="en-us_topic_0056890050__b842352706163417_5">Description</strong></p>
</th>
</tr>
</thead>
<tbody><tr id="en-us_topic_0056890050__row57254219101956"><td class="cellrowborder" valign="top" width="24.242424242424242%" headers="mcps1.3.4.2.1.1.2.4.1.1 "><p id="en-us_topic_0056890050__p7080202101956">resize</p>
</td>
<td class="cellrowborder" valign="top" width="42.42424242424242%" headers="mcps1.3.4.2.1.1.2.4.1.2 "><p id="en-us_topic_0056890050__p36625522101956">Dictionary data structure. For details, see <a href="#en-us_topic_0056890050__table50214959101956">Table 3</a>.</p>
</td>
<td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.4.2.1.1.2.4.1.3 "><p id="en-us_topic_0056890050__p57786747101956">Specifies the information about the returned parameter <strong id="en-us_topic_0056890050__b842352706113940">flavorRef</strong>.</p>
</td>
</tr>
</tbody>
</table>
</div>
<div class="tablenoborder"><a name="en-us_topic_0056890050__table50214959101956"></a><a name="table50214959101956"></a><table cellpadding="4" cellspacing="0" summary="" id="en-us_topic_0056890050__table50214959101956" 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_0056890050__row10175857101956"><th align="left" class="cellrowborder" valign="top" width="24.872487248724873%" id="mcps1.3.4.2.1.2.2.4.1.1"><p id="en-us_topic_0056890050__p18938068101956"><strong id="en-us_topic_0056890050__b84235270691445_7">Name</strong></p>
</th>
<th align="left" class="cellrowborder" valign="top" width="41.7941794179418%" id="mcps1.3.4.2.1.2.2.4.1.2"><p id="en-us_topic_0056890050__p57588511101956"><strong id="en-us_topic_0056890050__b842352706164541_3">Type</strong></p>
</th>
<th align="left" class="cellrowborder" valign="top" width="33.33333333333333%" id="mcps1.3.4.2.1.2.2.4.1.3"><p id="en-us_topic_0056890050__p34157819101956"><strong id="en-us_topic_0056890050__b842352706163417_7">Description</strong></p>
</th>
</tr>
</thead>
<tbody><tr id="en-us_topic_0056890050__row15319951101956"><td class="cellrowborder" valign="top" width="24.872487248724873%" headers="mcps1.3.4.2.1.2.2.4.1.1 "><p id="en-us_topic_0056890050__p32956548101956">flavorRef</p>
</td>
<td class="cellrowborder" valign="top" width="41.7941794179418%" headers="mcps1.3.4.2.1.2.2.4.1.2 "><p id="en-us_topic_0056890050__p52234754101956">String</p>
</td>
<td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.4.2.1.2.2.4.1.3 "><p id="en-us_topic_0056890050__p3156656101956">Specifies the specification ID (<strong id="en-us_topic_0056890050__b84235270617142">flavors.str_id</strong> in the response message in <a href="en-us_topic_0056890255.html">Obtaining All DB Instance Specifications</a>).</p>
</td>
</tr>
</tbody>
</table>
</div>
</li></ul>
<ul id="en-us_topic_0056890050__ul54362550101956"><li id="en-us_topic_0056890050__li19500906101956">Request example<pre class="codeblock" id="en-us_topic_0056890050__codeblock61220790102011">{
"resize":{
"flavorRef":"0d922098-553c-4123-80df-e627a1d41a0d"
}
}</pre>
</li></ul>
</div>
<div class="section" id="en-us_topic_0056890050__section36069544101956"><h4 class="sectiontitle">Normal Response</h4><p id="en-us_topic_0056890050__p4591430018214">None</p>
</div>
<div class="section" id="en-us_topic_0056890050__section26427218101956"><h4 class="sectiontitle">Abnormal Response</h4><p id="en-us_topic_0056890050__p60229902101956">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>